开通语聊房 UIKit 相关服务

更新时间不可用

了解如何在声网控制台开通语聊房,并获取接入所需的项目配置、凭据和服务权限。

通过含 UI 集成方案搭建语聊房时,你需要创建声网项目、开通实时消息(RTM)、消息通知(NCS)、即时通讯、环信 IM 等服务。本文介绍如何在声网控制台开通服务并获取相关的信息。

登录声网控制台

如果你是第一次使用声网服务,点击注册账号前往控制台进行注册。注册成功后会自动登录。

如果你已经拥有声网账号,可以直接登录控制台。

信息

注册和登录过程中如果遇到疑问,可以查看快速开始。

创建声网项目

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

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

获取 App ID

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

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

获取 App 证书

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

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

开通实时消息服务

按照以下步骤为该项目开通实时消息服务:

  1. 点击左侧导航栏的全部产品,点击基础能力分组下的实时消息 RTM。

  2. 在实时消息 RTM 页面,切换到功能配置子页面。勾选状态开关,设置你所需的服务区域,点击启用。

    服务区域设置一旦启用,后续将不允许修改。服务区域设置会影响你应用中的状态数据(User State)和属性数据(Channel Metadata 和 User Metadata)的存储区域。

  3. 启用 RTM 服务后,在状态同步(Storage)配置和分布式锁(Lock)配置中勾选启用按钮,并点击确认。

获取客户 ID 和客户密钥

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

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

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

信息

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

开通即时通讯服务

联系 sales@shengwang.cn 开通声网即时通讯(IM)服务。语聊 UIKit 前端依赖该服务。

开通环信 IM 服务

在环信控制台开通配置,详见开通配置环信即时通讯 IM 服务。语聊 UIKit 后端依赖该服务。