声光报警器的平台对接分两段：设备把报警上报，平台把指令下发。TTS 语音下发属于后者。对接能否顺利，取决于三件事——传输通道是否通、字段定义是否对齐、异常情况怎么处理。本页说明对接需要确认的信息项与联调顺序；具体报文格式、字段名与接口地址以对应型号的协议文档为准。
两段式对接：上报与下发
| 方向 | 内容 | 触发时机 | 对时效的要求 |
|---|---|---|---|
| 设备 → 平台 （上报） | 报警事件、设备状态、心跳 | 报警触发、状态变化、周期心跳 | 报警事件需优先，心跳可容忍延迟 |
| 平台 → 设备 （下发） | 报警指令、语音文本、参数配置 | 人工操作或平台规则触发 | 依赖网络往返，需允许失败重试 |
两段的失败影响不同：上报失败意味着平台看不到事件，但现场声光照常动作；下发失败意味着指令没到达设备，需要重试或改由现场操作。
上报内容的字段类别
不同型号的报文结构不同，但需要承载的信息类别基本一致。对接时按类别逐项核对，比直接比对字段名更不容易漏：
| 类别 | 作用 | 缺失后果 |
|---|---|---|
| 设备标识 | 区分是哪一台设备报警 | 无法定位现场位置 |
| 时间戳 | 记录报警发生的准确时间 | 事后追溯出现偏差 |
| 事件类型 | 区分报警、故障、恢复、心跳 | 平台把故障当成报警或反之 |
| 防区或位置 | 对应到具体区域 | 只知道「有报警」，不知道在哪 |
| 设备状态 | 电量、在线状态、信号强度 | 无法提前发现失联设备 |
指令下发的顺序
鉴权
平台按约定方式携带凭证，设备或服务端校验通过后才接受后续指令。鉴权失败应返回明确原因，便于排查。
下发
平台发送指令内容，包含目标设备、指令类型与参数。广播与单播需要区分，避免误发给全部设备。
执行与回执
设备执行后返回结果，平台据此更新状态。没有回执的指令应视为未确认，需要重试或人工介入。
异常处理
设备离线、指令超时、参数非法等情况需要有明确处理策略，而不是静默丢弃。
TTS 语音下发是什么
TTS（Text To Speech，文本转语音）指平台把一段文本交给设备，由设备在本地合成语音并播出。
它与另外两种常见方式不同，需要在方案阶段区分清楚：
| 方式 | 平台下发的内容 | 内容能否自由编辑 |
|---|---|---|
| 固定提示音 | 指令码 | 不能，内容出厂固定 |
| 预置语音 | 语音编号 | 只能在预置条目中选择 |
| TTS 语音 | 文本字符串 | 可以，改文本即改内容 |
TTS 的价值在于内容可随时调整，不需要重新烧录或更换设备。适用于提示语随场景变化的场合，例如提示某区域人员沿指定路线转移。
TTS 不是实时对讲。它是单向播报，不构成通话；也不等同于录音上传播放，后者下发的是音频文件而非文本。这两点在客户沟通中容易混淆，需要提前说明。
TTS 对接需要确认的六件事
- 文本编码与长度上限。中文、英文、数字混排时按什么编码传输，单次可下发多少字符，超长时是截断还是拒绝。
- 语种与音色支持。设备端支持哪些语种，是否可切换音色与语速。多语种项目要提前确认，不能默认支持。
- 播报优先级与打断规则。新语音到达时，正在播报的内容是否被打断；报警声与语音同时触发时谁优先。
- 重复次数与间隔。一条语音播报几遍、间隔多久，是否可配置。
- 与声光动作的关系。语音播报时声光是否同时动作，还是各自独立控制。
- 失败处理与回执。设备离线时语音如何处理，是否有队列与重试，平台能否得知播报成功。
以上六项的具体取值取决于设备型号与固件版本，请以对应型号的协议文档为准。本页不列出未经验证的字段名与报文示例，避免照抄后联调失败。
联调建议顺序
先通链路
确认设备能上线、心跳正常，平台能看到设备在线状态。这一步不通，后面的都不用做。
再验上报
手动触发一次报警，核对平台收到的设备标识、时间、事件类型、防区是否与现场一致。
验证下发
下发一条不改变现场状态的指令（如参数读取），确认往返通路正常。
再调 TTS
下发一条短文本，在现场确认播出内容、音量与清晰度，再逐步加长、加复杂。
测异常
断网、断电、设备离线各测一次，确认平台提示与恢复后的状态同步符合预期。
索取协议文档
协议文档按型号提供，包含传输方式、报文结构、字段定义、错误码与示例。索取时请说明平台侧的技术栈与对接方式（直连设备 / 经我方平台转发 / 经网关转换），便于提供对应的文档版本。
可通过联系我们提交对接需求，或致电 16710807777。