[{"data":1,"prerenderedAt":3331},["ShallowReactive",2],{"navigation":3,"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions":531,"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions-surround":3326},[4,119,191,255,270,283,356,412,527],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":19},"云平台","i-lucide-cloud","\u002Fcloud-platform","1.cloud-platform",[10,20,33,71,93],{"title":11,"icon":12,"path":13,"stem":14,"children":15,"page":19},"产品介绍","i-lucide-book-open","\u002Fcloud-platform\u002F01-product-introduction","1.cloud-platform\u002F01-product-introduction",[16],{"title":11,"path":17,"stem":18},"\u002Fcloud-platform\u002F01-product-introduction\u002Foverview","1.cloud-platform\u002F01-product-introduction\u002Foverview",false,{"title":21,"icon":22,"path":23,"stem":24,"children":25,"page":19},"快速开始","i-lucide-rocket","\u002Fcloud-platform\u002F02-quick-start","1.cloud-platform\u002F02-quick-start",[26,30],{"title":27,"path":28,"stem":29},"设备激活教程","\u002Fcloud-platform\u002F02-quick-start\u002F02-activation-guide","1.cloud-platform\u002F02-quick-start\u002F02-activation-guide",{"title":21,"path":31,"stem":32},"\u002Fcloud-platform\u002F02-quick-start\u002Fquick-start","1.cloud-platform\u002F02-quick-start\u002Fquick-start",{"title":34,"icon":35,"path":36,"stem":37,"children":38,"page":19},"菜单介绍","i-lucide-list","\u002Fcloud-platform\u002F03-menu-introduction","1.cloud-platform\u002F03-menu-introduction",[39,43,47,51,55,59,63,67],{"title":40,"path":41,"stem":42},"首页","\u002Fcloud-platform\u002F03-menu-introduction\u002F01-home","1.cloud-platform\u002F03-menu-introduction\u002F01-home",{"title":44,"path":45,"stem":46},"仪表盘","\u002Fcloud-platform\u002F03-menu-introduction\u002F02-dashboard","1.cloud-platform\u002F03-menu-introduction\u002F02-dashboard",{"title":48,"path":49,"stem":50},"说明文档","\u002Fcloud-platform\u002F03-menu-introduction\u002F03-documentation","1.cloud-platform\u002F03-menu-introduction\u002F03-documentation",{"title":52,"path":53,"stem":54},"AI 助手","\u002Fcloud-platform\u002F03-menu-introduction\u002F04-ai-assistant","1.cloud-platform\u002F03-menu-introduction\u002F04-ai-assistant",{"title":56,"path":57,"stem":58},"IOT物联网","\u002Fcloud-platform\u002F03-menu-introduction\u002F05-iot","1.cloud-platform\u002F03-menu-introduction\u002F05-iot",{"title":60,"path":61,"stem":62},"隧道管理","\u002Fcloud-platform\u002F03-menu-introduction\u002F06-tunnel-management","1.cloud-platform\u002F03-menu-introduction\u002F06-tunnel-management",{"title":64,"path":65,"stem":66},"系统管理","\u002Fcloud-platform\u002F03-menu-introduction\u002F07-system-management","1.cloud-platform\u002F03-menu-introduction\u002F07-system-management",{"title":68,"path":69,"stem":70},"系统工具","\u002Fcloud-platform\u002F03-menu-introduction\u002F08-system-tools","1.cloud-platform\u002F03-menu-introduction\u002F08-system-tools",{"title":72,"icon":73,"path":74,"stem":75,"children":76,"page":19},"隧道客户端","i-lucide-network","\u002Fcloud-platform\u002F03-tunnel-client","1.cloud-platform\u002F03-tunnel-client",[77,81,85,89],{"title":78,"path":79,"stem":80},"客户端介绍","\u002Fcloud-platform\u002F03-tunnel-client\u002F01-introduction","1.cloud-platform\u002F03-tunnel-client\u002F01-introduction",{"title":82,"path":83,"stem":84},"安装与连接","\u002Fcloud-platform\u002F03-tunnel-client\u002F02-installation","1.cloud-platform\u002F03-tunnel-client\u002F02-installation",{"title":86,"path":87,"stem":88},"服务管理","\u002Fcloud-platform\u002F03-tunnel-client\u002F03-service-management","1.cloud-platform\u002F03-tunnel-client\u002F03-service-management",{"title":90,"path":91,"stem":92},"配置与排查","\u002Fcloud-platform\u002F03-tunnel-client\u002F04-configuration-and-troubleshooting","1.cloud-platform\u002F03-tunnel-client\u002F04-configuration-and-troubleshooting",{"title":94,"icon":95,"path":96,"stem":97,"children":98,"page":19},"MQTT接入","i-lucide-plug","\u002Fcloud-platform\u002F04-third-party-integration","1.cloud-platform\u002F04-third-party-integration",[99,103,107,111,115],{"title":100,"path":101,"stem":102},"接入概览","\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access","1.cloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access",{"title":104,"path":105,"stem":106},"连接认证","\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-01-connection","1.cloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-01-connection",{"title":108,"path":109,"stem":110},"主题总览","\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-02-topics","1.cloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-02-topics",{"title":112,"path":113,"stem":114},"设备注册","\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-03-registration","1.cloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-03-registration",{"title":116,"path":117,"stem":118},"设备交互","\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions","1.cloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions",{"title":120,"icon":121,"path":122,"stem":123,"children":124,"page":19},"中控服务器","i-lucide-server","\u002Fcontrol-server","2.control-server",[125,133,141,174,183],{"title":11,"icon":12,"path":126,"stem":127,"children":128,"page":19},"\u002Fcontrol-server\u002F01-product-introduction","2.control-server\u002F01-product-introduction",[129],{"title":130,"path":131,"stem":132},"概述","\u002Fcontrol-server\u002F01-product-introduction\u002Foverview","2.control-server\u002F01-product-introduction\u002Foverview",{"title":21,"icon":22,"path":134,"stem":135,"children":136,"page":19},"\u002Fcontrol-server\u002F03-quick-start-guide","2.control-server\u002F03-quick-start-guide",[137],{"title":138,"path":139,"stem":140},"新手教程","\u002Fcontrol-server\u002F03-quick-start-guide\u002Ffirst-login","2.control-server\u002F03-quick-start-guide\u002Ffirst-login",{"title":34,"icon":35,"path":142,"stem":143,"children":144,"page":19},"\u002Fcontrol-server\u002F04-menu-introduction","2.control-server\u002F04-menu-introduction",[145,148,151,155,159,163,167,171],{"title":40,"path":146,"stem":147},"\u002Fcontrol-server\u002F04-menu-introduction\u002F01-home","2.control-server\u002F04-menu-introduction\u002F01-home",{"title":44,"path":149,"stem":150},"\u002Fcontrol-server\u002F04-menu-introduction\u002F02-dashboard","2.control-server\u002F04-menu-introduction\u002F02-dashboard",{"title":152,"path":153,"stem":154},"运维管理","\u002Fcontrol-server\u002F04-menu-introduction\u002F03-operations","2.control-server\u002F04-menu-introduction\u002F03-operations",{"title":156,"path":157,"stem":158},"调度管理","\u002Fcontrol-server\u002F04-menu-introduction\u002F04-scheduling","2.control-server\u002F04-menu-introduction\u002F04-scheduling",{"title":160,"path":161,"stem":162},"设备管理","\u002Fcontrol-server\u002F04-menu-introduction\u002F05-devices","2.control-server\u002F04-menu-introduction\u002F05-devices",{"title":164,"path":165,"stem":166},"协议管理","\u002Fcontrol-server\u002F04-menu-introduction\u002F06-protocols","2.control-server\u002F04-menu-introduction\u002F06-protocols",{"title":168,"path":169,"stem":170},"系统监控","\u002Fcontrol-server\u002F04-menu-introduction\u002F07-monitoring","2.control-server\u002F04-menu-introduction\u002F07-monitoring",{"title":64,"path":172,"stem":173},"\u002Fcontrol-server\u002F04-menu-introduction\u002F08-system","2.control-server\u002F04-menu-introduction\u002F08-system",{"title":175,"icon":176,"path":177,"stem":178,"children":179,"page":19},"常见问题","i-lucide-life-buoy","\u002Fcontrol-server\u002F07-operations-guide","2.control-server\u002F07-operations-guide",[180],{"title":175,"path":181,"stem":182},"\u002Fcontrol-server\u002F07-operations-guide\u002Fdaily-checks","2.control-server\u002F07-operations-guide\u002Fdaily-checks",{"title":184,"icon":95,"path":185,"stem":186,"children":187,"page":19},"第三方接入","\u002Fcontrol-server\u002F08-integration-guide","2.control-server\u002F08-integration-guide",[188],{"title":184,"path":189,"stem":190},"\u002Fcontrol-server\u002F08-integration-guide\u002Fintegration-checklist","2.control-server\u002F08-integration-guide\u002Fintegration-checklist",{"title":192,"icon":193,"path":194,"stem":195,"children":196,"page":19},"播控软件","i-lucide-monitor-play","\u002Fav-aggregation-and-playout","3.av-aggregation-and-playout",[197,204,215,246],{"title":11,"icon":12,"path":198,"stem":199,"children":200,"page":19},"\u002Fav-aggregation-and-playout\u002F01-product-introduction","3.av-aggregation-and-playout\u002F01-product-introduction",[201],{"title":11,"path":202,"stem":203},"\u002Fav-aggregation-and-playout\u002F01-product-introduction\u002Foverview","3.av-aggregation-and-playout\u002F01-product-introduction\u002Foverview",{"title":21,"icon":22,"path":205,"stem":206,"children":207,"page":19},"\u002Fav-aggregation-and-playout\u002F02-quick-start","3.av-aggregation-and-playout\u002F02-quick-start",[208,212],{"title":209,"path":210,"stem":211},"安装","\u002Fav-aggregation-and-playout\u002F02-quick-start\u002Finstallation-and-upgrade","3.av-aggregation-and-playout\u002F02-quick-start\u002Finstallation-and-upgrade",{"title":21,"path":213,"stem":214},"\u002Fav-aggregation-and-playout\u002F02-quick-start\u002Fquick-start","3.av-aggregation-and-playout\u002F02-quick-start\u002Fquick-start",{"title":34,"icon":35,"path":216,"stem":217,"children":218,"page":19},"\u002Fav-aggregation-and-playout\u002F03-menu-introduction","3.av-aggregation-and-playout\u002F03-menu-introduction",[219,223,226,230,234,238,242],{"title":220,"path":221,"stem":222},"媒体文件","\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F01-media-files","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F01-media-files",{"title":44,"path":224,"stem":225},"\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F02-dashboard","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F02-dashboard",{"title":227,"path":228,"stem":229},"浏览器","\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F03-browser","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F03-browser",{"title":231,"path":232,"stem":233},"远程桌面","\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F04-remote-desktop","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F04-remote-desktop",{"title":235,"path":236,"stem":237},"文件传输","\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F05-file-transfer","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F05-file-transfer",{"title":239,"path":240,"stem":241},"设置","\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F06-settings","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F06-settings",{"title":243,"path":244,"stem":245},"设备通信","\u002Fav-aggregation-and-playout\u002F03-menu-introduction\u002F07-device-communication","3.av-aggregation-and-playout\u002F03-menu-introduction\u002F07-device-communication",{"title":247,"path":248,"stem":249,"children":250,"page":19},"04 Integration","\u002Fav-aggregation-and-playout\u002F04-integration","3.av-aggregation-and-playout\u002F04-integration",[251],{"title":252,"path":253,"stem":254},"控制指令接入","\u002Fav-aggregation-and-playout\u002F04-integration\u002F01-control-commands","3.av-aggregation-and-playout\u002F04-integration\u002F01-control-commands",{"title":256,"icon":257,"path":258,"stem":259,"children":260,"page":19},"NVR 守卫","i-lucide-video","\u002Fnvr-guard","4.nvr-guard",[261],{"title":11,"icon":262,"path":263,"stem":264,"children":265,"page":19},"i-lucide-info","\u002Fnvr-guard\u002F01-product-introduction","4.nvr-guard\u002F01-product-introduction",[266],{"title":267,"path":268,"stem":269},"产品概述","\u002Fnvr-guard\u002F01-product-introduction\u002Foverview","4.nvr-guard\u002F01-product-introduction\u002Foverview",{"title":271,"icon":272,"path":273,"stem":274,"children":275,"page":19},"边缘采集网关","i-lucide-router","\u002Fedge-collection-gateway","5.edge-collection-gateway",[276],{"title":11,"icon":262,"path":277,"stem":278,"children":279,"page":19},"\u002Fedge-collection-gateway\u002F01-product-introduction","5.edge-collection-gateway\u002F01-product-introduction",[280],{"title":267,"path":281,"stem":282},"\u002Fedge-collection-gateway\u002F01-product-introduction\u002Foverview","5.edge-collection-gateway\u002F01-product-introduction\u002Foverview",{"title":284,"path":285,"stem":286,"children":287,"page":19},"Control App","\u002Fcontrol-app","6.control-app",[288,305,322,339],{"title":289,"path":290,"stem":291,"children":292,"page":19},"01 Control Server App","\u002Fcontrol-app\u002F01-control-server-app","6.control-app\u002F01-control-server-app",[293,296,299,302],{"title":11,"path":294,"stem":295},"\u002Fcontrol-app\u002F01-control-server-app\u002F01-product-introduction","6.control-app\u002F01-control-server-app\u002F01-product-introduction",{"title":21,"path":297,"stem":298},"\u002Fcontrol-app\u002F01-control-server-app\u002F02-quick-start","6.control-app\u002F01-control-server-app\u002F02-quick-start",{"title":34,"path":300,"stem":301},"\u002Fcontrol-app\u002F01-control-server-app\u002F03-menu-introduction","6.control-app\u002F01-control-server-app\u002F03-menu-introduction",{"title":175,"path":303,"stem":304},"\u002Fcontrol-app\u002F01-control-server-app\u002F04-common-questions","6.control-app\u002F01-control-server-app\u002F04-common-questions",{"title":306,"path":307,"stem":308,"children":309,"page":19},"02 Playout App","\u002Fcontrol-app\u002F02-playout-app","6.control-app\u002F02-playout-app",[310,313,316,319],{"title":11,"path":311,"stem":312},"\u002Fcontrol-app\u002F02-playout-app\u002F01-product-introduction","6.control-app\u002F02-playout-app\u002F01-product-introduction",{"title":21,"path":314,"stem":315},"\u002Fcontrol-app\u002F02-playout-app\u002F02-quick-start","6.control-app\u002F02-playout-app\u002F02-quick-start",{"title":34,"path":317,"stem":318},"\u002Fcontrol-app\u002F02-playout-app\u002F03-menu-introduction","6.control-app\u002F02-playout-app\u002F03-menu-introduction",{"title":175,"path":320,"stem":321},"\u002Fcontrol-app\u002F02-playout-app\u002F04-common-questions","6.control-app\u002F02-playout-app\u002F04-common-questions",{"title":323,"path":324,"stem":325,"children":326,"page":19},"03 Smart Control Panel App","\u002Fcontrol-app\u002F03-smart-control-panel-app","6.control-app\u002F03-smart-control-panel-app",[327,330,333,336],{"title":11,"path":328,"stem":329},"\u002Fcontrol-app\u002F03-smart-control-panel-app\u002F01-product-introduction","6.control-app\u002F03-smart-control-panel-app\u002F01-product-introduction",{"title":21,"path":331,"stem":332},"\u002Fcontrol-app\u002F03-smart-control-panel-app\u002F02-quick-start","6.control-app\u002F03-smart-control-panel-app\u002F02-quick-start",{"title":34,"path":334,"stem":335},"\u002Fcontrol-app\u002F03-smart-control-panel-app\u002F03-menu-introduction","6.control-app\u002F03-smart-control-panel-app\u002F03-menu-introduction",{"title":175,"path":337,"stem":338},"\u002Fcontrol-app\u002F03-smart-control-panel-app\u002F04-common-questions","6.control-app\u002F03-smart-control-panel-app\u002F04-common-questions",{"title":340,"path":341,"stem":342,"children":343,"page":19},"04 Cloud Platform App","\u002Fcontrol-app\u002F04-cloud-platform-app","6.control-app\u002F04-cloud-platform-app",[344,347,350,353],{"title":11,"path":345,"stem":346},"\u002Fcontrol-app\u002F04-cloud-platform-app\u002F01-product-introduction","6.control-app\u002F04-cloud-platform-app\u002F01-product-introduction",{"title":21,"path":348,"stem":349},"\u002Fcontrol-app\u002F04-cloud-platform-app\u002F02-quick-start","6.control-app\u002F04-cloud-platform-app\u002F02-quick-start",{"title":34,"path":351,"stem":352},"\u002Fcontrol-app\u002F04-cloud-platform-app\u002F03-menu-introduction","6.control-app\u002F04-cloud-platform-app\u002F03-menu-introduction",{"title":175,"path":354,"stem":355},"\u002Fcontrol-app\u002F04-cloud-platform-app\u002F04-common-questions","6.control-app\u002F04-cloud-platform-app\u002F04-common-questions",{"title":357,"icon":358,"path":359,"stem":360,"children":361,"page":19},"硬件设备","i-lucide-cpu","\u002Fhardware-device","7.hardware-device",[362,380],{"title":363,"icon":364,"path":365,"stem":366,"children":367,"page":19},"智能面板","i-lucide-panels-top-left","\u002Fhardware-device\u002F01-smart-panel","7.hardware-device\u002F01-smart-panel",[368,371,374,377],{"title":11,"path":369,"stem":370},"\u002Fhardware-device\u002F01-smart-panel\u002F01-product-introduction","7.hardware-device\u002F01-smart-panel\u002F01-product-introduction",{"title":21,"path":372,"stem":373},"\u002Fhardware-device\u002F01-smart-panel\u002F02-quick-start","7.hardware-device\u002F01-smart-panel\u002F02-quick-start",{"title":34,"path":375,"stem":376},"\u002Fhardware-device\u002F01-smart-panel\u002F03-menu-introduction","7.hardware-device\u002F01-smart-panel\u002F03-menu-introduction",{"title":175,"path":378,"stem":379},"\u002Fhardware-device\u002F01-smart-panel\u002F04-common-questions","7.hardware-device\u002F01-smart-panel\u002F04-common-questions",{"title":381,"icon":382,"path":383,"stem":384,"children":385,"page":19},"自动喂食器","i-lucide-settings-2","\u002Fhardware-device\u002F02-automatic-feeder","7.hardware-device\u002F02-automatic-feeder",[386,389,392,396,400,404,408],{"title":11,"path":387,"stem":388},"\u002Fhardware-device\u002F02-automatic-feeder\u002F01-product-introduction","7.hardware-device\u002F02-automatic-feeder\u002F01-product-introduction",{"title":21,"path":390,"stem":391},"\u002Fhardware-device\u002F02-automatic-feeder\u002F02-quick-start","7.hardware-device\u002F02-automatic-feeder\u002F02-quick-start",{"title":393,"path":394,"stem":395},"菜单与日常操作","\u002Fhardware-device\u002F02-automatic-feeder\u002F03-menu-introduction","7.hardware-device\u002F02-automatic-feeder\u002F03-menu-introduction",{"title":397,"path":398,"stem":399},"参数设置","\u002Fhardware-device\u002F02-automatic-feeder\u002F04-parameter-setting","7.hardware-device\u002F02-automatic-feeder\u002F04-parameter-setting",{"title":401,"path":402,"stem":403},"笼位校准与管理","\u002Fhardware-device\u002F02-automatic-feeder\u002F05-cage-calibration","7.hardware-device\u002F02-automatic-feeder\u002F05-cage-calibration",{"title":405,"path":406,"stem":407},"报警与恢复","\u002Fhardware-device\u002F02-automatic-feeder\u002F06-alarm-setting","7.hardware-device\u002F02-automatic-feeder\u002F06-alarm-setting",{"title":409,"path":410,"stem":411},"故障排查","\u002Fhardware-device\u002F02-automatic-feeder\u002F07-troubleshooting","7.hardware-device\u002F02-automatic-feeder\u002F07-troubleshooting",{"title":413,"icon":414,"path":415,"stem":416,"children":417,"page":19},"交互软件","i-lucide-mouse-pointer-2","\u002Finteractive-software","8.interactive-software",[418,440,459,476,493,510],{"title":419,"icon":420,"path":421,"stem":422,"children":423,"page":19},"宴会互动","i-lucide-party-popper","\u002Finteractive-software\u002F01-banquet-interaction","8.interactive-software\u002F01-banquet-interaction",[424,427,430,433,436],{"title":11,"path":425,"stem":426},"\u002Finteractive-software\u002F01-banquet-interaction\u002F01-product-introduction","8.interactive-software\u002F01-banquet-interaction\u002F01-product-introduction",{"title":21,"path":428,"stem":429},"\u002Finteractive-software\u002F01-banquet-interaction\u002F02-quick-start","8.interactive-software\u002F01-banquet-interaction\u002F02-quick-start",{"title":34,"path":431,"stem":432},"\u002Finteractive-software\u002F01-banquet-interaction\u002F03-menu-introduction","8.interactive-software\u002F01-banquet-interaction\u002F03-menu-introduction",{"title":175,"path":434,"stem":435},"\u002Finteractive-software\u002F01-banquet-interaction\u002F04-common-questions","8.interactive-software\u002F01-banquet-interaction\u002F04-common-questions",{"title":437,"path":438,"stem":439},"运维设置","\u002Finteractive-software\u002F01-banquet-interaction\u002F05-parameter-setting","8.interactive-software\u002F01-banquet-interaction\u002F05-parameter-setting",{"title":441,"icon":442,"path":443,"stem":444,"children":445,"page":19},"冲浪大作战","i-lucide-gamepad-2","\u002Finteractive-software\u002F02-surf-battle","8.interactive-software\u002F02-surf-battle",[446,449,452,456],{"title":11,"path":447,"stem":448},"\u002Finteractive-software\u002F02-surf-battle\u002F01-product-introduction","8.interactive-software\u002F02-surf-battle\u002F01-product-introduction",{"title":21,"path":450,"stem":451},"\u002Finteractive-software\u002F02-surf-battle\u002F02-quick-start","8.interactive-software\u002F02-surf-battle\u002F02-quick-start",{"title":453,"path":454,"stem":455},"玩法说明","\u002Finteractive-software\u002F02-surf-battle\u002F03-gameplay","8.interactive-software\u002F02-surf-battle\u002F03-gameplay",{"title":175,"path":457,"stem":458},"\u002Finteractive-software\u002F02-surf-battle\u002F04-faq","8.interactive-software\u002F02-surf-battle\u002F04-faq",{"title":460,"icon":442,"path":461,"stem":462,"children":463,"page":19},"潜艇大作战","\u002Finteractive-software\u002F03-submarine-battle","8.interactive-software\u002F03-submarine-battle",[464,467,470,473],{"title":11,"path":465,"stem":466},"\u002Finteractive-software\u002F03-submarine-battle\u002F01-product-introduction","8.interactive-software\u002F03-submarine-battle\u002F01-product-introduction",{"title":21,"path":468,"stem":469},"\u002Finteractive-software\u002F03-submarine-battle\u002F02-quick-start","8.interactive-software\u002F03-submarine-battle\u002F02-quick-start",{"title":453,"path":471,"stem":472},"\u002Finteractive-software\u002F03-submarine-battle\u002F03-gameplay","8.interactive-software\u002F03-submarine-battle\u002F03-gameplay",{"title":175,"path":474,"stem":475},"\u002Finteractive-software\u002F03-submarine-battle\u002F04-faq","8.interactive-software\u002F03-submarine-battle\u002F04-faq",{"title":477,"icon":442,"path":478,"stem":479,"children":480,"page":19},"切蛋糕","\u002Finteractive-software\u002F04-cake-cutting","8.interactive-software\u002F04-cake-cutting",[481,484,487,490],{"title":11,"path":482,"stem":483},"\u002Finteractive-software\u002F04-cake-cutting\u002F01-product-introduction","8.interactive-software\u002F04-cake-cutting\u002F01-product-introduction",{"title":21,"path":485,"stem":486},"\u002Finteractive-software\u002F04-cake-cutting\u002F02-quick-start","8.interactive-software\u002F04-cake-cutting\u002F02-quick-start",{"title":453,"path":488,"stem":489},"\u002Finteractive-software\u002F04-cake-cutting\u002F03-gameplay","8.interactive-software\u002F04-cake-cutting\u002F03-gameplay",{"title":175,"path":491,"stem":492},"\u002Finteractive-software\u002F04-cake-cutting\u002F04-faq","8.interactive-software\u002F04-cake-cutting\u002F04-faq",{"title":494,"icon":442,"path":495,"stem":496,"children":497,"page":19},"水果接接乐","\u002Finteractive-software\u002F05-fruit-catch","8.interactive-software\u002F05-fruit-catch",[498,501,504,507],{"title":11,"path":499,"stem":500},"\u002Finteractive-software\u002F05-fruit-catch\u002F01-product-introduction","8.interactive-software\u002F05-fruit-catch\u002F01-product-introduction",{"title":21,"path":502,"stem":503},"\u002Finteractive-software\u002F05-fruit-catch\u002F02-quick-start","8.interactive-software\u002F05-fruit-catch\u002F02-quick-start",{"title":453,"path":505,"stem":506},"\u002Finteractive-software\u002F05-fruit-catch\u002F03-gameplay","8.interactive-software\u002F05-fruit-catch\u002F03-gameplay",{"title":175,"path":508,"stem":509},"\u002Finteractive-software\u002F05-fruit-catch\u002F04-faq","8.interactive-software\u002F05-fruit-catch\u002F04-faq",{"title":511,"icon":442,"path":512,"stem":513,"children":514,"page":19},"体感接物","\u002Finteractive-software\u002F06-motion-catch","8.interactive-software\u002F06-motion-catch",[515,518,521,524],{"title":11,"path":516,"stem":517},"\u002Finteractive-software\u002F06-motion-catch\u002F01-product-introduction","8.interactive-software\u002F06-motion-catch\u002F01-product-introduction",{"title":21,"path":519,"stem":520},"\u002Finteractive-software\u002F06-motion-catch\u002F02-quick-start","8.interactive-software\u002F06-motion-catch\u002F02-quick-start",{"title":453,"path":522,"stem":523},"\u002Finteractive-software\u002F06-motion-catch\u002F03-gameplay","8.interactive-software\u002F06-motion-catch\u002F03-gameplay",{"title":175,"path":525,"stem":526},"\u002Finteractive-software\u002F06-motion-catch\u002F04-faq","8.interactive-software\u002F06-motion-catch\u002F04-faq",{"title":528,"path":529,"stem":530},"产品文档中心","\u002F","index",{"id":532,"title":116,"body":533,"description":3318,"extension":3319,"links":3320,"meta":3321,"navigation":3322,"path":117,"rawbody":3323,"seo":3324,"stem":118,"__hash__":3325},"docs\u002F1.cloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions.md",{"type":534,"value":535,"toc":3298},"minimark",[536,544,584,587,600,604,607,618,646,881,884,894,897,900,903,909,912,918,982,1042,1048,1050,1053,1063,1066,1072,1075,1121,1127,1130,1137,1143,1153,1218,1225,1318,1321,1401,1403,1412,1415,1421,1428,1459,1464,1470,1473,1549,1552,1596,1702,1704,1714,1717,1723,1803,1806,1812,1879,1896,1899,1902,1904,1922,1925,1928,1931,1934,1959,1962,1965,1971,1974,1980,1991,2073,2077,2084,2127,2134,2304,2315,2318,2325,2386,2393,2396,2468,2489,2492,2534,2537,2792,2810,2813,2818,2861,2867,2870,3000,3018,3064,3082,3102,3105,3107,3121,3124,3174,3177,3180,3245,3269,3272,3294],[537,538,539,540,543],"p",{},"设备建立正式连接后，按产品启用的能力实现下列交互。完整主题及配置要求见",[541,542,108],"a",{"href":109},"。",[545,546,547,554,560,566,572,578],"ul",{},[548,549,550],"li",{},[541,551,553],{"href":552},"#%E6%95%B0%E6%8D%AE%E4%B8%8A%E6%8A%A5","数据上报",[548,555,556],{},[541,557,559],{"href":558},"#%E5%85%B1%E4%BA%AB%E5%B1%9E%E6%80%A7","共享属性",[548,561,562],{},[541,563,565],{"href":564},"#%E9%85%8D%E7%BD%AE%E8%AF%BB%E5%8F%96","配置读取",[548,567,568],{},[541,569,571],{"href":570},"#%E6%8E%A7%E5%88%B6%E6%8C%87%E4%BB%A4","控制指令",[548,573,574],{},[541,575,577],{"href":576},"#%E8%AE%BE%E5%A4%87%E8%81%94%E5%8A%A8","设备联动",[548,579,580],{},[541,581,583],{"href":582},"#%E5%9B%BA%E4%BB%B6%E5%8D%87%E7%BA%A7","固件升级",[585,586,553],"h2",{"id":553},[537,588,589,590,592,593,597,598,543],{},"设备应先完成",[541,591,104],{"href":105},"，按",[541,594,596],{"href":595},"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access#%E6%8E%A5%E5%85%A5%E5%89%8D%E5%87%86%E5%A4%87","接入前准备","配置产品物模型，声明所使用的数据键和类型。数据上报及确认主题见",[541,599,108],{"href":109},[601,602,603],"h3",{"id":603},"综合数据上报",[537,605,606],{},"设备只通过以下主题上报遥测和客户端属性：",[608,609,615],"pre",{"className":610,"code":612,"language":613,"meta":614},[611],"language-text","v1\u002Fdevices\u002F{token}\u002Fdata\n","text","",[616,617,612],"code",{"__ignoreMap":614},[537,619,620,621,624,625,628,629,632,633,635,636,638,639,642,643,543],{},"报文顶层只允许包含 ",[616,622,623],{},"messageId","、",[616,626,627],{},"telemetry"," 和 ",[616,630,631],{},"client","。其中 ",[616,634,623],{}," 不能为空，",[616,637,627],{}," 必须是采集点数组，每个采集点只能包含毫秒时间戳 ",[616,640,641],{},"ts"," 和非空数据对象 ",[616,644,645],{},"values",[608,647,651],{"className":648,"code":649,"language":650,"meta":614,"style":614},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"messageId\": \"20260914-000001\",\n  \"telemetry\": [\n    {\n      \"ts\": 1789462300000,\n      \"values\": {\n        \"machineCode\": \"DEVICE-MC-001\",\n        \"temperature\": 25.4,\n        \"humidity\": 60.2\n      }\n    }\n  ],\n  \"client\": {\n    \"firmwareVersion\": \"1.2.0\",\n    \"currentWorkMode\": \"AUTO\"\n  }\n}\n","json",[616,652,653,662,689,703,709,728,742,764,781,796,802,808,814,827,849,869,875],{"__ignoreMap":614},[654,655,658],"span",{"class":656,"line":657},"line",1,[654,659,661],{"class":660},"sMK4o","{\n",[654,663,665,668,671,674,677,680,684,686],{"class":656,"line":664},2,[654,666,667],{"class":660},"  \"",[654,669,623],{"class":670},"spNyl",[654,672,673],{"class":660},"\"",[654,675,676],{"class":660},":",[654,678,679],{"class":660}," \"",[654,681,683],{"class":682},"sfazB","20260914-000001",[654,685,673],{"class":660},[654,687,688],{"class":660},",\n",[654,690,692,694,696,698,700],{"class":656,"line":691},3,[654,693,667],{"class":660},[654,695,627],{"class":670},[654,697,673],{"class":660},[654,699,676],{"class":660},[654,701,702],{"class":660}," [\n",[654,704,706],{"class":656,"line":705},4,[654,707,708],{"class":660},"    {\n",[654,710,712,715,718,720,722,726],{"class":656,"line":711},5,[654,713,714],{"class":660},"      \"",[654,716,641],{"class":717},"sBMFI",[654,719,673],{"class":660},[654,721,676],{"class":660},[654,723,725],{"class":724},"sbssI"," 1789462300000",[654,727,688],{"class":660},[654,729,731,733,735,737,739],{"class":656,"line":730},6,[654,732,714],{"class":660},[654,734,645],{"class":717},[654,736,673],{"class":660},[654,738,676],{"class":660},[654,740,741],{"class":660}," {\n",[654,743,745,748,751,753,755,757,760,762],{"class":656,"line":744},7,[654,746,747],{"class":660},"        \"",[654,749,750],{"class":724},"machineCode",[654,752,673],{"class":660},[654,754,676],{"class":660},[654,756,679],{"class":660},[654,758,759],{"class":682},"DEVICE-MC-001",[654,761,673],{"class":660},[654,763,688],{"class":660},[654,765,767,769,772,774,776,779],{"class":656,"line":766},8,[654,768,747],{"class":660},[654,770,771],{"class":724},"temperature",[654,773,673],{"class":660},[654,775,676],{"class":660},[654,777,778],{"class":724}," 25.4",[654,780,688],{"class":660},[654,782,784,786,789,791,793],{"class":656,"line":783},9,[654,785,747],{"class":660},[654,787,788],{"class":724},"humidity",[654,790,673],{"class":660},[654,792,676],{"class":660},[654,794,795],{"class":724}," 60.2\n",[654,797,799],{"class":656,"line":798},10,[654,800,801],{"class":660},"      }\n",[654,803,805],{"class":656,"line":804},11,[654,806,807],{"class":660},"    }\n",[654,809,811],{"class":656,"line":810},12,[654,812,813],{"class":660},"  ],\n",[654,815,817,819,821,823,825],{"class":656,"line":816},13,[654,818,667],{"class":660},[654,820,631],{"class":670},[654,822,673],{"class":660},[654,824,676],{"class":660},[654,826,741],{"class":660},[654,828,830,833,836,838,840,842,845,847],{"class":656,"line":829},14,[654,831,832],{"class":660},"    \"",[654,834,835],{"class":717},"firmwareVersion",[654,837,673],{"class":660},[654,839,676],{"class":660},[654,841,679],{"class":660},[654,843,844],{"class":682},"1.2.0",[654,846,673],{"class":660},[654,848,688],{"class":660},[654,850,852,854,857,859,861,863,866],{"class":656,"line":851},15,[654,853,832],{"class":660},[654,855,856],{"class":717},"currentWorkMode",[654,858,673],{"class":660},[654,860,676],{"class":660},[654,862,679],{"class":660},[654,864,865],{"class":682},"AUTO",[654,867,868],{"class":660},"\"\n",[654,870,872],{"class":656,"line":871},16,[654,873,874],{"class":660},"  }\n",[654,876,878],{"class":656,"line":877},17,[654,879,880],{"class":660},"}\n",[537,882,883],{},"所有字段、数据类型和取值范围都必须在产品物模型中提前声明。每包最多包含一百个采集点，采集时间最多向前追溯三十天，最多超前平台时间五分钟。",[537,885,886,887,890,891,893],{},"设备每次周期上报都必须在 ",[616,888,889],{},"telemetry[].values"," 中携带相同的 ",[616,892,750],{},"。首次有效上报会锁定该设备的机器码，后续不得更改，也不得与其他设备重复。",[537,895,896],{},"认领前，平台只登记机器码并返回确认，不会保存其他遥测或触发业务规则。因此，认领前收到成功确认不代表普通遥测已经入库。",[601,898,899],{"id":899},"数据确认与重试",[537,901,902],{},"设备在上报前必须先订阅：",[608,904,907],{"className":905,"code":906,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fack\u002F+\n",[616,908,906],{"__ignoreMap":614},[537,910,911],{},"平台完成数据事务后，会通过以下主题返回处理结果：",[608,913,916],{"className":914,"code":915,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fack\u002F{messageId}\n",[616,917,915],{"__ignoreMap":614},[608,919,921],{"className":648,"code":920,"language":650,"meta":614,"style":614},"{\n  \"messageId\": \"20260914-000001\",\n  \"code\": 200,\n  \"msg\": \"上报成功\"\n}\n",[616,922,923,927,945,960,978],{"__ignoreMap":614},[654,924,925],{"class":656,"line":657},[654,926,661],{"class":660},[654,928,929,931,933,935,937,939,941,943],{"class":656,"line":664},[654,930,667],{"class":660},[654,932,623],{"class":670},[654,934,673],{"class":660},[654,936,676],{"class":660},[654,938,679],{"class":660},[654,940,683],{"class":682},[654,942,673],{"class":660},[654,944,688],{"class":660},[654,946,947,949,951,953,955,958],{"class":656,"line":691},[654,948,667],{"class":660},[654,950,616],{"class":670},[654,952,673],{"class":660},[654,954,676],{"class":660},[654,956,957],{"class":724}," 200",[654,959,688],{"class":660},[654,961,962,964,967,969,971,973,976],{"class":656,"line":705},[654,963,667],{"class":660},[654,965,966],{"class":670},"msg",[654,968,673],{"class":660},[654,970,676],{"class":660},[654,972,679],{"class":660},[654,974,975],{"class":682},"上报成功",[654,977,868],{"class":660},[654,979,980],{"class":656,"line":711},[654,981,880],{"class":660},[983,984,985,998],"table",{},[986,987,988],"thead",{},[989,990,991,995],"tr",{},[992,993,994],"th",{},"状态码",[992,996,997],{},"处理方式",[999,1000,1001,1012,1022,1032],"tbody",{},[989,1002,1003,1009],{},[1004,1005,1006],"td",{},[616,1007,1008],{},"200",[1004,1010,1011],{},"数据已经成功提交",[989,1013,1014,1019],{},[1004,1015,1016],{},[616,1017,1018],{},"20001",[1004,1020,1021],{},"相同消息已经处理，不得更换消息编号重复发送同一批数据",[989,1023,1024,1029],{},[1004,1025,1026],{},[616,1027,1028],{},"40001",[1004,1030,1031],{},"报文或物模型校验失败，修正数据后使用新的消息编号上报",[989,1033,1034,1039],{},[1004,1035,1036],{},[616,1037,1038],{},"50000",[1004,1040,1041],{},"平台处理异常，可保留原消息编号重试",[537,1043,1044,1045,1047],{},"等待确认超时后，应使用原 ",[616,1046,623],{}," 重试。平台按照设备和消息编号进行幂等处理，重复数据不会再次写入遥测历史或重复触发规则。",[585,1049,559],{"id":559},[601,1051,1052],{"id":1052},"配置下发与平台属性查询",[537,1054,1055,1059,1060,543],{},[1056,1057,1058],"strong",{},"按需配置：需要平台维护并下发共享配置的设备实现。"," 本节的“读取”是设备读取平台保存的属性；平台读取设备本机配置见",[541,1061,565],{"href":1062},"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#%E9%85%8D%E7%BD%AE%E8%AF%BB%E5%8F%96",[537,1064,1065],{},"共享属性用于平台向设备下发需要持久保存的目标配置。设备订阅以下主题接收变更：",[608,1067,1070],{"className":1068,"code":1069,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fattributes\n",[616,1071,1069],{"__ignoreMap":614},[537,1073,1074],{},"平台下发内容为扁平键值对象：",[608,1076,1078],{"className":648,"code":1077,"language":650,"meta":614,"style":614},"{\n  \"targetTemperature\": 26.5,\n  \"workMode\": \"AUTO\"\n}\n",[616,1079,1080,1084,1100,1117],{"__ignoreMap":614},[654,1081,1082],{"class":656,"line":657},[654,1083,661],{"class":660},[654,1085,1086,1088,1091,1093,1095,1098],{"class":656,"line":664},[654,1087,667],{"class":660},[654,1089,1090],{"class":670},"targetTemperature",[654,1092,673],{"class":660},[654,1094,676],{"class":660},[654,1096,1097],{"class":724}," 26.5",[654,1099,688],{"class":660},[654,1101,1102,1104,1107,1109,1111,1113,1115],{"class":656,"line":691},[654,1103,667],{"class":660},[654,1105,1106],{"class":670},"workMode",[654,1108,673],{"class":660},[654,1110,676],{"class":660},[654,1112,679],{"class":660},[654,1114,865],{"class":682},[654,1116,868],{"class":660},[654,1118,1119],{"class":656,"line":705},[654,1120,880],{"class":660},[537,1122,1123,1124,1126],{},"设备收到后应校验、保存并应用收到的属性键值，未包含的属性不应被当作删除。共享属性由平台维护，设备不得通过综合数据报文反向上报共享属性。需要持续上报配置的实际生效状态时，可在物模型中另行定义客户端属性；需要临时读取本机配置时，使用",[541,1125,565],{"href":1062},"中的读取协议。",[601,1128,1129],{"id":1129},"设备查询平台属性",[537,1131,1132,1133,1136],{},"使用共享配置的设备启动或重新连接后，应先订阅 ",[616,1134,1135],{},"v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fresponse\u002F+","，再向以下主题主动读取最新属性：",[608,1138,1141],{"className":1139,"code":1140,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fattributes\u002Frequest\u002F{requestId}\n",[616,1142,1140],{"__ignoreMap":614},[537,1144,1145,1146,628,1149,1152],{},"请求必须同时包含 ",[616,1147,1148],{},"clientKeys",[616,1150,1151],{},"sharedKeys"," 字符串数组，不需要的类别使用空数组：",[608,1154,1156],{"className":648,"code":1155,"language":650,"meta":614,"style":614},"{\n  \"clientKeys\": [\"firmwareVersion\"],\n  \"sharedKeys\": [\"targetTemperature\", \"workMode\"]\n}\n",[616,1157,1158,1162,1184,1214],{"__ignoreMap":614},[654,1159,1160],{"class":656,"line":657},[654,1161,661],{"class":660},[654,1163,1164,1166,1168,1170,1172,1175,1177,1179,1181],{"class":656,"line":664},[654,1165,667],{"class":660},[654,1167,1148],{"class":670},[654,1169,673],{"class":660},[654,1171,676],{"class":660},[654,1173,1174],{"class":660}," [",[654,1176,673],{"class":660},[654,1178,835],{"class":682},[654,1180,673],{"class":660},[654,1182,1183],{"class":660},"],\n",[654,1185,1186,1188,1190,1192,1194,1196,1198,1200,1202,1205,1207,1209,1211],{"class":656,"line":691},[654,1187,667],{"class":660},[654,1189,1151],{"class":670},[654,1191,673],{"class":660},[654,1193,676],{"class":660},[654,1195,1174],{"class":660},[654,1197,673],{"class":660},[654,1199,1090],{"class":682},[654,1201,673],{"class":660},[654,1203,1204],{"class":660},",",[654,1206,679],{"class":660},[654,1208,1106],{"class":682},[654,1210,673],{"class":660},[654,1212,1213],{"class":660},"]\n",[654,1215,1216],{"class":656,"line":705},[654,1217,880],{"class":660},[537,1219,1220,1221,1224],{},"平台通过 ",[616,1222,1223],{},"v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fresponse\u002F{requestId}"," 返回已保存的属性值，请求与响应编号一致：",[608,1226,1228],{"className":648,"code":1227,"language":650,"meta":614,"style":614},"{\n  \"client\": {\n    \"firmwareVersion\": \"1.2.0\"\n  },\n  \"shared\": {\n    \"targetTemperature\": 26.5,\n    \"workMode\": \"AUTO\"\n  }\n}\n",[616,1229,1230,1234,1246,1262,1267,1280,1294,1310,1314],{"__ignoreMap":614},[654,1231,1232],{"class":656,"line":657},[654,1233,661],{"class":660},[654,1235,1236,1238,1240,1242,1244],{"class":656,"line":664},[654,1237,667],{"class":660},[654,1239,631],{"class":670},[654,1241,673],{"class":660},[654,1243,676],{"class":660},[654,1245,741],{"class":660},[654,1247,1248,1250,1252,1254,1256,1258,1260],{"class":656,"line":691},[654,1249,832],{"class":660},[654,1251,835],{"class":717},[654,1253,673],{"class":660},[654,1255,676],{"class":660},[654,1257,679],{"class":660},[654,1259,844],{"class":682},[654,1261,868],{"class":660},[654,1263,1264],{"class":656,"line":705},[654,1265,1266],{"class":660},"  },\n",[654,1268,1269,1271,1274,1276,1278],{"class":656,"line":711},[654,1270,667],{"class":660},[654,1272,1273],{"class":670},"shared",[654,1275,673],{"class":660},[654,1277,676],{"class":660},[654,1279,741],{"class":660},[654,1281,1282,1284,1286,1288,1290,1292],{"class":656,"line":730},[654,1283,832],{"class":660},[654,1285,1090],{"class":717},[654,1287,673],{"class":660},[654,1289,676],{"class":660},[654,1291,1097],{"class":724},[654,1293,688],{"class":660},[654,1295,1296,1298,1300,1302,1304,1306,1308],{"class":656,"line":744},[654,1297,832],{"class":660},[654,1299,1106],{"class":717},[654,1301,673],{"class":660},[654,1303,676],{"class":660},[654,1305,679],{"class":660},[654,1307,865],{"class":682},[654,1309,868],{"class":660},[654,1311,1312],{"class":656,"line":766},[654,1313,874],{"class":660},[654,1315,1316],{"class":656,"line":783},[654,1317,880],{"class":660},[601,1319,1320],{"id":1320},"属性交互的区别",[983,1322,1323,1339],{},[986,1324,1325],{},[989,1326,1327,1330,1333,1336],{},[992,1328,1329],{},"需求",[992,1331,1332],{},"发起方",[992,1334,1335],{},"使用主题",[992,1337,1338],{},"读取或写入对象",[999,1340,1341,1360,1381],{},[989,1342,1343,1349,1352,1357],{},[1004,1344,1345],{},[541,1346,1348],{"href":1347},"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#%E5%85%B1%E4%BA%AB%E5%B1%9E%E6%80%A7","修改设备共享配置",[1004,1350,1351],{},"平台",[1004,1353,1354],{},[616,1355,1356],{},"attributes",[1004,1358,1359],{},"平台下发属性变更，设备保存并应用。",[989,1361,1362,1367,1370,1378],{},[1004,1363,1364],{},[541,1365,1366],{"href":1347},"启动或重连后恢复平台配置",[1004,1368,1369],{},"设备",[1004,1371,1372,624,1375],{},[616,1373,1374],{},"attributes\u002Frequest",[616,1376,1377],{},"attributes\u002Fresponse",[1004,1379,1380],{},"查询平台已保存的属性值。",[989,1382,1383,1388,1390,1398],{},[1004,1384,1385],{},[541,1386,1387],{"href":1062},"获取设备当前保存的配置",[1004,1389,1351],{},[1004,1391,1392,624,1395],{},[616,1393,1394],{},"attributes\u002Fread\u002Frequest",[616,1396,1397],{},"attributes\u002Fread\u002Fresponse",[1004,1399,1400],{},"查询设备本机值，仅返回读取结果。",[585,1402,565],{"id":565},[537,1404,1405,1408,1409,1411],{},[1056,1406,1407],{},"按需配置：需要管理端获取设备本机配置的设备实现。"," 此能力用于查看、核对或编辑设备当前保存的配置，不能用",[541,1410,559],{"href":1347},"中的平台属性查询结果代替。",[537,1413,1414],{},"管理员在共享属性设置中点击“获取”时，平台向在线设备发送读取请求。每次请求读取一个物模型已定义的共享属性，设备订阅：",[608,1416,1419],{"className":1417,"code":1418,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fread\u002Frequest\u002F+\n",[616,1420,1418],{"__ignoreMap":614},[537,1422,1423,1424,1427],{},"实际收到的主题为 ",[616,1425,1426],{},"v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fread\u002Frequest\u002F{requestId}","，其中请求编号由平台生成。请求内容：",[608,1429,1431],{"className":648,"code":1430,"language":650,"meta":614,"style":614},"{\n  \"key\": \"system_config\"\n}\n",[616,1432,1433,1437,1455],{"__ignoreMap":614},[654,1434,1435],{"class":656,"line":657},[654,1436,661],{"class":660},[654,1438,1439,1441,1444,1446,1448,1450,1453],{"class":656,"line":664},[654,1440,667],{"class":660},[654,1442,1443],{"class":670},"key",[654,1445,673],{"class":660},[654,1447,676],{"class":660},[654,1449,679],{"class":660},[654,1451,1452],{"class":682},"system_config",[654,1454,868],{"class":660},[654,1456,1457],{"class":656,"line":691},[654,1458,880],{"class":660},[537,1460,1461,1463],{},[616,1462,1452],{}," 仅用于说明属性键的位置，应替换为该产品实际定义的共享属性键。设备读取本机保存的对应配置后，通过以下主题响应：",[608,1465,1468],{"className":1466,"code":1467,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fread\u002Fresponse\u002F{requestId}\n",[616,1469,1467],{"__ignoreMap":614},[537,1471,1472],{},"读取成功：",[608,1474,1476],{"className":648,"code":1475,"language":650,"meta":614,"style":614},"{\n  \"success\": true,\n  \"data\": {\n    \"key\": \"system_config\",\n    \"value\": {}\n  }\n}\n",[616,1477,1478,1482,1496,1509,1527,1541,1545],{"__ignoreMap":614},[654,1479,1480],{"class":656,"line":657},[654,1481,661],{"class":660},[654,1483,1484,1486,1489,1491,1493],{"class":656,"line":664},[654,1485,667],{"class":660},[654,1487,1488],{"class":670},"success",[654,1490,673],{"class":660},[654,1492,676],{"class":660},[654,1494,1495],{"class":660}," true,\n",[654,1497,1498,1500,1503,1505,1507],{"class":656,"line":691},[654,1499,667],{"class":660},[654,1501,1502],{"class":670},"data",[654,1504,673],{"class":660},[654,1506,676],{"class":660},[654,1508,741],{"class":660},[654,1510,1511,1513,1515,1517,1519,1521,1523,1525],{"class":656,"line":705},[654,1512,832],{"class":660},[654,1514,1443],{"class":717},[654,1516,673],{"class":660},[654,1518,676],{"class":660},[654,1520,679],{"class":660},[654,1522,1452],{"class":682},[654,1524,673],{"class":660},[654,1526,688],{"class":660},[654,1528,1529,1531,1534,1536,1538],{"class":656,"line":711},[654,1530,832],{"class":660},[654,1532,1533],{"class":717},"value",[654,1535,673],{"class":660},[654,1537,676],{"class":660},[654,1539,1540],{"class":660}," {}\n",[654,1542,1543],{"class":656,"line":730},[654,1544,874],{"class":660},[654,1546,1547],{"class":656,"line":744},[654,1548,880],{"class":660},[537,1550,1551],{},"读取失败：",[608,1553,1555],{"className":648,"code":1554,"language":650,"meta":614,"style":614},"{\n  \"success\": false,\n  \"error\": \"设备未保存该项配置\"\n}\n",[616,1556,1557,1561,1574,1592],{"__ignoreMap":614},[654,1558,1559],{"class":656,"line":657},[654,1560,661],{"class":660},[654,1562,1563,1565,1567,1569,1571],{"class":656,"line":664},[654,1564,667],{"class":660},[654,1566,1488],{"class":670},[654,1568,673],{"class":660},[654,1570,676],{"class":660},[654,1572,1573],{"class":660}," false,\n",[654,1575,1576,1578,1581,1583,1585,1587,1590],{"class":656,"line":691},[654,1577,667],{"class":660},[654,1579,1580],{"class":670},"error",[654,1582,673],{"class":660},[654,1584,676],{"class":660},[654,1586,679],{"class":660},[654,1588,1589],{"class":682},"设备未保存该项配置",[654,1591,868],{"class":660},[654,1593,1594],{"class":656,"line":705},[654,1595,880],{"class":660},[983,1597,1598,1608],{},[986,1599,1600],{},[989,1601,1602,1605],{},[992,1603,1604],{},"项目",[992,1606,1607],{},"处理要求",[999,1609,1610,1625,1654,1664,1675,1683,1694],{},[989,1611,1612,1615],{},[1004,1613,1614],{},"请求对应关系",[1004,1616,1617,1618,1621,1622,1624],{},"响应主题使用收到的原请求编号，成功响应中的 ",[616,1619,1620],{},"data.key"," 必须与请求的 ",[616,1623,1443],{}," 完全一致。",[989,1626,1627,1630],{},[1004,1628,1629],{},"响应字段",[1004,1631,1632,1633,624,1635,1637,1638,1640,1641,624,1643,1645,1646,1648,1649,543,1651,1653],{},"成功报文顶层只包含 ",[616,1634,1488],{},[616,1636,1502],{},"，",[616,1639,1502],{}," 只包含 ",[616,1642,1443],{},[616,1644,1533],{},"；失败报文只包含 ",[616,1647,1488],{},"、非空字符串 ",[616,1650,1580],{},[616,1652,1488],{}," 必须是布尔值。",[989,1655,1656,1659],{},[1004,1657,1658],{},"配置内容",[1004,1660,1661,1663],{},[616,1662,1533],{}," 使用设备实际保存的值，数据类型应符合该共享属性的物模型定义。上面的空对象仅展示响应封装，不规定配置内部字段；参数设置、笼位位置、模板设置、报警灯设置、系统配置等内容由设备端自行组织和解析。",[989,1665,1666,1669],{},[1004,1667,1668],{},"JSON 属性",[1004,1670,1671,1672,1674],{},"对象或数组直接放入 ",[616,1673,1533],{},"，不能先转换成 JSON 字符串再传输。平台不额外规定这些配置的内部结构，不接受非有限数值。",[989,1676,1677,1680],{},[1004,1678,1679],{},"大小与时限",[1004,1681,1682],{},"单条响应最大为 256 KiB，按 UTF-8 编码后的字节数计算。平台默认等待十秒，读取等待时间最大三十秒；设备应及时返回，不支持离线排队读取。",[989,1684,1685,1688],{},[1004,1686,1687],{},"重复或过期响应",[1004,1689,1690,1691,543],{},"平台只接收仍在等待中的对应响应；已完成、已超时或没有读取请求的响应会被忽略。响应设置 ",[616,1692,1693],{},"retain=false",[989,1695,1696,1699],{},[1004,1697,1698],{},"管理端效果",[1004,1700,1701],{},"“获取”仅把读取结果填入编辑表单，不会自动保存平台属性，也不会再次下发配置。管理员确认设置后才保存并下发。",[585,1703,571],{"id":571},[537,1705,1706,1709,1710,1713],{},[1056,1707,1708],{},"按需配置：支持远程控制，或作为设备联动目标的设备实现。"," ",[541,1711,577],{"href":1712},"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#%E8%AE%BE%E5%A4%87%E8%81%94%E5%8A%A8","的目标设备沿用本节的请求和响应协议，不需要单独增加一套目标控制主题。",[537,1715,1716],{},"需要立即执行的设备动作应在产品物模型中定义为服务。平台通过以下主题下发请求：",[608,1718,1721],{"className":1719,"code":1720,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Frpc\u002Frequest\u002F{requestId}\n",[616,1722,1720],{"__ignoreMap":614},[608,1724,1726],{"className":648,"code":1725,"language":650,"meta":614,"style":614},"{\n  \"method\": \"setRelay\",\n  \"params\": {\n    \"channel\": 1,\n    \"state\": true\n  }\n}\n",[616,1727,1728,1732,1752,1765,1781,1795,1799],{"__ignoreMap":614},[654,1729,1730],{"class":656,"line":657},[654,1731,661],{"class":660},[654,1733,1734,1736,1739,1741,1743,1745,1748,1750],{"class":656,"line":664},[654,1735,667],{"class":660},[654,1737,1738],{"class":670},"method",[654,1740,673],{"class":660},[654,1742,676],{"class":660},[654,1744,679],{"class":660},[654,1746,1747],{"class":682},"setRelay",[654,1749,673],{"class":660},[654,1751,688],{"class":660},[654,1753,1754,1756,1759,1761,1763],{"class":656,"line":691},[654,1755,667],{"class":660},[654,1757,1758],{"class":670},"params",[654,1760,673],{"class":660},[654,1762,676],{"class":660},[654,1764,741],{"class":660},[654,1766,1767,1769,1772,1774,1776,1779],{"class":656,"line":705},[654,1768,832],{"class":660},[654,1770,1771],{"class":717},"channel",[654,1773,673],{"class":660},[654,1775,676],{"class":660},[654,1777,1778],{"class":724}," 1",[654,1780,688],{"class":660},[654,1782,1783,1785,1788,1790,1792],{"class":656,"line":711},[654,1784,832],{"class":660},[654,1786,1787],{"class":717},"state",[654,1789,673],{"class":660},[654,1791,676],{"class":660},[654,1793,1794],{"class":660}," true\n",[654,1796,1797],{"class":656,"line":730},[654,1798,874],{"class":660},[654,1800,1801],{"class":656,"line":744},[654,1802,880],{"class":660},[537,1804,1805],{},"设备应校验方法和参数，执行后使用相同请求编号返回结果：",[608,1807,1810],{"className":1808,"code":1809,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Frpc\u002Fresponse\u002F{requestId}\n",[616,1811,1809],{"__ignoreMap":614},[608,1813,1815],{"className":648,"code":1814,"language":650,"meta":614,"style":614},"{\n  \"success\": true,\n  \"data\": {\n    \"channel\": 1,\n    \"state\": true\n  }\n}\n",[616,1816,1817,1821,1833,1845,1859,1871,1875],{"__ignoreMap":614},[654,1818,1819],{"class":656,"line":657},[654,1820,661],{"class":660},[654,1822,1823,1825,1827,1829,1831],{"class":656,"line":664},[654,1824,667],{"class":660},[654,1826,1488],{"class":670},[654,1828,673],{"class":660},[654,1830,676],{"class":660},[654,1832,1495],{"class":660},[654,1834,1835,1837,1839,1841,1843],{"class":656,"line":691},[654,1836,667],{"class":660},[654,1838,1502],{"class":670},[654,1840,673],{"class":660},[654,1842,676],{"class":660},[654,1844,741],{"class":660},[654,1846,1847,1849,1851,1853,1855,1857],{"class":656,"line":705},[654,1848,832],{"class":660},[654,1850,1771],{"class":717},[654,1852,673],{"class":660},[654,1854,676],{"class":660},[654,1856,1778],{"class":724},[654,1858,688],{"class":660},[654,1860,1861,1863,1865,1867,1869],{"class":656,"line":711},[654,1862,832],{"class":660},[654,1864,1787],{"class":717},[654,1866,673],{"class":660},[654,1868,676],{"class":660},[654,1870,1794],{"class":660},[654,1872,1873],{"class":656,"line":730},[654,1874,874],{"class":660},[654,1876,1877],{"class":656,"line":744},[654,1878,880],{"class":660},[537,1880,1881,1882,1884,1885,1888,1889,1891,1892,1895],{},"设备必须使用布尔值 ",[616,1883,1488],{}," 返回实际执行结果，不能用“已收到请求”代替“已执行成功”。执行失败时返回 ",[616,1886,1887],{},"success: false","，并通过 ",[616,1890,1580],{}," 或 ",[616,1893,1894],{},"message"," 说明原因。单条响应最大为四千字节。",[537,1897,1898],{},"设备应按指令请求编号处理重复投递：同一编号只执行一次，后续重复消息返回原执行结果，避免重复动作。",[537,1900,1901],{},"管理端发起的离线调用可能进入排队状态；设备联动不采用离线补发。平台显示“已下发”只表示 MQTT 服务已确认接收发布消息，不代表目标设备已经收到或执行成功；最终执行结果应以设备响应为准。",[585,1903,577],{"id":577},[537,1905,1906,1913,1914,1917,1918,1921],{},[1056,1907,1908,1909,1912],{},"按需配置：需要主动触发其他设备动作的来源设备实现 ",[616,1910,1911],{},"platform"," 主题。"," 仅接受控制的目标设备实现",[541,1915,571],{"href":1916},"\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#%E6%8E%A7%E5%88%B6%E6%8C%87%E4%BB%A4","中的 ",[616,1919,1920],{},"rpc"," 主题即可。",[537,1923,1924],{},"设备联动由来源设备的本地业务逻辑发起。例如，喂食器需要打开电箱的照明时，喂食器向平台提交联动标识，平台按已配置的目标设备、控制指令和固定参数向电箱发送远程调用，再将执行状态返回喂食器。配置联动本身不会自动根据遥测触发动作。",[601,1926,1927],{"id":1927},"平台配置与设备职责",[537,1929,1930],{},"在来源设备详情侧板的“设备联动”标签页中新增配置，填写名称和联动标识，选择目标设备、其产品物模型中的控制指令及参数，并设置是否启用和响应超时。超时默认十秒，可配置一至六十秒。",[537,1932,1933],{},"来源设备与目标设备必须是同一有效租户下已认领、未停用且凭据有效的不同设备，产品也必须有效。来源设备只使用自己的访问令牌，不需要知道目标设备的访问令牌。",[537,1935,1936,1937,1940,1941,1943,1944,624,1947,1950,1951,1954,1955,1958],{},"例如，联动标识 ",[616,1938,1939],{},"light_on"," 对应目标电箱的 ",[616,1942,1747],{}," 指令，固定参数为 ",[616,1945,1946],{},"channel: 1",[616,1948,1949],{},"state: true","。关闭照明应另行配置一个标识，例如 ",[616,1952,1953],{},"light_off","，使用 ",[616,1956,1957],{},"state: false","。来源设备不能在联动请求中临时指定目标设备、控制方法或参数。",[601,1960,1961],{"id":1961},"来源设备的请求与响应",[537,1963,1964],{},"来源设备先订阅：",[608,1966,1969],{"className":1967,"code":1968,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fplatform\u002Fresponse\u002F+\n",[616,1970,1968],{"__ignoreMap":614},[537,1972,1973],{},"然后通过以下主题发送请求：",[608,1975,1978],{"className":1976,"code":1977,"language":613,"meta":614},[611],"v1\u002Fdevices\u002F{token}\u002Fplatform\u002Frequest\u002F{requestId}\n",[616,1979,1977],{"__ignoreMap":614},[537,1981,1982,1983,1986,1987,1990],{},"请求编号由来源设备生成，仅允许字母、数字、下划线和连字符，长度为一至六十四个字符。",[616,1984,1985],{},"version"," 必须为整数 ",[616,1988,1989],{},"1","。请求只允许包含对应操作规定的字段，单条请求最大为四千字节。",[983,1992,1993,2011],{},[986,1994,1995],{},[989,1996,1997,2000,2005,2008],{},[992,1998,1999],{},"操作",[992,2001,2002],{},[616,2003,2004],{},"type",[992,2006,2007],{},"允许的请求字段",[992,2009,2010],{},"用途",[999,2012,2013,2032,2054],{},[989,2014,2015,2018,2023,2029],{},[1004,2016,2017],{},"查询目录",[1004,2019,2020],{},[616,2021,2022],{},"catalog",[1004,2024,2025,624,2027],{},[616,2026,1985],{},[616,2028,2004],{},[1004,2030,2031],{},"获取来源设备当前可用的联动标识和名称；已知标识时可直接触发，不必每次先查询目录。",[989,2033,2034,2037,2042,2051],{},[1004,2035,2036],{},"执行联动",[1004,2038,2039],{},[616,2040,2041],{},"execute",[1004,2043,2044,624,2046,624,2048],{},[616,2045,1985],{},[616,2047,2004],{},[616,2049,2050],{},"bindingCode",[1004,2052,2053],{},"按联动标识执行平台预先配置的指令和参数。每次新的动作使用新的请求编号。",[989,2055,2056,2059,2064,2070],{},[1004,2057,2058],{},"查询结果",[1004,2060,2061],{},[616,2062,2063],{},"query",[1004,2065,2066,624,2068],{},[616,2067,1985],{},[616,2069,2004],{},[1004,2071,2072],{},"使用原执行请求编号查询该次联动的最新状态，不会重新执行。",[2074,2075,2076],"h4",{"id":2076},"查询可用联动目录",[537,2078,2079,2080,2083],{},"使用一个新的请求编号，例如 ",[616,2081,2082],{},"catalog_001","，发送：",[608,2085,2087],{"className":648,"code":2086,"language":650,"meta":614,"style":614},"{\n  \"version\": 1,\n  \"type\": \"catalog\"\n}\n",[616,2088,2089,2093,2107,2123],{"__ignoreMap":614},[654,2090,2091],{"class":656,"line":657},[654,2092,661],{"class":660},[654,2094,2095,2097,2099,2101,2103,2105],{"class":656,"line":664},[654,2096,667],{"class":660},[654,2098,1985],{"class":670},[654,2100,673],{"class":660},[654,2102,676],{"class":660},[654,2104,1778],{"class":724},[654,2106,688],{"class":660},[654,2108,2109,2111,2113,2115,2117,2119,2121],{"class":656,"line":691},[654,2110,667],{"class":660},[654,2112,2004],{"class":670},[654,2114,673],{"class":660},[654,2116,676],{"class":660},[654,2118,679],{"class":660},[654,2120,2022],{"class":682},[654,2122,868],{"class":660},[654,2124,2125],{"class":656,"line":705},[654,2126,880],{"class":660},[537,2128,2129,2130,2133],{},"平台在 ",[616,2131,2132],{},"v1\u002Fdevices\u002F{token}\u002Fplatform\u002Fresponse\u002Fcatalog_001"," 返回当前有效且已启用的配置：",[608,2135,2137],{"className":648,"code":2136,"language":650,"meta":614,"style":614},"{\n  \"version\": 1,\n  \"requestId\": \"catalog_001\",\n  \"type\": \"catalog\",\n  \"bindings\": [\n    {\n      \"code\": \"light_on\",\n      \"name\": \"打开照明\"\n    },\n    {\n      \"code\": \"light_off\",\n      \"name\": \"关闭照明\"\n    }\n  ]\n}\n",[616,2138,2139,2143,2157,2176,2194,2207,2211,2229,2247,2252,2256,2274,2291,2295,2300],{"__ignoreMap":614},[654,2140,2141],{"class":656,"line":657},[654,2142,661],{"class":660},[654,2144,2145,2147,2149,2151,2153,2155],{"class":656,"line":664},[654,2146,667],{"class":660},[654,2148,1985],{"class":670},[654,2150,673],{"class":660},[654,2152,676],{"class":660},[654,2154,1778],{"class":724},[654,2156,688],{"class":660},[654,2158,2159,2161,2164,2166,2168,2170,2172,2174],{"class":656,"line":691},[654,2160,667],{"class":660},[654,2162,2163],{"class":670},"requestId",[654,2165,673],{"class":660},[654,2167,676],{"class":660},[654,2169,679],{"class":660},[654,2171,2082],{"class":682},[654,2173,673],{"class":660},[654,2175,688],{"class":660},[654,2177,2178,2180,2182,2184,2186,2188,2190,2192],{"class":656,"line":705},[654,2179,667],{"class":660},[654,2181,2004],{"class":670},[654,2183,673],{"class":660},[654,2185,676],{"class":660},[654,2187,679],{"class":660},[654,2189,2022],{"class":682},[654,2191,673],{"class":660},[654,2193,688],{"class":660},[654,2195,2196,2198,2201,2203,2205],{"class":656,"line":711},[654,2197,667],{"class":660},[654,2199,2200],{"class":670},"bindings",[654,2202,673],{"class":660},[654,2204,676],{"class":660},[654,2206,702],{"class":660},[654,2208,2209],{"class":656,"line":730},[654,2210,708],{"class":660},[654,2212,2213,2215,2217,2219,2221,2223,2225,2227],{"class":656,"line":744},[654,2214,714],{"class":660},[654,2216,616],{"class":717},[654,2218,673],{"class":660},[654,2220,676],{"class":660},[654,2222,679],{"class":660},[654,2224,1939],{"class":682},[654,2226,673],{"class":660},[654,2228,688],{"class":660},[654,2230,2231,2233,2236,2238,2240,2242,2245],{"class":656,"line":766},[654,2232,714],{"class":660},[654,2234,2235],{"class":717},"name",[654,2237,673],{"class":660},[654,2239,676],{"class":660},[654,2241,679],{"class":660},[654,2243,2244],{"class":682},"打开照明",[654,2246,868],{"class":660},[654,2248,2249],{"class":656,"line":783},[654,2250,2251],{"class":660},"    },\n",[654,2253,2254],{"class":656,"line":798},[654,2255,708],{"class":660},[654,2257,2258,2260,2262,2264,2266,2268,2270,2272],{"class":656,"line":804},[654,2259,714],{"class":660},[654,2261,616],{"class":717},[654,2263,673],{"class":660},[654,2265,676],{"class":660},[654,2267,679],{"class":660},[654,2269,1953],{"class":682},[654,2271,673],{"class":660},[654,2273,688],{"class":660},[654,2275,2276,2278,2280,2282,2284,2286,2289],{"class":656,"line":810},[654,2277,714],{"class":660},[654,2279,2235],{"class":717},[654,2281,673],{"class":660},[654,2283,676],{"class":660},[654,2285,679],{"class":660},[654,2287,2288],{"class":682},"关闭照明",[654,2290,868],{"class":660},[654,2292,2293],{"class":656,"line":816},[654,2294,807],{"class":660},[654,2296,2297],{"class":656,"line":829},[654,2298,2299],{"class":660},"  ]\n",[654,2301,2302],{"class":656,"line":851},[654,2303,880],{"class":660},[537,2305,2306,2307,2309,2310,2312,2313,543],{},"没有可用配置时 ",[616,2308,2200],{}," 为空数组。返回的 ",[616,2311,616],{}," 用于执行请求的 ",[616,2314,2050],{},[2074,2316,2317],{"id":2317},"触发联动",[537,2319,2320,2321,2324],{},"例如向 ",[616,2322,2323],{},"v1\u002Fdevices\u002F{token}\u002Fplatform\u002Frequest\u002Ffeeder_light_001"," 发布：",[608,2326,2328],{"className":648,"code":2327,"language":650,"meta":614,"style":614},"{\n  \"version\": 1,\n  \"type\": \"execute\",\n  \"bindingCode\": \"light_on\"\n}\n",[616,2329,2330,2334,2348,2366,2382],{"__ignoreMap":614},[654,2331,2332],{"class":656,"line":657},[654,2333,661],{"class":660},[654,2335,2336,2338,2340,2342,2344,2346],{"class":656,"line":664},[654,2337,667],{"class":660},[654,2339,1985],{"class":670},[654,2341,673],{"class":660},[654,2343,676],{"class":660},[654,2345,1778],{"class":724},[654,2347,688],{"class":660},[654,2349,2350,2352,2354,2356,2358,2360,2362,2364],{"class":656,"line":691},[654,2351,667],{"class":660},[654,2353,2004],{"class":670},[654,2355,673],{"class":660},[654,2357,676],{"class":660},[654,2359,679],{"class":660},[654,2361,2041],{"class":682},[654,2363,673],{"class":660},[654,2365,688],{"class":660},[654,2367,2368,2370,2372,2374,2376,2378,2380],{"class":656,"line":705},[654,2369,667],{"class":660},[654,2371,2050],{"class":670},[654,2373,673],{"class":660},[654,2375,676],{"class":660},[654,2377,679],{"class":660},[654,2379,1939],{"class":682},[654,2381,868],{"class":660},[654,2383,2384],{"class":656,"line":711},[654,2385,880],{"class":660},[537,2387,2388,2389,2392],{},"平台校验配置后创建指令，并返回当前状态。后续状态和最终结果也通过 ",[616,2390,2391],{},"v1\u002Fdevices\u002F{token}\u002Fplatform\u002Fresponse\u002Ffeeder_light_001"," 返回；首次响应可能仍在排队或执行中，应继续等待最终结果。",[537,2394,2395],{},"目标设备收到的是标准远程调用：",[608,2397,2398],{"className":648,"code":1725,"language":650,"meta":614,"style":614},[616,2399,2400,2404,2422,2434,2448,2460,2464],{"__ignoreMap":614},[654,2401,2402],{"class":656,"line":657},[654,2403,661],{"class":660},[654,2405,2406,2408,2410,2412,2414,2416,2418,2420],{"class":656,"line":664},[654,2407,667],{"class":660},[654,2409,1738],{"class":670},[654,2411,673],{"class":660},[654,2413,676],{"class":660},[654,2415,679],{"class":660},[654,2417,1747],{"class":682},[654,2419,673],{"class":660},[654,2421,688],{"class":660},[654,2423,2424,2426,2428,2430,2432],{"class":656,"line":691},[654,2425,667],{"class":660},[654,2427,1758],{"class":670},[654,2429,673],{"class":660},[654,2431,676],{"class":660},[654,2433,741],{"class":660},[654,2435,2436,2438,2440,2442,2444,2446],{"class":656,"line":705},[654,2437,832],{"class":660},[654,2439,1771],{"class":717},[654,2441,673],{"class":660},[654,2443,676],{"class":660},[654,2445,1778],{"class":724},[654,2447,688],{"class":660},[654,2449,2450,2452,2454,2456,2458],{"class":656,"line":711},[654,2451,832],{"class":660},[654,2453,1787],{"class":717},[654,2455,673],{"class":660},[654,2457,676],{"class":660},[654,2459,1794],{"class":660},[654,2461,2462],{"class":656,"line":730},[654,2463,874],{"class":660},[654,2465,2466],{"class":656,"line":744},[654,2467,880],{"class":660},[537,2469,2470,2471,1912,2474,2484,2485,2488],{},"该调用使用目标设备自己的 ",[616,2472,2473],{},"rpc\u002Frequest\u002F{rpcRequestId}",[1056,2475,2476,2477,2480,2481,2483],{},"平台为目标指令生成的 ",[616,2478,2479],{},"rpcRequestId"," 与来源设备的 ",[616,2482,2163],{}," 是两个编号。"," 目标设备必须使用收到的目标指令编号返回 ",[616,2486,2487],{},"rpc\u002Fresponse\u002F{rpcRequestId}","，不能使用喂食器的执行请求编号。",[537,2490,2491],{},"目标设备执行完成后可以返回：",[608,2493,2495],{"className":648,"code":2494,"language":650,"meta":614,"style":614},"{\n  \"success\": true,\n  \"message\": \"照明已开启\"\n}\n",[616,2496,2497,2501,2513,2530],{"__ignoreMap":614},[654,2498,2499],{"class":656,"line":657},[654,2500,661],{"class":660},[654,2502,2503,2505,2507,2509,2511],{"class":656,"line":664},[654,2504,667],{"class":660},[654,2506,1488],{"class":670},[654,2508,673],{"class":660},[654,2510,676],{"class":660},[654,2512,1495],{"class":660},[654,2514,2515,2517,2519,2521,2523,2525,2528],{"class":656,"line":691},[654,2516,667],{"class":660},[654,2518,1894],{"class":670},[654,2520,673],{"class":660},[654,2522,676],{"class":660},[654,2524,679],{"class":660},[654,2526,2527],{"class":682},"照明已开启",[654,2529,868],{"class":660},[654,2531,2532],{"class":656,"line":705},[654,2533,880],{"class":660},[537,2535,2536],{},"平台向来源设备返回的成功结果示例：",[608,2538,2540],{"className":648,"code":2539,"language":650,"meta":614,"style":614},"{\n  \"version\": 1,\n  \"requestId\": \"feeder_light_001\",\n  \"bindingCode\": \"light_on\",\n  \"rpcRequestId\": \"link_0123456789abcdef0123456789abcdef0123456789abcdef01234567\",\n  \"status\": \"SUCCESS\",\n  \"terminal\": true,\n  \"sent\": true,\n  \"sendState\": \"CONFIRMED\",\n  \"reason\": \"\",\n  \"receivedAt\": 1791500000000,\n  \"expiresAt\": 1791500010000,\n  \"success\": true,\n  \"result\": {\n    \"success\": true,\n    \"message\": \"照明已开启\"\n  }\n}\n",[616,2541,2542,2546,2560,2579,2597,2616,2636,2649,2662,2682,2698,2714,2730,2742,2755,2767,2783,2787],{"__ignoreMap":614},[654,2543,2544],{"class":656,"line":657},[654,2545,661],{"class":660},[654,2547,2548,2550,2552,2554,2556,2558],{"class":656,"line":664},[654,2549,667],{"class":660},[654,2551,1985],{"class":670},[654,2553,673],{"class":660},[654,2555,676],{"class":660},[654,2557,1778],{"class":724},[654,2559,688],{"class":660},[654,2561,2562,2564,2566,2568,2570,2572,2575,2577],{"class":656,"line":691},[654,2563,667],{"class":660},[654,2565,2163],{"class":670},[654,2567,673],{"class":660},[654,2569,676],{"class":660},[654,2571,679],{"class":660},[654,2573,2574],{"class":682},"feeder_light_001",[654,2576,673],{"class":660},[654,2578,688],{"class":660},[654,2580,2581,2583,2585,2587,2589,2591,2593,2595],{"class":656,"line":705},[654,2582,667],{"class":660},[654,2584,2050],{"class":670},[654,2586,673],{"class":660},[654,2588,676],{"class":660},[654,2590,679],{"class":660},[654,2592,1939],{"class":682},[654,2594,673],{"class":660},[654,2596,688],{"class":660},[654,2598,2599,2601,2603,2605,2607,2609,2612,2614],{"class":656,"line":711},[654,2600,667],{"class":660},[654,2602,2479],{"class":670},[654,2604,673],{"class":660},[654,2606,676],{"class":660},[654,2608,679],{"class":660},[654,2610,2611],{"class":682},"link_0123456789abcdef0123456789abcdef0123456789abcdef01234567",[654,2613,673],{"class":660},[654,2615,688],{"class":660},[654,2617,2618,2620,2623,2625,2627,2629,2632,2634],{"class":656,"line":730},[654,2619,667],{"class":660},[654,2621,2622],{"class":670},"status",[654,2624,673],{"class":660},[654,2626,676],{"class":660},[654,2628,679],{"class":660},[654,2630,2631],{"class":682},"SUCCESS",[654,2633,673],{"class":660},[654,2635,688],{"class":660},[654,2637,2638,2640,2643,2645,2647],{"class":656,"line":744},[654,2639,667],{"class":660},[654,2641,2642],{"class":670},"terminal",[654,2644,673],{"class":660},[654,2646,676],{"class":660},[654,2648,1495],{"class":660},[654,2650,2651,2653,2656,2658,2660],{"class":656,"line":766},[654,2652,667],{"class":660},[654,2654,2655],{"class":670},"sent",[654,2657,673],{"class":660},[654,2659,676],{"class":660},[654,2661,1495],{"class":660},[654,2663,2664,2666,2669,2671,2673,2675,2678,2680],{"class":656,"line":783},[654,2665,667],{"class":660},[654,2667,2668],{"class":670},"sendState",[654,2670,673],{"class":660},[654,2672,676],{"class":660},[654,2674,679],{"class":660},[654,2676,2677],{"class":682},"CONFIRMED",[654,2679,673],{"class":660},[654,2681,688],{"class":660},[654,2683,2684,2686,2689,2691,2693,2696],{"class":656,"line":798},[654,2685,667],{"class":660},[654,2687,2688],{"class":670},"reason",[654,2690,673],{"class":660},[654,2692,676],{"class":660},[654,2694,2695],{"class":660}," \"\"",[654,2697,688],{"class":660},[654,2699,2700,2702,2705,2707,2709,2712],{"class":656,"line":804},[654,2701,667],{"class":660},[654,2703,2704],{"class":670},"receivedAt",[654,2706,673],{"class":660},[654,2708,676],{"class":660},[654,2710,2711],{"class":724}," 1791500000000",[654,2713,688],{"class":660},[654,2715,2716,2718,2721,2723,2725,2728],{"class":656,"line":810},[654,2717,667],{"class":660},[654,2719,2720],{"class":670},"expiresAt",[654,2722,673],{"class":660},[654,2724,676],{"class":660},[654,2726,2727],{"class":724}," 1791500010000",[654,2729,688],{"class":660},[654,2731,2732,2734,2736,2738,2740],{"class":656,"line":816},[654,2733,667],{"class":660},[654,2735,1488],{"class":670},[654,2737,673],{"class":660},[654,2739,676],{"class":660},[654,2741,1495],{"class":660},[654,2743,2744,2746,2749,2751,2753],{"class":656,"line":829},[654,2745,667],{"class":660},[654,2747,2748],{"class":670},"result",[654,2750,673],{"class":660},[654,2752,676],{"class":660},[654,2754,741],{"class":660},[654,2756,2757,2759,2761,2763,2765],{"class":656,"line":851},[654,2758,832],{"class":660},[654,2760,1488],{"class":717},[654,2762,673],{"class":660},[654,2764,676],{"class":660},[654,2766,1495],{"class":660},[654,2768,2769,2771,2773,2775,2777,2779,2781],{"class":656,"line":871},[654,2770,832],{"class":660},[654,2772,1894],{"class":717},[654,2774,673],{"class":660},[654,2776,676],{"class":660},[654,2778,679],{"class":660},[654,2780,2527],{"class":682},[654,2782,868],{"class":660},[654,2784,2785],{"class":656,"line":877},[654,2786,874],{"class":660},[654,2788,2790],{"class":656,"line":2789},18,[654,2791,880],{"class":660},[537,2793,2794,628,2796,2798,2799,2801,2802,628,2804,2806,2807,2809],{},[616,2795,2704],{},[616,2797,2720],{}," 为毫秒时间戳。",[616,2800,2642],{}," 表示该请求是否已经结束；处理中响应不包含最终 ",[616,2803,1488],{},[616,2805,2748],{},"。成功或设备明确返回失败时，",[616,2808,2748],{}," 只提供执行结果及简短消息，不透传目标设备响应中的其他数据。",[2074,2811,2812],{"id":2812},"查询某次执行结果",[537,2814,2815,2816,2324],{},"没有收到最终响应，或来源设备断线后需要恢复查询时，向原执行主题 ",[616,2817,2323],{},[608,2819,2821],{"className":648,"code":2820,"language":650,"meta":614,"style":614},"{\n  \"version\": 1,\n  \"type\": \"query\"\n}\n",[616,2822,2823,2827,2841,2857],{"__ignoreMap":614},[654,2824,2825],{"class":656,"line":657},[654,2826,661],{"class":660},[654,2828,2829,2831,2833,2835,2837,2839],{"class":656,"line":664},[654,2830,667],{"class":660},[654,2832,1985],{"class":670},[654,2834,673],{"class":660},[654,2836,676],{"class":660},[654,2838,1778],{"class":724},[654,2840,688],{"class":660},[654,2842,2843,2845,2847,2849,2851,2853,2855],{"class":656,"line":691},[654,2844,667],{"class":660},[654,2846,2004],{"class":670},[654,2848,673],{"class":660},[654,2850,676],{"class":660},[654,2852,679],{"class":660},[654,2854,2063],{"class":682},[654,2856,868],{"class":660},[654,2858,2859],{"class":656,"line":705},[654,2860,880],{"class":660},[537,2862,2863,2864,2866],{},"平台返回原请求的当前状态。查询必须沿用原执行请求编号，且不能带 ",[616,2865,2050],{},"。查询不存在的请求会被拒绝；查询只读取状态，不会再次发送目标控制指令。来源设备应保存未结束请求的编号，重连后先恢复响应订阅，再查询原请求。",[601,2868,2869],{"id":2869},"执行状态与重试",[983,2871,2872,2886],{},[986,2873,2874],{},[989,2875,2876,2880,2883],{},[992,2877,2878],{},[616,2879,2622],{},[992,2881,2882],{},"是否结束",[992,2884,2885],{},"含义与设备处理",[999,2887,2888,2901,2913,2925,2941,2960,2972,2986],{},[989,2889,2890,2895,2898],{},[1004,2891,2892],{},[616,2893,2894],{},"QUEUED",[1004,2896,2897],{},"否",[1004,2899,2900],{},"平台已受理，等待内部执行；不等于离线排队补发。继续等待或查询。",[989,2902,2903,2908,2910],{},[1004,2904,2905],{},[616,2906,2907],{},"PROCESSING",[1004,2909,2897],{},[1004,2911,2912],{},"平台正在发送或核对发送结果，消息可能已经发出。不能自行认定目标动作未执行。",[989,2914,2915,2920,2922],{},[1004,2916,2917],{},[616,2918,2919],{},"DELIVERED",[1004,2921,2897],{},[1004,2923,2924],{},"MQTT 服务已确认发布，等待目标设备实际响应。不能视为执行成功。",[989,2926,2927,2931,2934],{},[1004,2928,2929],{},[616,2930,2631],{},[1004,2932,2933],{},"是",[1004,2935,2936,2937,2940],{},"目标设备已明确返回 ",[616,2938,2939],{},"success: true","，可按成功处理。",[989,2942,2943,2948,2950],{},[1004,2944,2945],{},[616,2946,2947],{},"FAILED",[1004,2949,2933],{},[1004,2951,2936,2952,2954,2955,628,2957,543],{},[616,2953,1887],{},"，查看 ",[616,2956,2688],{},[616,2958,2959],{},"result.message",[989,2961,2962,2967,2969],{},[1004,2963,2964],{},[616,2965,2966],{},"TIMEOUT",[1004,2968,2933],{},[1004,2970,2971],{},"在时限内没有得到有效结果；结合发送状态判断，可能已经执行，不能直接当作未执行并重复触发。",[989,2973,2974,2979,2981],{},[1004,2975,2976],{},[616,2977,2978],{},"CANCELED",[1004,2980,2933],{},[1004,2982,2983,2984,543],{},"指令因目标离线、配置失效等原因在发送前取消，查看 ",[616,2985,2688],{},[989,2987,2988,2993,2995],{},[1004,2989,2990],{},[616,2991,2992],{},"REJECTED",[1004,2994,2933],{},[1004,2996,2997,2998,543],{},"请求字段、联动标识或设备授权条件不符合要求，或查询记录不存在；查看 ",[616,2999,2688],{},[537,3001,3002,3003,624,3005,624,3007,624,3009,624,3011,624,3013,628,3015,3017],{},"拒绝响应包含 ",[616,3004,1985],{},[616,3006,2163],{},[616,3008,2622],{},[616,3010,2642],{},[616,3012,1488],{},[616,3014,2655],{},[616,3016,2688],{},"，不保证包含目标指令编号或其他执行记录字段。",[983,3019,3020,3030],{},[986,3021,3022],{},[989,3023,3024,3027],{},[992,3025,3026],{},"发送状态",[992,3028,3029],{},"含义",[999,3031,3032,3042,3052],{},[989,3033,3034,3039],{},[1004,3035,3036],{},[616,3037,3038],{},"NOT_SENT",[1004,3040,3041],{},"尚未发送，平台可以在原请求的有效期内继续处理。",[989,3043,3044,3049],{},[1004,3045,3046],{},[616,3047,3048],{},"POSSIBLE",[1004,3050,3051],{},"消息可能已经发出，平台不会自动重复发布，以免目标设备重复动作。",[989,3053,3054,3058],{},[1004,3055,3056],{},[616,3057,2677],{},[1004,3059,3060,3061,3063],{},"发布已经得到确认，或已收到目标设备的有效响应。仍需看执行 ",[616,3062,2622],{},"，不能仅据此判断业务成功。",[537,3065,3066,3069,3070,3073,3074,3077,3078,3081],{},[616,3067,3068],{},"sent: true"," 对应 ",[616,3071,3072],{},"sendState: CONFIRMED","，表示发送确认，不表示动作成功；",[616,3075,3076],{},"sent: false"," 且 ",[616,3079,3080],{},"sendState: POSSIBLE"," 时，也不能认定消息未到达目标设备。",[545,3083,3084,3087,3090,3093,3099],{},[548,3085,3086],{},"目标离线时取消联动，不在目标重连后补发。需要新的动作时，由来源设备根据当前业务状态重新判断，并使用新请求编号发起。",[548,3088,3089],{},"对同一次动作重试必须保留原请求编号和相同请求内容，平台返回原记录，不会再次创建或发布目标指令。同一编号改用其他联动标识会被拒绝。",[548,3091,3092],{},"已结束的请求不会因为再次提交而重新执行。执行新的动作需要新的编号；超时但可能已发送时，应先核对目标状态再决定是否发起新动作。",[548,3094,3095,3096,3098],{},"最终状态通知可能因来源设备离线或网络中断而无法接收，不应假定重连后会自动补齐所有通知，使用 ",[616,3097,2063],{}," 查询原请求。",[548,3100,3101],{},"目标设备必须按自己的远程调用请求编号去重，并如实返回执行结果。",[537,3103,3104],{},"管理端可在指令日志中按“设备联动”来源筛选执行记录，查看目标指令的状态和联动详情。",[585,3106,583],{"id":583},[537,3108,3109,3112,3113,3116,3117,3120],{},[1056,3110,3111],{},"按需配置：仅支持平台远程固件升级的设备需要实现。"," 使用 ",[616,3114,3115],{},"ota\u002Frequest\u002F{requestId}"," 发布请求或进度，订阅 ",[616,3118,3119],{},"ota\u002Fresponse\u002F+"," 接收结果和任务。",[537,3122,3123],{},"设备检查升级时，通过升级请求主题发送当前版本：",[608,3125,3127],{"className":648,"code":3126,"language":650,"meta":614,"style":614},"{\n  \"action\": \"CHECK\",\n  \"currentVersion\": \"1.2.0\"\n}\n",[616,3128,3129,3133,3153,3170],{"__ignoreMap":614},[654,3130,3131],{"class":656,"line":657},[654,3132,661],{"class":660},[654,3134,3135,3137,3140,3142,3144,3146,3149,3151],{"class":656,"line":664},[654,3136,667],{"class":660},[654,3138,3139],{"class":670},"action",[654,3141,673],{"class":660},[654,3143,676],{"class":660},[654,3145,679],{"class":660},[654,3147,3148],{"class":682},"CHECK",[654,3150,673],{"class":660},[654,3152,688],{"class":660},[654,3154,3155,3157,3160,3162,3164,3166,3168],{"class":656,"line":691},[654,3156,667],{"class":660},[654,3158,3159],{"class":670},"currentVersion",[654,3161,673],{"class":660},[654,3163,676],{"class":660},[654,3165,679],{"class":660},[654,3167,844],{"class":682},[654,3169,868],{"class":660},[654,3171,3172],{"class":656,"line":705},[654,3173,880],{"class":660},[537,3175,3176],{},"平台使用相同请求编号返回无可用更新或存在可用更新。存在更新时，响应中会包含版本、下载地址、文件大小和校验信息。",[537,3178,3179],{},"设备下载和安装过程中，应使用平台任务的同一请求编号上报进度：",[608,3181,3183],{"className":648,"code":3182,"language":650,"meta":614,"style":614},"{\n  \"action\": \"PROGRESS\",\n  \"status\": \"UPDATING\",\n  \"progress\": 80\n}\n",[616,3184,3185,3189,3208,3227,3241],{"__ignoreMap":614},[654,3186,3187],{"class":656,"line":657},[654,3188,661],{"class":660},[654,3190,3191,3193,3195,3197,3199,3201,3204,3206],{"class":656,"line":664},[654,3192,667],{"class":660},[654,3194,3139],{"class":670},[654,3196,673],{"class":660},[654,3198,676],{"class":660},[654,3200,679],{"class":660},[654,3202,3203],{"class":682},"PROGRESS",[654,3205,673],{"class":660},[654,3207,688],{"class":660},[654,3209,3210,3212,3214,3216,3218,3220,3223,3225],{"class":656,"line":691},[654,3211,667],{"class":660},[654,3213,2622],{"class":670},[654,3215,673],{"class":660},[654,3217,676],{"class":660},[654,3219,679],{"class":660},[654,3221,3222],{"class":682},"UPDATING",[654,3224,673],{"class":660},[654,3226,688],{"class":660},[654,3228,3229,3231,3234,3236,3238],{"class":656,"line":705},[654,3230,667],{"class":660},[654,3232,3233],{"class":670},"progress",[654,3235,673],{"class":660},[654,3237,676],{"class":660},[654,3239,3240],{"class":724}," 80\n",[654,3242,3243],{"class":656,"line":711},[654,3244,880],{"class":660},[537,3246,3247,3248,624,3251,624,3254,624,3257,624,3259,628,3262,3264,3265,3268],{},"允许的升级状态为 ",[616,3249,3250],{},"DOWNLOADING",[616,3252,3253],{},"DOWNLOADED",[616,3255,3256],{},"VERIFIED",[616,3258,3222],{},[616,3260,3261],{},"UPDATED",[616,3263,2947],{},"。进度必须是零到一百之间的整数；失败时可附加 ",[616,3266,3267],{},"errorMessage"," 错误信息。",[585,3270,3271],{"id":3271},"相关文档",[545,3273,3274,3278,3282,3286,3290],{},[548,3275,3276],{},[541,3277,100],{"href":101},[548,3279,3280],{},[541,3281,104],{"href":105},[548,3283,3284],{},[541,3285,108],{"href":109},[548,3287,3288],{},[541,3289,112],{"href":113},[548,3291,3292],{},[541,3293,596],{"href":595},[3295,3296,3297],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":614,"searchDepth":657,"depth":664,"links":3299},[3300,3304,3309,3310,3311,3316,3317],{"id":553,"depth":664,"text":553,"children":3301},[3302,3303],{"id":603,"depth":691,"text":603},{"id":899,"depth":691,"text":899},{"id":559,"depth":664,"text":559,"children":3305},[3306,3307,3308],{"id":1052,"depth":691,"text":1052},{"id":1129,"depth":691,"text":1129},{"id":1320,"depth":691,"text":1320},{"id":565,"depth":664,"text":565},{"id":571,"depth":664,"text":571},{"id":577,"depth":664,"text":577,"children":3312},[3313,3314,3315],{"id":1927,"depth":691,"text":1927},{"id":1961,"depth":691,"text":1961},{"id":2869,"depth":691,"text":2869},{"id":583,"depth":664,"text":583},{"id":3271,"depth":664,"text":3271},"通过 MQTT 完成数据上报、共享属性交互、配置读取、控制指令、设备联动和固件升级。","md",null,{},true,"---\ntitle: 设备交互\ndescription: 通过 MQTT 完成数据上报、共享属性交互、配置读取、控制指令、设备联动和固件升级。\n---\n\n设备建立正式连接后，按产品启用的能力实现下列交互。完整主题及配置要求见[主题总览](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-02-topics)。\n\n- [数据上报](#数据上报)\n- [共享属性](#共享属性)\n- [配置读取](#配置读取)\n- [控制指令](#控制指令)\n- [设备联动](#设备联动)\n- [固件升级](#固件升级)\n\n## 数据上报\n\n设备应先完成[连接认证](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-01-connection)，按[接入前准备](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access#接入前准备)配置产品物模型，声明所使用的数据键和类型。数据上报及确认主题见[主题总览](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-02-topics)。\n\n### 综合数据上报\n\n设备只通过以下主题上报遥测和客户端属性：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fdata\n```\n\n报文顶层只允许包含 `messageId`、`telemetry` 和 `client`。其中 `messageId` 不能为空，`telemetry` 必须是采集点数组，每个采集点只能包含毫秒时间戳 `ts` 和非空数据对象 `values`。\n\n```json\n{\n  \"messageId\": \"20260914-000001\",\n  \"telemetry\": [\n    {\n      \"ts\": 1789462300000,\n      \"values\": {\n        \"machineCode\": \"DEVICE-MC-001\",\n        \"temperature\": 25.4,\n        \"humidity\": 60.2\n      }\n    }\n  ],\n  \"client\": {\n    \"firmwareVersion\": \"1.2.0\",\n    \"currentWorkMode\": \"AUTO\"\n  }\n}\n```\n\n所有字段、数据类型和取值范围都必须在产品物模型中提前声明。每包最多包含一百个采集点，采集时间最多向前追溯三十天，最多超前平台时间五分钟。\n\n设备每次周期上报都必须在 `telemetry[].values` 中携带相同的 `machineCode`。首次有效上报会锁定该设备的机器码，后续不得更改，也不得与其他设备重复。\n\n认领前，平台只登记机器码并返回确认，不会保存其他遥测或触发业务规则。因此，认领前收到成功确认不代表普通遥测已经入库。\n\n### 数据确认与重试\n\n设备在上报前必须先订阅：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fack\u002F+\n```\n\n平台完成数据事务后，会通过以下主题返回处理结果：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fack\u002F{messageId}\n```\n\n```json\n{\n  \"messageId\": \"20260914-000001\",\n  \"code\": 200,\n  \"msg\": \"上报成功\"\n}\n```\n\n| 状态码 | 处理方式 |\n| --- | --- |\n| `200` | 数据已经成功提交 |\n| `20001` | 相同消息已经处理，不得更换消息编号重复发送同一批数据 |\n| `40001` | 报文或物模型校验失败，修正数据后使用新的消息编号上报 |\n| `50000` | 平台处理异常，可保留原消息编号重试 |\n\n等待确认超时后，应使用原 `messageId` 重试。平台按照设备和消息编号进行幂等处理，重复数据不会再次写入遥测历史或重复触发规则。\n\n## 共享属性\n\n### 配置下发与平台属性查询\n\n**按需配置：需要平台维护并下发共享配置的设备实现。** 本节的“读取”是设备读取平台保存的属性；平台读取设备本机配置见[配置读取](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#配置读取)。\n\n共享属性用于平台向设备下发需要持久保存的目标配置。设备订阅以下主题接收变更：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fattributes\n```\n\n平台下发内容为扁平键值对象：\n\n```json\n{\n  \"targetTemperature\": 26.5,\n  \"workMode\": \"AUTO\"\n}\n```\n\n设备收到后应校验、保存并应用收到的属性键值，未包含的属性不应被当作删除。共享属性由平台维护，设备不得通过综合数据报文反向上报共享属性。需要持续上报配置的实际生效状态时，可在物模型中另行定义客户端属性；需要临时读取本机配置时，使用[配置读取](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#配置读取)中的读取协议。\n\n### 设备查询平台属性\n\n使用共享配置的设备启动或重新连接后，应先订阅 `v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fresponse\u002F+`，再向以下主题主动读取最新属性：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fattributes\u002Frequest\u002F{requestId}\n```\n\n请求必须同时包含 `clientKeys` 和 `sharedKeys` 字符串数组，不需要的类别使用空数组：\n\n```json\n{\n  \"clientKeys\": [\"firmwareVersion\"],\n  \"sharedKeys\": [\"targetTemperature\", \"workMode\"]\n}\n```\n\n平台通过 `v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fresponse\u002F{requestId}` 返回已保存的属性值，请求与响应编号一致：\n\n```json\n{\n  \"client\": {\n    \"firmwareVersion\": \"1.2.0\"\n  },\n  \"shared\": {\n    \"targetTemperature\": 26.5,\n    \"workMode\": \"AUTO\"\n  }\n}\n```\n\n### 属性交互的区别\n\n| 需求 | 发起方 | 使用主题 | 读取或写入对象 |\n| --- | --- | --- | --- |\n| [修改设备共享配置](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#共享属性) | 平台 | `attributes` | 平台下发属性变更，设备保存并应用。 |\n| [启动或重连后恢复平台配置](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#共享属性) | 设备 | `attributes\u002Frequest`、`attributes\u002Fresponse` | 查询平台已保存的属性值。 |\n| [获取设备当前保存的配置](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#配置读取) | 平台 | `attributes\u002Fread\u002Frequest`、`attributes\u002Fread\u002Fresponse` | 查询设备本机值，仅返回读取结果。 |\n\n## 配置读取\n\n**按需配置：需要管理端获取设备本机配置的设备实现。** 此能力用于查看、核对或编辑设备当前保存的配置，不能用[共享属性](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#共享属性)中的平台属性查询结果代替。\n\n管理员在共享属性设置中点击“获取”时，平台向在线设备发送读取请求。每次请求读取一个物模型已定义的共享属性，设备订阅：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fattributes\u002Fread\u002Frequest\u002F+\n```\n\n实际收到的主题为 `v1\u002Fdevices\u002F{token}\u002Fattributes\u002Fread\u002Frequest\u002F{requestId}`，其中请求编号由平台生成。请求内容：\n\n```json\n{\n  \"key\": \"system_config\"\n}\n```\n\n`system_config` 仅用于说明属性键的位置，应替换为该产品实际定义的共享属性键。设备读取本机保存的对应配置后，通过以下主题响应：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fattributes\u002Fread\u002Fresponse\u002F{requestId}\n```\n\n读取成功：\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"key\": \"system_config\",\n    \"value\": {}\n  }\n}\n```\n\n读取失败：\n\n```json\n{\n  \"success\": false,\n  \"error\": \"设备未保存该项配置\"\n}\n```\n\n| 项目 | 处理要求 |\n| --- | --- |\n| 请求对应关系 | 响应主题使用收到的原请求编号，成功响应中的 `data.key` 必须与请求的 `key` 完全一致。 |\n| 响应字段 | 成功报文顶层只包含 `success`、`data`，`data` 只包含 `key`、`value`；失败报文只包含 `success`、非空字符串 `error`。`success` 必须是布尔值。 |\n| 配置内容 | `value` 使用设备实际保存的值，数据类型应符合该共享属性的物模型定义。上面的空对象仅展示响应封装，不规定配置内部字段；参数设置、笼位位置、模板设置、报警灯设置、系统配置等内容由设备端自行组织和解析。 |\n| JSON 属性 | 对象或数组直接放入 `value`，不能先转换成 JSON 字符串再传输。平台不额外规定这些配置的内部结构，不接受非有限数值。 |\n| 大小与时限 | 单条响应最大为 256 KiB，按 UTF-8 编码后的字节数计算。平台默认等待十秒，读取等待时间最大三十秒；设备应及时返回，不支持离线排队读取。 |\n| 重复或过期响应 | 平台只接收仍在等待中的对应响应；已完成、已超时或没有读取请求的响应会被忽略。响应设置 `retain=false`。 |\n| 管理端效果 | “获取”仅把读取结果填入编辑表单，不会自动保存平台属性，也不会再次下发配置。管理员确认设置后才保存并下发。 |\n\n## 控制指令\n\n**按需配置：支持远程控制，或作为设备联动目标的设备实现。** [设备联动](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#设备联动)的目标设备沿用本节的请求和响应协议，不需要单独增加一套目标控制主题。\n\n需要立即执行的设备动作应在产品物模型中定义为服务。平台通过以下主题下发请求：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Frpc\u002Frequest\u002F{requestId}\n```\n\n```json\n{\n  \"method\": \"setRelay\",\n  \"params\": {\n    \"channel\": 1,\n    \"state\": true\n  }\n}\n```\n\n设备应校验方法和参数，执行后使用相同请求编号返回结果：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Frpc\u002Fresponse\u002F{requestId}\n```\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"channel\": 1,\n    \"state\": true\n  }\n}\n```\n\n设备必须使用布尔值 `success` 返回实际执行结果，不能用“已收到请求”代替“已执行成功”。执行失败时返回 `success: false`，并通过 `error` 或 `message` 说明原因。单条响应最大为四千字节。\n\n设备应按指令请求编号处理重复投递：同一编号只执行一次，后续重复消息返回原执行结果，避免重复动作。\n\n管理端发起的离线调用可能进入排队状态；设备联动不采用离线补发。平台显示“已下发”只表示 MQTT 服务已确认接收发布消息，不代表目标设备已经收到或执行成功；最终执行结果应以设备响应为准。\n\n## 设备联动\n\n**按需配置：需要主动触发其他设备动作的来源设备实现 `platform` 主题。** 仅接受控制的目标设备实现[控制指令](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-05-interactions#控制指令)中的 `rpc` 主题即可。\n\n设备联动由来源设备的本地业务逻辑发起。例如，喂食器需要打开电箱的照明时，喂食器向平台提交联动标识，平台按已配置的目标设备、控制指令和固定参数向电箱发送远程调用，再将执行状态返回喂食器。配置联动本身不会自动根据遥测触发动作。\n\n### 平台配置与设备职责\n\n在来源设备详情侧板的“设备联动”标签页中新增配置，填写名称和联动标识，选择目标设备、其产品物模型中的控制指令及参数，并设置是否启用和响应超时。超时默认十秒，可配置一至六十秒。\n\n来源设备与目标设备必须是同一有效租户下已认领、未停用且凭据有效的不同设备，产品也必须有效。来源设备只使用自己的访问令牌，不需要知道目标设备的访问令牌。\n\n例如，联动标识 `light_on` 对应目标电箱的 `setRelay` 指令，固定参数为 `channel: 1`、`state: true`。关闭照明应另行配置一个标识，例如 `light_off`，使用 `state: false`。来源设备不能在联动请求中临时指定目标设备、控制方法或参数。\n\n### 来源设备的请求与响应\n\n来源设备先订阅：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fplatform\u002Fresponse\u002F+\n```\n\n然后通过以下主题发送请求：\n\n```text\nv1\u002Fdevices\u002F{token}\u002Fplatform\u002Frequest\u002F{requestId}\n```\n\n请求编号由来源设备生成，仅允许字母、数字、下划线和连字符，长度为一至六十四个字符。`version` 必须为整数 `1`。请求只允许包含对应操作规定的字段，单条请求最大为四千字节。\n\n| 操作 | `type` | 允许的请求字段 | 用途 |\n| --- | --- | --- | --- |\n| 查询目录 | `catalog` | `version`、`type` | 获取来源设备当前可用的联动标识和名称；已知标识时可直接触发，不必每次先查询目录。 |\n| 执行联动 | `execute` | `version`、`type`、`bindingCode` | 按联动标识执行平台预先配置的指令和参数。每次新的动作使用新的请求编号。 |\n| 查询结果 | `query` | `version`、`type` | 使用原执行请求编号查询该次联动的最新状态，不会重新执行。 |\n\n#### 查询可用联动目录\n\n使用一个新的请求编号，例如 `catalog_001`，发送：\n\n```json\n{\n  \"version\": 1,\n  \"type\": \"catalog\"\n}\n```\n\n平台在 `v1\u002Fdevices\u002F{token}\u002Fplatform\u002Fresponse\u002Fcatalog_001` 返回当前有效且已启用的配置：\n\n```json\n{\n  \"version\": 1,\n  \"requestId\": \"catalog_001\",\n  \"type\": \"catalog\",\n  \"bindings\": [\n    {\n      \"code\": \"light_on\",\n      \"name\": \"打开照明\"\n    },\n    {\n      \"code\": \"light_off\",\n      \"name\": \"关闭照明\"\n    }\n  ]\n}\n```\n\n没有可用配置时 `bindings` 为空数组。返回的 `code` 用于执行请求的 `bindingCode`。\n\n#### 触发联动\n\n例如向 `v1\u002Fdevices\u002F{token}\u002Fplatform\u002Frequest\u002Ffeeder_light_001` 发布：\n\n```json\n{\n  \"version\": 1,\n  \"type\": \"execute\",\n  \"bindingCode\": \"light_on\"\n}\n```\n\n平台校验配置后创建指令，并返回当前状态。后续状态和最终结果也通过 `v1\u002Fdevices\u002F{token}\u002Fplatform\u002Fresponse\u002Ffeeder_light_001` 返回；首次响应可能仍在排队或执行中，应继续等待最终结果。\n\n目标设备收到的是标准远程调用：\n\n```json\n{\n  \"method\": \"setRelay\",\n  \"params\": {\n    \"channel\": 1,\n    \"state\": true\n  }\n}\n```\n\n该调用使用目标设备自己的 `rpc\u002Frequest\u002F{rpcRequestId}` 主题。**平台为目标指令生成的 `rpcRequestId` 与来源设备的 `requestId` 是两个编号。** 目标设备必须使用收到的目标指令编号返回 `rpc\u002Fresponse\u002F{rpcRequestId}`，不能使用喂食器的执行请求编号。\n\n目标设备执行完成后可以返回：\n\n```json\n{\n  \"success\": true,\n  \"message\": \"照明已开启\"\n}\n```\n\n平台向来源设备返回的成功结果示例：\n\n```json\n{\n  \"version\": 1,\n  \"requestId\": \"feeder_light_001\",\n  \"bindingCode\": \"light_on\",\n  \"rpcRequestId\": \"link_0123456789abcdef0123456789abcdef0123456789abcdef01234567\",\n  \"status\": \"SUCCESS\",\n  \"terminal\": true,\n  \"sent\": true,\n  \"sendState\": \"CONFIRMED\",\n  \"reason\": \"\",\n  \"receivedAt\": 1791500000000,\n  \"expiresAt\": 1791500010000,\n  \"success\": true,\n  \"result\": {\n    \"success\": true,\n    \"message\": \"照明已开启\"\n  }\n}\n```\n\n`receivedAt` 和 `expiresAt` 为毫秒时间戳。`terminal` 表示该请求是否已经结束；处理中响应不包含最终 `success` 和 `result`。成功或设备明确返回失败时，`result` 只提供执行结果及简短消息，不透传目标设备响应中的其他数据。\n\n#### 查询某次执行结果\n\n没有收到最终响应，或来源设备断线后需要恢复查询时，向原执行主题 `v1\u002Fdevices\u002F{token}\u002Fplatform\u002Frequest\u002Ffeeder_light_001` 发布：\n\n```json\n{\n  \"version\": 1,\n  \"type\": \"query\"\n}\n```\n\n平台返回原请求的当前状态。查询必须沿用原执行请求编号，且不能带 `bindingCode`。查询不存在的请求会被拒绝；查询只读取状态，不会再次发送目标控制指令。来源设备应保存未结束请求的编号，重连后先恢复响应订阅，再查询原请求。\n\n### 执行状态与重试\n\n| `status` | 是否结束 | 含义与设备处理 |\n| --- | --- | --- |\n| `QUEUED` | 否 | 平台已受理，等待内部执行；不等于离线排队补发。继续等待或查询。 |\n| `PROCESSING` | 否 | 平台正在发送或核对发送结果，消息可能已经发出。不能自行认定目标动作未执行。 |\n| `DELIVERED` | 否 | MQTT 服务已确认发布，等待目标设备实际响应。不能视为执行成功。 |\n| `SUCCESS` | 是 | 目标设备已明确返回 `success: true`，可按成功处理。 |\n| `FAILED` | 是 | 目标设备已明确返回 `success: false`，查看 `reason` 和 `result.message`。 |\n| `TIMEOUT` | 是 | 在时限内没有得到有效结果；结合发送状态判断，可能已经执行，不能直接当作未执行并重复触发。 |\n| `CANCELED` | 是 | 指令因目标离线、配置失效等原因在发送前取消，查看 `reason`。 |\n| `REJECTED` | 是 | 请求字段、联动标识或设备授权条件不符合要求，或查询记录不存在；查看 `reason`。 |\n\n拒绝响应包含 `version`、`requestId`、`status`、`terminal`、`success`、`sent` 和 `reason`，不保证包含目标指令编号或其他执行记录字段。\n\n| 发送状态 | 含义 |\n| --- | --- |\n| `NOT_SENT` | 尚未发送，平台可以在原请求的有效期内继续处理。 |\n| `POSSIBLE` | 消息可能已经发出，平台不会自动重复发布，以免目标设备重复动作。 |\n| `CONFIRMED` | 发布已经得到确认，或已收到目标设备的有效响应。仍需看执行 `status`，不能仅据此判断业务成功。 |\n\n`sent: true` 对应 `sendState: CONFIRMED`，表示发送确认，不表示动作成功；`sent: false` 且 `sendState: POSSIBLE` 时，也不能认定消息未到达目标设备。\n\n- 目标离线时取消联动，不在目标重连后补发。需要新的动作时，由来源设备根据当前业务状态重新判断，并使用新请求编号发起。\n- 对同一次动作重试必须保留原请求编号和相同请求内容，平台返回原记录，不会再次创建或发布目标指令。同一编号改用其他联动标识会被拒绝。\n- 已结束的请求不会因为再次提交而重新执行。执行新的动作需要新的编号；超时但可能已发送时，应先核对目标状态再决定是否发起新动作。\n- 最终状态通知可能因来源设备离线或网络中断而无法接收，不应假定重连后会自动补齐所有通知，使用 `query` 查询原请求。\n- 目标设备必须按自己的远程调用请求编号去重，并如实返回执行结果。\n\n管理端可在指令日志中按“设备联动”来源筛选执行记录，查看目标指令的状态和联动详情。\n\n## 固件升级\n\n**按需配置：仅支持平台远程固件升级的设备需要实现。** 使用 `ota\u002Frequest\u002F{requestId}` 发布请求或进度，订阅 `ota\u002Fresponse\u002F+` 接收结果和任务。\n\n设备检查升级时，通过升级请求主题发送当前版本：\n\n```json\n{\n  \"action\": \"CHECK\",\n  \"currentVersion\": \"1.2.0\"\n}\n```\n\n平台使用相同请求编号返回无可用更新或存在可用更新。存在更新时，响应中会包含版本、下载地址、文件大小和校验信息。\n\n设备下载和安装过程中，应使用平台任务的同一请求编号上报进度：\n\n```json\n{\n  \"action\": \"PROGRESS\",\n  \"status\": \"UPDATING\",\n  \"progress\": 80\n}\n```\n\n允许的升级状态为 `DOWNLOADING`、`DOWNLOADED`、`VERIFIED`、`UPDATING`、`UPDATED` 和 `FAILED`。进度必须是零到一百之间的整数；失败时可附加 `errorMessage` 错误信息。\n\n## 相关文档\n\n- [接入概览](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access)\n- [连接认证](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-01-connection)\n- [主题总览](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-02-topics)\n- [设备注册](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access-03-registration)\n- [接入前准备](\u002Fcloud-platform\u002F04-third-party-integration\u002Fmqtt-device-access#接入前准备)\n",{"title":116,"description":3318},"J2P6NzUZ96tHP3ADfNG45ZtkCogRuv7OEmbn4cln6wU",[3327,3329],{"title":112,"path":113,"stem":114,"description":3328,"children":-1},"通过临时 MQTT 连接申请设备访问令牌，完成机器码登记和租户认领，并处理设备删除或令牌失效后的接入恢复。",{"title":130,"path":131,"stem":132,"description":3330,"children":-1},"设备接入、控制策略执行和运行状态采集的核心服务。管理员通过 Web 管理界面统一维护网络设备、串口设备、协议、区域和调度任务，并通过完善的日志审计模块监控运行状态。",1793265885080]