设备模型 Android SDK

更新时间：2019-03-11 14:13:29

概述

设备控制 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控

初始化

参考平台下载包里的说明文件。

如何使用

获取本地发现且支持本地控制的设备列表
本地通信功能是设备模型 SDK 提供的一项基础能力，它提供了在外网断连的情况下，局域网内设备控制的 feature。
当外网断连的情况下，本地通信模块会去搜寻当前局域网内的设备，如果被发现的设备是之前用户控制过的设备，那么此时可以通过本地通信链路去控制设备。
在外网断连时，如向云端拉取用户账号下的设备列表会失败，此时可以使用以下接口获取当前可以本地通信控制的设备列表。由于本地发现设备是一个较长的过程，所以第一次调用此接口时有可能返回为空，此时需要允许用户刷新设备列表。
此 API 在 sdk 版本 2.1.4 中新增

DeviceManager.getInstance().getLocalAuthedDeviceDataList();

返回值是一个 JSONArray 对象，对象内的数据格式具体请参见 根据设备获取绑定关系协议的

设备创建

设备创建

PanelDevice panelDevice = new PanelDevice(iotid);

iotid 可以通过云端接口获取。具体请参见 物的核心模型服务。

panelDevice.init(context, new IPanelCallback() {
            @Override
            public void onComplete(boolean b, Object o) {               
            }
        });

context是应用的上下文，IPanelCallback 是初始化回调接口

设备控制

设备控制是基于物的模型对设备定义的属性、事件、服务进行操作。关于属性、事件、服务的描述，请参见 生成物的模型TSL

获取设备状态

panelDevice.getStatus(new IPanelCallback() {
                    @Override
                    public void onComplete(boolean bSuc, Object o) {
                        ALog.d(TAG,"getStatus(), request complete," + bSuc);
                        JSONObject data = new JSONObject((String)o);
                    }
                });

获取设备属性

panelDevice.getProperties(new IPanelCallback() {
                    @Override
                    public void onComplete(boolean bSuc, Object o) {
                        ALog.d(TAG,"getProps(), request complete," + bSuc);
                        JSONObject data = new JSONObject((String)o);
                    }
                });

通过panelDevice 的getProperties接口，获取到设备当前的所有属性值。

设置设备属性

panelDevice.setProperties(paramsStr, new IPanelCallback() {
                    @Override
                    public void onComplete(boolean bSuc, Object o) {
                        ALog.d(TAG,"setProps(), request complete,"+bSuc);
                        JSONObject data = new JSONObject((String)o);
                    }
                })；

paramsStr是设置属性协议中params参数的字符串,请参见物的模型服务

调用服务

panelDevice.invokeService(paramsStr, new IPanelCallback() {
                    @Override
                    public void onComplete(boolean bSuc, Object o) {
                        ALog.d(TAG,"callService(), request complete,"+bSuc);
                        JSONObject data = new JSONObject((String)o);
                    }
                });

paramsStr是调用服务中params参数的字符串，请参见物的模型服务

订阅所有事件

panelDevice.subAllEvent(new IPanelEventCallback() {
                    @Override
                    public void onNotify(String iotid,String topic, Object data) {
                        ALog.d(TAG,"onNofity(),topic = "+topic);
                        JSONObject jData = new JSONObject((String)data);
                    }
                },null);

iotid 参数是设备iotid
topic 参数是回调的事件主题字符串
Object data 是触发事件的内容

清理缓存

账号退出时需要清理账号缓存的数据

DeviceManager.getInstance().clearAccessTokenCache();

混淆配置

-keep class com.aliyun.alink.linksdk.tmp.**{*;}

-keep class com.aliyun.alink.linksdk.cmp.**{*;}

-keep class com.aliyun.alink.linksdk.alcs.**{*;}

-keep class com.aliyun.iot.ble.**{*;}

-keep class com.aliyun.iot.breeze.**{*;}

更多功能

获取物的模型

panelDevice.getTsl(new IPanelCallback() {
        @Override
        public void onComplete(boolean bSuc, Object data) {
               ALog.d(TAG,"doTslTest data:" + data) ;
        }
    });

开发者也可以使用云端接口来获取原始的物的模型。
具体请参见 物的核心模型服务-获取物的模板 。

Android 设备端支持

设备模型 SDK 不仅用于移动端 App 开发，也能用于运行 Android 系统的设备开发。
通过本地通信服务端可以让一个 Android 设备成为能被 APP 端访问和控制的设备。如带 Android 系统的空调，通过本地通信服务端可以让空调设备接收到 APP 端的操作请求，空调设备调整自身设置后返回响应的结果到 APP ，由 APP 显示最新的运行情况，整个过程在本地网络进行，安全快捷。

创建服务端设备

protected int mDefaultProfile = 3;
protected int mDefaultWorkMode = 3;
protected int mDefaultBrightness = 30;
//设置设备属性的初始值
Map<String,ValueWrapper> propertyValues = new HashMap<>();
propertyValues.put("profile",new ValueWrapper.IntValueWrapper(mDefaultProfile));
propertyValues.put("Brightness",new ValueWrapper.IntValueWrapper(mDefaultBrightness));
propertyValues.put("WorkMode",new ValueWrapper.IntValueWrapper(mDefaultWorkMode));
final DefaultServerConfig config = new DefaultServerConfig();
//服务端颁发的设备三元组
config.mIotProductKey = mIotProductKey;
config.mIotDeviceName = mIotDeviceName;
config.mIotSecret     = mIotDeviceSecret;
//设置设备的基础信息
DeviceBasicData basicData = new DeviceBasicData();
basicData.setProductKey(productKey);
basicData.setDeviceName(deviceName);
//deviceModel为设备在后台开发得到的tsl字符串
basicData.setDeviceModelJson(deviceModel);
basicData.setLocal(true);
basicData.setPort(5683);
config.setBasicData(basicData);
config.setPropertValues(propertyValues);
//创建设备并初始化
IDevice mIDevice = DeviceManager.getInstance().createDevice(config);
mIDevice.init(null, new IDevListener() {
    @Override
    public void onSuccess(Object o, OutputParams outputParams) {
    }
    @Override
    public void onFail(Object o, ErrorInfo errorInfo) {
    }
});

注册设备信息并处理请求

在设备初始化成功后注册发现和设备三要素，处理客户端的请求并返回响应
注册发现协议并处理

mIDevice.regRes("dev",false, new ITResRequestHandler() {
    @Override
    public void onProcess(String s, InputParams inputParams, ITResResponseCallback itResResponseCallback) {
        ValueWrapper valueWrapper = new ValueWrapper();
        valueWrapper.setValue(deviceModelMap); 
        itResResponseCallback.onComplete(TmpConstant.METHOD_IDENTIFIER_DEV,null, new OutputParams("deviceModel",valueWrapper));
    }
});

注册三要素并处理

mIDevice.regRes("set",true, new ITResRequestHandler() {
    @Override
    public void onProcess(String identifier, InputParams inputParams, ITResResponseCallback itResResponseCallback) {
        boolean isSuc = true;
        OutputParams outputParams = new OutputParams();
        //根据参数处理请求
        //...
        if(isSuc){                                                                                
          itResResponseCallback.onComplete("set",null,outputParams);
        }else{
            itResResponseCallback.onComplete("set",new ErrorInfo(ErrorCode.ERROR_CODE,ErrorCode.PARAM_ERR_DESC),null);
        }
    }
});