设备适配性检查
注意:
当您确认使用腾讯云 TWeTalk 后,请检查您的目标芯片和 SDK 是否满足以下要求,这对后续适配至关重要。
1. 检查设备是否可以正常联网
由于 TWeTalk 需要联网使用,所以在对接前需保证网络可以正常访问,且网速稳定在100kbps以上。默认我们使用2路 TCP 连接,需要保证 TCP Connect/Read/Write/Disconnect 等接口可用。
2. 检查设备是否支持 opus 编解码
为了节省网络带宽,我们的音频传输都使用 opus 编解码。
上行(设备->平台)音频可以将录音文件保存为 record.opus,然后导出到电脑端。通过 python 脚本 opus_decoder.py 来解码播放以此来验证编码是否正确。
下行(平台->设备)音频可以播放一个本地测试 opus 文件 recv.opus,如果设备播放的音频和 output.wav 一致,则认为解码正常。
3. 检查设备是否支持回声消除
对于需要实现流畅的自然语言对话的场景,需要滤除录音数据中混杂的喇叭音频,从而保证人声的干净。
如果不支持回声消除,则只能实现单双工模式,即喇叭播放的时候,关闭录音采集。录音的时候,关闭喇叭播放。
4. 检查设备容量
检查设备是否有100KBytesRAM,200KBytes Flash 用于 TWeTalk SDK 的运行(此值为估算值,可执行程序的实际大小会受工具链优化、芯片架构等因素影响有所波动,建议至少150KB以上)
RAM(SRAM、PSRAM、DRAM 等)是否有80KB及以上的内存、20KB及以上的任务栈内存供腾讯 TWeTalk SDK 使用。
TWeTalk SDK 接入
TWeTalk 的接入需要关注以下几个方面:
1. TWeTalk 初始化依赖 IoT Explorer 的初始化,所以必须要等 IoT Explorer 初始化完成后,再初始化 TWeTalk。
2. TWeTalk 初始化完成后,会注册一个音频接收的回调函数,在此回调函数里,可以取出音频用于播放。
3. TWeTalk 初始化完成后,会注册一个事件接收回调函数,在此回调函数里,可以处理您关注的事件,如字幕回显、开始讲话、停止讲话、来电等。
4. 对于设备的本地录音数据,有一个专用的 API 用于推送音频。
IoT Explorer 接入
1. 设备配网
对于单 Wi-Fi 设备,我们支持 SoftAP 方式配网。
对于 Wi-Fi BLE Combo 设备,我们支持标准蓝牙辅助配网。
2. 物模型
物模型支持属性、事件、行为等操作,涵盖一款设备需要网络信息交换的全流程。
借助物模型,TWeTalk 可以无缝使用物模型来做设备控制。例如直接语音交互:音量调整为30、声音大一点、当前房间的温度怎么样。
3. OTA
可以很方便的借助物联网开发平台来实现设备固件的持续迭代优化。
获取 SDK
我们在 GitHub 上提供了完整的开源示例工程,该工程已内置了最新版本的设备端 SDK,此 SDK 会定期更新以支持新特性,您可以直接下载源码进行编译和烧录。
如果您有其他平台的需求,请联系商务进行需求对接。
创建产品
1. 注册腾讯云账号并登录腾讯云物联网开发平台 控制台。如果是第一次登录,会默认有一个公共实例。

2. 进入公共实例的产品页面,单击新建产品,选择对应的产品类型和规格完成创建。具体操作可参见 创建产品。
说明:
请注意您所购买的音视频激活码规格,选择对应的规格进行产品创建。如果您需要使用 TWeTalk 基础版或高级版,请购买音频激活码或音视频激活码;如果您需要使用 TWeTalk 多模态版本,请购买音视频激活码。

3. 进入设备页面,新建一个设备,并获取到设备的三元组:产品ID,设备名称,设备密钥。具体操作可参见 创建设备。

申请测试 SDK
如果您未购买音视频激活码,则无法使用 TWeTalk 服务。我们为首次接入的客户提供有限的免费测试资源,如果您有接入测试需求,请联系商务为您申请测试激活码。