Lierda Cat.1 NT26FxDx OpenKit TiRTC 功能演示指南

English

本文用于功能验证、客户演示和测试验收，覆盖 SET、AI、WX、DEV 和 LIVE 五项功能。编译、烧录、首次上电、设备绑定和第一次 AI 跑通，请先参考 TiRTC 快速开始指南。

适用工程：examples/NT26FxDx_OpenKit_TiRTC
适用硬件：L-CT4IT00-YP00W-01_V04、NT26F6D0、F6D_A、128×64 SSD1306 OLED、 三按键、ES8311 音频。

1. 演示前检查

  1. 设备已经烧录 NT26FxDx_OpenKit_TiRTC 固件。

  2. 设备已完成 4G 联网和网页绑定，并停留在首页。

  3. OLED、麦克风和扬声器工作正常。

  4. 记录演示设备的账号、设备名和测试联系人，避免现场临时配置。

  5. 每完成一项功能后，等待设备返回首页，再开始下一项。

AI、WX、DEV、LIVE 共用 TiRTC 连接和音频资源。设备处于拨号、通话、来电处理 或资源释放状态时，其他功能可能被拒绝或延迟。

2. SET 音频设置

2.1 功能说明

SET 是设备本机功能，用于调整扬声器音量和麦克风增益，不需要网页或通话对端。

2.2 演示准备

  • 一台已启动并进入首页的设备；

  • 已连接麦克风和扬声器。

2.3 演示步骤

  1. 首页使用 KEY0 选择 SET。

  2. 按 KEY1 进入设置页面。

  3. 使用 KEY0 在 V+、V-、M+、M- 之间循环选择。

  4. 按 KEY1 对当前选项调整一级。

  5. 按 KEY2 返回首页。

2.4 验收结果和限制

  • OLED 显示当前设置项和数值；

  • 修改立即写入运行时配置；

  • 后续 AI、WX、DEV、LIVE 会话使用新的音量和增益；

  • 重新上电后恢复默认值；

  • SET 页面不显示底层音频驱动错误，异常时需要结合串口日志。

3. AI 语音对讲

3.1 功能说明

设备通过 TiRTC 与平台绑定的 AI 智能体进行语音交互。

3.2 演示准备

  • 设备已完成网页绑定；

  • 已在平台“我的设备”中将 AI 智能体绑定到设备；

  • 设备已进入首页；

  • 麦克风和扬声器正常。

3.3 演示步骤

  1. 首页选择 AI，按 KEY1 进入。

  2. 等待 OLED 显示 LISTENING。

  3. 对着麦克风讲话。

  4. 等待 OLED 显示 AI SPEAK，确认扬声器播放 AI 回复。

  5. 回复结束后设备重新进入 LISTENING，可继续讲话。

  6. 按 KEY2 结束会话并返回首页。

3.4 验收结果和限制

  • 可以从 LISTENING 切换到 AI SPEAK；

  • 麦克风采集和扬声器播放正常；

  • AI 为半双工，播放回复时暂停麦克风采集；

  • 不支持按住说话；

  • 不支持由 AI 指令主动发起 DEV 呼叫；

  • 未绑定 AI 智能体时，通常在 GET TOKEN 阶段报错。

4. WX 微信电话

4.1 功能说明

WX 用于设备与微信小程序“探鸽小钛”用户之间的双向语音呼叫。

4.2 演示准备

  • 设备已经完成网页绑定；

  • 微信登录账号与网页平台账号相同；

  • 在“探鸽小钛”中完成设备 VoIP 授权和上报；

  • 设备没有占用 AI、DEV 或 LIVE 音频资源。

4.3 设备呼叫微信

  1. 首页选择 WX，按 KEY1 进入联系人页面。

  2. 使用 KEY0 选择联系人，按 KEY1 发起呼叫。

  3. 微信端接听，设备显示 WX TALK。

  4. 设备按 KEY2 挂断，等待设备返回首页。

4.4 微信呼叫设备

  1. 微信小程序选择目标设备并发起语音呼叫。

  2. 设备显示 INCOMING。

  3. 按 KEY1 接听，按 KEY2 拒接。

  4. 接通后设备显示 WX TALK。

  5. 设备按 KEY2 挂断。

4.5 验收结果和限制

  • 设备和微信端可以双向听到语音；

  • 最多缓存 8 个 WX 联系人；

  • 约 45 秒无人接听会自动结束；

  • 网页绑定和微信 VoIP 授权是两个独立步骤；

5. DEV 设备电话

5.1 功能说明

DEV 用于两台已绑定且在线的 TiRTC 设备之间进行双向语音呼叫。

5.2 演示准备

  • 两台相同或兼容的 TiRTC 设备；

  • 两台设备均已联网、绑定并进入首页；

  • 服务端已经向设备下发对端设备联系人；

  • 两台设备的麦克风和扬声器正常。

5.3 演示步骤

  1. 主叫设备首页选择 DEV，按 KEY1 进入设备列表。

  2. 使用 KEY0 选择被叫设备，按 KEY1 发起呼叫。

  3. 被叫设备显示来电页面，按 KEY1 接听，或按 KEY2 拒接。

  4. 通话建立后，两台设备均显示 DEV TALK。

  5. 任一设备按 KEY2 挂断，等待双方回到首页。

5.4 验收结果和限制

  • 两台设备可以双向听到语音；

  • DEV 联系人由服务端下发，设备端不能手动添加或审批；

  • 约 45 秒无人接听会自动结束；

  • 当前没有摄像头，即使收到视频类型呼叫也只验证音频。

6. LIVE 网页实时语音

6.1 功能说明

LIVE 是平台网页主动发起的远端实时语音，不是设备首页菜单。

6.2 演示准备

  • 设备已完成联网、绑定和 TiRTC runtime 初始化；

  • 设备停留在真正的首页；

  • AI、WX、DEV 均处于空闲状态；

  • 网页账号具有 LIVE 权限。

6.3 演示步骤

  1. 确认设备停留在首页，且没有其他业务正在拨号、通话或释放资源。

  2. 在平台网页中选择目标设备并发起 LIVE。

  3. 网页显示连接成功后，确认可以听到设备麦克风声音。

  4. 通过网页向设备发送语音，确认设备扬声器可以播放。

  5. 设备按 KEY1 结束 LIVE。

6.4 验收结果、安全边界和限制

  • LIVE 建立后设备继续显示原首页，没有专用 LIVE 页面或图标；

  • KEY0 只切换首页菜单，KEY2 不能挂断 LIVE；

  • 当前设备只传输音频，不发送摄像头视频；

  • 满足准入条件时，远端可能无需设备按键确认即可采集设备麦克风；

  • 网页视频区域无画面属于当前无摄像头实现的预期现象；

7. 详细状态和故障定位

本指南只覆盖演示流程。完整 OLED 状态、按键行为、错误码、超时和恢复策略， 请参考源码工程中的：

examples/NT26FxDx_OpenKit_TiRTC/tirtc/docs/当前设备操作.md

代码架构、模块职责和维护边界，请参考：

examples/NT26FxDx_OpenKit_TiRTC/tirtc/docs/代码与流程详解.md