动态配置与动态更新地址¶

本文介绍 UniApp SDK 0.3.0 及以上版本的主动更新远程配置和动态更新上报地址能力。

动态配置¶

主动更新远程配置¶

uni-app 应用调用前需要在 sdkConfig 中设置 remoteConfiguration: true；宿主 App 中的 uni 小程序由宿主 App 在初始化 Native SDK 时开启远程配置。miniUpdateInterval 使用本次调用指定的最小更新间隔。

mobileAgent.updateRemoteConfigWithMiniUpdateInterval({
    miniUpdateInterval: 0
}, result => {
    if (result.success) {
        console.log('remote config: ' + result.rawJson);
    } else {
        console.log('remote config failed: ' + result.errorMessage);
    }
});

API - updateRemoteConfigWithMiniUpdateInterval¶

请求字段	类型	必须	说明
miniUpdateInterval	number	否	本次主动更新的最小间隔，范围 `[0,)`，单位秒，默认 `0`

回调参数：

返回字段	类型	说明
success	boolean	是否更新成功
platform	string	当前平台
rawJson	string	更新成功时返回的原始远程配置 JSON 字符串
errorCode	number/string	更新失败时的错误码
errorMessage	string	更新失败时的错误信息

动态更新上报地址¶

初始化时可以同时省略 datakitUrl 和 datawayUrl。设置有效上报地址前，SDK 仍可初始化并缓存数据；设置地址后开始上传。setDatakitURL 与 setDatawayURL 二选一使用，切换到 DataWay 时必须同时传入 clientToken。

mobileAgent.setDatakitURL({
    datakitUrl: 'http://10.0.0.1:9529'
});

// 使用 DataWay 时调用以下方法替代 setDatakitURL。
mobileAgent.setDatawayURL({
    datawayUrl: 'https://open.dataway.url',
    clientToken: 'client-token'
});

API - setDatakitURL¶

字段	类型	必须	说明
datakitUrl	string	是	新的 Datakit 上报地址

API - setDatawayURL¶

字段	类型	必须	说明
datawayUrl	string	是	新的 DataWay 上报地址
clientToken	string	是	与 DataWay 地址匹配的认证 Token