灯的APP免开发解决方案

更新时间：2018-11-15 00:13:06

方案简介

为让智能灯的设备开发者更方便地将APP和设备结合，更容易地实现智能灯的商业化，平台为智能灯提供了一整套免开发的APP标准界面。开发者仅需关注设备端的开发，完全无需任何云端、APP开发，即可实现demo演示或商业化。
搭配平台提供的公版APP，灯的界面如下，基本功能包括：

1. 白灯的亮度和色温调节
2. 彩灯的颜色、亮度和饱和度调节
3. 情景模式（如晚安模式下，颜色昏暗），支持开发者预设的默认情景，也支持用户自定义扩展情景
4. 定时，支持云端定时或本地定时

功能定义

需要在控制台创建产品，选择“灯”这个品类，并选择以下标准功能：

无论白灯与彩灯都应包括HSVColor，Brightness。如果白灯不支持冷暖调节，则无需添加ColorTemperature。

界面逻辑

由于灯的界面较复杂，以下将详细描述灯的界面和设备功能之间的逻辑，有助于设备开发。

白灯模式

• 初次使用白灯模式或者从彩灯模式切换到白灯模式，会set一个Brightness = 50，作为初始值，并set 一个属于白灯特有的HSVColor 用于显示app里灯的颜色；

• 白灯模式下的HSVColor对实体灯是没有实际意义的，只用于app上灯的冷暖以及亮度的显示。白灯模式下只有Brightenss和ColorTemperture存在实际意义。

• 白灯模式的亮度Brightness 依然是1-100，但是不存在换算关系。

• 每调节Brightness 或ColorTemperture 都会转换成对应的HSVColor 并set到属性里。在白灯模式下开发者不用在意这个属性。

彩灯模式

• 初次使用或者从白灯模式切换到彩光模式，会set一个Brigtness = 0 和一个HSVColor的初始值。此模式下Brightness只是作为白灯与彩灯的标识符，并没有实际作用；

• 彩光模式的色调、饱和度 、亮度 对应的分别是H（Hue）S（Saturation）V（Value），各值的范围如下：
  Hue：0-360 与实际灯的是一一对应的
  Saturation：0-100 与实际灯的是一一对应的
  Value：20-100 因为实际调节灯的亮度不会变成0，所以在app上调节的范围是1-100。由于app上灯的显示 Value 值过小的话会变成黑色，这里设置的对应关系如下：

情景模式

灯的标准界面中，一共支持8中情景，其中优先展示标准属性“工作模式”中的6个标准情景，其他为自定义情景，即：消费者可以自己为情景设定跑马灯的颜色和速度。
如果您希望修改情景的名称，可以在“人机交互”“多语言管理”中，修改枚举值的名称。
如果您希望提供更多的自定义情景，可以在功能定义中，手动删除几个枚举值即可，不足8个的，界面上都将以“自定义情景”填充，如下图：

逻辑图示

定时

可选择云端定时 和 本地定时。如果功能定义中添加了“本地定时”的标准属性，页面上将默认实现本地定时功能；如果功能定义中没有添加，则默认云端定时。

• 云端定时：用户设置定时后，由云端保存该定时任务，并在时间到达时，由云端给设备下发指令，实现定时任务。优点是设备端无需关注复杂的定时逻辑，仅需实现基本设备功能。缺点是在弱网或断网时，无法执行该定时任务。

• 本地定时：用户设置定时后，由设备端保存该定时任务，并在时间到达时，设备自己执行该指令。优点是可以在弱网或断网情况下，设备也能执行定时任务；缺点是设备端需自行实现定时逻辑。本地定时功能开发实践