开通服务

大约 4 分钟

开通服务

本文介绍如何开通即时通讯 IM 服务。

1. 登录声网控制台

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

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

提示

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

2. 开通即时通讯 IM 服务

创建项目并开通

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

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

创建项目时,默认开通即时通讯 IM 服务。

img

现有项目中开通

展开控制台左上角下拉框,选择需要开通即时通讯 IM 服务的项目,然后按照以下步骤操作:

  1. 点击左侧导航栏的全部产品

  2. 在下拉列表中找到即时通讯 IM 并点击。

  3. 即时通讯 IM 页面,进入功能配置标签页。

  4. 点击即时通讯IM服务状态对应的启用按钮。

  5. 在弹出窗口中选择数据中心。

提示

数据中心的设置将影响你应用中的数据存储区域,此设置一旦启用,后续将不允许修改。

  1. 点击启用按钮完成开通。

img

成功开通即时通讯 IM 服务后,你的项目就支持了实时聊天功能,你可以根据实际需求配置在推送证书推送模板消息功能用户状态页签下配置推送、消息和用户在线状态相关功能。

3. 获取 App ID

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

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

img

4. 获取临时 Token

对于鉴权机制为安全模式的项目,在后续调用 API 进行聊天等操作时,你还需要传入 App ID 和 Token 对用户进行鉴权。

为方便体验和测试,在 App 调试阶段你可以先从声网控制台open in new window获取临时 Token(有效期为 24 小时),无需自行部署 Token 服务器。但在 App 正式上线前,你必须在自己的服务端部署并生成 Token。

  • 临时 App Token:用于进行管理操作,例如,调用 RESTful API 删除用户和封禁用户等。
  • 临时用户 Token:用于登录即时通讯 IM 客户端进行聊天等操作,例如,跑通快速开始时进行登录,在客户端发送和接收一对一单聊文本消息。

在控制台左上角的下拉框,切换到你想要获取临时 Token 的项目,然后按如下步骤获取临时 App Token:

  1. 总览页面的项目信息栏,点击临时 Token 生成器
  2. 生成临时 Token 页面,点击添加产品
  3. 选择 即时通讯 IM 产品,设置 Token 类型,可选择 App TokenUser Token。在下图中,选择 App Token
  4. 点击确认
  5. 成功生成临时 Token 后,点击 Token 右侧的复制按钮,保存好复制的 Token。

img

此外,对于用户 token,你还可以声网控制台open in new window创建用户后,在用户列表点击对应的用户的操作一栏中的更多,选择查看Token

在弹出的对话框中,可以查看用户 Token,也可以点击重新生成,生成用户 token。

img

5. 获取 App 证书

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

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

上次编辑于: