快速上手
没有开发板，如何体验设备实时音视频？
用一台电脑模拟设备，完成绑定、实时画面与音频验证，再决定下一步硬件接入。
先回答：可以，从设备模拟器开始
你不需要先购买开发板，也不需要在首次体验时自行部署服务器。小钛服务端示例提供 Python 设备模拟器，可以连接官方 H5 演示平台，验证设备绑定与实时音视频链路。模拟器推送的是测试媒体，不代表真实摄像头和麦克风已经接入。
开始前，准备这些条件
在一台可联网的电脑上，按对应系统的说明配置并运行设备模拟器即可开始体验。仓库首页提供 Ubuntu/Debian x86_64 的步骤；Windows x86_64 和 Apple Silicon macOS 请使用仓库中的各平台启动说明。其他架构需要先确认 SDK 是否匹配。
01 · 启动模拟器
打开文末的“查看主要参考文档”，按对应系统安装 Python 环境和项目依赖，再启动设备模拟器。首次体验可以使用仓库随附的测试音视频文件，不必先接入真实硬件。具体命令以仓库当前版本为准。
02 · 绑定到体验平台
保持模拟器运行，找到终端输出的六位验证码。打开 xiaotai.chat，注册并登录账号，在设备页面输入验证码完成绑定。验证码过期时，按仓库说明重新启动绑定流程。
03 · 打开实时画面
绑定成功后，在 H5 设备列表中打开对应设备，检查是否能看到测试画面并听到音频。如果没有验证码，先检查 SDK、依赖和测试文件；如果已绑定但没有媒体，应分别排查连接状态与媒体发送日志。
这次验证能说明什么？
它可以帮助你熟悉设备上线、绑定和实时媒体传输流程。它不能替代真实硬件的采集、播放、回声处理、弱网和长时间运行测试，也不构成量产性能承诺。
默认文件模式与电脑麦克风模式有什么区别？
当前 Python 模拟器默认读取仓库随附的测试音视频，不会自动使用电脑摄像头、麦克风或扬声器。因此，网页能看到测试片源，并不意味着电脑摄像头已经接入；网页向模拟器发送声音，也不能仅凭电脑扬声器是否出声来判断传输成功。默认接收到的媒体可在 received/<device_id>/ 目录检查。
Windows 可以按文档安装可选依赖，再用 --with-mic 启用麦克风和扬声器，用 --with-camera 启用摄像头。硬件音频模式还有格式限制，应按该模式的当前说明配置上下行。Linux 与 Apple Silicon macOS 的文件媒体路径不要直接套用 Windows 的硬件参数。
选择系统后，怎样完成第一次启动？
当前文档覆盖 Windows 10/11 x64、Ubuntu x64 和 Apple Silicon macOS，使用 CPython 3.10–3.14。先安装 Git 与适用的 Python，取得仓库后进入 thing-connect/device-sim/device-sim-py，创建独立的虚拟环境，安装 requirements.txt，再运行 device_sim_main.py。仓库当前随附 SDK 2.5.0 与默认素材；这是本次核对的版本，不是对未来版本的固定要求。
Windows：在 PowerShell 按 Windows 小节操作；首次安装 Python 后重新打开终端。Ubuntu：先确认 python3 与 python3-venv 可用。macOS：先确认使用 Apple 芯片及匹配的运行环境。三种系统的命令不要交叉复制；详细可复制命令见下方文档。
用四个结果判断是否跑通
一：终端显示绑定码，说明程序已经走到设备绑定步骤。二：绑定后设备出现在平台并在线。三：打开实时查看，看到持续变化的测试画面并听到上行声音。四：测试反向语音时，按文件模式检查接收结果，或在已配置的 Windows 硬件模式检查扬声器播放。不要把“在线”直接当成音视频全部通过。
跑不通时，先看这些具体位置
找不到 Python：检查安装版本、命令名称和终端是否重新打开。安装依赖失败：保留第一条错误，区分网络下载失败与平台或版本不匹配。找不到 SDK：核对系统架构与仓库中的 SDK 目录。设备下线：检查模拟器窗口是否关闭或进程是否退出。看得到片源但电脑不出声：先确认是否仍在默认文件模式，再查播放配置。
下一步：从模拟器走向真实设备
完成首次体验后，再确认目标硬件与 SDK，接入摄像头、麦克风和扬声器，并逐项验证业务功能。需要接入自有系统时，再评估服务部署、鉴权、设备管理与业务接口。
如果希望继续体验设备实时音视频，可选择适配的开发板，按固件指南烧录、配网并绑定到体验平台。这条路径没有要求先领取开发者控制台 ID。准备为自己的产品接入实时音视频时，再使用开发者控制台与 SDK 文档；注册赠送的 10 个 ID 包含免费 Ti RTC 基础流量，其他服务按量付费。
资料核对：2026 年 11 月 7 日。开源体验步骤请以文末参考文档的当前版本为准。