关于物联网:如何基于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，在配置相应的权限等

<meta-data
android:name="TUYA_SMART_APPKEY"
android:value="利用 Appkey" />
<meta-data
android:name="TUYA_SMART_SECRET"
android:value="利用密钥 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<String, Object> 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<String, Object> 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）

通过产品 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;
    /**
     * 工作模式。* <p>
     * MODE_WHITE 为白光模式；* MODE_COLOUR 为彩光模式；* MODE_SCENE 为情景模式；*/
    public LightMode workMode;

    /**
     * 亮度百分比，从 0 到 100
     */
    public int brightness;

    /**
     * 色温百分比，从 0 到 100
     */
    public int colorTemperature;

    /**
     * 色彩值，HSV 色调空间.
     * <p>
     * 其中 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_C,
/**
 * 白光 + 冷暖，dpCode：bright_value + temp_value
 */
TYPE_CW,
/**
 * RGB，dpCode：colour_data
 */
TYPE_RGB,
/**
 * 白光 +RGB，dpCode：bright_value + colour_data
 */
TYPE_RGBC,
/**
 * 白光 + 冷暖 +RGB，dpCode：bright_value + temp_value + colour_data
 */
TYPE_RGBCW

获取以后设施所有性能的值

关上一个设施面板时，须要获取所有性能点值来展现。可通过此接口获取下面提到的 LightDataPoint 对象。

/**
 * 获取灯所有性能点的值
 */
LightDataPoint getLightDataPoint();

开关

管制灯的开关

办法阐明

/**
 * 开灯 or 关灯
 *
 * @param status         true or false
 * @param resultCallback callback
 */
void powerSwitch(boolean status, IResultCallback resultCallback);

参数阐明

工作模式

管制工作模式的切换。

办法阐明

/**
 * 切换工作模式
 *
 * @param mode           工作模式
 * @param resultCallback callback
 */
void workMode(LightMode mode, IResultCallback resultCallback);

参数阐明

调用示例

如切换到彩光模式：

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);

参数阐明

冷暖

管制灯的冷暖值

办法阐明

/**
 * 色温管制
 *
 * @param status         色温的百分比，取值范畴 0 -100
 * @param resultCallback callback
 */
void colorTemperature(int status, IResultCallback resultCallback);

参数阐明

彩光

管制黑白灯的色彩

办法阐明

/**
 * 设置彩灯的色彩
 *
 * @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 定时，须要进行规范 Code 本义成 Id 能力进行设置定时器，参考原有定时器

办法调用

/**
 * @param dpCodes  规范 DpCode 指令
 * @param devId    设施 ID
 */
Map<String, Object> convertCodeToIdMap(Map<String, Object> dpCodes, String devId);

示例代码

Map<String, Object> dps=TuyaHomeSdk.getDataInstance().getStandardConverter().convertCodeToIdMap(Map<String, Object> dpCodes, String devId);
TuyaTimerBuilder builder = new TuyaTimerBuilder.Builder()
        .taskName(mTaskName)
        .devId("efw9990wedsew")
        .deviceType(TimerDeviceTypeEnum.DEVICE)
        .actions(dps)  
        .loops("1100011")
        .aliasName("Test")
        .status(1)
        .appPush(true)
        .build();
TuyaHomeSdk.getTimerInstance().addTimer(builder, new IResultCallback() {
    @Override
    public void onSuccess() {}

    @Override
    public void onError(String errorCode, String errorMsg) {}});