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