设备能力模型
设备能力模型
是什么
设备是否支持某项预览、对讲、云台或配置，以设备能力为准，而不是以平台接口列表为准。新能力按域组织，入口见 设备能力。遗留 listDeviceAbility 等所用的 I/II 类能力码见 设备能力集与能力开关；物模型 device.property.* / device.service.invoke 与能力集是两套目录，调用前分别查能力页与 API 说明。
为什么这样设计
同一接口在不同设备上结果不同。轻应用组件写明：对讲、云台、光学变焦是否出现，取决于设备能力或取流结果中的 ability。
关系
调用配置或动作之前，先确认该设备具备对应能力。移动应用开发同时指出：新出厂设备的绑定可能无法只靠 bindDevice 完成，需要客户端 SDK。这是绑定路径的限制，不是某条能力字段的取值。
物模型接口与设备能力是两套目录，不要把物模型字段当成设备能力集的同义词。对照关系见 从旧接口迁移到设备能力 与 遗留接口，勿自行编造映射。
型号 productId（可选）
调用 device.capability.list、device.property.get / set、device.service.invoke 时，已绑定设备传 deviceId 即可。productId（产品型号）非必填；未绑定前可按型号列举能力。若同时传了 deviceId 与 productId，以设备为准；传了 productId 且与设备实际型号不一致 → 错误码 DV2009。各能力叶页与 设备能力 API 请求表中有同一字段说明。
常见误区
文档里有某个配置接口，就认为所有已绑定设备都可以调用。