com.aliyun.alink.linksdk.tmp.api

接口 IDevice

public interface IDevice

本地通信接口类
用于读取设备状态，操作设备

从以下版本开始:

1.0

方法概要

限定符和类型	方法和说明
boolean	addDeviceStateChangeListener(IDevStateChangeListener listener) 添加设备状态监听器
java.util.Map<java.lang.String,ValueWrapper>	getAllPropertyValue() 获取所有属性值
TmpEnum.DeviceState	getDeviceState() 获取设备状态
java.lang.String	getDevId() 获取设备的唯一标识符
java.lang.String	getDevName() 获取设备的名称
java.util.List<Event>	getEvents() 获取设备的事件列表
java.util.List<Property>	getProperties() 获取设备的属性列表
boolean	getPropertyValue(java.util.List<java.lang.String> idList, java.lang.Object tag, IDevListener handler) 异步获取属性值
ValueWrapper	getPropertyValue(java.lang.String propId) 同步获取设备属性值
java.util.List<Service>	getServices() 获取设备的方法列表
void	init(java.lang.Object tag, IDevListener handler) 初始化一个设备，包括设备链接，认证，获取设备模型，从设备端读取到设备属性的当前值 本类中的别的所有方法都需要在本方法调用并回调成功之后才能调用
boolean	invokeService(java.lang.String id, java.util.List<KeyValuePair> args, java.lang.Object tag, IDevListener handler) 调用设备提供的一个方法
boolean	regRawRes(boolean isNeedAuth, ITRawDataRequestHandler handler) 监听二进制数据接口
java.lang.String	regRes(java.lang.String identifier, boolean isNeedAuth, ITResRequestHandler handler) 注册资源
boolean	removeDeviceStateChangeListener(IDevStateChangeListener listener) 移除设备状态监听器
boolean	sendRawData(byte[] data, IDevRawDataListener handler) 发送二进制数据
boolean	setPropertyValue(java.util.List<KeyValuePair> keyValuePairList, java.lang.Object tag, IDevListener handler) 异步设置多个属性的值
boolean	setPropertyValue(java.util.Map<java.lang.String,ValueWrapper> properties, boolean isNeedNotify) 设置服务端属性值
boolean	setPropertyValue(java.util.Map<java.lang.String,ValueWrapper> properties, boolean isNeedNotify, IPublishResourceListener listener) 设置服务端属性值
boolean	setPropertyValue(java.lang.String identifier, ValueWrapper value, java.lang.Object tag, IDevListener handler) 异步设置一个属性的值
boolean	setup(java.lang.Object configData, java.lang.Object tag, IDevListener handler) 配置本地通信客户端和服务端
boolean	subAllEvents(java.lang.Object tag, IEventListener handler) 监听设备的所有事件
boolean	subscribeEvent(java.lang.String id, java.lang.Object tag, IEventListener handler) 监听设备的一个事件
boolean	triggerRes(java.lang.String identifier, OutputParams inputParams) 触发资源的变化事件
boolean	triggerRes(java.lang.String identifier, OutputParams inputParams, IPublishResourceListener listener) 触发资源的变化事件
void	unInit() 反初始化设备
boolean	unRegRes(java.lang.String identifier, ITResRequestHandler handler) 注销资源
boolean	unsubscribeEvent(java.lang.String id, java.lang.Object tag, IDevListener handler) 取消监听设备的一个事件

方法详细资料

init

void init(java.lang.Object tag,
          IDevListener handler)

初始化一个设备，包括设备链接，认证，获取设备模型，从设备端读取到设备属性的当前值 本类中的别的所有方法都需要在本方法调用并回调成功之后才能调用

参数:

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

unInit

void unInit()

反初始化设备

getDevId

java.lang.String getDevId()

获取设备的唯一标识符

返回:

设备的唯一标识符

getDeviceState

TmpEnum.DeviceState getDeviceState()

获取设备状态

返回:

设备状态

addDeviceStateChangeListener

boolean addDeviceStateChangeListener(IDevStateChangeListener listener)

添加设备状态监听器

参数:

listener - 设备状态监听器

removeDeviceStateChangeListener

boolean removeDeviceStateChangeListener(IDevStateChangeListener listener)

移除设备状态监听器

参数:

listener - 设备状态监听器

getDevName

java.lang.String getDevName()

获取设备的名称

返回:

设备的昵称

getProperties

java.util.List<Property> getProperties()

获取设备的属性列表

返回:

设备的属性列表

getServices

java.util.List<Service> getServices()

获取设备的方法列表

返回:

设备的方法类标

getEvents

java.util.List<Event> getEvents()

获取设备的事件列表

返回:

设备的事件列表

getPropertyValue

ValueWrapper getPropertyValue(java.lang.String propId)

同步获取设备属性值

参数:

propId - 设备属性唯一标识符

返回:

设备属性值

getAllPropertyValue

java.util.Map<java.lang.String,ValueWrapper> getAllPropertyValue()

获取所有属性值

返回:

所有属性值列表

getPropertyValue

boolean getPropertyValue(java.util.List<java.lang.String> idList,
                         java.lang.Object tag,
                         IDevListener handler)

异步获取属性值

参数:

idList - 属性的唯一标识符列表

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

获取是否成功

setPropertyValue

boolean setPropertyValue(java.util.List<KeyValuePair> keyValuePairList,
                         java.lang.Object tag,
                         IDevListener handler)

异步设置多个属性的值

参数:

keyValuePairList - 设置的属性唯一标识符和值的列表

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用是否成功

setPropertyValue

boolean setPropertyValue(java.util.Map<java.lang.String,ValueWrapper> properties,
                         boolean isNeedNotify,
                         IPublishResourceListener listener)

设置服务端属性值

参数:

properties - 设置的属性唯一标识符和值的集合

isNeedNotify - 是否需要发送post属性变化事件

listener - publish的回调接口

返回:

函数调用是否成功

setPropertyValue

boolean setPropertyValue(java.util.Map<java.lang.String,ValueWrapper> properties,
                         boolean isNeedNotify)

设置服务端属性值

参数:

properties - 设置的属性唯一标识符和值的集合

isNeedNotify - 是否需要发送post属性变化事件

返回:

函数调用是否成功

另请参阅:

setPropertyValue(Map, boolean, IPublishResourceListener)

setPropertyValue

boolean setPropertyValue(java.lang.String identifier,
                         ValueWrapper value,
                         java.lang.Object tag,
                         IDevListener handler)

异步设置一个属性的值

参数:

identifier - 设置的属性唯一标识符和值的列表

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用是否成功

invokeService

boolean invokeService(java.lang.String id,
                      java.util.List<KeyValuePair> args,
                      java.lang.Object tag,
                      IDevListener handler)

调用设备提供的一个方法

参数:

id - 设备方法的方法名，要求展开后的格式

args - 设备方法的参数

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用是否成功

subscribeEvent

boolean subscribeEvent(java.lang.String id,
                       java.lang.Object tag,
                       IEventListener handler)

监听设备的一个事件

参数:

id - 设备事件的事件名，要求展开后的格式

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用使用成功

subAllEvents

boolean subAllEvents(java.lang.Object tag,
                     IEventListener handler)

监听设备的所有事件

参数:

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用使用成功

unsubscribeEvent

boolean unsubscribeEvent(java.lang.String id,
                         java.lang.Object tag,
                         IDevListener handler)

取消监听设备的一个事件

参数:

id - 设备事件的事件名，要求展开后的格式

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用是否成功

setup

boolean setup(java.lang.Object configData,
              java.lang.Object tag,
              IDevListener handler)

配置本地通信客户端和服务端

参数:

configData - 配置数据

tag - 使用者自定义的一个值，在回调方法空会带该值

handler - 回调接口

返回:

函数调用是否成功

regRes

java.lang.String regRes(java.lang.String identifier,
                        boolean isNeedAuth,
                        ITResRequestHandler handler)

注册资源

参数:

identifier - 设备三要素的唯一标识符

isNeedAuth - 访问者是否需要经过认证

handler - 访问处理接口

返回:

主题字符串

unRegRes

boolean unRegRes(java.lang.String identifier,
                 ITResRequestHandler handler)

注销资源

参数:

identifier - 设备三要素的唯一标识符

handler - 访问处理接口，可以为null

返回:

注销调用是否成功

triggerRes

boolean triggerRes(java.lang.String identifier,
                   OutputParams inputParams,
                   IPublishResourceListener listener)

触发资源的变化事件

参数:

identifier - 设备三要素唯一标识符

inputParams - 事件的参数

listener - 触发资源的回调

返回:

触发调用是否成功

triggerRes

boolean triggerRes(java.lang.String identifier,
                   OutputParams inputParams)

触发资源的变化事件

参数:

identifier - 设备三要素唯一标识符

inputParams - 事件的参数

返回:

触发调用是否成功

另请参阅:

triggerRes(String, OutputParams, IPublishResourceListener)

sendRawData

boolean sendRawData(byte[] data,
                    IDevRawDataListener handler)

发送二进制数据

参数:

data -

handler -

返回:

是否发送成功

regRawRes

boolean regRawRes(boolean isNeedAuth,
                  ITRawDataRequestHandler handler)

监听二进制数据接口

参数:

isNeedAuth -

handler -

返回: