Architecting Life
·
小智 AI 通信协议补漏，通过OTA接口注册设备
内容提要
文章讨论了小智AI的WebSocket通信协议，强调设备注册的重要性。未注册设备无法获取版本信息，需在启动时进行OTA版本检查和注册。注册通过POST请求发送固件信息JSON，确保Device-Id与Client-Id一致。未注册时，服务端返回激活信息，需重新建立WebSocket连接。
关键要点
-
文章讨论了小智AI的WebSocket通信协议，强调设备注册的重要性。
-
未注册设备无法获取版本信息，需在启动时进行OTA版本检查和注册。
-
注册通过POST请求发送固件信息JSON，确保Device-Id与Client-Id一致。
-
未注册时，服务端返回激活信息，需重新建立WebSocket连接。
-
如果设备未注册，服务端会返回没有找到设备版本信息的提示。
-
注册设备时需构建固件信息的JSON并发送到OTA_VERSION_URL接口。
-
发送POST请求时，header中需包含Device-Id和Client-Id。
-
服务端响应中，未注册设备会返回包含激活信息的activation字段。
-
在激活设备和控制台添加设备前，需重新建立WebSocket连接以生效。
延伸解读
设备注册的重要性
设备注册是小智AI通信协议中的关键步骤，未注册的设备无法获取版本信息，导致无法正常工作。确保在设备启动时完成注册，可以避免后续对话中出现无法找到版本信息的错误提示。
POST请求的注意事项
在发送设备注册的POST请求时，必须确保请求头中包含正确的Device-Id和Client-Id。这是确保设备能够成功注册的前提，任何不一致都可能导致注册失败，影响设备的正常使用。
WebSocket连接的影响
在激活设备和控制台添加设备之前，若已建立WebSocket连接，则添加设备的操作不会生效。用户需重新建立连接，以确保设备能够正确连接到智能体并正常工作。
延伸问答
小智AI的WebSocket通信协议中，设备注册有什么重要性？
设备注册是获取版本信息的前提，未注册设备无法进行OTA版本检查和获取相关信息。
如何通过OTA接口注册设备？
需要构建固件信息的JSON，并通过POST请求发送到OTA_VERSION_URL接口，同时在header中包含Device-Id和Client-Id。
如果设备未注册，会发生什么？
未注册设备在启动时会收到服务端返回的没有找到设备版本信息的提示，无法进行正常对话。
注册设备后，服务端的响应中会包含哪些信息？
服务端响应中会包含activation字段，包含code、message和challenge等属性，code属性尤为重要。
在激活设备和控制台添加设备前需要注意什么？
在建立WebSocket连接并开始对话后，添加设备操作不会生效，需要重新建立WebSocket连接。
设备注册时，JSON结构体需要包含哪些信息？
JSON结构体需要包含固件信息，并确保device_id与配置中的一致。
