使用 tirn_probe_device 探测工具

tirn_probe_device 用于验证设备到 WHIP Service 的建连和 Echo 音频链路。它是联调与诊断工具，不是设备量产 SDK。

源码、构建要求和完整命令说明见 tangeai/tirn-probe-device。从 TiRTC SDK 下载页获取与你的平台匹配的 SDK 后执行：

bash

git clone https://github.com/tangeai/tirn-probe-device.git
cd tirn-probe-device
./script/build.sh --sdk-dir /absolute/path/to/tirtc-sdk

构建脚本支持 macOS arm64 和 Linux x86_64 原生构建，产物位于 build/<platform>/tirn_probe_device。

开始前应准备：

已注册的设备 ID 和设备密钥；
Echo 服务的 peer_id 和有效 Token；
与运行平台匹配的 tirn_probe_device。

连接参数的获取方式见运行快速开始示例。命令中的密钥和 Token 不要写入日志。

测试音视频

media 发送内置测试音频和 JPEG 测试帧，并检查 Echo 返回的音视频：

bash

./build/linux-x86_64/tirn_probe_device media \
  --device-id your_device_id \
  --device-secret-key "$DEVICE_SECRET_KEY" \
  --peer-id "$ECHO_PEER_ID" \
  --token "$CONNECT_TOKEN" \
  --audio-output /tmp/tirn-probe-echo.pcm \
  --duration-sec 10

四项音视频收发计数均大于零时测试通过。--audio-output 可选，用于把收到的音频保存为 8 kHz、16 bit、单声道 PCM 裸数据。

测试建连

执行 20 次连接，统计成功率和连接耗时：

bash

./build/linux-x86_64/tirn_probe_device connect \
  --device-id your_device_id \
  --device-secret-key "$DEVICE_SECRET_KEY" \
  --peer-id "$ECHO_PEER_ID" \
  --token "$CONNECT_TOKEN" \
  --iterations 20 \
  --connect-timeout-ms 30000

结果包含成功次数、失败次数以及成功连接耗时的 P50、P90、P95 和 P99。出现失败时，先检查设备注册信息、Token 有效期、服务名和设备网络。

测试音频

audio 会先完成设备与服务端对时，再发送内置 440 Hz PCM 测试音频并接收 Echo 回声：

bash

./build/linux-x86_64/tirn_probe_device audio \
  --device-id your_device_id \
  --device-secret-key "$DEVICE_SECRET_KEY" \
  --peer-id "$ECHO_PEER_ID" \
  --token "$CONNECT_TOKEN" \
  --audio-iterations 3 \
  --duration-sec 30 \
  --frame-ms 40 \
  --audio-sample-log /tmp/tirn-probe-audio-samples.csv

终端输出用于确认发送、回声和对时是否成功。指定 --audio-sample-log 后，CSV 会保存逐帧原始时间数据，便于进一步排查回声率、延迟、帧间隔和卡顿。

需要使用实际语音时，可增加 --audio-input <ogg-opus-file>。需要保存收到的回声音频时，同时增加 --audio-echo-output <output.opus>。

使用 tirn_probe_device 探测工具 ​

测试音视频 ​

测试建连 ​

测试音频 ​

使用 tirn_probe_device 探测工具

测试音视频

测试建连

测试音频