com.aliyun.alink.linksdk.tmp.api

接口 IDevice

public interface IDevice

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

从以下版本开始:

1.0

方法概要

限定符和类型	方法和说明
boolean	delAuthUser(java.lang.String uid, java.lang.Object tag, IDevListener handler) 已过时。
java.util.Map<java.lang.String,ValueWrapper>	getAllPropertyValue() 获取所有属性值
java.lang.String	getDevId() 获取设备的唯一标识符
java.lang.String	getDevName() 获取设备的名称
java.util.List<Event>	getEvent() 获取设备的事件列表
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	putAuthUser(java.lang.String uid, java.lang.String key, java.lang.Object tag, IDevListener handler) 已过时。
java.lang.String	regRes(java.lang.String identifier, boolean isNeedAuth, ITResRequestHandler handler) 注册资源
boolean	setPropertyValue(java.util.List<KeyValuePair> keyValuePairList, java.lang.Object tag, IDevListener handler) 异步设置多个属性的值
boolean	setPropertyValue(java.lang.String identifier, ValueWrapper value, java.lang.Object tag, IDevListener handler) 异步设置一个属性的值
boolean	subAllEvent(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) 触发资源的变化事件
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()

获取设备的唯一标识符

返回:

设备的唯一标识符

getDevName

java.lang.String getDevName()

获取设备的名称

返回:

设备的昵称

getProperties

java.util.List<Property> getProperties()

获取设备的属性列表

返回:

设备的属性列表

getServices

java.util.List<Service> getServices()

获取设备的方法列表

返回:

设备的方法类标

getEvent

java.util.List<Event> getEvent()

获取设备的事件列表

返回:

设备的事件列表

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.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 - 回调接口

返回:

函数调用使用成功

subAllEvent

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

监听设备的所有事件

参数:

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

handler - 回调接口

返回:

函数调用使用成功

unsubscribeEvent

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

取消监听设备的一个事件

参数:

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

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

handler - 回调接口

putAuthUser

@Deprecated
boolean putAuthUser(java.lang.String uid,
                                java.lang.String key,
                                java.lang.Object tag,
                                IDevListener handler)

已过时。

delAuthUser

@Deprecated
boolean delAuthUser(java.lang.String uid,
                                java.lang.Object tag,
                                IDevListener 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)

触发资源的变化事件

参数:

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

inputParams - 事件的参数

返回:

触发调用是否成功