场景介绍
当设备需要设置不同的闪烁效果时,可以调用 Light 模块,例如,LED 灯能够设置灯颜色、灯亮和灯灭时长的闪烁效果。
说明
使用该功能依赖于硬件设备是否具有 LED 灯。
接口说明
灯模块主要提供的功能有:查询设备上灯的列表,查询某个灯设备支持的效果,打开和关闭灯设备。LightAgent 类开放能力如下,具体请查阅 API 参考文档。
接口名 | 描述 |
---|---|
getLightIdList() | 获取硬件设备上的灯列表。 |
isSupport(int) | 根据指定灯Id查询硬件设备是否有该灯。 |
isEffectSupport(int, String) | 查询指定的灯是否支持指定的闪烁效果。 |
turnOn(int, String) | 对指定的灯创建指定效果的一次性闪烁。 |
turnOn(int, LightEffect) | 对指定的灯创建自定义效果的一次性闪烁。 |
turnOn(String) | 对指定的灯创建指定效果的一次性闪烁。 |
turnOn(LightEffect) | 对指定的灯创建自定义效果的一次性闪烁。 |
turnOff(int) | 关闭指定的灯。 |
turnOff() | 关闭指定的灯。 |
开发步骤
- 查询硬件设备上灯的列表。
- 查询指定的灯是否支持指定的闪烁效果。
- 创建不同的闪烁效果。
- 关闭指定的灯。
private LightAgent lightAgent = new LightAgent();
@Override
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_light_layout);
// ...
// 查询硬件设备上的灯列表
List<Integer> myLightList = lightAgent.getLightIdList();
if (myLightList.isEmpty()) {
return;
}
int lightId = myLightList.get(0);
// 查询指定的灯是否支持指定的闪烁效果
boolean isSupport = lightAgent.isEffectSupport(lightId, LightEffect.LIGHT_ID_KEYBOARD);
// 创建指定效果的一次性闪烁
boolean turnOnResult = lightAgent.turnOn(lightId, LightEffect.LIGHT_ID_KEYBOARD);
// 创建自定义效果的一次性闪烁
LightBrightness lightBrightness = new LightBrightness(255, 255, 255);
LightEffect lightEffect = new LightEffect(lightBrightness, 1000, 1000);
boolean turnOnEffectResult = lightAgent.turnOn(lightId, lightEffect);
// 关闭指定的灯
boolean turnOffResult = lightAgent.turnOff(lightId);
}