title: Android SDK 开发指南 subtitle: Android SDK 开发指南 published: true

涂鸦智能Android SDK 接入指南

1.功能概述

涂鸦智能APP SDK提供了与硬件设备、涂鸦云通讯的接口封装，加速应用开发过程，主要包括了以下功能：

硬件设备相关（配网、控制、状态上报、定时任务、群组、固件升级、共享）
账户体系（手机号、邮箱的注册、登录、重置密码等通用的账户功能）
消息中心
意见反馈
涂鸦云HTTP API接口封装 (参见涂鸦云api调用）

2.集成准备

获取App ID和App Secret

开发平台上，在应用管理中新建一款应用，输入应用名称、应用包名、应用标示符等信息。创建成功后，即可获得App ID和Secret用于SDK开发。

3.集成SDK

3.1 集成准备

（1）创建工程

在Android Studio中建立你的工程。

（2）引入aar包

在工程中新建一个libs目录，将下载好的tuyasmart-xxxx.aar复制到该目录中（如下图所示，建立了一个名为tuyaTest的工程，并把aar包复制到libs目录下）。请前往GitHub获取涂鸦智能Android SDK

（3）build.gradle 配置

build.gradle 文件里添加如下配置

defaultConfig {
ndk {
abiFilters "armeabi-v7a","x86"
}

gradle
repositories {
flatDir {
dirs 'libs'
}
}
dependencies {
compile(name: ‘tuyasmart-xxx’, ext: ‘aar')
compile 'com.alibaba:fastjson:1.1.45.android'
compile 'com.squareup.okhttp3:okhttp-urlconnection:3.2.0'
compile 'de.greenrobot:eventbus:2.4.0'
compile 'io.reactivex:rxandroid:1.2.1'
compile 'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.1.0'

// removed from 1.13.13 
//compile 'org.eclipse.paho:org.eclipse.paho.android.service:1.1.1'
}


android {
lintOptions {
abortOnError false
disable 'InvalidPackage'
}

compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
packagingOptions {
exclude 'META-INF/LICENSE.txt'
exclude 'META-INF/NOTICE'
exclude 'META-INF/LICENSE'
exclude 'META-INF/NOTICE.txt'
exclude 'META-INF/INDEX.LIST'
exclude 'META-INF/services/javax.annotation.processing.Processor'
}
}

【注意事项】

涂鸦智能sdk默认只支持armeabi-v7a和x86架构的平台，如有其他平台需要可前往GitHub获取

（4）AndroidManifest.xml 设置

在AndroidManifest.xml文件里配置appkey和appSecret，在配置相应的权限等

<meta-data
android:name="TUYA_SMART_APPKEY"
android:value="应用id" />
<meta-data
android:name="TUYA_SMART_SECRET"
android:value="应用密钥" />

添加必要的权限支持
<!-- sdcard -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" android:required="false"/>
<!-- 网络 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK"android:required="false" />

<!-- Add the necessary service和receiver -->
<!-- Add from 1.13.13 which the com.tuya.smart.MqttService replaced the org.eclipse.paho.android.service.MqttService-->

<service android:name="com.tuya.smart.mqtt.MqttService"/>

<!-- Deprecated By 1.13.13
<service android:name="org.eclipse.paho.android.service.MqttService" />
-->

<receiver android:name="com.tuya.smart.android.base.broadcast.NetworkBroadcastReceiver">
<intent-filter>
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
</receiver>

<service
android:name="com.tuya.smart.android.hardware.service.GwBroadcastMonitorService"
android:exported="true"
android:label="UDPService"
android:process=":monitor">
<intent-filter>
<action android:name="tuya.intent.action.udp" />

<!-- Add from 1.9.9, which DevTransferService replaced the GwTransferService
-->

<category android:name="tuya" />
</intent-filter>
</service>
<service
android:name="com.tuya.smart.android.hardware.service.DevTransferService"
android:exported="true"
android:label="TCPService"
android:process=":transfer">
<intent-filter>
<action android:name="tuya.intent.action.tcp" />
<category android:name="tuya" />
</intent-filter>
</service>

<!-- Deprecated By 1.9.9
<service
android:name="com.tuya.smart.android.hardware.service.GwTransferService"
android:exported="true"
android:label="TCPService"
android:process=":transfer">
<intent-filter>
<action android:name="tuya.intent.action.tcp" />
<category android:name="tuya" />
</intent-filter>
</service>
-->

（5）混淆配置

在proguard-rules.pro文件配置相应混淆配置

#EventBus
-keep class de.greenrobot.event.**{*;}
-dontwarn de.greenrobot.event.**
-keepclassmembers class ** {
public void onEvent*(**);
}

#commons
-keep class org.apache.commons.**{*;}
-dontwarn org.apache.commons.**

#fastJson
-keep class com.alibaba.fastjson.**{*;}
-dontwarn com.alibaba.fastjson.**

#netty
-keep class io.netty.** { *; }
-dontwarn io.netty.**

#mqtt
-keep class org.eclipse.paho.client.mqttv3.** { *; }
-dontwarn org.eclipse.paho.client.mqttv3.**

#removed from 1.13.13
#-keep class org.eclipse.paho.android.service.** { *; }
#-dontwarn org.eclipse.paho.android.service.**

-dontwarn okio.**
-dontwarn rx.**
-dontwarn javax.annotation.**
-keep class com.squareup.okhttp.** { *; }
-keep interface com.squareup.okhttp.** { *; }
-keep class okio.** { *; }
-dontwarn com.squareup.okhttp.**

-keep class com.tuya.smart.**{*;}
-dontwarn com.tuya.smart.**

3.2 在代码中使用SDK功能

(1) Application中初始化涂鸦智能sdk。

【描述】

主要用于初始化EventBus、通信服务等组件。

【代码范例】

public class TuyaSmartApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        TuyaSdk.init(this);
    }
}

【注意事项】

appId和appSecret需要配置AndroidManifest.xml文件里，或者在build环境里配置，也可以在代码里写入。

(2) 注销涂鸦智能云连接

在退出应用或者退出登陆的时候调用以下接口注销掉。

TuyaUser.getDeviceInstance().onDestroy();

(3) 注册session失效监听

【描述】

Session由于可能存在用户修改密码、在长时间不操作（45天）等操作的情况下会失效掉，这时候需要退出应用，重新登陆获取Session。

【方法调用】

//session失效监听
TuyaSdk.setOnNeedLoginListener(INeedLoginListener needLoginListener);

【实现回调】

needLoginListener.onNeedLogin(Context context);

【代码范例】

public class TuyaSmartApp extends Application {

        @Override
        public void onCreate() {
            super.onCreate();
            //需要在application里面注册
  			  TuyaSdk.setOnNeedLoginListener(new INeedLoginListener() {
     		  @Override
      		  public void onNeedLogin(Context context) {

      		  }
    });

【注意事项】

一旦出现此类回调，请跳转到登陆页面，让用户重新登陆。

4.用户管理

4.1 用户手机验证码登陆

涂鸦智能提供手机验证码登陆体系。

(1)手机验证码登陆

【描述】

手机验证码登陆，支持国内手机验证码登陆。

【代码调用】

//获取手机验证码
* @param countryCode   国家区号
* @param phoneNumber   手机号码
TuyaUser.getUserInstance().getValidateCode(String countryCode, String phoneNumber, final IValidateCallback callback);
//手机验证码登陆
* @param countryCode 国家区号
* @param phone       电话
* @param code        验证码
* @param callback    登陆回调接口
TuyaUser.getUserInstance().loginWithPhone(String countryCode, String phone, String code, final ILoginCallback callback)

【代码范例】

//获取手机验证码
TuyaUser.getUserInstance().getValidateCode("86","13666666666", new IValidateCallback(){
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "获取验证码成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});
//手机验证码登陆
TuyaUser.getUserInstance().loginWithPhone("86", "13355555555", "123456", new ILoginCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "登录成功，用户名：" + TuyaUser.getUserInstance().getUser().getUsername(), Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, error, Toast.LENGTH_SHORT).show();
    }
});

4.2 用户手机密码登陆

涂鸦智能提供手机密码登陆体系。

(1)手机密码注册

【描述】

手机密码注册。支持国内外手机注册。

【方法调用】

//获取手机验证码
* @param countryCode   国家区号
* @param phoneNumber   手机号码
TuyaUser.getUserInstance().getValidateCode(String countryCode, String phoneNumber, final IValidateCallback callback);

//注册手机密码账户
* @param countryCode 国家区号
* @param phone       手机密码
* @param passwd      登陆密码
* @param callback    登陆回调接口
TuyaUser.getUserInstance().registerAccountWithPhone(final String countryCode, final String phone, final String passwd, final String code, final IRegisterCallback callback);

【代码范例】

//获取手机验证码
TuyaUser.getUserInstance().getValidateCode("86","13666666666", new IValidateCallback(){
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "获取验证码成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
 });
//注册手机密码账户
TuyaUser.getUserInstance().registerAccountWithPhone("86","13666666666","123456","124332", new IRegisterCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "注册成功", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

(2)手机密码登陆

【描述】

手机密码登陆。

【方法调用】

//手机密码登陆
* @param countryCode 国家区号
* @param phone       手机密码
* @param passwd      登陆密码
* @param callback    登陆回调接口
TuyaUser.getUserInstance().loginWithPhonePassword(String countryCode, String phone, String passwd, final ILoginCallback callback);

【代码范例】

//手机密码登陆
TuyaUser.getUserInstance().loginWithPhonePassword("86", "13666666666", "123456", new ILoginCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "登录成功，用户名：" + TuyaUser.getUserInstance().getUser().getUsername(), Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

(3)手机重置密码

【描述】

手机密码登陆重置密码。

【方法调用】

//获取手机验证码
* @param countryCode   国家区号
* @param phoneNumber   手机号码
TuyaUser.getUserInstance().getValidateCode(String countryCode, String phoneNumber, final IValidateCallback callback);

//重置密码
* @param countryCode 国家区号
* @param phone       手机号码
* @param code        手机验证码
* @param newPasswd   新密码
* @param callback    重置手机密码回调接口
TuyaUser.getUserInstance().resetPhonePassword(final String countryCode, final String phone, final String code, final String newPasswd, final IResetPasswordCallback callback);

【代码范例】

//手机获取验证码
TuyaUser.getUserInstance().getValidateCode("86", "13555555555", new IValidateCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "获取验证码成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});
//重置手机密码
TuyaUser.getUserInstance().resetPhonePassword("86", "13555555555", "123456", "123123", new IResetPasswordCallback(){
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "找回密码成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

4.3 用户邮箱密码登陆

涂鸦智能提供邮箱密码登陆体系。

(1) 用户邮箱密码注册

【描述】

用户邮箱密码注册。支持国内外邮箱注册。

【方法调用】

//邮箱注册获取验证码
/**
 * 注册获取邮箱验证码
 * @param email
 * @param callback
 */
void getRegisterEmailValidateCode(String countryCode, String email, IResultCallback callback);

//邮箱密码注册
* @param countryCode 国家区号
* @param email       邮箱账户
* @param passwd      登陆密码
* @param code			 验证码
* @param callback    邮箱注册回调接口
TuyaUser.getUserInstance().registerAccountWithEmail(final String countryCode, final String email, final String passwd, String code, final IRegisterCallback callback);

【代码范例】

//注册获取邮箱验证码
TuyaUser.getUserInstance().getRegisterEmailValidateCode("86","123456@123.com",new IResultCallback() {
            @Override
            public void onError(String code, String error) {
            }

            @Override
            public void onSuccess() {
            }
        } );
//邮箱密码注册
TuyaUser.getUserInstance().registerAccountWithEmail("86", "123456@123.com","123456","5723", new IRegisterCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "注册成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

【注意事项】

账户一旦注册到一个国家，目前数据无法迁移其他国家。

(2) 用户邮箱密码登陆

【描述】

用户邮箱密码登陆

【方法调用】

//邮箱密码登陆
* @param email  邮箱账户
* @param passwd 登陆密码
TuyaUser.getUserInstance().loginWithEmail(String countryCode, String email, String passwd, final ILoginCallback callback);

【代码范例】

//邮箱密码登陆
TuyaUser.getUserInstance().loginWithEmail("86", "123456@123.com", "123123", new ILoginCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "登录成功，用户名：").show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

(3) 用户邮箱重置密码

【描述】

用户邮箱重置密码

【方法调用】

//邮箱找回密码，获取验证码
* @param countryCode 国家区号
* @param email       邮箱账户
* @param callback    获取验证码回调接口
TuyaUser.getUserInstance().getEmailValidateCode(String countryCode, final String email, final IValidateCallback callback);

//邮箱重置密码
* @param countryCode 国家区号
* @param email     用户账户
* @param emailCode 邮箱验证码
* @param passwd    新密码
* @param callback  重置密码回调接口
TuyaUser.getUserInstance().resetEmailPassword(final String countryCode,final String email, final String emailCode, final String passwd, final IResetPasswordCallback callback);

【代码范例】

//获取邮箱验证码
TuyaUser.getUserInstance().getEmailValidateCode("86", "123456@123.com", new IValidateCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "获取验证码成功", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});
//重置密码
TuyaUser.getUserInstance().resetEmailPassword("86", "123456@123.com", "6725","123123", new IResetPasswordCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "找回密码成功", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

4.4 用户uid登陆体系

涂鸦智能提供uid登陆体系。如果客户自有用户体系，那么可以通过uid登陆体系，接入我们的sdk。

(1) 用户uid注册

【描述】

用户uid注册

【方法调用】

//用户uid注册
* @param countryCode 国家号码
* @param uid         用户uid 
* @param password    用户密码 建议使用客户体系用户下密码的hash值，这样可增加用户数据安全
* @param callback    uid 注册回调接口
TuyaUser.getUserInstance().registerAccountWithUid(String countryCode, String uid, String password, IRegisterCallback callback);

【代码范例】

//uid注册
TuyaUser.getUserInstance().registerAccountWithUid("86", "1234","123456", new IRegisterCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "UID注册成功", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

(2) 用户uid登陆

【描述】

用户uid登陆

【方法调用】

//uid 登陆
* @param countryCode 国家号码
* @param uid         用户uid
* @param passwd      用户密码
* @param callback    uid 登陆回调接口
TuyaUser.getUserInstance().loginWithUid(String countryCode, String uid, String passwd, ILoginCallback callback);

【代码范例】

//uid登陆
TuyaUser.getUserInstance().loginWithUid("86", "1234", "123456", new ILoginCallback() {
    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "登录成功，用户名：" , Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }    @Override
    public void onSuccess(User user) {
        Toast.makeText(mContext, "登录成功，用户名：" , Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "code: " + code + "error:" + error, Toast.LENGTH_SHORT).show();
    }
});

(3) 用户uid重置密码

【描述】

用户uid重置密码需要调用云端接口重置

4.5 第三方登陆

Twitter登陆

【方法调用】

* @param countryCode 国家区号
* @param key         twitter授权登录获取的key
* @param secret      twitter授权登录获取的secret

TuyaUser.getUserInstance().loginByTwitter(String countryCode, String key, String secret, ILoginCallback callback);

QQ登陆

【方法调用】

* @param countryCode 国家区号
* @param userId         QQ授权登录获取的userId
* @param accessToken    QQ授权登录获取的accessToken

TuyaUser.getUserInstance().loginByQQ(String countryCode, String userId, String accessToken, ILoginCallback callback);

微信登陆

【方法调用】

 *  @param countryCode 国家区号
 *  @param code 微信授权登录获取的code
TuyaUser.getUserInstance().loginByWechat(String countryCode, String code, ILoginCallback callback);

Facebook 登陆

 *  @param countryCode 国家区号
 *  @param token facebook授权登录获取的token
 
TuyaUser.getUserInstance().loginByFacebook(String countryCode, String token, ILoginCallback callback);

4.6 上传用户头像

上传用户的头像。

【描述】

用于上传�用户自定义的头像。

【方法原型】

/**
 * 上传用户头像
 *
 * @param file     用户头像图片文件
 * @param callback 回调
 */
void uploadUserAvatar(File file, IBooleanCallback callback)

【代码范例】

TuyaUser.getUserInstance().uploadUserAvatar(
    file, 
    new IBooleanCallback() {
        @Override
        public void onSuccess() {
        }

        @Override
        public void onError(String code, String error) {

        }
});

4.7 设置温度单位

设置温度单位是摄氏度还是华氏度

/**
 * TempUnitEnum.Celsius是摄氏度,TempUnitEnum.Fahrenheit是华摄度
 *
 * @param unit
 * @param callback
 */
void setTempUnit(TempUnitEnum unit, IResultCallback callback);

4.8 退出登录接口

用户账号切换的时候需要调用退出登录接口

        TuyaUser.getUserInstance().logout(new ILogoutCallback() {
            @Override
            public void onSuccess() {
            	//退出登录成功
            }

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

4.9 注销账户

一周后账号才会永久停用并删除以下你账户中的所有信息，在此之前重新登录，则你的停用请求将被取消

/**
 * 注销账户
 * Account cancellation
 *
 * @param callback
 */
void cancelAccount(IResultCallback callback);

【代码范例】

TuyaUser.getUserInstance().cancelAccount(new IResultCallback() {
    @Override
    public void onError(String code, String error) {

    }

    @Override
    public void onSuccess() {

    }
});

4.10 数据模型

用户相关的数据模型。

User

nickName 昵称
phoneCode 国家区号
mobile 手机号码
username 用户名称
email 邮箱地址
uid 用户唯一标识符
sid 用户登录产生唯一标识id.
headPic 用户头像路径

5.设备配网

涂鸦硬件模块支持两种配网模式：快连模式（TLink，简称EZ模式）、热点模式（AP模式）。快连模式操作较为简便，建议在配网失败后，再使用热点模式作为备选方案。

【描述】

TuyaActivator主要是为了实现TuyaLink配网而提供的操作类。

【初始化参数配置】

TuyaActivator.getInstance().newActivator(new ActivatorBuilder()
.setSsid(ssid)
.setContext(mContext)
.setPassword(password)
//EZ模式
.setActivatorModel(ActivatorModelEnum.TY_EZ)
//AP模式
.setActivatorModel(ActivatorModelEnum.TY_AP)
//超时时间
.setTimeOut(CONFIG_TIME_OUT) //unit is seconds
.setToken(token).setListener();

【参数说明】

【入参】

* @param token  配网所需要的激活key。需要通过方法TuyaActivator.getInstance().getActivatorToken ()接口获取;Token的有效期为10分钟，且配置成功后就会失效（再次配网需要重新获取）
* @param ssid   配网之后，设备工作WiFi的名称。（家庭网络）
* @param password   配网之后，设备工作WiFi的密码。（家庭网络）
* @param activatorModel:	现在给设备配网有以下两种方式:
ActivatorModelEnum.TY_EZ: 传入该参数则进行EZ配网
ActivatorModelEnum.TY_AP: 传入该参数则进行AP配网
* @param timeout     配网的超时时间设置，默认是100s.
* @param context:  	需要传入activity 的context.

【出参】

ITuyaSmartActivatorListener listener 配网回调接口

* @method onError(String errorCode,String errorMsg);			

@param errorCode:
1001        网络错误
1002        配网设备激活接口调用失败，接口调用不成功
1003        配网设备激活失败，设备找不到。
1004        token 获取失败
1005        设备没有上线
1006        配网超时

@param errorMsg:
暂时没有数据，请参考errorCode。

* @method onActiveSuccess(GwDevResp gwDevResp);		设备配网成功,且设备上线（手机可以直接控制），可以通过TuyaUser.getDeviceInstance().getDev(gwDevResp.getGwId());获取到设备数据。

* @method onStep(String step, Object o);	
|@param step         |@param o
|device_find         |devId (String)
|device_bind_success |dev (GwDevResp)
【备注】
device_find 发现设备
device_bind_success 设备绑定成功，但还未上线，此时设备处于离线状态，无法控制设备。

【TY_EZ配网】

流程如下图所示：

【TY_AP配网】

流程如下图所示：

【方法调用】

//getActivator Token
TuyaActivator.getInstance().getActivatorToken（);
//开始配置
mTuyaActivator.start();
//停止配置
mTuyaActivator.stop();
//退出页面销毁一些缓存和监听
mTuyaActivator.onDestroy();

【代码范例】

//初始化回调接口
ITuyaSmartActivatorListener mListener = new ITuyaSmartActivatorListener() {

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

    @Override
    public void onActiveSuccess(GwDevResp gwDevResp) {
    }

    @Override
    public void onStep(String step, Object o) {
    }
};

//配置相应参数
mTuyaActivator = TuyaActivator.getInstance().newActivator(new 	ActivatorBuilder()
.setSsid("ssid")
.setContext(mContext)
.setPassword("password")
.setActivatorModel(ActivatorModelEnum.TY_EZ)
.setTimeOut(100)
.setToken(token).setListener(mListener)
//开始配置
mTuyaActivator.start();
//停止配置
mTuyaActivator.stop();
//回调销毁
mTuyaActivator.onDestroy();

【数据模型】

GwDevResp

后期会被DeviceBean 替代。设备数据可以通过TuyaUser.getInstance().getDev(gwId)。

gwId 设备id 。这个属性和devId相同，是设备唯一标识符，所有设备都不相同.

【配网问题汇总】

配网超时，此时设备一直处于连不上网络的状态。有以下几种原因。

获取WiFi Ssid 错误，导致配网失败安卓系统API里面获取到ssid，通常前后会有“”。建议使用Tuya Sdk里面自带的WiFiUtil.getCurrentSSID()去获取
WiFi密码包含空格用户在输入密码的时候，由于输入法联想的功能很容易在密码中输入空格。建议密码输入的时候直接显示出来，另外在判断密码含有空格的时候，弹窗提醒用户。
用户不输入WiFi密码用户在首次使用智能设备产品的过程中，很容易不输入密码就进行后续操作建议判断密码输入为空且WiFi加密类型不为NONE时，弹窗提醒用户。
用户在AP配网时选择了设备的热点名称，用户首次使用智能产品的过程中，很容易出现此问题。建议在判别AP配网时用户选择了设备的热点名称，弹窗提醒给用户。
获取WiFi的Ssid为"0x","<unknown ssid>" 目前发现在一些国产手机会出现此问题。并不是用户选择的WiFi名称。这是由于定位权限没开启导致的，建议用户可以手动输入WiFi的Ssid，或者给出弹窗提醒，让用户开启相应权限。

配网超时，此时设备已经激活成功。可能原因有：

APP没有连接到正常的网络，导致无法获取设备的状态。

6.设备控制

6.1 设备信息获取

【描述】

涂鸦智能提供了丰富的接口供开发者实现设备信息的获取和管理能力(移除等)。设备相关的返回数据都采用异步消息的方式通知接受者。我们采用了EventBus的方案来实现消息通知。因此在每个设备操作页面都需要注册和销毁通知对象。具体请参考demo实现。

【方法调用】

//从云端获取设备列表, 更新本地设备列表缓存
TuyaUser.getDeviceInstance().queryDevList();
//根据网关id获取指定设备信息，更新本地设备缓存
TuyaUser.getDeviceInstance().queryGw(String gwId);
//获取所有设备列表
TuyaUser.getDeviceInstance().getDevList();
//根据设备id获取单个设备
TuyaUser.getDeviceInstance().getDev();
//根据设备id获取设备所有dp数据
TuyaUser.getDeviceInstance().getDps(String devId);
//获取设备单个dp点数据
TuyaUser.getDeviceInstance().getDp(String devId, String dpId);
//根据设备id获取设备schema信息
TuyaUser.getDeviceInstance().getSchema(String devId);
//销毁监听事件，清理缓存数据，需要在退出时进行调用
TuyaUser.getDeviceInstance().onDestroy();

【注意事项】

退出应用时一定要调用onDestroy()方法，否则会造成内存泄露等异常。
schema dp数据相关介绍[详见功能点相关概念][3]
分享设备是不能被删除的

6.2 设备操作控制

TuyaDevice类提供了设备状态通知能力，通过注册回调函数，开发者可以方便的获取设备数据接受、设备移除、设备上下线、手机网络变化的通知。同时也提供了控制指令下发，设备固件升级的接口。

//根据设备id初始化设备控制类
TuyaDevice mDevice = new TuyaDevice(deviceBean.getDevId());

设备功能点

DeviceBean 类 dps 属性定义了设备的状态，称作数据点（DP点）或功能点。dps字典里的每个key对应一个功能点的dpId，dpValue为该功能点的值。各自产品功能点定义参见涂鸦开发者平台的产品功能。功能点具体参见快速入门-功能点相关概念

【指令格式】

发送控制指令按照以下格式： {"(dpId)":"(dpValue)"}

【功能点示例】

开发平台可以看到一个产品这样的界面

根据后台该产品的功能点定义，示例代码如下:

//设置dpId为1的布尔型功能点示例 作用:开关打开 
dps = {"1": true};

//设置dpId为4的字符串型功能点示例 作用:设置RGB颜色为ff5500
dps = {"4": "ff5500"};

//设置dpId为5的枚举型功能点示例 作用:设置档位为2档
dps = {"5": "2"};

//设置dpId为6的数值型功能点示例 用:设置温度为20°
dps = {"6": 20};

//设置dpId为15的透传型(byte数组)功能点示例 作用:透传红外数据为1122
dps = {"15": "1122"};

//多个功能合并发送
dps = {"1": true, "4": "ff5500"};

mDevice.publishDps(dps, new IControlCallback() {
@Override
public void onError(String code, String error) {}
@Override
public void onSuccess() {
}
});

【注意事项】

控制命令的发送需要特别注意数据类型。
比如功能点的数据类型是数值型（value），那控制命令发送的应该是 {"2": 25} 而不是 {"2": "25"}
透传类型传输的byte数组是字符串格式并且必须是偶数位。
比如正确的格式是: {"1": "0110"} 而不是 {"1": "110"}

初始化数据监听

【描述】

TuyaDevice提供设备相关信息（dp数据、设备名称、设备在线状态和设备移除）的监听，会实时同步到这里。

【实现回调】

mDevice.registerDevListener(new IDevListener() {
    @Override
    public void onDpUpdate(String devId, String dpStr) {
    //dp数据更新:devId 和相应dp数据
    }
    @Override
    public void onRemoved(String devId) {
    //设备被移除
    }
    @Override
    public void onStatusChanged(String devId, boolean online) {
    //设备在线状态，online
    }
    @Override
    public void onNetworkStatusChanged(String devId, boolean status) {
    //网络状态监听
    }
    @Override
    public void onDevInfoUpdate(String devId) {
    //设备信息变更，目前只有设备名称变化，会调用该接口
    }
});

监听设备列表变更

#####【描述】监听设备列表的变更，并刷新列表

#####【方法调用】

//register
TuyaUser.getDeviceInstance().registerTuyaListChangedListener(new ITuyaListChangedListener() {
        @Override
        public void onDeviceChanged(TuyaListBean tuyaListBean) {
            //please update the data list
        }
    })
    
 //unregister
 
 TuyaUser.getDeviceInstance().unRegisterTuyaListChangedListener(mListener);

数据下发

【描述】

通过局域网或者云端这两种方式发送控制指令给设备。

【方法调用】

//发送控制命令给硬件
mDevice.send(String command,IControlCallback callback);

【代码范例】

以灯类产品作为示例

1、定义灯开关dp点

public static final String STHEME_LAMP_DPID_1 = "1"; //灯开关

2、关于灯开关的数据结构：

public class LampBean {
	private boolean open;
	
	public boolean isOpen() {
		return open;
	}

	public void setOpen(boolean open) {
		this.open = open;
	}
}

3、对设备进行初始化

/**
 * 设备对象。该设备的所有dp变化都会通过callback返回。
 *
 * 初始化设备之前，请确保已经初始化连接服务端，否则无法获取到服务端返回信息
 */
mDevice = new TuyaDevice(mDevId);

mDevice.registerDevListener(new IDevListener() {
    @Override
    public void onDpUpdate(String devId, String dpStr) {
        //dp数据更新:devId 和相应dp数据
    }
    @Override
    public void onRemoved(String devId) {
        //设备被移除
    }
    @Override
    public void onStatusChanged(String devId, boolean online) {
        //设备在线状态，online
        //这个statusChange是指硬件设备和云端通信是否正常。
    }
    @Override
    public void onNetworkStatusChanged(String devId, boolean status) {
        //网络状态监听
        //这个onNetworkStatusChanged是指手机和云端通信是否正常。
    }
    @Override
    public void onDevInfoUpdate(String devId) {
        //设备信息变更，目前只有设备名称变化，会调用该接口
    }
});

4、开灯的代码片段

 public void openLamp() {
    LampBean bean = new LampBean();
    bean.setOpen(true);
    HashMap<String, Object> hashMap = new HashMap<>();
    hashMap.put(STHEME_LAMP_DPID_1, bean.isOpen());
    mDevice.publishDps(JSONObject.toJSONString(hashMap), new IControlCallback() {
        @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();
        }
    });
}

5、注销设备监听事件

mDevice.unRegisterDevListener();

6、设备资源销毁

mDevice.onDestroy();

【注意事项】

指令下发成功并不是指设备真正操作成功，只是意味着指令成功发送出去。操作成功会有dp数据信息上报上来，且通过IDevListener onDpUpdate接口返回。
command 命令字符串是以Map<String dpId,Object dpValue> 数据格式转成JsonString。
command 命令可以一次发送多个dp数据。

固件升级

【描述】

固件升级主要是用于修复设备bug和增加新功能等。固件升级主要分为两种，第一种是设备（Dev）升级，第二种是网关(Gw)升级。只有针对特殊设备（使用MCU芯片）才有网关升级，其他都是设备升级。

【方法调用】

//获取固件升级信息，会获取到设备或者网关的固件版本信息。
getFirmwareUpgradeInfo(IHardwareUpdateInfo hardwareUpdateInfo)

//设置设备或者网关升级回调。
setHardwareUpgradeListener(IFirmwareUpgradeListener listener);

//取消网关或者设备升级
mTuyaDevice.stopHardwareUpgrade();

【代码范例】

1、查询固件升级。

mDevice.getFirmwareUpgradeInfo(new IHardwareUpdateInfo() {
    @Override
    public void onError(String code, String error) {
        Toast.makeText(mContext, "检查更新错误：" + error, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onSuccess(HardwareUpgradeBean info) {
        UpgradeInfoBean dev = info.getDev();
        if (dev != null) {
            Toast.makeText(mContext, String.format("固件信息。新版本：%s，当前版本：%s，升级信息: %s", dev.getVersion(), dev.getCurrentVersion(), dev.getDesc()), Toast.LENGTH_SHORT).show();
        }
        UpgradeInfoBean gw = info.getGw();
        //upgradeStatus - 0:无新版本 1:有新版本 2:在升级中
        //upgradeType - 0:app提醒升级 2-app强制升级 3-检测升级
        if (gw != null) {
            Toast.makeText(mContext, String.format("固件信息。新版本：%1$s,当前版本：%2$s,升级信息：%3$s,升级状态: %4$d,升级类型: %5$d", gw.getVersion(), gw.getCurrentVersion(), dev.getDesc(), gw.getUpgradeStatus(), gw.getUpgradeType()), Toast.LENGTH_SHORT).show();
        }
    }
});

2、设置网关或者设备升级监听。

mDevice.setHardwareUpgradeListener(new IFirmwareUpgradeListener() {
    @Override
    public void onSuccess(FirmwareUpgradeEnum firmwareUpgradeEnum) {
    //固件升级成功
    //FirmwareUpgradeEnum 固件类型:（网关或者设备）
    }

    @Override
    public void onFailure(FirmwareUpgradeEnum firmwareUpgradeEnum, String code, String error) {
    //固件升级失败
    //FirmwareUpgradeEnum 固件类型:（网关或者设备）
    }

    @Override
    public void onProgress(FirmwareUpgradeEnum firmwareUpgradeEnum, int progress) {
    //FirmwareUpgradeEnum 固件类型:（网关或者设备）
    //固件升级进度
    }
});

3、开始固件升级（如果检测到含有需要升级的固件信息，则可以调用以下接口对相应固件进行升级）。

//开始对设备固件升级
mDevice.upgradeFirmware(FirmwareUpgradeEnum.TY_DEV);

//开始对网关固件升级。    
mDevice.upgradeFirmware(FirmwareUpgradeEnum.TY_GW);

设备信息查询

【描述】

查询单个dp数据从设备上查询dp最新数据会经过 IDevicePanelCallback onDpUpdate 接口回调。

【方法调用】

mDevice.getDp(String dpId, IControlCallback callback);

【代码范例】

1、通过调用mTuyaDevice.getDp方法。

2、数据会通过dp数据更新监听上报上来。
IDevListener.onDpUpdate(String devId,String dpStr)

【注意事项】

该接口主要是针对那些数据不主动去上报的dp点。常规查询dp数据值可以通过 TuyaUser.getDeviceIntance().getDp() 方法。

设备重命名

【描述】

设备重命名，支持多设备同步。

【方法调用】

//重命名
mDevice.renameGw(String name,IControlCallback callback);

【代码范例】

mDevice.renameGw("设备名称", new IControlCallback() {
    @Override
    public void onError(String code, String error) {
        //重命名失败
    }
    @Override
    public void onSuccess() {
        //重命名成功
    }
});

成功之后，IDevListener.onDevInfoUpdate() 会收到通知。

调用以下方法获取最新数据，然后刷新设备信息即可。

TuyaUser.getDeviceInstance().getDev(String devId);

获取数据点的历史数据

【描述】

获取dp点的历史状态数据，例如电量等信息。

【方法调用】

* @param type           获取历史数据type类型值 day week month
* @param number         获取历史数据点最大个数 value(1-50)
* @param dpId           获取历史数据的dp点值
* @param startTime      获取历史数据点的坐标日期
getDataPointStat(DataPointTypeEnum type, long startTime, int number, String dpId, final IGetDataPointStatCallback callback)

long startTime = System.currentTimeMillis(); //startTime起始时间
int number = 12;//往前获取历史数据结果值的个数 ，最大是50
String dpId = "1";
mDevice.getDataPointStat(DataPointTypeEnum.DAY, startTime, number, dpId, new IGetDataPointStatCallback() {
    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "获取历史数据失败" + errorMsg, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onSuccess(DataPointStatBean bean) {
        Toast.makeText(mContext, "获取历史数据成功：", Toast.LENGTH_SHORT).show();
    }
});

移除设备

【描述】

用于从用户设备列表中移除设备

【方法调用】

/**
 * 移除设备
 *
 * @param callback
 */
void removeDevice(IControlCallback callback);

【代码范例】

mDevice.removeDevice(new IControlCallback() {
    @Override
    public void onError(String errorCode, String errorMsg) {
    }

    @Override
    public void onSuccess() {
    }
});

数据模型

DeviceBean

iconUrl 设备图标链接地址
devId 设备唯一标示id
isOnline 设备是否在线（局域网或者云端在线）
name 设备名称
schema 用来描述设备dp点属性
productId 产品唯一标示id
pv 网关通信协议版本用x.x来表示。
bv 网关通用固件版本用x.x来表示。
time 设备添加时间
isShare 设备是否被分享
schemaMap Map类型 key 表示dpId， value 表示Schema 数据。
dps 设备当前数据信息。key 是 dpId ，value 是值。
lon、lat用来标示经纬度信息，需要用户使用sdk前，调用TuyaSdk.setLatAndLong 设置经纬度信息。

7.共享设备

涂鸦智能提供了向好友分享控制设备的能力。支持分享者和被分享者对分享的设备进行增加、删除、查询、修改。

7.1 添加分享

(1)添加多个设备共享（覆盖）

【描述】

分享多个设备给指定用户，会将指定用户的以前所有分享覆盖掉

【方法调用】

@param countryCode 国家码
@param userAccount 账号
@param ShareIdBean 分享内容 目前支持 设备或者mesh
@param autoSharing 是否自动分享新增的设备，如果为true，则分享者以后新增的设备都会自动分享给该指定用户（mesh暂不支持该选项）

void addShare(String countryCode, String userAccount, ShareIdBean bean, boolean autoSharing, IAddShareWithInfoCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().addShare("86", "test@test.com", shareIdBean, false, new IAddShareForDevsCallback() {
    @Override
    public void onSuccess(AddShareInfoBean bean) {
    }

    @Override
    public void onError(String code, String error) {
    }
})

(2)添加多个设备共享（追加）

【描述】

分享多个设备给指定用户，会将要分享的设备追加到指定用户的所有分享中

【方法调用】

@param countryCode   国家区号
@param phoneNumber   手机号码
@param devIds 		 分享的设备id列表

TuyaDeviceShare.getInstance().addShareUserForDevs(String countryCode, String userAccount, List<String> devId, IAddShareForDevsCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().addShareUserForDevs(countryCode, phoneNumber, devList, new IAddShareForDevsCallback() {
    @Override
    public void onSuccess(AddShareInfoBean addShareInfoBean) {
        
    }

    @Override
    public void onError(String code, String error) {

    }
});

(3)添加单个设备共享

【描述】

通过用户关系id分享单个设备

【方法调用】

@param devId 设备Id
@param relationId 用户关系Id PersonBean类id字段

void addDevShare(String devId, long relationId, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().addDevShare(devId, relationId, new IResultCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess() {

    }
});

7.2 查询分享

(1)查询主动分享的关系列表

【描述】

分享者获取主动分享的关系列表

【方法调用】

void queryUserShareList(IQueryUserShareListCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().queryUserShareList(new IQueryUserShareListCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess(List<PersonBean> list) {

    }
});

(2)查询收到分享关系列表

【描述】

被分享者获取收到的分享关系列表

【方法调用】

void queryShareReceivedUserList(IQueryReceivedShareUserListCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().queryShareReceivedUserList(new IQueryReceivedShareUserListCallback() {
    @Override
    public void onSuccess(List<PersonBean> list) {

    }

    @Override
    public void onError(String code, String error) {

    }
});

(3)查询指定设备的分享用户列表

【描述】

分享者获取某个设备的共享用户列表

【方法调用】

@param devId 设备Id
void queryDevShareUserList(String devId, IQueryDevShareUserListCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().queryDevShareUserList(devId, new IQueryDevShareUserListCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess(List<DevShareUserBean> list) {

    }
});

(4)查询指定设备是谁共享的

【描述】

被分享者查找指定设备是谁共享过来的

【方法调用】

@param devId 设备Id
void queryShareDevFromInfo(String devId, IGetShareFromInfoCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().queryShareDevFromInfo(devId, new IGetShareFromInfoCallback() {
    @Override
    public void onSuccess(SharerInfoBean sharerInfoBean) {
        
    }

    @Override
    public void onError(String code, String error) {

    }
})

(5)查询分享到指定用户的共享关系

【描述】

分享者通过relationId 获取分享给这个关系用户的所有共享设备信息

【方法调用】

@param relationId 用户关系Id PersonBean类id字段
void getUserShareInfo(long relationId, IGetUserShareInfoCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().getUserShareInfo(relationId, new IGetUserShareInfoCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess(UserShareInfoBean userShareInfoBean) {

    }
})

(6)查询收到指定用户共享的信息

【描述】

被分享者通过relationId 获取收到这个关系用户的所有共享设备信息

【方法调用】

@param relationId 用户关系Id PersonBean类id字段
void getReceivedShareInfo(long relationId, IGetReceivedShareInfoCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().getReceivedShareInfo(relationId, new IGetReceivedShareInfoCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess(UserReceivedShareInfoBean userReceivedShareInfoBean) {

    }
});

7.3 移除分享

(1)删除共享关系

【描述】

分享者通过relationId 删除与这个关系用户的所有共享关系

【方法调用】

@param relationId 用户关系Id PersonBean类id字段
void removeUserShare(long relationId, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().removeUserShare(relationId, new IResultCallback() {
    @Override
    public void onError(String code, String error) {

    }

    @Override
    public void onSuccess() {

    }
})

(2)删除收到的共享关系

【描述】

被分享者通过relationId 删除与这个关系用户的所有共享关系

【方法调用】

@param relationId 用户关系Id PersonBean类id字段
void removeReceivedUserShare(long relationId, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().removeReceivedUserShare(relationId, new IResultCallback() {
    @Override
    public void onError(String code, String error) {

    }

    @Override
    public void onSuccess() {

    }
})

(3)删除某个设备共享

【描述】

分享者删除指定关系用户下的某个共享的设备

【方法调用】

@param devId 设备Id
@param relationId 用户关系Id PersonBean类id字段
void removeDevShare(String devId, long relationId, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().removeDevShare(devId, relationId, new IResultCallback() {
    @Override
    public void onError(String code, String error) {

    }

    @Override
    public void onSuccess() {

    }
})

(4)移除收到的分享设备

【描述】

被分享者删除某个共享的设备

【方法调用】

@param devId 设备Id
void removeReceivedDevShare(String devId, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().removeReceivedDevShare(devId,new IResultCallback() {
    @Override
    public void onError(String code, String error) {

    }

    @Override
    public void onSuccess() {

    }
})

7.4 修改昵称

(1)修改发出的分享人的昵称

【描述】

分享者修改发出的分享人的昵称.(发出的分享)

【代码调用】

* @param relationId      用户关系Id PersonBean类id字段
* @param name   			  要修改的昵称
void renameShareNickname(long relationId, String name, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().renameShareNickname(relationId, name, new IResultCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess() {

    }
})

(2)修改接收到的分享人的昵称

【描述】

被分享者修改接收到的分享人的昵称.（接收到的分享）

【方法调用】

* @param relationId     用户关系Id PersonBean类id字段
* @param name    		 要修改的昵称 
void renameReceivedShareNickname(long relationId, String name, IResultCallback callback);

【代码范例】

TuyaDeviceShare.getInstance().renameReceivedShareNickname(relationId, name, new IResultCallback() {
    @Override
    public void onError(String code, String error) {
        
    }

    @Override
    public void onSuccess() {

    }
})

8.定时任务

涂鸦智能提供了基本的定时能力，支持设备（包括WiFi设备，蓝牙mesh子设备，zigbee子设备）和群组。并封装了针对设备dp点的定时器信息的增删改查接口，所有接口都位于TuyaTimerManager中。APP通过定时接口设置好定时器信息后，硬件模块会自动根据定时要求进行预订的操作。每个定时任务下可以包含多个定时器。如下图所示：

以下多个接口用到了taskName这个参数，具体可描述为一个分组，一个分组可以有多个定时器。每个定时属于或不属于一个分组，分组目前仅用于展示

8.1 增加定时器

【描述】

增加一个定时器

【方法调用】

 /**
 * 增加定时器   单dp点 默认置为true      支持子设备新接口
 * @param taskName 定时任务名称
 * @param devId        设备Id或群组Id
 * @param loops    循环次数 "0000000", 每一位 0:关闭,1:开启, 从左至右依次表示: 周日 周一 周二 周三 周四 周五 周六 。如果只有周六周日执行则："1000001",只执行一次则："0000000"
 *  @param dpId  			dp点id
 * @param time     定时任务下的定时钟,只支持24小时制，如果用户使用12小时制，开发者需要转换为24小时制
 * @param callback 回调
 */
public void addTimerWithTask(String taskName, String devId, String loops, String dpId, String time, final IResultStatusCallback callback) ;


/**
 * 增加定时器         支持子设备新接口
 * 其他参数值释义同上
 * @param dps    dp点键值对，key是dpId，value是dpValue,仅支持单dp点
 * @param callback 回调
 */

public void addTimerWithTask(String taskName, String devId, String loops, Map<String, Object> dps, String time, final IResultStatusCallback callback)

【代码范例】

mTuyaTimerManager.addTimerWithTask("task01", mDevId, "1111111", dps, "14:29", new IResultStatusCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "添加定时任务成功", Toast.LENGTH_LONG).show();
    }

    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "添加定时任务失败 " + errorMsg, Toast.LENGTH_LONG).show();
    }
});

8.2 获取某设备下的所有定时任务状态

【描述】

获取某设备下的所有定时任务状态

【方法调用】

* 获取某设备下的所有定时任务状态
*
* @param devId    设备Id或群组Id
* @param callback 回调
public void getTimerTaskStatusWithDeviceId(String devId, final IGetDeviceTimerStatusCallback callback);

【代码范例】

mTuyaTimerManager.getTimerTaskStatusWithDeviceId(mDevId, new IGetDeviceTimerStatusCallback() {
    @Override
    public void onSuccess(ArrayList<TimerTaskStatus> list) {
        Toast.makeText(mContext,"获取设备的定时状态成功",Toast.LENGTH_LONG).show();
    }
    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "获取设备的定时状态失败 " + errorMsg, Toast.LENGTH_LONG).show();
    }
});

8.3 控制定时任务中所有定时器的开关状态

【描述】

控制定时任务中所有定时器的开关状态

【方法调用】

* 控制定时任务中所有定时器的开关状态
* @param taskName 定时任务名称
* @param devId    设备Id或群组Id
* @param isOpen   开关
* @param callback 回调
public void operateTimerInTask(String taskName, String devId, boolean isOpen, final IResultStatusCallback callback);

/**
 *
 * @param taskName 定时任务名称
 * @param devId    设备Id或群组Id
 * @param status   状态值 1表示开关状态开启  0开关状态关闭
 * @param callback 回调
 */
public void operateTimerInTask(String taskName, String devId, int status, final IResultStatusCallback callback)

【代码范例】

mTuyaTimerManager.operateTimerInTask(taskName, mDevId, false, new IResultStatusCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "控制定时任务中所有定时器的开关状态成功", Toast.LENGTH_LONG).show();
    }

    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "控制定时任务中所有定时器的开关状态失败 " + errorMsg, Toast.LENGTH_LONG).show();
    }
});

8.4 控制某个定时器的开关状态

【描述】

控制某个定时器的开关状态

【方法调用】

* 控制某个定时器的开关状态
* @param taskName 定时任务名称
* @param devId    设备Id或群组Id
* @param timerId  定时钟Id
* @param isOpen   开关
* @param callback 回调
public void operateTimer(String taskName, String devId, String timerId, boolean isOpen, IResultStatusCallback callback);

【代码范例】

mTuyaTimerManager.operateTimer(taskName, mDevId, timeId, false, new IResultStatusCallback() {
        @Override
        public void onSuccess() {
            Toast.makeText(mContext, "控制定时器的开关状态成功", Toast.LENGTH_LONG).show();
        }

        @Override
        public void onError(String errorCode, String errorMsg) {
            Toast.makeText(mContext, "控制定时器的开关状态失败 " + errorMsg, Toast.LENGTH_LONG).show();
        }
    });

8.5 删除定时器

【描述】

删除定时器

【方法调用】

* 删除定时器
* @param taskName 定时任务名称
* @param devId    设备Id或群组Id
* @param timerId  定时钟Id
* @param callback 回调
public void removeTimer(String taskName, String devId, String timerId, IResultStatusCallback callback);

【代码范例】

mTuyaTimerManager.removeTimer(taskName, mDevId, timeId, new IResultStatusCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "删除定时成功", Toast.LENGTH_LONG).show();
    }

    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "删除定时失败" + errorMsg, Toast.LENGTH_LONG).show();
    }
});

8.6 更新定时器的状态

【描述】

更新定时器的状态该接口可以修改一个定时器的所有属性。

【方法调用】

/**
 * 更新定时器的状态
 * @param taskName 定时任务名称
 * @param devId    设备Id或群组Id
 * @param timerId  定时钟Id
 * @param loops    循环次数 "0000000", 每一位 0:关闭,1:开启, 从左至右依次表示: 周日 周一 周二 周三 周四 周五 周六 。如果只有周六周日执行则："1000001",只执行一次则："0000000"
 * @param dpId     dp点id
 * @param time     定时时间
 * @param isOpen	  是否开启
 * @param callback 回调
 */
public void updateTimerStatus(String taskName, String devId, String timerId, String dpId, String loops, String time, boolean isOpen, final IResultStatusCallback callback);



/**
 * 更新定时器的状态
 *
 * @param taskName 定时任务名称
 * @param devId    设备Id或群组id
 * @param timerId  定时钟Id
 * @param loops    循环次数
 * @param instruct 定时dp点数据,只支持单dp点 json格式 如:   [{
 *                 "time": "20:00",
 *                 "dps": {
 *                 "1": true
 *                 }]
 * @param callback 回调
 */
public void updateTimerStatus(String taskName, String devId, String timerId, String loops, String instruct, final IResultStatusCallback callback)

【代码范例】

mTuyaTimerManager.updateTimerStatus(taskName, mDevId, timeId, "0011001", "[{"time": "20:00", "dps": { "1": true},{"time": "22:00","dps": {"2": true}]", new IResultStatusCallback() {
    @Override
    public void onSuccess() {
        Toast.makeText(mContext, "更新定时器属性成功", Toast.LENGTH_LONG).show();
    }
    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "更新定时器属性失败" + errorMsg, Toast.LENGTH_LONG).show();
    }
});

8.7 获取定时任务下所有定时器

【描述】

获取定时任务下所有定时器

【方法调用】

* 获取定时任务下所有定时器
* @param taskName 定时任务名称
* @param devId    设备Id或群组Id
* @param callback 回调
public void getTimerWithTask(String taskName, String devId, final IGetTimerWithTaskCallback callback);

【代码范例】

mTuyaTimerManager.getTimerWithTask(taskName, mDevId, new IGetTimerWithTaskCallback() {
    @Override
    public void onSuccess(TimerTask timerTask) {
        Toast.makeText(mContext, "获取定时任务下的定时 成功", Toast.LENGTH_LONG).show();
    }
    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "获取定时任务下的定时 失败" + errorMsg, Toast.LENGTH_LONG).show();
    }
});

8.8 获取设备所有定时任务下所有定时器

【描述】

获取设备所有定时任务下所有定时器

【方法调用】

* 获取设备所有定时任务下所有定时器
* @param devId    设备Id或群组Id
* @param callback 回调
public void getAllTimerWithDeviceId(String devId, final IGetAllTimerWithDevIdCallback callback);

【代码范例】

mTuyaTimerManager.getAllTimerWithDeviceId(mDevId, new IGetAllTimerWithDevIdCallback() {
    @Override
    public void onSuccess(ArrayList<TimerTask> taskArrayList) {
        Toast.makeText(mContext, "获取设备下的定时 成功", Toast.LENGTH_LONG).show();
    }

    @Override
    public void onError(String errorCode, String errorMsg) {
        Toast.makeText(mContext, "获取设备下的定时 失败" + errorMsg, Toast.LENGTH_LONG).show();
    }
});

9.群组管理

涂鸦云支持群组管理体系：可以创建群组，修改群组名称，管理群组设备，通过群组管理多个设备，解散群组。

9.1 创建群组

【描述】

涂鸦智能提供一些设备群组控制的接口。

【方法调用】

* 获取设备所有定时任务下所有定时器
* @param productId    产品id 可从 DeviceBean.getProductId获取
* @param groupName 群组名称
* @param devIdList 选择要加入群组的设备
* @param callback 回调
TuyaGroup.getGroupInstance().createNewGroup(String productId, String groupName, List<String> devIdList, ICreateGroupCallback callback)

【代码范例】

//创建群组
TuyaGroup.getGroupInstance().createNewGroup("productId", "name", devIds, new ICreateGroupCallback() {
    @Override
    public void onSuccess(long groupId) {
//返回groupId
    }

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

    }
});

【注意事项】

群组默认不支持创建，如果你的产品需要这个功能，那么请联系我们对产品进行开启这项功能。

9.2 群组列表获取

【描述】

此接口主要是从云端拉取最新群组列表。

【方法调用】

*
* @param productId    产品id 可从 DeviceBean.getProductId获取
* @param callback 回调
TuyaGroup.getGroupInstance().getGroupDevList(String productId,IGetDevsFromGroupByPidCallback callback)

【代码范例】

//云端获取群组列表
TuyaGroup.getGroupInstance().getGroupDevList("productId", new IGetDevsFromGroupByPidCallback() {
    @Override
    public void onSuccess(List<GroupDeviceBean> bizResult) {

    }

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

    }
});

9.3 群组操作

【描述】

涂鸦智能群组操作，主要是基于对主设备的操作，主设备是指当前群组在线的第一个设备。在线和离线状态、数据上报都是依赖于主设备的变更。发送控制命令是面对群组的所有设备。

【实例化】

* 群组实例化
* @param groupId 群组Id
ITuyaGroup mITuyaGroup= TuyaGroup.newGroupInstance(groupId);

(1) 群组修改名称

【描述】

群组修改名称

【方法调用】

* 群组修改名称
* @param groupId    群组id
* @param callback 回调
mITuyaGroup.updateGroupName(IControlCallback callback)

【代码范例】

//群组重命名
mITuyaGroup.updateGroupName(new IControlCallback() {
    @Override
    public void onSuccess() {
    }

    @Override
    public void onError(String s, String s1) {
    }
});

(2) 修改群组设备列表

【描述】

修改群组设备列表

【方法调用】

* 修改群组设备列表
* @param devIds   设备devIds
* @param callback 回调
mITuyaGroup.updateGroupRelations(List<String> devIds,IControlCallback callback);

【代码范例】

//修改群组设备列表
mITuyaGroup.updateGroupRelations(getSelectedDeviceIds, new IControlCallback() {
    @Override
    public void onError(String errorCode, String errorMsg) {
    }

    @Override
    public void onSuccess() {
    }
});

(3) 解散群组

【描述】

解散群组

【方法调用】

* 解散群组
* @param groupId    群组id
* @param callback 回调
mITuyaGroup.dismissGroup(IControlCallback callback)

【代码范例】

//删除群组
mITuyaGroup.dismissGroup(new IControlCallback() {
    @Override
    public void onSuccess() {
    }

    @Override
    public void onError(String s, String s1) {
    }
});

(4) 群组回调事件

【描述】

群组回调事件

【方法调用】

* 注册群组回调事件
* @param listener 回调
mITuyaGroup.registerGroupListener(IGroupListener listener);

* 注销群组回调事件
mITuyaGroup.unRegisterGroupListener();

【代码范例】

//注册群组回调事件
mITuyaGroup.registerGroupListener(new IGroupListener() {
    //主设备数据点更新
    @Override
    public void onDpUpdate(String dps) {
    }
    //主设备在线状态变更
    @Override
    public void onStatusChanged(boolean status) {
    }
    //网络状态变更
    @Override
    public void onNetworkStatusChanged(boolean isNetworkOk) {
    }
});
//注销群组回调事件
mITuyaGroup.unRegisterGroupListener();

（5）发送群组控制命令

【描述】

发送群组控制命令

【方法调用】

* 发送群组控制命令
* @param command 控制命令
* @param listener 回调
mTuyaGroup.publishDps(String command,IControlCallback listener);

【代码范例】

//群组开灯代码片段
LampBean bean = new LampBean();
bean.setOpen(true);
HashMap<String, Object> hashMap = new HashMap<>();
hashMap.put(STHEME_LAMP_DPID_1, bean.isOpen());
mTuyaGroup.publishDps(JSONObject.toJSONString(hashMap),callback)；

【注意事项】

群组的发送命令返回结果，是指发送给云端成功，并不是指实际控制设备成功。

（6）获取群组下设备列表

【描述】

云端获取获取群组下设备列表

【方法调用】

* @param listener 回调
mTuyaGroup.getGroupDevList(IGetDevicesInGroupCallback listener)

【代码范例】

//获取群组列表
mITuyaGroup.getGroupDevList(new IGetDevicesInGroupCallback() {
    @Override
    public void onSuccess(List<GroupDeviceBean> list) {
    }

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

（7）群组数据获取

【描述】

本地获取群组数据

【方法调用】

* 本地获取群组数据bean
* @param groupId 群组id
* @return GroupBean  群组数据类
TuyaUser.getDeviceInstance().getGroupBean(String groupId);

* 本地获取群组数据列表
* @return  List<GroupBean>  群组列表
TuyaUser.getDeviceInstance().getGroupList();

【代码范例】

//获取群组数据类
GroupBean groupBean = TuyaUser.getDeviceInstance().getGroupBean(mGroupId);
//本地获取群组列表。
TuyaUser.getDeviceInstance().getGroupList()

（8）群组数据销毁

【描述】

群组数据销毁，建议退出群组控制页面的时候调用。

【方法调用】

* 群组数据销毁
mITuyaGroup.onDestroy();

【代码范例】

//销毁数据
mITuyaGroup.onDestroy();

10.智能场景

简介

智能场景是由用户设定条件，当条件触发后自动控制设备的功能。

涂鸦智能Android SDK中，智能场景包括智能场景统一管理类TuyaSceneManager和智能场景独立操作类TuyaSmartScene，统一管理类通过单例方式获取，独立操作类需要用场景id初始化，场景id可以在获取场景列表接口的返回结果中获取。

10.1 获取场景列表

【描述】

获取场景列表，当场景首页初始化时使用。

【方法原型】

/**
 * 获取场景列表
 * @param callback 回调
 */
public void getSceneList(ITuyaDataCallback<List<SceneBean>> callback)

其中，SceneBean的接口定义如下

/**
 *  获取场景id
 * @return 场景id
 */
public String getId()

/**
 *  获取场景名称
 * @return 场景名称
 */
public String getName()

/**
 *  获取场景条件 (目前仅支持最多一个条件)
 * @return 场景条件
 */
public List<SceneCondition> getConditions()


/**
 *  获取场景任务
 * @return 场景任务
 */
public List<SceneTask> getActions()

【代码范例】

TuyaScene.getTuyaSceneManager().getSceneList(new ITuyaDataCallback<List<SceneBean>>() {
    @Override
    public void onSuccess(List<SceneBean> result) {
    }

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

10.2 场景条件

用户可设置的条件包括天气状况以及设备状况，目前仅支持最多1个条件设定。当不设定条件时，仍可保存场景，但需要用户手动触发。

在涂鸦云API中，智能场景条件分为两种类型：

天气型

天气条件包括温度、湿度、天气、PM2.5、空气质量、日出日落，可自由选定城市。根据用户账号中设备的不同，可选择的天气条件也不同。
```
/**
 * 创建天气型条件
 *
 * @param place 天气城市 
 * @param type  条件类型
 * @param rule  条件规则
 * @return
 */
public static SceneCondition createWeatherCondition(
    PlaceFacadeBean place, 
    String type,
    Rule rule)
```
注: PlaceFacadeBean类对象请从获取城市�列表,根据经纬度获取城市, 根据城市id获取城市接口获取。

设备型

设备条件是指当一个设备处于某种状态时，会触发另一台或多台设备的预定任务。为了避免循环控制，同一台设备无法同时作为条件和任务。

/**
 * 创建设备型条件
 *
 * @param devBean 条件设备
 * @param dpId    条件dpId
 * @param rule    条件规则
 * @return
 */
public static SceneCondition createDevCondition(
    SceneDevBean devBean,
    String dpId,
    Rule rule)

注: SceneDevBean类对象请从获取条件设备列表接口获取。

每种类型都有三种规则:

数值型

以温度为例，数值型条件的最终表达式为"temp > 20"的格式。您可以从获取条件列表接口获得目前支持的温度最大值、最小值、粒度（步进)。在用户界面上完成配置后，调用ValueRule.newInstance方法构建规则，并用规则构成条件。

例:

 ValueProperty tempProperty = (ValueProperty) conditionListBean.getProperty();       //数值型Property

 int max = tempProperty.getMax();       //最大值
 int min = tempProperty.getMin();       //最小值
 int step = tempProperty.getStep();     //粒度
 String unit = tempProperty.getUnit();  //单位

 //温度大于20度
 ValueRule tempRule = ValueRule.newInstance(
     "temp",  //类别
     ">",     //运算规则(">", "==", "<")
     20       //临界值
 ); 
 SceneCondition tempCondition = SceneCondition.createWeatherCondition(
     placeFacadeBean,   //城市
     "temp",            //类别
     tempRule           //规则
 );

枚举型

以天气状况为例, 枚举型条件的最终表达式为"condition == rainy"的格式，您可以从获取条件列表接口获得目前支持的天气状况，包括每种天气状况的code和名称。在用户界面上完成配置后，调用EnumRule.newInstance方法构建规则，并用规则构成条件。

例:

 EnumProperty weatherProperty = (EnumProperty) conditionListBean.getProperty();  //枚举型Property

 /** 
 {
    {"sunny", "晴天"},
    {"rainy", "雨天"}
 } 
 */
 HashMap<Object, String> enums = weatherProperty.getEnums();

 //天气为下雨
 EnumRule enumRule = EnumRule.newInstance(
             "condition",  //类别 
             "rainy"        //选定的枚举值
 );
 SceneCondition weatherCondition = SceneCondition.createWeatherCondition(
             placeFacadeBean,    //城市
             "condition",        //类别
             enumRule            //规则
 );

布尔型

布尔型常见于设备型条件, 最终表达式为"dp1 == true"的格式, 您需要调用获取条件设备列表接口获取支持配置智能场景的设备，然后根据设备id查询该设备可支持的操作，详见获取设备支持的操作。在用户界面上完成配置后，调用BoolRule.newInstance方法构建规则，并用规则构成条件。

例:

BoolProperty devProperty = (BoolProperty) conditionListBean.getProperty();  //布尔型Property

/**
{
  {true, "已开启"},
  {false, "已关闭"}
}
*/
HashMap<Boolean, String> boolMap = devProperty.getBoolMap(); 

//当设备开启时
BoolRule boolRule = BoolRule.newInstance(
    "dp1",    //"dp" + dpId
    true    //触发条件的bool
);
SceneCondition devCondition = SceneCondition.createDevCondition(
    devBean,    //设备
    "1",        //dpId
    boolRule    //规则
);

10.2.1 获取天气条件列表

【接口描述】

获取当前用户支持配置的条件的列表，通常用于添加或修改条件的第一步。

【方法原型】

/**
 * 获取天气条件列表
 *
 * @param callback 回调
 */
void getConditionList(ITuyaDataCallback<List<ConditionListBean>> callback);

其中， ConditionListBean提供的接口为

/**
 * 获取条件类别
 *
 * @return 类别 [1]
 */
public String getType() {
    return type;
}·

/**
 * 获取条件名称
 *
 * @return 名称
 */
public String getName() {
    return name;
}

/**
 * 获取Property [2]
 *
 * @return Property 
 */
public IProperty getProperty() {
    return property;
}

注:

目前支持的天气条件类别及其名称和Property类型

名称	Type	Property Type
温度	Temp	ValueProperty
湿度	humidity	EnumProperty
天气	condition	EnumProperty
PM2.5	pm25	EnumProperty
空气质量	aqi	EnumProperty
日出日落	sunsetrise	EnumProperty

Property是涂鸦智能中一种常用的数据结构，可以用来控制设备和其他功能。目前提供三种Property: 数值型，枚举型，布尔型(与条件中的数值型，枚举型，布尔型相对应), 每种Property提供不同的访问接口。详见前文规则介绍处。

【代码范例】

TuyaScene.getTuyaSceneManager().getConditionList(new ITuyaDataCallback<List<ConditionListBean>>() {
    @Override
    public void onSuccess(List<ConditionListBean> conditionActionBeans) {
    }

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

10.2.2 获取条件设备列表

【描述】

获取可用于条件设置的设备列表。

【方法原型】

/**
 * 获取条件中的可选设备列表
 *
 * @param callback 回调
 */
void getConditionDevList(ITuyaDataCallback<List<SceneDevBean>> callback);

【代码范例】

TuyaScene.getTuyaSceneManager().getConditionDevList(new ITuyaDataCallback<List<SceneDevBean>>() {
    @Override
    public void onSuccess(List<SceneDevBean> sceneDevBeans) {
    }

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

10.2.3 根据设备id获取设备任务

【描述】

用于获取在选择设备具体的触发条件时，可选择的任务。

【方法原型】

  /**
     * 获取设备支持的任务条件列表
     *
     * @param devId    设备id
     * @param callback 回调
     */
    void getDevOperationList(String devId, ITuyaDataCallback<List<TaskListBean>> callback);

其中, TaskListBean提供以下接口:

/**
 *  获取dp点名称， 用于界面展示
 *
 * @return dp点名称
 */
public String getName() {
    return name;
}

/**
 *  获取dpId
 *
 * @return dpId
 */
public long getDpId() {
    return dpId;
}

/**
 *  获取该dp点可配置的操作
 *
 *   格式:
 *     {
 *       {true, "已开启"},
 *       {false, "已关闭"}
 *     }
 *
 * @return 
 */
public HashMap<Object, String> getTasks() {
    return tasks;
}

【代码范例】

TuyaScene.getTuyaSceneManager().getDevOperationList(
    devId, //设备id
    new ITuyaDataCallback<List<TaskListBean>>() {
        @Override
        public void onSuccess(List<TaskListBean> conditionActionBeans) {
        }

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

10.2.4 获取城市列表

【描述】

用于在创建天气条件时，选择城市。注：目前城市列表暂时仅支持中国。

【方法原型】

/**
 * 根据国家码获取城市列表
 *
 * @param countryCode 国家码
 * @param callback    回调
 */
void getCityListByCountryCode(String countryCode, ITuyaDataCallback<List<PlaceFacadeBean>> callback);

其中, PlaceFacadeBean类提供以下接口:

/**
 * 获取区域名称
 *
 * @return 区域名称
 */
public String getArea() {
    return area;
}

/**
 * 获取省份名称
 *
 * @return 省份名称
 */
public String getProvince() {
    return province;
}

/**
 * 获取城市名称
 *
 * @return 城市名称
 */
public String getCity() {
    return city;
}

/**
 * 获取城市id
 *
 * @return 城市id
 */
public long getCityId() {
    return cityId;
}

【代码范例】

TuyaScene.getTuyaSceneManager().getCityListByCountryCode(
	"cn",  //中国
	new ITuyaDataCallback<List<PlaceFacadeBean>>() {
    	@Override
    	public void onSuccess(List<PlaceFacadeBean> placeFacadeBeans) {
    	}

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

10.2.5 根据城市id获取城市信息

【描述】

根据城市id获取城市信息，用于展示已有的天气条件。城市id可以在获取城市列表接口中获取。

【方法原型】

/**
 * 根据城市id获取城市信息
 *
 * @param cityId   城市id{@link com.tuya.smart.sdk.bean.secne.PlaceFacadeBean}
 * @param callback 回调
 */
void getCityByCityIndex(long cityId, ITuyaDataCallback<PlaceFacadeBean> callback);

【代码范例】

TuyaScene.getTuyaSceneManager().getCityByCityIndex(
	cityId, //城市id
	new ITuyaDataCallback<PlaceFacadeBean>() {
		@Override
		public void onSuccess(PlaceFacadeBean placeFacadeBean) {
		}

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

10.2.6 根据经纬度获取城市信息

【描述】

根据经纬度获取城市信息，用于展示已有的天气条件。

【方法原型】

/**
 * 根据经纬度获取城市信息
 *
 * @param lon      经度
 * @param lat      纬度
 * @param callback 回调
 */
void getCityByLatLng(String lon, String lat, ITuyaDataCallback<PlaceFacadeBean> callback);

【代码范例】

TuyaScene.getTuyaSceneManager().getCityByLatLng(
    String.valueOf(longitude), //经度
    String.valueOf(latitude),   //纬度
    new ITuyaDataCallback<PlaceFacadeBean>() {
        @Override
        public void onSuccess(PlaceFacadeBean placeFacadeBean) {
        }

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

10.3 场景任务

场景任务指当条件触发时执行的控制设备任务。用户可设定的任务视用户的设备而定，请注意，并不是每一款产品都支持智能场景。

####10.3.1 获取任务设备列表

【描述】

获取支持智能场景任务的设备列表，用于创建任务时。

【方法原型】

/**
 * 获取任务中的可选设备列表
 *
 * @param callback 回调
 */
void getTaskDevList(ITuyaDataCallback<List<SceneDevBean>> callback);

其中， SceneDevBean提供以下接口:

/**
 *  获取设备名称
 * 
 * @return 设备名称
 */
public String getName() {
    return name;
}

/**
 *  产品id
 * 
 * @return 产品id
 */
public String getProductId() {
    return productId;
}

/**
 *  获取设备id
 * 
 * @return 设备id
 */
public String getDevId() {
    return devId;
}

【代码范例】

TuyaScene.getTuyaSceneManager().getTaskDevList(new ITuyaDataCallback<List<SceneDevBean>>() {
    @Override
    public void onSuccess(List<SceneDevBean> sceneDevBeans) {
    }

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

10.3.2 根据设备id获取设备任务

【描述】

用于在创建任务时，获取设备可执行的任务。

【方法原型】

/**
* 获取设备可以执行的操作
*
* @param devId    设备id
* @param callback 回调
*/
void getTaskList(String devId, ITuyaDataCallback<List<TaskListBean>> callback);

其中, TaskListBean提供以下接口:

/**
 *  获取dp点名称， 用于界面展示
 *
 * @return dp点名称
 */
public String getName() {
    return name;
}

/**
 *  获取dpId
 *
 * @return dpId
 */
public long getDpId() {
    return dpId;
}

/**
 *  获取该dp点可配置的操作
 *
 *   格式:
 *     {
 *       {true, "已开启"},
 *       {false, "已关闭"}
 *     }
 *
 * @return 
 */
public HashMap<Object, String> getTasks() {
    return tasks;
}

【代码范例】

TuyaScene.getTuyaSceneManager().getTaskList(
    devId, //设备id
    new ITuyaDataCallback<List<TaskListBean>>() {
        @Override
        public void onSuccess(List<TaskListBean> conditionActionBeans) {
        }

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

10.3.3 创建任务

【描述】

用于创建设备任务。

【方法原型】

/**
 * 创建硬件控制任务
 *
 * @param devId 设备id
 * @param tasks 要执行的任务 格式: { dpId: dp点值 }
 *                          例：
 *                          {
 *                              "1": true,
 *                          }
 * @return 场景任务
 */
public static SceneTask createDpTask(@NonNull String devId, HashMap<String, Object> tasks)

【代码范例】

HashMap<String, Object> taskMap = new HashMap<>();
taskMap.put("1", true); //开启设备
SceneTask task = SceneTask.createDpTask(
    devId,      //设备id
    taskMap     //设备任务
);

10.4 创建场景

【描述】

用于将条件和任务组装成场景并创建新的场景，成功后会返回场景数据。

【方法原型】

/**
 * 创建场景
 *
 * @param name      场景名称
 * @param condition 场景触发条件 {@link SceneCondition}
 * @param tasks     场景执行任务 {@link SceneTask}
 * @param callback  回调
 */
void createScene(String name, SceneCondition condition, List<SceneTask> tasks, final ITuyaDataCallback<SceneBean> callback);

【代码范例】

TuyaScene.getTuyaSceneManager().createScene(
    "Morning", //场景名称
    condition, //条件
    tasks,     //任务
    new ITuyaDataCallback<SceneBean>() {
        @Override
        public void onSuccess(SceneBean sceneBean) {
            Log.d(TAG, "createScene Success");
        }

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

10.5 修改场景

【描述】

用于修改场景，成功后会返回新的场景数据。

【方法原型】

/**
 *  修改场景
 * 
 * @param sceneReqBean 场景数据类
 * @param callback 回调
 */
void modifyScene(SceneBean sceneReqBean, ITuyaDataCallback<SceneBean> callback);

注：该接口只能用于修改场景，请勿传入新建的SceneBean对象。

【代码范例】

sceneBean.setName("New name");  //更改场景名称
sceneBean.setConditions(Collections.singletonList(condition)); //更改场景条件
sceneBean.setActions(tasks); //更改场景任务

String sceneId = sceneBean.getId();  //获取场景id以初始化TuyaSmartScene类
TuyaScene.getTuyaSmartScene(sceneId).modifyScene(
    sceneBean,  //修改后的场景数据类
    new ITuyaDataCallback<SceneBean>() {
        @Override
        public void onSuccess(SceneBean sceneBean) {
            Log.d(TAG, "Modify Scene Success");
        }

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

10.6 执行场景

【描述】

用于手动执行场景任务。

【方法原型】

/**
 * 执行场景任务
 *
 * @param callback 回调
 */
void executeScene(IExecuteSceneCallback callback);

【代码范例】

String sceneId = sceneBean.getId();  //获取场景id以初始化TuyaSmartScene类

TuyaScene.getTuyaSmartScene(sceneId).executeScene(new IExecuteSceneCallback() {
    @Override
    public void onSuccess() {
        Log.d(TAG, "Excute Scene Success");
    }

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

10.7 删除场景

【描述】

用于删除场景。

【方法原型】

/**
 * 删除场景
 *
 * @param callback 回调
 */
void deleteScene(IDeleteSceneCallback callback);

【代码范例】

String sceneId = sceneBean.getId();  //获取场景id以初始化TuyaSmartScene类

TuyaScene.getTuyaSmartScene(sceneId).deleteScene(new 
IDeleteSceneCallback() {
    @Override
    public void onSuccess() {
        Log.d(TAG, "Delete Scene Success");
    }

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

11.消息中心

11.1 获取消息列表

【描述】

用于获取全部消息列表。

【方法原型】

/**
 *  获取消息列表
 *
 * @param callback 回调
 */
void getMessageList(ITuyaDataCallback<List<MessageBean>> callback);

其中， MessageBean提供以下接口：

/**
 * 获取日期和时间 格式: 2017-09-08 17:12:45
 *
 * @return 日期和时间
 */
public String getDateTime() {
    return dateTime;
}

/**
 * 获取消息图标URL
 *
 * @return 消息图标URL
 */
public String getIcon() {
    return icon;
}

/**
 * 获取消息类型名称(如果是告警类型消息则为dp点名称)
 *
 * @return 消息类型名称
 */
public String getMsgTypeContent() {
    return msgTypeContent;
}

/**
 *  获取消息内容, 可用于界面展示
 *
 * @return 消息内容
 */
public String getMsgContent() {
    return msgContent;
}

/**
 * 获取消息类型
 * 0: 系统消息
 * 1: 有新的设备
 * 2: 有新的好友
 * 4: 设备告警
 *
 * @return 消息类型
 */
public int getMsgType() {
    return msgType;
}

/**
 * 获取设备id
 * 注： 只有告警类型消息才会有该字段
 *
 * @return 设备ID
 */
public String getMsgSrcId() {
    return msgSrcId;
}

/**
 *  获取消息id
 *
 * @return 消息id
 */
public String getId() {
    return id;
}

【代码范例】

TuyaMessage.getInstance().getMessageList(new ITuyaDataCallback<List<MessageBean>>() {
    @Override
    public void onSuccess(List<MessageBean> result) {
    }

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

11.2 删除消息

【描述】

用于批量删除消息。

【方法原型】

/**
 *  删除消息
 *
 * @param mIds 要删除的消息的id列表
 * @param callback 回调
 */
void deleteMessage(List<String> mIds, IBooleanCallback callback);

【代码范例】

List<String> deleteList = new ArrayList<>();  
deleteList.add(messageBean.getId());  //取要删除的消息的id添加到列表中
TuyaMessage.getInstance().deleteMessages(
    deleteList, 
    new IBooleanCallback() {
        @Override
        public void onSuccess() {
            
        }

        @Override
        public void onError(String errorCode, String errorMessage) {

        }
});

11.3 获取最新一条消息时间戳

【描述】

获取最新一条消息的时间戳，可以用于与本地最新一条消息时间戳比较，大于本地最新消息时，表示有新消息

可以展示一个红点提示。

【方法原型】

 /**
     *  获取最新的消息 时间戳
     * @param callback
     */
void getMessageMaxTime(ITuyaDataCallback<Integer> callback);

【代码范例】

TuyaMessage.getInstance().getMessageMaxTime(new ITuyaDataCallback<Integer>() {
         @Override
         public void onSuccess(Integer result) {
         }

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

12.意见反馈

12.1 获取反馈列表

【描述】

获取该用户所有的反馈。

【方法原型】

/**
 * 获取反馈列表
 *
 * @param callback 回调
 */
void getFeedbackList(final ITuyaDataCallback<List<FeedbackBean>> callback);

其中， FeedbackTalkBean类提供以下接口:

/**
 * 获取日期和时间 格式: 2017-09-08 17:12:45
 * 
 * @return 日期和时间
 */
public String getDateTime() {
    return dateTime;
}

/**
 *  获取最新一条反馈内容, 用于显示在列表中
 *
 * @return 反馈内容
 */ 
public String getContent() {
    return content;
}

/**
 *  获取反馈类目id
 *
 * @return 反馈类目id
 */
public String getHdId() {
    return hdId;
}

/**
 * 获取反馈类型
 * 2: 设备故障
 * 7: 其他
 *
 * @return 反馈类型
 */
public int getHdType() {
    return hdType;
}

/**
 *  获取反馈类目标题(如果为设备故障反馈即设备名称)
 *
 * @return 类目标题
 */
public String getTitle() {
    return title;
}

【代码范例】

TuyaFeedback.getFeedbackManager().getFeedbackList(new ITuyaDataCallback<List<FeedbackBean>>() {
    @Override
    public void onSuccess(List<FeedbackBean> feedbackTalkBeans) {
    }

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

12.2 获取反馈类目列表

【描述】

获取可选择的反馈条目列表，用于创建反馈之前�选择。

【方法原型】

/**
 * 获取反馈类目列表
 *
 * @param callback 回调
 */
void getFeedbackType(final ITuyaDataCallback<List<FeedbackTypeRespBean>> callback);

其中, FeedbackTypeRespBean类提供以下接口:

/**
 * 获取反馈类目列表(设备列表和其他列表)
 *
 * @return 类目列表
 */
public ArrayList<FeedbackTypeBean> getList() {
    return list;
}

/**
 *  获取列表类别(目前仅有设备和其他)
 * 
 * @return 列表类别
 */
public String getType() {
    return type;
}

FeedbackTypeBean类提供以下接口:

/**
 *  获取反馈类目id
 *
 * @return 反馈类目id
 */
public String getHdId() {
    return hdId;
}

/**
 * 获取反馈类型
 * 2: 设备故障
 * 7: 其他
 *
 * @return 反馈类型
 */
public int getHdType() {
    return hdType;
}

/**
 *  获取反馈类目标题(如果为设备故障反馈即设备名称)
 *
 * @return 类目标题
 */
public String getTitle() {
    return title;
}

【代码范例】

TuyaFeedback.getFeedbackManager().getFeedbackType(new ITuyaDataCallback<List<FeedbackTypeRespBean>>() {
    @Override
    public void onSuccess(List<FeedbackTypeRespBean> feedbackTypeRespBeans) {
    }

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

12.3 新增反馈

【描述】

用于新建反馈。

【方法原型】

/**
 * 添加反馈
 *
 * @param message  反馈内容
 * @param hdId     反馈类目id
 * @param hdType   反馈类型
 * @param callback 回调
 */
void addFeedback(final String message, String hdId, int hdType, final ITuyaDataCallback<FeedbackMsgBean> callback);

注 hdId, hdType变量可以从获取反馈类目列表接口返回的FeedbackTypeBean类中获取。

【代码范例】

TuyaFeedback.getFeedbackManager().addFeedback(
    "设备存在故障", //反馈信息
    feebackTypeBean.getHdId(), 
    feebackTypeBean.getHdType(), 
    new ITuyaDataCallback<FeedbackMsgBean>() {
        @Override
        public void onSuccess(FeedbackMsgBean feedbackMsgBean) {
        }

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

12.4 反馈消息管理

由获取反馈列表接口返回的反馈列表中，每个反馈对象都对应者一组消息(对话)。请用该接口返回的FeedbackBean对象的参数来调用TuyaFeedback.getFeedbackMsg方法来初始化消息管理类。

例:

ITuyaFeedbackMag mFeedbackMag = TuyaFeedback.getFeedbackMsg(
    feedbackBean.getHdId(),
    feedbackBean.getHdType()
);

12.4.1 获取反馈消息列表

【描述】

用于获取当前反馈话题的消息列表。

【方法原型】

/**
 * 获取反馈消息列表
 *
 *  @param callback 回调
 */
void getMsgList(ITuyaDataCallback<List<FeedbackMsgBean>> callback);

其中, FeedbackMsgBean提供以下接口:

/**
 *  获取消息内容
 * 
 * @return 消息内容
 */
public String getContent() {
    return content;
}

/**
 *  获取消息时间
 *
 * @return 消息时间
 */
public int getCtime() {
    return ctime;
}

【代码范例】

mFeedbackMsg.getMsgList(new ITuyaDataCallback<List<FeedbackMsgBean>>() {
    @Override
    public void onSuccess(List<FeedbackMsgBean> result) {
    }

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

12.4.2 添加新反馈

【描述】

用于在当前对话中添加新的反馈消息。

【方法原型】

/**
 * 添加新反馈
 *
 * @param msg      反馈内容
 * @param callback 回调
 */
void addMsg(String msg, ITuyaDataCallback<FeedbackMsgBean> callback);

【代码范例】

mFeedbackMsg.addMsg(
    "再次反馈问题", 
    new ITuyaDataCallback<FeedbackMsgBean>() {
        @Override
        public void onSuccess(FeedbackMsgBean result) {
        }

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

13.集成Push

基于Tuya SDK开发的app，Tuya平台支持Push功能，支持给用户发送运营Push和产品的告警Push。

13.1.1 集成友盟

国内Push功能是基于友盟推送开发的，请先参考友盟文档将友盟集成到项目中，涂鸦云支持友盟第三方通道，如果需要小米、华为、魅族通道，去各个平台申请，依照友盟文档初始化

13.1.2 设置用户别名

在确保友盟已经集成到项目中后，通过友盟SDK设置用户id，即aliasId，推送时会按照用户id向用户推送消息.

String  aliasId = PhoneUtil.getDeviceID(mContext);

向友盟设置用户别名：

* @param aliasId Alias		1.可以是你的应用为每个用户自动生成的唯一id，
* 2.也可以是用户采用第三方平台登录时从第三方平台获取到的用户id  具体参考友盟文档
* 3.也可以使用涂鸦SDK中的方法获取唯一的id，PhoneUtil.getDeviceID(context),PhoneUtil位于com.tuya.smart.android.common.utils包中
* @param ALIAS_TYPE		需要填"TUYA_SMART"
mPushAgent.addAlias(aliasId, "TUYA_SMART", new UTrack.ICallBack() {
    @Override
    public void onMessage(boolean isSuccess, String message) {
    }
});

13.1.3 Push涂鸦云注册

将aliasId注册到涂鸦云

* @param aliasId   用户别名 为第二步向友盟注册用户别名的alias
* @param pushProvider   注册push的类别  友盟填"umeng"
		
TuyaPush.getInstance().registerDevice(String aliasId, String pushProvider, new IResultCallback() {
    @Override
    public void onError(String code, String error) {
    }

    @Override
    public void onSuccess() {

    }
});

13.1.4 第三方通道设置

如果使用了友盟第三方通道，弹窗的activity必须命名为SpecialPushActivity. 以小米为例，SpecialPushActivity继承自UmengNotifyClickActivity，并且完整的包名路径为com.activity.SpecialPushActivity.

13.1.5 Push消息接收

继承 UmengMessageService, 实现自己的Service来完全控制达到消息的处理，参考友盟文档完全自定义消息

public class MyPushIntentService extends UmengMessageService {
    @Override
    public void onMessage(Context context, Intent intent) {
        try {
            String message = intent.getStringExtra(AgooConstants.MESSAGE_BODY);
            UMessage msg = new UMessage(new JSONObject(message);
            UmLog.d(TAG, "message=" + message);      //消息体
            UmLog.d(TAG, "custom=" + msg.custom);    //自定义消息的内容
            UmLog.d(TAG, "title=" + msg.title);      //通知标题
            UmLog.d(TAG, "text=" + msg.text);        //通知内容
            
            PushBean pushBean=PushBean.formatMessage(msg.custom)

        } catch (Exception e) {
            L.e(TAG, e.toString());
        }
}

在自定义Application类的onCreate方法中调用：

PushAgent.getInstance(mContext).setPushIntentServiceClass(MyPushIntentService.class);

【说明】

msg.custom中的内容就是收到的推送信息
msg.custom的具体协议格式： custom=tuya://message?a=view&ct=${title}&cc=${content}&p={}&link=tuyaSmart%3A%2F%2Fbrowser%3Furl%3Dhttp%253A%252F%252Fwww.baidu.com;
通过PushBean.formatMessage()来对数据进行解析得到PushBean

13.1.6 用户解绑

【说明】

在用户退出登录等需要解除应用和用户关系的操作下调用友盟的移除别名的方法

* @param aliasId Alias		用户自动生成的唯一id
* @param ALIAS_TYPE		需要填"TUYA_SMART"
 
mPushAgent.deleteAlias(aliasId, "TUYA_SMART", new UTrack.ICallBack() {
    @Override
    public void onMessage(boolean isSuccess, String message) {
    }
});

13.1.7 发送Push

新增运营Push

涂鸦开发者平台 - 用户运营 - 消息中心 - 新增消息

新增告警Push

涂鸦开发者平台 - 对应产品 - 扩展功能 - 告警设置 - 新增告警规则(应用推送方式)

13.2.1 集成FCM Push

对于国外的用户，需要提供Google的FCM推送服务。先参照官方文档将 Firebase 添加到您的 Android 项目,之后配置客户端，参考 Android客户端配置Firebase

13.2.2 将注册令牌注册到涂鸦云

在继承FirebaseInstanceIdService类的onTokenRefresh方法监控注册令牌的生成，并将令牌注册到涂鸦云。

* @param aliasId   用户别名 即fcm生成的token
* @param pushProvider   注册push的类别  fcm填"gcm"
		
TuyaPush.getInstance().registerDevice(String aliasId, String pushProvider, new IResultCallback() {
    @Override
    public void onError(String code, String error) {
    }

    @Override
    public void onSuccess() {

    }
});

13.2.3 用户解绑

【说明】

在用户退出登录等需要解除应用和用户关系的操作下调用FCM的移除注册令牌的方法

FirebaseInstanceId.getInstance().deleteInstanceId();

14.错误码

错误码	描述
101	网络异常
102	json转义失败
103	网络错误，无法访问网络
104	手机时钟不对 https证书过期
105	登陆需要session信息
106	同步io错误
1001	配网网络错误
1002	配网绑定网关失败
1004	配网获取token失败
1005	配网检测设备在线状态失败
1006	配网超时
1007	配网错误设备列表
1100	手机号码不正确
1101	验证码不正确
1102	升级错误
10201	设备局域网不在线
10202	设备云端不在线
10203	设备不在线
11001	下发的command格式有误
11002	设备已被移除
11004	签名有误
11005	下发失败
11009	下发数据为空
12001	数据解析失败
12002	签名不一致
12003	数据过期
12004	协议号不存在

Files

android-sdk.md

Latest commit

History

android-sdk.md

File metadata and controls

title: Android SDK 开发指南 subtitle: Android SDK 开发指南 published: true

涂鸦智能Android SDK 接入指南

1.功能概述

2.集成准备

获取App ID和App Secret

3.集成SDK

3.1 集成准备

（1）创建工程

（2）引入aar包

（3）build.gradle 配置

【注意事项】

（4）AndroidManifest.xml 设置

（5）混淆配置

3.2 在代码中使用SDK功能

(1) Application中初始化涂鸦智能sdk。

【描述】

【代码范例】

【注意事项】

(2) 注销涂鸦智能云连接

(3) 注册session失效监听

【描述】

【方法调用】

【实现回调】

【代码范例】

4.用户管理

4.1 用户手机验证码登陆

(1)手机验证码登陆

【描述】

【代码调用】

【代码范例】

4.2 用户手机密码登陆

(1)手机密码注册

【描述】

【方法调用】

【代码范例】

(2)手机密码登陆

【描述】

【方法调用】

【代码范例】

(3)手机重置密码

【描述】

【方法调用】

【代码范例】

4.3 用户邮箱密码登陆

(1) 用户邮箱密码注册

【描述】

【方法调用】

【代码范例】

【注意事项】

(2) 用户邮箱密码登陆

【描述】

【方法调用】

【代码范例】

(3) 用户邮箱重置密码

【描述】

【方法调用】

【代码范例】

4.4 用户uid登陆体系

(1) 用户uid注册

【描述】

【方法调用】

【代码范例】

(2) 用户uid登陆

【描述】

【方法调用】

【代码范例】

(3) 用户uid重置密码

【描述】

4.5 第三方登陆

Twitter登陆

【方法调用】

QQ登陆

【方法调用】

微信登陆