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