# 开通云端录制服务 (/zh-CN/realtime-media/cloud-recording/build/setup-and-access/enable-service)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## 登录声网控制台 [#登录声网控制台]

本文介绍如何开通云端录制服务。

如果你是第一次使用声网服务，点击[注册账号](https://sso.shengwang.cn/cn/v4/signup/with-sms)前往控制台进行注册。注册成功后会自动登录。

如果你已经拥有声网账号，可以直接[登录控制台](https://console.shengwang.cn//)。

:::info[信息]
注册和登录过程中如果遇到疑问，可以查看[快速开始](/zh-CN/introduction/quickstart)。
:::

## 创建声网项目 [#创建声网项目]

成功登录控制台后，按照以下步骤创建一个声网项目：

1. 展开控制台左上角下拉框，点击**创建项目**按钮。
2. 在弹出的对话框内，依次选择**项目类型**，输入**项目名称**，选择**场景标签**和**鉴权机制**。其中鉴权机制推荐选择**安全模式**，**调试模式**的安全性较低。

:::warning[注意]
为使用云端录制服务创建项目时，项目类型选择**通用项目**。
:::

## 获取 App ID [#获取-app-id]

成功创建项目后，声网会给每个项目自动分配一个 App ID 作为项目唯一标识。你可以直接在**总览**页面的**项目信息**栏，点击 App ID 右侧的复制按钮来获取当前项目的 App ID。

你需要保存好复制的 App ID，后续调用 API 进行初始化等操作时需要传入你获取的 App ID。

## 获取 App 证书 [#获取-app-证书]

创建好项目后，你可以参考如下步骤获取项目的 App 证书。

在声网控制台**总览**页面的**项目信息**栏，点击**主要证书**/**次要证书**下面的复制图标，即可获取项目的主次 App 证书。

## 获取临时 Token [#获取临时-token]

对于鉴权机制为安全模式的项目，在后续调用 API 进行加入频道等操作时，你还需要传入频道名和 Token 来对用户进行鉴权。

为方便体验和测试，在 App 调试阶段你可以先从控制台获取临时 Token（有效期为 24 小时），无需自行部署 Token 服务器。但在 App 正式上线前，你必须在自己的服务端部署并生成 Token。

在控制台左上角的下拉框，切换到你想要获取临时 Token 的项目，然后按如下步骤获取临时 Token：

1. 在**总览**页面的**项目信息**栏，点击**临时 Token 生成器**。
2. 在**生成临时 Token** 页面，点击**添加产品**。
3. 选择 **RTC** 产品，输入频道名，例如 `testChannel`。然后保存好输入的内容。
4. 点击**确认**。
5. 成功生成临时 Token 后，点击 Token 右侧的复制按钮，保存好复制的 Token。

## 获取客户 ID 和客户密钥 [#获取客户-id-和客户密钥]

声网 RESTful API 使用 HTTP 基本认证进行鉴权。进行 HTTP 基本认证时，你需要使用声网提供的客户 ID 和客户密钥生成一个 Base64 算法编码的凭证，并填入 HTTP 请求头部的 `Authorization` 字段中。

参考以下步骤获取客户 ID 和客户密钥：

1. 在[声网控制台](https://console.shengwang.cn/)左侧菜单点击**设置** > **RESTful API**，进入 RESTful API 页面。
2. 在 RESTful API 页面，点击**添加密钥**按钮，就会生成一组客户 ID 和客户密钥。
3. 在对应的客户密钥栏点击**下载**按钮。仔细阅读弹窗提示后，点击**下载**。请妥善保管下载的 `key_and_secret.txt` 文件，其中 `key` 为客户 ID，`secret` 为客户密钥。

:::info[信息]
客户 ID 和客户密钥仅用于访问 RESTful API。客户密钥只能下载一次，下载后将不在控制台保存，请妥善保管。
:::

## 开通云端录制服务 [#开通云端录制服务]

第一次使用云端录制，需要在声网控制台开通服务，步骤如下：

1. 登录[控制台](https://console.shengwang.cn/)，在左上角下拉列表中切换至需要开通云端录制服务的项目。

2. 点击左侧导航栏的**全部产品**，点击**媒体服务**，找到**云端录制**。

![云端录制服务入口示意图](https://web-cdn.agora.io/docs-portal/img/cloud-recording/enable-1.png)

3. 在**云端录制**页面切换到**功能配置**子页面。点击**云端录制**标签页下，勾选**状态**开关，点击**启用**。

<DocsImage alt="功能配置页面示意图" src="https://web-cdn.agora.io/docs-portal/img/cloud-recording/enable-2.png" displayWidth="40%" />

开通成功后你可以点击**前往查看**按钮看到云端录制的使用情况。

<DocsImage alt="云端录制使用情况页面示意图" src="https://web-cdn.agora.io/docs-portal/img/cloud-recording/enable-3.png" displayWidth="40%" />
