VENDOR REFERENCE

DuDuTalk 参考适配器

过渡期接入

借用设备与云能力，不交出设备主权。

参考 SG401、开放服务 v2.1 与本地实测记录。这里只保留可用于适配的事实，不复制任何凭据。
REFERENCE ADAPTER
鉴权

appId、timestamp、sign 换取 24 小时 accessToken。时间戳窗口只有 10 秒。

摄取

v0.2.2 已实现设备与录音元数据分页拉取；回调暂不作为可信入口。

限制

分页上限 100，录音查询单次不超过 31 天，开始与停止接口最长 32 秒。

字段归一化

供应商字段止于适配层。

deviceNoprovider_device_ref
remainPowerhealth.battery
remainStorageSizehealth.storageFreeMb
pendingFileNumhealth.pendingUploads
rssihealth.signal
firmwareVersionfirmware_version
已实现的归一化函数
normalizeDuduTalkDevice({
  deviceNo: "SSYG•••1790",
  onlineStatus: 1,
  remainPower: 86,
  remainStorageSize: 1480,
  pendingFileNum: 2,
  rssi: 22
})
实测偏差

适配代码必须容忍文档与真实返回不一致。

orderNo 可能为空

不能依赖它做录音归并键，应从 fileName 解析或使用自己的窗口 ID。

endMark 不是封口信号

endMark 为 1 时 fileUrl 仍可能为空，媒体就绪必须额外判断。

在线状态是三值

0 离线、1 在线、3 关机。平台一期把 0 与 3 归入离线。

开放接口文件地址风险

实测地址可能长期公开且可推导。内测可知情使用，真实客户前应要求短时签名链接。

推荐摄取

回调是提醒，不是最终数据。

1接收 AUDIO_INFORM
2幂等写入事件
3静默窗口与对账
4提交媒体合并
5转存自有对象存储
6发布 media.ready