Device Group

A device group is a collection of devices with the same features, allowing users to manage and control a large number of devices as a whole. For example, turn devices on or off, and create scheduled tasks. Group management makes it easier for you to organize and dispatch devices in a more efficient and cost-effective way.

Scenario example

In commercial lighting scenarios, you need to implement modularized management and control of many lights.

You can number all the lights in a commercial building and group them based on the building structure and light type. For example, all lights of the same type and on the same floor can be divided into a light group, and each light group contains several lights. With just a single tap, users can:

• Turn on or off all lights in the same group.
• Adjust the brightness of a light group.
• Control each light group separately.

How it works

The following diagram describes how it works.

Terms

API list

The APIs often apply to the following scenarios.

• Create a group: Create a group of colored lights in a factory.
• Add devices: Add newly installed colored lights to the same group.
• Delete devices: Delete old colored lights from the group.
• Send group properties: Send the group an instruction to turn off colored lights. Then, all devices in the group will receive the control instruction and go off accordingly.

Limitations

Additional notes

• The Device Group 2.0 APIs are no longer recommended for historical reasons. New users are recommended to use the Device Group 2.1 APIs.
• Device Group 2.1 APIs completely cover the capabilities offered by Device Group 2.0 APIs, so groups created by users in Device Group 2.0 APIs are still available in Device Group 2.1 APIs.