进阶指南

最近更新 2026/09/03

1. 初始化参数

初始化传入的 TDRemoteConfigSettings 配置详细解释如下：

属性名	类型	说明
appId	String	在 AE 后台创建的项目的 app id
serverUrl	String	在 AE 后台创建的项目的 server url
mode	TDRemoteConfigMode	NORMAL:正常模式 DEBUG：调试模式
customFetchParams	Map<String, dynamic>?	（TDRemoteConfig 使用）拉取配置时的自定义请求参数

2. 自定义拉取时机

2.1 自动拉取

在以下场景，SDK 会自动拉取远端配置数据

• App 冷启动
• App 前后台切换，两次间隔超过6小时
• 数据采集SDK账号系统发生了变更，例如 login、logout

2.2 手动拉取

手动调用 SDK 方法，随时拉取远端配置

TDRemoteConfig.fetch();

该 API 内部有频控限制，请避免频繁拉取。

3. 自定义 Fetch 参数

Fetch 参数为客户端 SDK 请求 AE 服务端取值时可用的参数，您可自定义 Fetch 参数，将参数添加为配置通道的环境参数，即可在配置策略时，使用 Fetch 参数自定义目标受众环境。

3.1 添加

TDRemoteConfig.setCustomFetchParams({"fetch_key": "fetch_value"});

3.2 删除

根据指定的 key 进行删除

TDRemoteConfig.removeCustomFetchParam("key");