如何基于SDK快速开发一款IoT App控制智能灯泡（Android版）
对于现在上班打工族来说，当你带着惺忪的双眼，背着沉重的电脑包，爬着长长的楼梯，回到租的房屋，一开门，乌七八黑，顿时片刻的孤独席卷而来，奈何还需要用手沿着冰冷的墙壁，去摸索着开关。一开灯，刺眼的光芒射进眼球里，本来就沉重的心，又浇了一壶冰水。时光机往后拨一下，当你晚上回家，打开门的时候，一束温暖的灯光，伴随着门的打开流露出来，有点像小学课本里，游子在家门不远处看到母亲打着灯笼的光若隐若散。时光机回到现在，对于新世纪的程序员，我们艰巨着改变世界的重任，实现一款智能灯APP，改变大家对灯的认识是非常重要的。比如早上起床，伴随着闹钟，冷光灯亮起，走到厨房，自动启动照明，晚上回家，暖光在开门前就已经亮起。
那么如何实现一款智能灯APP呢？首先先了解下智能灯的基础功能
智能灯APP基础功能
智能定时功能
- 可以按照日、周进行设计定时器，可以实现单次，循环定时，可以对分组进行设置定时。
远程控制功能
- 通过家用无线路由器组成的局域网与其他终端设备（手机、平板等）进行通讯，还可以远程遥控灯光操作，实现对灯光的开，关，调光，场景，彩光模式等控制。
色彩调节功能
- 通过色彩调节功能，可以实现16777216 种颜色的调节。
地理围栏功能
- 智能灯控APP可以为用户实现离家和到家模式。
智能音乐灯功能
- 可以通过手机音乐和灯结合在一起，实现灯随着音乐有节律的闪烁。
智能场景功能
- 通过专家精心调优出四大场景功能，可以实现柔光模式、缤纷模式、炫彩模式、斑斓模式。
智能灯应用场景
办公场景
- 针对办公场景，智能灯具有白光调节模式，还拥有阅读模式的场景可以选择
客厅餐厅会客日常场景
- 可以采用休闲模式，调节气氛。
客厅——卧室场景
- 卧室场景推荐使用暖光模式
起床唤醒场景
- 可以通过设置智能定时实现起床播放音乐，并唤醒音乐灯。
打造智能灯如何快速实现？
准备工作
注册开发者账号
前往 涂鸦智能开发平台 注册开发者账号、创建产品、创建功能点等，具体流程请参考接入流程
创建 SDK 应用
在涂鸦 IoT 平台中 “App 工作台” 中点击 “App SDK”，点击“创建 App”。
填写 App 相关信息，点击确认。
- 应用名称：填写您的 App 名称。
- iOS 应用包名：填写您的 iOS App 包名（建议格式：com.xxxxx.xxxxx)。
- 安卓应用包名：填写您的安卓 App 包名（两者可以保持一致，也可以不一致）。
- 渠道标识符：不是必填项，如果不填写，系统会根据包名自动生成。
您可以根据实际需求选择需要的选择方案，支持多选，然后根据 Podfile 和 Gradle 进行 SDK 的集成。
点击获取密码，获取 SDK 的 AppKey，AppSecret，安全图片等信息。
集成 Home SDK
创建工程
在 Android Studio 中新建工程。
配置 build.gradle
build.gradle 文件里添加集成准备中下载的 dependencies 依赖库。
android {
defaultConfig {
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
packagingOptions {
pickFirst 'lib/*/libc++_shared.so' // 多个aar存在此so，需要选择第一个
}
}
dependencies {
implementation 'com.alibaba:fastjson:1.1.67.android'
implementation 'com.squareup.okhttp3:okhttp-urlconnection:3.14.9'
// Tuya Home 最新稳定版：
implementation 'com.tuya.smart:tuyasmart:3.20.0'
}
在根目录的 build.gradle 文件中增加 jcenter() 仓库
repositories {
jcenter()
}
[!TIP]
- 涂鸦智能 3.10.0 之前的版本的 sdk 默认只支持 armeabi-v7a，
- 3.11.0 版本后已经将 armeabi-v7a、arm64-v8a 集成进 sdk，请将本地手动放入的 sdk 的相关 so 库移除，使用 sdk 中提供的。
- 如果集成新版本 so 库。请移除之前老版本手动集成的库，防止冲突或者代码版本不一致导致的问题
- 如有其他平台需要可前往 GitHub 获取。
集成安全图片
点击 "下载安全图片" ——"安全图片下载" 下载安全图片。
在集成准备中点击“下载安全图片”。将下载的安全图片命名为 “t_s.bmp”，放置到工程目录的 assets 文件夹下。
设置 Appkey 和 AppSecret
在 AndroidManifest.xml 文件里配置 appkey 和 appSecret，在配置相应的权限等
混淆配置
在 proguard-rules.pro 文件配置相应混淆配置
#fastJson
-keep class com.alibaba.fastjson.**{*;}
-dontwarn com.alibaba.fastjson.**
#mqtt
-keep class com.tuya.smart.mqttclient.mqttv3.** { *; }
-dontwarn com.tuya.smart.mqttclient.mqttv3.**
#OkHttp3
-keep class okhttp3.** { *; }
-keep interface okhttp3.** { *; }
-dontwarn okhttp3.**
-keep class okio.** { *; }
-dontwarn okio.**
-keep class com.tuya.**{*;}
-dontwarn com.tuya.**
初始化 SDK
描述
用于初始化 SDK，请在 Application 中初始化 SDK，确保所有进程都能初始化。
示例代码
public class TuyaSmartApp extends Application {
@Override
public void onCreate() {
super.onCreate();
TuyaHomeSdk.init(this);
}
}
appId 和 appSecret 需要配置 AndroidManifest.xml 文件里，也可以在初始化代码里初始化。
TuyaHomeSdk.init(Application application, String appkey, String appSerect)
注销涂鸦智能云连接
在退出应用的时候调用以下接口注销掉。
TuyaHomeSdk.onDestroy();
调试开关
在 debug 模式下可以开启 SDK 的日志开关，查看更多的日志信息，帮助快速定位问题。在 release 模式下建议关闭日志开关。
TuyaHomeSdk.setDebugMode(true);
集成照明控制SDK
在接入 照明控制 SDK 之前，您可以先了解一下 照明灯的DEMO，需要把DEMO跑起来，登陆成功之后，在进行下列操作，照明控制 SDK 需要依赖 Home SDK 其中的一部分，下面的文档也会介绍到依赖的这一部分。
依赖说明
// homesdk 依赖，注意，必须使用大于等于此版本的SDK
implementation 'com.tuya.smart:tuyasmart:3.20.0'
// 控制SDK依赖
implementation 'com.tuya.smart:tuyasmart-centralcontrol:1.0.2'
需要注意的是，tuyasmart-centralcontrol使用了kotlin编译，需要引入kotlin库确保其正常使用。
项目中已引入kotlin的可忽略下面的配置。
kotlin接入
在根目录的build.gradle中引入kotlin插件的依赖：
buildscript {
ext.kotlin_version = '1.3.72'
dependencies {
...
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
}
在app的build.gradle中引入kotlin插件和kotlin包：
apply plugin: 'kotlin-android'
dependencies {
implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
}
标准指令说明
使用标准指令之前
未使用标准控制指令时，设备控制 一般使用这种方式：
ITuyaDevice mDevice = TuyaHomeSdk.newDeviceInstance(String devId);
// 监听控制结果
mDevice.registerDevListener(new IDevListener() {
@Override
public void onDpUpdate(String devId, String dpStr) {
}
@Override
public void onRemoved(String devId) {
}
@Override
public void onStatusChanged(String devId, boolean online) {
}
@Override
public void onNetworkStatusChanged(String devId, boolean status) {
}
@Override
public void onDevInfoUpdate(String devId) {
}
});
mDevice.publishDps("{\"101\": true}", new IResultCallback() {
@Override
public void onError(String code, String error) {
Toast.makeText(mContext, "开灯失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onSuccess() {
Toast.makeText(mContext, "开灯成功", Toast.LENGTH_SHORT).show();
}
});
这种方式控制时，会发送dpId，如101、102之类的给设备来控制。其中101就是这个设备定义的开关dpId。
这么做的缺点是，如果另一个设备也有开关功能，但是不是101控制开关，你就需要传入不同的参数来控制。而当n个设备都有开关功能，但是却dpId都不同，就要写非常多的适配逻辑。
为了解决同一个功能定义的id不同的问题，引入了标准指令的概念。
判断当前产品是否支持标准指令
根据产品 id 判断当前产品是否支持标准指令。
使用标准指令需要判断当前设备是否支持标准指令控制，不支持的设备不可以使用该控制方式，只能使用之前的接口控制。
示例代码：
boolean isStandard = TuyaHomeSdk.getDataInstance().isStandardProduct("your_product_id");
其中的 productId 是产品 id，可从 DeviceBean 中获取。
使用标准指令之后
什么是标准指令？
标准指令就是特定功能的标准编号。如照明类设备的开灯功能，其标准指令一定是"switch_led"。发送控制指令switch_led，一定可以控制照明设备的开关。
在集成了此SDK之后，调用方式变化如下：
ITuyaDevice mDevice = TuyaHomeSdk.newDeviceInstance(String devId);
// 注意：这里方法是registerDeviceListener，注册的 Listener 是 IDeviceListener
tuyaDevice.registerDeviceListener(new IDeviceListener() {
@Override
public void onDpUpdate(String devId, Map dpCodeMap) {
}
@Override
public void onRemoved(String devId) {
}
@Override
public void onStatusChanged(String devId, boolean online) {
}
@Override
public void onNetworkStatusChanged(String devId, boolean status) {
}
@Override
public void onDevInfoUpdate(String devId) {
}
});
HashMap dpCodeMap = new HashMap<>();
dpCodeMap.put("switch_led", true);
// 发送标准指令
tuyaDevice.publishCommands(dpCodeMap, new IResultCallback() {
@Override
public void onError(String code, String error) {
Toast.makeText(mContext, "开灯失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onSuccess() {
Toast.makeText(mContext, "开灯成功", Toast.LENGTH_SHORT).show();
}
});
注意：标准指令使用方法registerDeviceListener注册监听， 非标准是registerDevListener
值得注意的是，目前不是所有设备都支持标准指令控制，后文会说明如何判断该设备是否支持标准指令控制。
如果不支持的设备，而又必须使用标准控制，需要联系涂鸦适配。
标准指令文档
所有标准指令都可以在涂鸦智能平台查找到：
灯具(dj) 标准指令集
开关-插座-排插(kg,cz,pc) 标准指令集
场景开关(cjkg) 标准指令集
等等。
有了tuyaDevice.publishCommands方法和上面的指令，就可以发送标准指令来控制设备。
品类说明
涂鸦 iot 平台上有很多品类的iot设备，不同的品类在涂鸦平台上都有固定的编号（category）。
开发者文档上体现在每个品类指令集的标题上，如 灯具(dj) 标准指令集 中dj，dj就是灯具的category值。
使用 category 字段可以判断当前设备是什么产品，来展示不同的面板。
品类列表
此表格包含大多数支持的品类，具体可参见 IoT 平台。
| 品类 | category |
| 开关 | kg |
| 插座 | cz |
| 排插 | pc |
| 场景开关 | cjkg |
| 窗帘开关 | clkg |
| 灯具 | dj |
| 扫地机 | sd |
| 电茶壶 | bh |
| 香薰机 | xxj |
| 加湿器 | jsq |
| 空调 | kt |
| 空气净化器 | kj |
| 晾衣架 | lyj |
| 取暖器 | qn |
| 空调控制器 | ktkzq |
| 窗帘 | cl |
| 温控器 | wk |
| 风扇 | fs |
| 门磁传感器 | mcs |
| 水浸传感器 | sj |
| 温湿度传感器 | wsdcg |
| PIR传感器 | pir |
| 震动传感器 | zd |
| 压力传感器 | ylcg |
| 亮度传感器 | ldcg |
| 烟雾报警传感器 | ywbj |
| 声光报警传感器 | sgbj |
| CO2传感器 | co2bj |
| CO传感器 | cobj |
| pm2.5传感器 | pm2.5 |
| 燃气报警传感器 | rqbj |
| sos传感器 | sos |
| 门锁 | ms |
获取产品的品类值（category）
通过产品 id 获取产品的品类值。
示例代码：
String category = TuyaHomeSdk.getDataInstance().getStandardProductConfig("your_product_id").category;
照明设备控制
涂鸦照明设备同时存在v1和v2新旧两种固件，即使使用了标准指令，也需要开发两套控制逻辑。
因此对照明设备功能进行封装，封装了灯具设备的开关、工作模式切换、亮度控制、冷暖控制、彩光控制和四种情景模式的控制。
快速使用
首先，创建ITuyaLightDevice对象，灯相关的方法均封装在此方法中。
ITuyaLightDevice lightDevice = new TuyaLightDevice(String devId);
该对象封装了灯的所有dp点，包括控制指令的下发和上报。
这里提供几个简单的调用示例：
// 创建lightDevice
ITuyaLightDevice lightDevice = new TuyaLightDevice("vdevo159793004250542");
// 注册监听
lightDevice.registerLightListener(new ILightListener() {
@Override
public void onDpUpdate(LightDataPoint dataPoint) { // 返回LightDataPoint，包含灯所有功能点的值
Log.i("test_light", "onDpUpdate:" + dataPoint);
}
@Override
public void onRemoved() {
Log.i("test_light", "onRemoved");
}
@Override
public void onStatusChanged(boolean status) {
Log.i("test_light", "onDpUpdate:" + status);
}
@Override
public void onNetworkStatusChanged(boolean status) {
Log.i("test_light", "onDpUpdate:" + status);
}
@Override
public void onDevInfoUpdate() {
Log.i("test_light", "onDevInfoUpdate:");
}
});
// 开灯
lightDevice.powerSwitch(true, new IResultCallback() {
@Override
public void onError(String code, String error) {
Log.i("test_light", "powerSwitch onError:" + code + error);
}
@Override
public void onSuccess() {
Log.i("test_light", "powerSwitch onSuccess:");
}
});
// 晚安场景
lightDevice.scene(LightScene.SCENE_GOODNIGHT, new IResultCallback() {
@Override
public void onError(String code, String error) {
Log.i("test_light", "scene onError:" + code + error);
}
@Override
public void onSuccess() {
Log.i("test_light", "scene onSuccess:");
}
});
// 设置颜色
lightDevice.colorHSV(100, 100, 100, new IResultCallback() {
@Override
public void onError(String code, String error) {
Log.i("test_light", "colorHSV onError:" + code + error);
}
@Override
public void onSuccess() {
Log.i("test_light", "colorHSV onSuccess:");
}
});
更多API请参考下面的文档。
注册监听
方法说明
/**
* 注册监听
*/
void registerLightListener(ILightListener listener);
其中，ILightListener回调如下：
public interface ILightListener {
/**
* 监听照明设备dp点变化
*
* @param dataPoint 该灯具所有dp点的状态
*/
void onDpUpdate(LightDataPoint dataPoint);
/**
* 设备移除
*/
void onRemoved();
/**
* 设备上下线
*/
void onStatusChanged(boolean online);
/**
* 网络状态
*/
void onNetworkStatusChanged(boolean status);
/**
* 设备信息更新例如name之类的
*/
void onDevInfoUpdate();
}
参数说明
值得说明的是LightDataPoint对象，该对象封装了当前设备所有功能点。当功能点发生变化时，将会回调。每次回调的都会是完整的对象。
以下是该对象参数的具体含义：
public class LightDataPoint {
/**
* 开关
*/
public boolean powerSwitch;
/**
* 工作模式。
*
* MODE_WHITE为白光模式；
* MODE_COLOUR为彩光模式；
* MODE_SCENE为情景模式；
*/
public LightMode workMode;
/**
* 亮度百分比，从0到100
*/
public int brightness;
/**
* 色温百分比，从0到100
*/
public int colorTemperature;
/**
* 颜色值，HSV色彩空间.
*
* 其中H为色调，取值范围0-360；
* 其中S为饱和度，取值范围0-100；
* 其中V为明度，取值范围0-100；
*/
public LightColourData colorHSV;
/**
* 彩灯情景。
*
* SCENE_GOODNIGHT为晚安情景；
* SCENE_WORK为工作情景；
* SCENE_READ为阅读情景；
* SCENE_CASUAL为休闲情景；
*/
public LightScene scene;
}
获取当前灯的类型
灯共分为一路灯（仅有白光）、二路灯（白光+冷暖控制）、三路灯（仅有彩光模式）、四路灯（白光+彩光）、五路灯（白光+彩光+冷暖）。
这5种灯具在功能定义上有所区别，在开发相应的UI和控制时有所区别。
该方法可获取当前灯的类型。
/**
* 获取当前是几路灯
*
* @return {@link LightType}
*/
LightType lightType();
其中LightType中定义的类型有：
/**
* 白光灯，dpCode：bright_value
*/
TYPE_1,
/**
* 白光+冷暖，dpCode：bright_value + temp_value
*/
TYPE_2,
/**
* RGB，dpCode：colour_data
*/
TYPE_3,
/**
* 白光+RGB，dpCode：bright_value + colour_data
*/
TYPE_4,
/**
* 白光+冷暖+RGB，dpCode：bright_value + temp_value + colour_data
*/
TYPE_5
获取当前设备所有功能的值
打开一个设备面板时，需要获取所有功能点值来展示。可通过此接口获取上面提到的LightDataPoint对象。
/**
* 获取灯所有功能点的值
*/
LightDataPoint getLightDataPoint();
开关
控制灯的开关
方法说明
/**
* 开灯 or 关灯
*
* @param status true or false
* @param resultCallback callback
*/
void powerSwitch(boolean status, IResultCallback resultCallback);
参数说明
| 字段 | 含义 |
| status | true为开 |
| resultCallback | 仅表示此次发送指令成功or失败，真正控制成功需要识别ILightListener中的dp变化 |
工作模式
控制工作模式的切换。
方法说明
/**
* 切换工作模式
*
* @param mode 工作模式
* @param resultCallback callback
*/
void workMode(LightMode mode, IResultCallback resultCallback);
参数说明
| 字段 | 含义 |
| mode | 工作模式，其值有MODE_WHITE（白光）, MODE_COLOUR（彩光）, MODE_SCENE（情景模式） |
| resultCallback | 仅表示此次发送指令成功or失败，真正控制成功需要识别ILightListener中的dp变化 |
调用示例
如切换到彩光模式：
lightDevice.workMode(LightMode.MODE_COLOUR, new IResultCallback() {
@Override
public void onError(String code, String error) {
Log.i("test_light", "workMode onError:" + code + error);
}
@Override
public void onSuccess() {
Log.i("test_light", "workMode onSuccess");
}
});
注意：部分灯具必须切换到对应的工作模式才可以控制，比如控制彩光，必须先切换到彩光模式才可以发颜色的值。
亮度
控制亮度
方法说明
/**
* 亮度控制。
*
* @param status 亮度的百分比，取值范围0-100
* @param resultCallback callback
*/
void brightness(int status, IResultCallback resultCallback);
参数说明
| 字段 | 含义 |
| status | 亮度的百分比 |
| resultCallback | 仅表示此次发送指令成功or失败，真正控制成功需要识别ILightListener中的dp变化 |
冷暖
控制灯的冷暖值
方法说明
/**
* 色温控制
*
* @param status 色温的百分比，取值范围0-100
* @param resultCallback callback
*/
void colorTemperature(int status, IResultCallback resultCallback);
参数说明
| 字段 | 含义 |
| status | 色温的百分比 |
| resultCallback | 仅表示此次发送指令成功or失败，真正控制成功需要识别ILightListener中的dp变化 |
彩光
控制彩色灯的颜色
方法说明
/**
* 设置彩灯的颜色
*
* @param hue 色调 （范围：0-360）
* @param saturation 饱和度（范围：0-100）
* @param value 明度（范围：0-100）
* @param resultCallback callback
*/
void colorHSV(int hue, int saturation, int value, IResultCallback resultCallback);
情景
切换彩灯的情景模式，目前共有四种模式：
LightScene.SCENE_GOODNIGHT为晚安情景；
LightScene.SCENE_WORK为工作情景；
LightScene.SCENE_READ为阅读情景；
LightScene.SCENE_CASUAL为休闲情景；
方法说明
/**
* @param lightScene {@link LightScene}
* @param resultCallback callback
*/
void scene(LightScene lightScene, IResultCallback resultCallback);
附录：灯具所有标准功能点
| code | 名称 | 数据类型 | 取值描述 | 说明 |
| switch_led | 开关 | Boolean | {} | |
| work_mode | 模式 | Enum | {"range":["white","colour","scene","music","scene_1","scene_2","scene_3","scene_4"]} | |
| bright_value | 亮度 | Integer | {"min":25,"scale":0,"unit":"","max":255,"step":1} | |
| bright_value_v2 | 亮度 | Integer | {"min":10,"scale":0,"unit":"","max":1000,"step":1} | |
| temp_value | 冷暖 | Integer | {"min":0,"scale":0,"unit":"","max":255,"step":1} | |
| temp_value_v2 | 冷暖 | Integer | {"min":0,"scale":0,"unit":"","max":1000,"step":1} | |
| colour_data | 彩光模式数 | Json | {} | |
| colour_data_v2 | 彩光模式数 | Json | {} | |
| scene_data | 情景模式数 | Json | {} | |
| scene_data_v2 | 情景模式数 | Json | {} | |
| flash_scene_1 | 柔光模式 | Json | {} | |
| flash_scene_2 | 缤纷模式 | Json | {} | |
| flash_scene_3 | 炫彩模式 | Json | {} | |
| flash_scene_4 | 斑斓模式 | Json | {} | |
| music_data | 音乐灯模式控制 | Json | {} | |
| control_data | 调节dp控制 | Json | {} | |
| countdown_1 | 倒计时 | Integer | {"unit":"","min":0,"max":86400,"scale":0,"step":1} | |
| scene_select | 场景选择 | Enum | {"range":["1","2","3","4","5"]} | 老版本 |
| switch_health_read | 健康阅读开关 | Boolean | {} | 老版本 |
| read_time | 健康阅读-阅读时间设置 | Integer | {"unit":"minute","min":1,"max":60,"scale":0,"step":1} | 老版本 |
| rest_time | 健康阅读-休息时间设置 | Integer | {"unit":"minute","min":1,"max":60,"scale":0,"step":1} | 老版本 |