开通服务
本文介绍如何开通实时消息 (RTM) 服务。
1. 登录声网控制台
如果你是第一次使用声网服务,点击注册账号前往进行注册。注册成功后会自动登录。
如果你已经拥有声网账号,可以直接登录控制台。
注册和登录过程中如果遇到疑问,可以查看快速开始。
2. 创建声网项目
成功登录控制台后,按照以下步骤创建一个声网项目:
- 展开控制台左上角下拉框。
- 点击创建项目按钮。
- 在弹出的对话框内,选择项目类型为通用项目,输入项目名称,选择场景标签和鉴权机制。其中鉴权机制推荐选择安全模式,调试模式的安全性较低。
- 点击创建新项目完成项目创建。
如果项目的鉴权机制为安全模式,则你需要在初始化 SDK 时填入 Token。详见获取临时 Token 和初始配置。
3. 开通 RTM 服务
展开控制台左上角下拉框,选择需要开通 RTM 服务的项目,然后按照以下步骤操作:
- 点击左侧导航栏的全部产品。
- 在下拉列表中找到实时消息 RTM 并点击。
- 在实时消息 RTM 页面,进入功能配置标签页.
- 点击状态后的开启按钮。
- 在弹出窗口中选择服务区域。
信息
服务区域设置将影响你应用中的状态数据 (User State) 和属性数据 (Channel Metadata 和 User Metadate) 存储区域,此设置一旦启用,后续将不允许修改。
- 点击启用按钮完成开通。
成功开通 RTM 服务后,你的项目就支持了 Message Channel 和 Presence 功能,你可以根据实际需求修改出席通知(Presence)配置。如需开通 Storage、Lock、Stream Channel 功能,点击对应功能配置栏下的启用按钮,然后点击确定即可。
4. 获取 App ID
成功创建项目后,声网会给每个项目自动分配一个 作为项目唯一标识。你可以直接在总览页面的项目信息栏,点击 App ID 右侧的复制按钮来获取当前项目的 App ID。
你需要保存好复制的 App ID,后续调用 API 进行初始化等操作时需要传入你获取的 App ID。
5. 获取临时 Token
对于机制为安全模式的项目,在后续调用 API 进行加入频道等操作时,你还需要传入频道名和 来对用户进行鉴权。
为方便体验和测试,在 App 调试阶段你可以先从控制台获取临时 Token(有效期为 24 小时),无需自行部署 Token 服务器。但在 App 正式上线前,你必须在自己的服务端部署并生成 Token。
在控制台左上角的下拉框,切换到你想要获取临时 Token 的项目,然后按如下步骤获取临时 Token:
- 在总览页面的项目信息栏,点击临时 Token 生成器。
- 在生成临时 Token 页面,点击添加产品。
- 选择 RTM 产品,输入用户 ID,例如
user1
。然后保存好输入的内容。 - 点击确认。
- 成功生成临时 Token 后,点击 Token 右侧的复制按钮,保存好复制的 Token。
6. 获取 App 证书
创建好项目后,你可以参考如下步骤获取项目的 。
在声网控制台总览页面的项目信息栏,点击主要证书/次要证书下面的复制图标,即可获取项目的主次 App 证书。