com.aliyun.alink.linksdk.channel.mobile.api

类 MobileChannel

java.lang.Object

com.aliyun.alink.linksdk.channel.mobile.api.MobileChannel

所有已实现的接口:

IMobileChannel

public class MobileChannel
extends java.lang.Object
implements IMobileChannel

Mobile 长连接入口类

构造器概要

构造器

构造器和说明
MobileChannel()

方法概要

限定符和类型	方法和说明
void	asyncSendRequest(java.lang.String topic, java.util.Map<java.lang.String,java.lang.Object> opts, java.lang.Object params, IMobileRequestListener listener) RPC请求接口，封装了业务的上行request以及下行resp。
void	ayncSendPublishRequest(java.lang.String topic, java.lang.Object params, IMobileRequestListener listener) 发布消息接口，不同于[invokeWithMethod:opts:params:respHandler:]。
void	bindAccount(java.lang.String iotToken, IMobileRequestListener listener) 账号绑定长连通道
java.lang.String	getClientId() 建联成功后，可获取ClientID
static IMobileChannel	getInstance()
MobileConnectState	getMobileConnectState() 获取当前长连接通道状态
void	registerConnectListener(boolean uiSafey, IMobileConnectListener listener) 注册通道的状态变化
void	registerDownstreamListener(boolean uiSafey, IMobileDownstreamListener listener) 设置通道的下推回调，如果不需要用的时候，记得调用removeDownStreamListener
void	startConnect(android.content.Context context, MobileConnectConfig config, IMobileConnectListener listener) 长连接通道启动接口，应用起来时调用一次
void	subscrbie(java.lang.String topic, IMobileSubscrbieListener listener) app订阅topic的接口
void	unBindAccount(java.lang.String iotToken, IMobileRequestListener listener) 长连通道解除绑定当前账号
void	unRegisterConnectListener(IMobileConnectListener listener) 取消注册通道的状态变化监听
void	unRegisterDownstreamListener(IMobileDownstreamListener listener) 取消某个通道的下推回调
void	unSubscrbie(java.lang.String topic, IMobileSubscrbieListener listener) app取消订阅topic的接口

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

MobileChannel

public MobileChannel()

方法详细资料

getInstance

public static IMobileChannel getInstance()

startConnect

public void startConnect(android.content.Context context,
                         MobileConnectConfig config,
                         IMobileConnectListener listener)

从接口复制的说明: IMobileChannel

长连接通道启动接口，应用起来时调用一次

指定者:

startConnect 在接口中 IMobileChannel

config - app身份鉴权配置项

listener - 反馈通道状态变化

getMobileConnectState

public MobileConnectState getMobileConnectState()

从接口复制的说明: IMobileChannel

获取当前长连接通道状态

指定者:

getMobileConnectState 在接口中 IMobileChannel

返回:

getClientId

public java.lang.String getClientId()

从接口复制的说明: IMobileChannel

建联成功后，可获取ClientID

指定者:

getClientId 在接口中 IMobileChannel

返回:

bindAccount

public void bindAccount(java.lang.String iotToken,
                        IMobileRequestListener listener)

从接口复制的说明: IMobileChannel

账号绑定长连通道

指定者:

bindAccount 在接口中 IMobileChannel

参数:

iotToken - 帐号登录后去IoT后台申请的token

listener - 绑定结束的Listener

unBindAccount

public void unBindAccount(java.lang.String iotToken,
                          IMobileRequestListener listener)

从接口复制的说明: IMobileChannel

长连通道解除绑定当前账号

指定者:

unBindAccount 在接口中 IMobileChannel

参数:

iotToken - 帐号登录后去IoT后台申请的token

listener - 绑定结束的Listener

asyncSendRequest

public void asyncSendRequest(java.lang.String topic,
                             java.util.Map<java.lang.String,java.lang.Object> opts,
                             java.lang.Object params,
                             IMobileRequestListener listener)

从接口复制的说明: IMobileChannel

RPC请求接口，封装了业务的上行request以及下行resp。

指定者:

asyncSendRequest 在接口中 IMobileChannel

参数:

topic - rpc请求的topic，由具体业务确定，上行的完整topic形如： /sys/${productKey}/${deviceName}/app/up/abc/cba 其中App 端 Topic 订阅协议前缀：/sys/${productKey}/${deviceName}/app/up 在sdk中会自动补齐。 所以开发者只需要传完整topic的业务部分，如上例中的/abc/cba即可。 也可以使用通配符 如/abc/#.

opts - 可选配置项，可空，预留

params - 业务参数。

listener - 业务服务器响应回调接口

ayncSendPublishRequest

public void ayncSendPublishRequest(java.lang.String topic,
                                   java.lang.Object params,
                                   IMobileRequestListener listener)

从接口复制的说明: IMobileChannel

发布消息接口，不同于[invokeWithMethod:opts:params:respHandler:]。这个接口不会有业务回执。

指定者:

ayncSendPublishRequest 在接口中 IMobileChannel

参数:

topic - rpc请求的topic，由具体业务确定，上行的完整topic形如： /sys/${productKey}/${deviceName}/app/up/abc/cba 其中App 端 Topic 订阅协议前缀：/sys/${productKey}/${deviceName}/app/up 在sdk中会自动补齐。 所以开发者只需要传完整topic的业务部分，如上例中的/abc/cba即可。 也可以使用通配符 如/abc/#.

subscrbie

public void subscrbie(java.lang.String topic,
                      IMobileSubscrbieListener listener)

从接口复制的说明: IMobileChannel

app订阅topic的接口

指定者:

subscrbie 在接口中 IMobileChannel

参数:

topic - 订阅的消息的topic，由具体业务确定，只需要传业务方的区段，公用区段不需要传. 可以参见asyncSendRequest 中的topic定义

listener - 订阅流程结束的监听

unSubscrbie

public void unSubscrbie(java.lang.String topic,
                        IMobileSubscrbieListener listener)

从接口复制的说明: IMobileChannel

app取消订阅topic的接口

指定者:

unSubscrbie 在接口中 IMobileChannel

参数:

topic - 订阅的消息的topic，由具体业务确定，只需要传业务方的区段，公用区段不需要传. 可以参见invokeWithTopic:opts:params:respHandler: 中的topic定义

listener - 订阅流程结束的监听

registerDownstreamListener

public void registerDownstreamListener(boolean uiSafey,
                                       IMobileDownstreamListener listener)

从接口复制的说明: IMobileChannel

设置通道的下推回调，如果不需要用的时候，记得调用removeDownStreamListener

指定者:

registerDownstreamListener 在接口中 IMobileChannel

参数:

uiSafey - 是否要在UI线程里回调，建议为YES

unRegisterDownstreamListener

public void unRegisterDownstreamListener(IMobileDownstreamListener listener)

从接口复制的说明: IMobileChannel

取消某个通道的下推回调

指定者:

unRegisterDownstreamListener 在接口中 IMobileChannel

registerConnectListener

public void registerConnectListener(boolean uiSafey,
                                    IMobileConnectListener listener)

从接口复制的说明: IMobileChannel

注册通道的状态变化

指定者:

registerConnectListener 在接口中 IMobileChannel

参数:

uiSafey - 是否需要在UI线程回调

unRegisterConnectListener

public void unRegisterConnectListener(IMobileConnectListener listener)

从接口复制的说明: IMobileChannel

取消注册通道的状态变化监听

指定者:

unRegisterConnectListener 在接口中 IMobileChannel