使用
初始化数据同步服务
ConchService 为数据同步 API 能力提供类,ConchConfig 为数据同步配置类。
Sample:
//TMFBase初始化
TMFBaseConfig config = new TMFBaseConfig.Builder()
.buildNo(BuildConfig.BUILD_NO) // 必须,网关, 热更等模块需要使用
.debug(true)
//...
.build();
TMFBase.init(this, config);
//初始化云指令服务
conchService = ConchService.getInstance(this);
获取云指令ID
注册监听、拉取云指令都需要云指令ID,获取方法请参见获取云指令ID
注册云指令
/**
* 注册云指令push
* @param cmdId 云指令Id
* @param listener 云指令push监听器,service收到网络层的push信息时,通过该监听器通知业务插件处理具体云指令
*/
@Override
public void registerConchPush(int cmdId, IConchPushListener listener)
参数名称 | 参数类型 | 参数描述 | 必选 |
---|---|---|---|
cmdId | int | 云指令 ID,在控制台上创建云指令模版后分配的 ID | Y |
listener | IConchPushListener | 云指令下发监听接口 | Y |
示例:
conchService.registerConchPush(6238, mConchListener);
批量注册云指令
/**
* 批量注册云指令push
* @param cmdIds 云指令id列表。
* @param listener 云指令push监听器,service收到网络层的push信息时,通过该监听器通知业务插件处理具体云指令
*/
@Override
public void registerConchPush(List<Integer> cmdIds, IConchPushListener listener)
参数名称 | 参数类型 | 参数描述 | 必选 |
---|---|---|---|
cmdIds | List |
云指令 ID 列表,在控制台上创建云指令模版后分配的 ID | Y |
listener | IConchPushListener | 云指令下发监听接口 | Y |
反注册云指令
/**
* 反注册云指令push
* @param cmdId 云指令Id
*/
@Override
public void unRegisterConchPush(int cmdId)
批量反注册云指令
/**
* 批量反注册云指令push
* @param cmdIds 云指令id列表。具体ID定义详见ECondChID.java
*/
@Override
public void unRegisterConchPush(List<Integer> cmdIds)
主动拉取所有云指令
/**
* 拉取云指令,通知后台立即push云指令
*/
@Override
public void pullConch()
主动拉取指定 ID 云指令
/**
* 拉取指定id云指令
* @param conchCmdId
*/
@Override
public void pullConch(final int conchCmdId)
上报云指令执行结果
数据同步执行结果上报到 TMF 服务端,用于 TMF 控制台展示。
@Override
public void reportConchResult(long taskId, long taskSeqno, int cmdId, int conchSeqno, int phase, int result)
参数名称 | 参数类型 | 参数描述 | 必选 |
---|---|---|---|
taskId | long | 任务 ID | Y |
taskSeqno | long | 任务序列号 | Y |
cmdId | int | 云指令 ID | Y |
conchSeqno | int | 云指令序列号 | Y |
phase | int | 云指令执行阶段 | Y |
result | int | 云指令执行结果 | Y |