设备群组

设备群组 是一组具有相同功能设备的集合，让大量设备可以被视作一个整体进行管理和控制，例如开启、关闭、定时任务等。群组化的管理方式，实现了更加方便的设备组织和调度方式，提高操作效率，并降低管理成本。

场景示例

商业照明场景中，因为设备数量普遍较高，需要对大量的灯进行模块化管理和控制。

您可以将商业大楼中的所有灯进行编号，再依据建筑结构和灯具类型等因素将灯分组。例如，所有同种类，同楼层的灯可被分为一个灯组，每个灯组包含若干个灯。通过一次的操作，可实现：

• 统一打开或关闭灯组的灯
• 调整灯组的亮度
• 单独控制每个灯组

业务流程

具体的使用流程如下：

```mermaid sequenceDiagram autonumber participant 开发者应用 participant 云端 participant 设备 开发者应用 ->> 云端: 创建群组 activate 开发者应用 activate 云端 云端 -) 设备: (异步)设备加群组操作 activate 设备 设备 --) 云端: (异步) -->> 开发者应用: 创建成功 deactivate 云端 deactivate 开发者应用 开发者应用 ->> 云端: -->> 开发者应用: 返回设备加入群组进度 deactivate 云端 deactivate 开发者应用 开发者应用 ->> 云端: -->> 开发者应用: 返回群组属性 deactivate 云端 deactivate 开发者应用 开发者应用 ->> 云端: -->> 开发者应用: 下发返回 deactivate 开发者应用 activate 设备 云端 ->> 设备: -->> 云端: 下发成功 deactivate 设备 deactivate 云端 ```

名词解释

API 列表

常用 API 的使用案例如下：

• 创建群组：将同一工厂中的彩灯设备创建为群组。
• 添加设备：将新安装的彩灯设备加入群组。
• 删除设备：将老旧的彩灯设备从群组中删除。
• 下发群组属性：给群组下发关闭彩灯的指令，群组下的设备均会接受该控制指令，达到统一关闭彩灯的效果。

使用限制

其他说明

• 设备群组 2.0 API 由于其历史原因，目前已不推荐使用，新接入用户推荐使用 设备群组 2.1 API。
• 设备群组 2.1 API 完全覆盖了设备群组 2.0 API 的能力，用户在设备群组 2.0 API 创建的群组在设备群组 2.1 API 仍然可以使用。