MobileChannel

java.lang.Object
- com.aliyun.alink.linksdk.channel.mobile.api.MobileChannel

All Implemented Interfaces:: IMobileChannel

public class MobileChannel
extends java.lang.Object
implements IMobileChannel

Mobile 长连接入口类

Constructor Summary

Constructors
Constructor and Description

MobileChannel()

Constructors
Constructor and Description
`MobileChannel()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`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)` 账号绑定长连通道
`void`	`endConnect()` 长连接通道关闭异步接口
`void`	`endConnect(long waitTime, IMqttActionListener listener)` 长连接通道关闭异步接口
`java.lang.String`	`getClientId()` 建联成功后，可获取ClientID
`static IMobileChannel`	`getInstance()`
`MobileConnectState`	`getMobileConnectState()` 获取当前长连接通道状态
`void`	`registerConnectListener(boolean uiSafey, IMobileConnectListener listener)` 注册通道的状态变化
`void`	`registerDownstreamListener(boolean uiSafey, IMobileDownstreamListener listener)` 设置通道的下推回调，如果不需要用的时候，记得调用removeDownStreamListener
`static void`	`setOpenLog(boolean logFlag)`
`void`	`startConnect(Context context, MobileConnectConfig config, IMobileConnectListener listener)` 长连接通道启动接口，应用起来时调用一次
`void`	`subscrbie(java.lang.String topic, IMobileSubscrbieListener listener)` app订阅topic的接口
`void`	`unBindAccount(IMobileRequestListener listener)` 长连通道解除绑定当前账号
`void`	`unRegisterConnectListener(IMobileConnectListener listener)` 取消注册通道的状态变化监听
`void`	`unRegisterDownstreamListener(IMobileDownstreamListener listener)` 取消某个通道的下推回调
`void`	`unSubscrbie(java.lang.String topic, IMobileSubscrbieListener listener)` app取消订阅topic的接口

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MobileChannel
```
public MobileChannel()
```
- Method Detail
  - getInstance
```
public static IMobileChannel getInstance()
```
  - setOpenLog
```
public static void setOpenLog(boolean logFlag)
```
  - startConnect
```
public void startConnect(Context context,
                         MobileConnectConfig config,
                         IMobileConnectListener listener)
```
    Description copied from interface: IMobileChannel
    
    长连接通道启动接口，应用起来时调用一次
    
    Specified by:
    
    startConnect in interface IMobileChannel
    
    config - app身份鉴权配置项
    
    listener - 反馈通道状态变化
  - endConnect
```
public void endConnect()
```
    Description copied from interface: IMobileChannel
    
    长连接通道关闭异步接口
    
    Specified by:
    
    endConnect in interface IMobileChannel
  - endConnect
```
public void endConnect(long waitTime,
                       IMqttActionListener listener)
```
    Description copied from interface: IMobileChannel
    
    长连接通道关闭异步接口
    
    Specified by:
    
    endConnect in interface IMobileChannel
  - getMobileConnectState
```
public MobileConnectState getMobileConnectState()
```
    Description copied from interface: IMobileChannel
    
    获取当前长连接通道状态
    
    Specified by:
    
    getMobileConnectState in interface IMobileChannel
    
    Returns:
  - getClientId
```
public java.lang.String getClientId()
```
    Description copied from interface: IMobileChannel
    
    建联成功后，可获取ClientID
    
    Specified by:
    
    getClientId in interface IMobileChannel
    
    Returns:
  - bindAccount
```
public void bindAccount(java.lang.String iotToken,
                        IMobileRequestListener listener)
```
    Description copied from interface: IMobileChannel
    
    账号绑定长连通道
    
    Specified by:
    
    bindAccount in interface IMobileChannel
    
    Parameters:
    
    iotToken - 帐号登录后去IoT后台申请的token
    
    listener - 绑定结束的Listener
  - unBindAccount
```
public void unBindAccount(IMobileRequestListener listener)
```
    Description copied from interface: IMobileChannel
    
    长连通道解除绑定当前账号
    
    Specified by:
    
    unBindAccount in interface IMobileChannel
    
    Parameters:
    
    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)
```
    Description copied from interface: IMobileChannel
    
    RPC请求接口，封装了业务的上行request以及下行resp。
    
    Specified by:
    
    asyncSendRequest in interface IMobileChannel
    
    Parameters:
    
    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)
```
    Description copied from interface: IMobileChannel
    
    发布消息接口，不同于[invokeWithMethod:opts:params:respHandler:]。这个接口不会有业务回执。
    
    Specified by:
    
    ayncSendPublishRequest in interface IMobileChannel
    
    Parameters:
    
    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)
```
    Description copied from interface: IMobileChannel
    
    app订阅topic的接口
    
    Specified by:
    
    subscrbie in interface IMobileChannel
    
    Parameters:
    
    topic - 订阅的消息的topic，由具体业务确定，只需要传业务方的区段，公用区段不需要传. 可以参见asyncSendRequest 中的topic定义
    
    listener - 订阅流程结束的监听
  - unSubscrbie
```
public void unSubscrbie(java.lang.String topic,
                        IMobileSubscrbieListener listener)
```
    Description copied from interface: IMobileChannel
    
    app取消订阅topic的接口
    
    Specified by:
    
    unSubscrbie in interface IMobileChannel
    
    Parameters:
    
    topic - 订阅的消息的topic，由具体业务确定，只需要传业务方的区段，公用区段不需要传. 可以参见invokeWithTopic:opts:params:respHandler: 中的topic定义
    
    listener - 订阅流程结束的监听
  - registerDownstreamListener
```
public void registerDownstreamListener(boolean uiSafey,
                                       IMobileDownstreamListener listener)
```
    Description copied from interface: IMobileChannel
    
    设置通道的下推回调，如果不需要用的时候，记得调用removeDownStreamListener
    
    Specified by:
    
    registerDownstreamListener in interface IMobileChannel
    
    Parameters:
    
    uiSafey - 是否要在UI线程里回调，建议为YES
  - unRegisterDownstreamListener
```
public void unRegisterDownstreamListener(IMobileDownstreamListener listener)
```
    Description copied from interface: IMobileChannel
    
    取消某个通道的下推回调
    
    Specified by:
    
    unRegisterDownstreamListener in interface IMobileChannel
  - registerConnectListener
```
public void registerConnectListener(boolean uiSafey,
                                    IMobileConnectListener listener)
```
    Description copied from interface: IMobileChannel
    
    注册通道的状态变化
    
    Specified by:
    
    registerConnectListener in interface IMobileChannel
    
    Parameters:
    
    uiSafey - 是否需要在UI线程回调
  - unRegisterConnectListener
```
public void unRegisterConnectListener(IMobileConnectListener listener)
```
    Description copied from interface: IMobileChannel
    
    取消注册通道的状态变化监听
    
    Specified by:
    
    unRegisterConnectListener in interface IMobileChannel

Class MobileChannel

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MobileChannel

Method Detail

getInstance

setOpenLog

startConnect

endConnect

endConnect

getMobileConnectState

getClientId

bindAccount

unBindAccount

asyncSendRequest

ayncSendPublishRequest

subscrbie

unSubscrbie

registerDownstreamListener

unRegisterDownstreamListener

registerConnectListener

unRegisterConnectListener