本文重点说明智能体场景下的接入判断、平台集成入口、licenseKey 鉴权方式，以及 Android 定制版本的使用边界。更细的 SDK 集成步骤、环境准备和 API 使用方式，请参考对应平台的 NERTC 在线集成开发文档。

适用范围

如果您希望在 App、Web 或桌面端应用中接入智能体的实时语音或音视频互动，推荐优先使用 音视频通话 NERTC SDK。这一路线适用于客户端加入 RTC 房间、与智能体在房间内完成实时互动，并由业务服务端配合开启实时对话 AI 任务的场景。

以下内容不在本文展开：

• 各端完整 API Reference。
• Android、iOS、Web 和桌面端的逐步接入教程。
• 嵌入式 NERTC SDK 的设备激活、绑定和量产流程。
• AI 数字人专题能力、场景化业务示例和最佳实践说明。

方案概览

在智能体场景下，音视频通话 NERTC SDK 负责客户端侧的实时音视频能力，包括 SDK 初始化、加入房间、发布音频流、接收智能体音频流，以及字幕、打断和状态回调等能力；智能体平台和业务服务端则负责创建实时对话任务、驱动智能体入房，并完成后续的 AI 处理链路。

典型流程如下：

text客户端初始化 SDK
-> 客户端加入 RTC 房间
-> 发布音频流
-> 业务服务端开启实时对话 AI
-> AI 智能体加入房间
-> 处理字幕、打断、状态和退出

适用场景

如果您的目标是在现有客户端应用中接入智能体实时对话，而不是处理设备侧激活绑定或嵌入式接入，那么 音视频通话 NERTC SDK 通常是更合适的入口。反之，请参考 嵌入式 SDK 接入。

关键概念

概念	说明
RTC 房间名	客户端和 AI 智能体共同加入的实时互动房间。
RTC 用户 ID	RTC 房间内的用户标识，不等同于业务用户 ID。
RTC Token	加入 RTC 房间时使用的鉴权凭证。
智能体 ID	在网易云信智能体平台创建的智能体标识。
licenseKey	智能体平台 License 鉴权场景下追加的 SDK 初始化参数，与 appkey 同级。
deviceId	Android 定制版本中可选的设备标识参数，用于联调特定智能体场景下的鉴权与互通链路。

接入前准备

在智能体场景下使用 音视频通话 NERTC SDK 前，请先完成以下准备：

1. 在网易云信控制台创建应用并获取 appkey。
2. 在智能体平台完成智能体创建与基础配置。
3. 准备加入 RTC 房间所需的 token、房间名和用户标识。
4. 如需对齐智能体平台 License 鉴权，准备对应的 licenseKey。
5. 根据目标平台选择对应的 NERTC 在线集成开发文档，先完成基础 SDK 集成。

平台开发集成入口

如需查看各平台更完整的环境要求、初始化方式、进房流程和 API 使用说明，请参考以下在线集成开发文档：

平台	在线集成开发入口	说明
Android	Android 集成开发文档	用于补充 Android SDK 集成、初始化和进房接入说明。
iOS	iOS 集成开发文档	用于补充 iOS SDK 集成、初始化和房间接入说明。
Web	Web 集成开发文档	用于补充 Web SDK 集成、浏览器环境要求和事件使用方式。
Windows	Windows 集成开发文档	用于补充 Windows 桌面端集成步骤。
macOS	macOS 集成开发文档	用于补充 macOS 桌面端集成步骤。
Linux	Linux 集成开发文档	用于补充 Linux 桌面端集成步骤。
HarmonyOS	HarmonyOS 集成开发文档	用于补充 HarmonyOS 平台集成说明。

SDK 版本说明

通用说明

本文仅说明智能体场景下需要特别关注的版本差异，不替代各平台正式发布说明。除本文明确列出的差异外，各平台基础集成能力、环境依赖和 API 调用方式，请以对应平台的在线集成开发文档和发布说明为准。

Android 5.8.1509 定制版本说明

Android 智能体场景存在一个需要特别说明的版本边界：如需使用 licenseKey 鉴权并配合 AI 互通能力，请使用支持该能力的 Android 5.8.1509 定制版本。

该版本补充了智能体场景下的关键接入能力：

• 支持在 SDK 初始化阶段传入 licenseKey。
• 支持可选的 deviceId 参数，用于需要固定设备标识的联调场景。
• 未主动设置 deviceId 时，可由 SDK 自动生成并持久化设备标识。

建议对外统一采用以下口径：

• Android 智能体场景如需使用 licenseKey 鉴权和 AI 互通，请确认使用支持该能力的 5.8.1509 定制版本。
• 初始化时除 appkey 外，还需按场景补充 licenseKey；如联调方案要求固定设备标识，再结合 deviceId 使用。

兼容性说明

• 未传 licenseKey 时，应保持原有 RTC SDK 行为不变。
• licenseKey 不替代 appkey、token 或既有 RTC 鉴权规则。
• licenseKey 作为智能体场景下的额外能力授权参数，不改变 RTC 基础接入路径。
• 除 Android 5.8.1509 定制版本外，其他平台如涉及 licenseKey 鉴权，请以对应平台交付版本和发布说明为准。

licenseKey 鉴权说明

适用场景

当业务场景需要与智能体平台的 License 鉴权能力对齐时，需要在 SDK 接入中额外关注 licenseKey。如果当前场景只使用 RTC 基础能力，且不涉及智能体平台 License，则通常可以沿用原有初始化方式。

参数关系

参数	作用	说明
appkey	RTC SDK 初始化标识	基础必需参数。
token	RTC 房间接入鉴权	用于进房鉴权。
licenseKey	智能体 License 鉴权	智能体场景下按需补充，与 appkey 同级。

licenseKey 不是 appkey 的替代项，也不是 token 的替代项，而是在需要与智能体平台 License 鉴权对齐时新增的一层能力授权信息。

接入口径

对外接入说明建议统一为以下口径：

• licenseKey 作为 SDK 初始化参数传入。
• 未传、传空或为空字符串时，应保持既有行为不变。
• 客户端负责透传 licenseKey，不在客户端实现独立的本地 License 解析或验签逻辑。

Web 端说明

Web 端当前可按与其他已确认平台一致的参数层级补充 licenseKey。在需要智能体 License 鉴权的场景下，将 licenseKey 作为与 appkey 同级的初始化参数传入；未传 licenseKey 时，应保持现有初始化和进房流程不变。具体实现和对外交付口径，请以 Web 端版本说明和研发确认结果为准。

平台差异说明

智能体场景下，各平台建议重点关注以下内容：

平台	重点关注内容
Android	5.8.1509 定制版本、licenseKey 鉴权、AI 互通能力边界，以及 deviceId 的使用场景。
iOS	智能体场景接入入口，以及涉及 licenseKey 时所使用的具体交付版本。
Web	licenseKey 初始化参数口径、浏览器环境要求，以及当前已确认的 Web 端接入方式。
Windows / macOS / Linux	智能体场景接入入口；如涉及 licenseKey，请以对应平台交付版本和发布说明为准。
HarmonyOS	智能体场景接入入口；如涉及 licenseKey，请以对应平台交付版本和发布说明为准。

推荐阅读顺序

如果您正在规划智能体场景接入，建议按以下顺序阅读：

1. 先阅读本文，判断是否适合使用 音视频通话 NERTC SDK，并确认是否需要 licenseKey。
2. 再阅读对应平台的 NERTC 在线集成开发文档，完成基础 SDK 集成。
3. 如涉及 Web 浏览器兼容、Android 定制版本联调或智能体专题能力，再结合对应专题文档继续阅读。