PSDK
接口变更说明
✓ 提供该接口，— 未提供。未列出的接口 EVO Nest 与 Autel Nest2 一致。
| Method | 功能 | EVO Nest | Autel Nest2 | 说明 |
|---|---|---|---|---|
psdk_light_open | 探照灯-打开 | — | ✓ | EVO Nest 文档未收录，仅有 psdk_light_close |
speaker_replay | 喊话器-重新播放 | — | ✓ |
喊话器-音频播放进度通知
Topic: thing/product/{gateway_sn}/events
Direction: up
Method: speaker_audio_play_start_progress
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 0是成功，非0为异常，异常详细情况：见错误码 | 返回码，0为成功 |
| output | 输出 | struct | 服务执行的输出结果 | |
| »psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| »status | 当前所处阶段 | enum_string | {"in_progress":"处理中","ok":"播放成功","canceled":"已取消"} | 当前播放阶段 |
| »md5 | 文件内容的md5校验和, 用作机巢唯一标识 | text | 文件MD5校验和 | |
| »progress | 进度 | struct | 播放进度信息 | |
| »»percent | 进度百分比 | int | {"max":"100","min":"0","step":"1","unit_name":"百分比 / %"} | 当前进度百分比 |
| »»step_key | 当前步骤 | enum_string | {"download":"从云端下载音频文件到机巢","encoding":"编码为 opus","upload":"机巢上传音频到psdk","play":"开始播放"} | 当前执行步骤标识 |
喊话器-tts播放进度通知
Topic: thing/product/{gateway_sn}/events
Direction: up
Method: speaker_tts_play_start_progress
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 0是成功，非0为异常，异常详细情况：见错误码 | 返回码，0为成功 |
| output | 输出 | struct | 服务执行的输出结果 | |
| »psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| »status | 当前所处阶段 | enum_string | {"in_progress":"处理中","ok":"播放成功","canceled":"已取消"} | 当前播放阶段 |
| »md5 | 文件内容的md5校验和, 用作机巢唯一标识 | text | 文件MD5校验和 | |
| »progress | 进度 | struct | 播放进度信息 | |
| »»percent | 进度百分比 | int | {"max":"100","min":"0","step":"1","unit_name":"百分比 / %"} | 当前进度百分比 |
| »»step_key | 当前步骤 | enum_string | {"change_work_mode":"切换工作模式","upload":"机巢上传文本到psdk","play":"开始播放"} | 当前执行步骤标识 |
services
psdk-设置控件值
当前固件暂未支持。
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_widget_value_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | PSDK负载设备索引 | |
| index | 控件编号 | int | 控件编号 | |
| value | 控件值 | int | 控件值 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_widget_value_set
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
喊话器-开始播放音频
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: speaker_audio_play_start
Data
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| file | 音频文件 | struct | 音频文件信息 | |
| »name | 文件名 | text | 音频文件名称 | |
| »url | 文件下载链接 | text | 音频文件下载地址 | |
| »md5 | 音频文件的md5校验和, 用作机巢唯一标识 | text | 音频文件MD5校验和 | |
| »format | 喊话器输入文件格式 | enum_string | {"opus":"opus 格式","mp3":"mp3 格式","wav":"wav 格式","flac":"flac 格式","aac":"aac 格式","m4a":"m4a 格式","wma":"wma 格式"} | 音频文件格式 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: speaker_audio_play_start
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
喊话器-开始播放TTS文本
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: speaker_tts_play_start
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| tts | tts 文本 | struct | TTS文本信息 | |
| »name | 文件名 | text | TTS文件名称，可选 | |
| »text | 文本内容 | text | 播报文本内容，必填 | |
| »md5 | 文件内容的md5校验和, 用作机巢唯一标识 | text | 文件内容MD5校验和，可选 | |
| »speed | 播报语速 | float | {"max":2.0,"min":0.5} | 播报语速，可选，默认 1.0；超出范围时按 1.0 处理 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: speaker_tts_play_start
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
喊话器-重新播放
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: speaker_replay
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","data": {"psdk_index": 2},"method": "speaker_replay","tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","timestamp": 1689748815503}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: speaker_replay
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","data": {"result": 0},"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","timestamp": 1654070968655,"method": "speaker_replay"}
喊话器-停止播放
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: speaker_play_stop
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","data": {"psdk_index": 2},"method": "speaker_play_stop","tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","timestamp": 1689748815503}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: speaker_play_stop
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","data": {"result": 0},"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","timestamp": 1654070968655,"method": "speaker_play_stop"}
喊话器-设置播放模式
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: speaker_play_mode_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| play_mode | 喊话器播放模式 | enum_int | {"0":"单次播放","1":"循环播放(单曲)"} | 播放模式设置 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","data": {"play_mode": 1,"psdk_index": 2},"method": "speaker_play_mode_set","tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","timestamp": 1689842974113}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: speaker_play_mode_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","data": {"result": 0},"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","timestamp": 1654070968655,"method": "speaker_play_mode_set"}
喊话器-设置音量
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: speaker_play_volume_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| play_volume | 喊话器音量 | int | {"max":100,"min":0,"step":1} | 喊话器播放音量 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","data": {"play_volume": 13,"psdk_index": 2},"method": "speaker_play_volume_set","tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","timestamp": 1689842989237}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: speaker_play_volume_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
Example:
{"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","data": {"result": 0},"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx","timestamp": 1654070968655,"method": "speaker_play_volume_set"}
探照灯-打开
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_light_open
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_light_open
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
探照灯-关闭
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_light_close
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_light_close
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
探照灯-曝闪模式设置
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_set_flash_mode
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| light_flash_mode | 曝闪模式 | enum_int | {"0":"关","1":"红色灯光曝闪","2":"红蓝灯光曝闪","3":"蓝色灯光曝闪"} | 探照灯曝闪模式 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_set_flash_mode
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
探照灯-设置亮度
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_light_set_brightness
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| light_brightness | 灯光亮度 | enum_int | {"1":"一档 33","2":"二档 66","3":"三档 99"} | 探照灯亮度档位 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_light_set_brightness
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
探照灯-设置俯仰角
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_light_set_pitch_angle
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
| light_pitch_angle | 俯仰角 | int | {"max":30,"min":-90,"step":1} | 探照灯俯仰角 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_light_set_pitch_angle
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
探照灯-打开云台联动
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_open_light_ptz_linkage
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_open_light_ptz_linkage
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |
探照灯-关闭云台联动
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: psdk_close_light_ptz_linkage
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| psdk_index | psdk 负载设备索引 | int | {"min":0} | PSDK负载设备索引 |
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: psdk_close_light_ptz_linkage
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | 结果返回码 | int | 返回码，0为成功 |