使用

初始化数据同步服务

ConchService 为数据同步 API 能力提供类,ConchConfig 为数据同步配置类。

说明:数据同步依赖于TMF基础库,用数据同步之前需要确保基础库已完成初始化。

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
Copyright © 2013-2023 Tencent Cloud. all right reserved,powered by GitbookUpdate Time 2023-08-31 14:46:07

results matching ""

    No results matching ""