新手必看 - IM 即时通讯 UIKit

新手必看

更新时间： 2024/09/14 11:33:17

简介

网易云信 IM 服务基于网易二十余年的 IM 技术积累，致力于打造最稳定的即时通讯平台。 IM 服务提供了一整套即时通讯基础能力，通过该平台服务就可以将即时通讯、实时网络能力快速集成至企业自身应用中。

IM UIKit 是基于 NIM SDK（网易云信 IM SDK）开发的一款即时通讯 UI 组件库，包括聊天、会话、圈组、搜索、群管理等组件。UIKit 简化了基于 NIM SDK 的应用开发过程。它不仅能助您快速实现 UI 功能，也支持调用 NIM SDK 相应的接口实现即时通讯业务逻辑和数据处理。因此，您在使用 IM UIKit 时仅需关注自身业务或个性化扩展。

初次接触网易云信 IM UIKit 服务，您可以通过以下产品介绍文档了解我们的产品介绍和功能：

架构介绍

接入步骤

以下流程主要是如何接入云信 IM 国内单元，并下载对应的 SDK 进行开发集成。

若用户有明确的出海业务场景，需要先接入海外单元，再进行对应的开发集成。具体的海外接入流程，请参考海外数据中心。

1. 创建云信账号

如果您还没有网易云信账号，请访问注册。

如果您已经有网易云信账号，请直接登录。

2. 创建应用并获取 App Key

创建应用是体验或使用网易云信各款产品和服务的首要前提，您可以参考创建应用文档在网易云信控制台创建一个应用，并查看该应用的 App Key。

3. 开通 IM 套餐包

云信 IM 套餐包支持 Android、iOS、Web、电脑桌面等主流平台，提供单聊、群聊、文字、图片、语音、视频、地理位置等消息类型，同时支持自定义消息，满足常见的个性化需求。

云信 IM 产品分为免费版和套餐包。免费版账号数上限为 100 个，套餐包没有限制。使用云信 IM 套餐包功能前，您需要在网易云信控制台开通 IM 套餐包服务。操作步骤如下：

在控制台首页 应用管理 列表下，选择一款应用，进入 应用配置 页面。
单击 IM 即时通讯 下的 免费试用 或 正式开通。

免费试用

如需免费试用 IM 套餐包，则在 免费试用 界面指定 IM 节点的服务区域为国内或海外（适用有出海及国际化业务场景），并单击 立即试用。

免费试用期限为 14 个自然日，试用结束后默认当前应用为 IM 即时通讯免费版，您将无法使用 IM 套餐包支持的功能。
试用结束后，您可以单击 套餐升级 将免费版升级为套餐包，具体开通步骤请参考第 3 步。

正式开通

单击 IM 即时通讯 下的 正式开通。
在 套餐对比 界面指定 IM 节点的服务区域为国内。
仔细查看套餐详情，并单击您适用的产品套餐。
鼠标继续下滑，按应用的实际需求配置服务。
按照控制台会生成的预估费用，设置不少于预估费用的 充值金额。

关于具体的计费策略，请参考计费方式或咨询您的云信商务经理。
勾选协议条款，并单击 提交订单。
单击 立即支付 完成订单支付。

请确保账号余额中有足够的金额开通服务。
开通完成后基本信息页面 IM 即时通讯套餐包状态为 已开通，您可以单击 功能配置 继续开通和配置具体功能。

4. 注册 IM 账号

网易云信 IM 账号是云信 IM 系统中用户的唯一身份标识，通过 IM 账号在应用中使用各种 IM 服务。

开发者将自身应用与云信 IM 对接时，需要注册 IM 账号与自身应用中的账号相对应。您可以根据业务需要注册多个云信 IM 账号来构成应用的账户体系。

注册方式

注册云信 IM 账号可以根据场景分成两种方式：

如果您有具体的业务需求，那么可以通过服务端接口注册 IM 账号，具体请参考注册云信 IM 账号。
如果您只需要进行简单的体验或者快速测试，那么可以在云信控制台创建账号，具体请参见下文。

IM 分为免费版和正式版。免费版账号数上限为100个，正式版没有限制。
为了保护业务账户的隐私和安全，需要区分测试账户和业务账户，所以通过服务端接口注册的账号不会出现在云信控制台的账号列表中。
通过服务端接口注册账户成功后，云信将返回 accid 与 token ，请在应用服务器上维护 accid 与 token 信息列表。

控制台配置

在控制台首页 应用管理 列表下，选择一款应用，进入 应用配置 页面。
单击 IM 即时通讯套餐包 下的 功能配置 按钮，进入 IM 即时通讯配置页。
在顶部选择 基础功能 页签，单击 测试账号管理 下的 子功能配置。
单击 新建账号，在弹窗填写账号、昵称、密码后，单击确定。

在云信控制台创建的 IM 账号信息，与服务端 OpenAPI 账号信息字段的映射关系如下：
- 账号：account_id
- 密码：token
- 昵称：name
（可选）对于创建好的测试账号，您可以在控制台修改昵称，重置密码，以及禁用操作。