检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后，才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
上报设备数据 接口功能 当直连设备（网关）有数据需要上报或者非直连设备上报数据到网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的pcDeviceId、pcRequstId和pcServiceId由SDK组装为消息的header；pcServic
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题：
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时，则启动内部业务流程，删除子设备。
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
开发者需要在设备添加成功后注册该设备的命令接收广播，广播主题为 “IOTA_TOPIC_SERVICE_CMD_RECEIVE/设备ID”，Agent Lite收到平台发往给设备的命令后会直接广播给该设备注册的广播处理函数。如果开发者不需要按设备进行分发，直接使用主题名即可，即“ IOTA_TOPIC_SERVICE_CMD_RECEIVE”。
开发中心没有设备分组和批量添加设备，怎么办？ 开发中心主要是用于调测的，调测不会接入大量设备，因此不提供批量注册设备功能。 开发中心也没有提供设备分组功能，但是可以调用API，在应用上做分组，详情请参见创建设备组API。 设备管理控制台中，包含设备分组管理和批量添加设备功能，您可在
选择“设备 > 所有设备”，在设备列表中，单击具体的设备进入到设备的详情页面，即可查看设备注册和接入时的基本信息，比如设备标识码，设备ID，接入协议等。如下图所示，点击“编辑”按钮，可以对部分信息进行修改。 用户也可通过调用修改设备信息接口修改设备的基本信息。 查看设备状态 在
上报设备数据 接口功能 当直连设备（网关）有数据需要上报或者非直连设备上报数据到网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId，requstId和serviceId由SDK组装为消息的header；servicePropert
DATATRANS_IE_DEVICEID 设备逻辑ID，在设备添加时由平台分配。 DATATRANS_IE_SERVICEID 服务ID。 DATATRANS_IE_METHOD 服务方法。 DATATRANS_IE_CMDCONTENT 命令内容。 示例 开发者注册广播接收器对设备命令接收结果进行相应的处理。
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支
HUB_RESULT_DEVICE_EXIST 1 NA 设备已存在。 HUB_RESULT_DEVICE_NOTEXIST 2 NA 设备不存在。 HUB_RESULT_DEVICE_FAILED 255 NA 执行失败。 示例 1 2 //开发者调用该接口进行设备添加 HubService
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);
修改设备信息 典型场景 第三方应用在物联网平台注册设备后，若设备的基本信息发生变更，也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 def modifyDeviceInfo(self
本示例为设备自带的温度传感器上报的温度大于80度时，平台自动下发命令关闭设备。 配置设备管理服务 在设备管理服务中创建产品模型、注册设备并设置设备联动规则，实现当设备上报特定数据时平台自动下发命令。 登录华为云官方网站，访问“设备管理服务”。 单击“立即使用”进入设备管理控制台。
接收设备命令 接口功能 调用设备命令接收接口来处理平台下发的控制命令。 接口描述 1 DataTransService.TOPIC_COMMAND_RECEIVE; 接口所属类 DataTransService 示例 开发者需要实现Agent Lite提供的观察者接口。 1
如何设置设备名称？ 在开发中心注册设备时，支持设置设备名称。 在设备接入和设备管理的控制台中注册设备时，不支持设置设备名称，您可在设备注册成功后，进入设备详情中新增/修改设备名称。 使用API注册/创建设备时，设备接入、设备管理和开发中心都支持在注册/创建设备时设置设备名称。 父主题：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
