开通服务
本文介绍如何在声网控制台开通灵动课堂服务。
登录声网控制台
如果你是第一次使用声网服务,点击注册账号前往进行注册。注册成功后会自动登录。
如果你已经拥有声网账号,可以直接登录控制台。
注册和登录过程中如果遇到疑问,可以查看快速开始。
创建声网项目
成功登录控制台后,按照以下步骤创建一个声网项目:
- 展开控制台左上角下拉框,点击创建项目按钮。
- 在弹出的对话框内,依次选择项目类型,输入项目名称,选择场景标签和鉴权机制。其中鉴权机制推荐选择安全模式,调试模式的安全性较低。
获取 App ID
成功创建项目后,声网会给每个项目自动分配一个 作为项目唯一标识。你可以直接在总览页面的项目信息栏,点击 App ID 右侧的复制按钮来获取当前项目的 App ID。
你需要保存好复制的 App ID,后续调用 API 进行初始化等操作时需要传入你获取的 App ID。
获取 App 证书
创建好项目后,你可以参考如下步骤获取项目的 。
在声网控制台总览页面的项目信息栏,点击主要证书/次要证书下面的复制图标,即可获取项目的主次 App 证书。
生成临时 Token
对于机制为安全模式的项目,在后续调用 API 进行加入频道等操作时,你还需要传入频道名和 来对用户进行鉴权。
为方便体验和测试,在 App 调试阶段你可以先从控制台获取临时 Token(有效期为 24 小时),无需自行部署 Token 服务器。但在 App 正式上线前,你必须在自己的服务端部署并生成 Token。
在控制台左上角的下拉框,切换到你想要获取临时 Token 的项目,然后按如下步骤获取临时 Token:
- 在总览页面的项目信息栏,点击临时 Token 生成器。
- 在生成临时 Token 页面,点击添加产品。
- 选择灵动课堂产品,输入用户 ID 和房间 ID,例如
user1
和room1
,再选择用户角色,例如教师。然后保存好输入的内容。 - 点击确认。
- 成功生成临时 Token 后,点击 Token 右侧的复制按钮,保存好复制的 Token。
获取客户 ID 和客户密钥
声网 RESTful API 使用 HTTP 基本认证进行鉴权。进行 HTTP 基本认证时,你需要使用声网提供的生成一个 Base64 算法编码的凭证,并填入 HTTP 请求头部的 Authorization
字段中。
参考以下步骤获取客户 ID 和客户密钥:
- 在声网控制台点击右上角账户名,在下拉菜单中点击 RESTful API,进入 RESTful API 页面。
- 在 RESTful API 页面,点击添加密钥按钮,就会生成一组客户 ID 和客户密钥。
- 在对应的客户密钥栏点击下载按钮。仔细阅读弹窗提示后,点击下载。请妥善保管下载的
key_and_secret.txt
文件,其中key
为客户 ID,secret
为客户密钥。
客户 ID 和客户密钥仅用于访问 RESTful API。客户密钥只能下载一次,下载后将不在控制台保存,请妥善保管。
开通灵动课堂服务
按照以下步骤,在声网控制台开通灵动课堂服务:
-
登录声网控制台,点击左侧导航栏的全部产品,选择灵动课堂,进入灵动课堂页面。
-
在灵动课堂页面,切换到功能配置页签,点击下方的开启按钮。
点击后,控制台会自动发出弹窗,提示启用灵动课堂后会开启的拓展能力。点击启用。
-
成功开通灵动课堂服务后,状态会变为已启用。
如果要在灵动课堂中使用互动白板、实时录制和实时消息功能,必须对配置白板、实时消息、实时录制相关模块的存储和权限进行配置,否则无法使用。