Unity

最近更新 2026/10/03

最新版本：v1.2.4

更新时间：2026-08-14

资源下载：下载

Beta版本：无

1. 概述

从 AE 4.4 版本开始，运营模块上线了“配置中心”功能，支持在 AE 后台添加功能参数配置，通过客户端 SDK 拉取至App，精细化定制您与玩家的互动内容。

本文介绍客户端SDK的集成过程，App 端只需要关注与数数 SDK 的交互即可，不需要关心 AE 后台配置细节。

2. 集成

2.1 手动集成 SDK

配置中心功能需要依赖以下数数 SDK：

SDK 名称	功能介绍	版本要求
ta_unity_sdk.unitypackage	实现数据采集与处理	>= 3.2.0
ta_remoteconfig_sdk.unitypackage	拉取 AE 后台的配置信息	>= 1.0.0
ta_core_sdk.unitypackage	提供基础组件能力	>= 1.0.0

1. 点击页面上方资源下载链接，下载SDK并解压
2. 双击ta_unity_sdk.unitypackage、ta_remoteconfig_sdk.unitypackage、ta_core_sdk.unitypackage

3. 初始化

在主线程初始化 SDK

using ThinkingData.Core;
// TDSettings 配置的详细使用方式请查看【进阶指南】
TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
TDApp.Init(settings);

4. 使用

4.1 数据结构样例

"configId" : {
    "templateId" : [
        {
         "#strategy_id" : "2024121001",
          "paramater_x" : "1111",
          "#ops_receipt_properties" : {}
        }
    ],
    "#custom_params" : {

    }
}

其中：

configId：在运营后台配置中心模块创建的“配置项ID”，用于标识业务模块信息。配置项说明详见配置项管理

templateId：业务在“配置项”下添加的“模版ID”，用于标识具体的功能模块信息。配置模板说明详见配置模板管理

#strategy_id：策略的唯一ID，用于策略生命周期管理。配置策略说明见配置策略管理

paramater_x：配置模板参数，对应功能模块所需的配置参数

#ops_receipt_properties：用于事件回收统计，当你需要自动统计策略效果（暂未支持）时，回收事件需要携带此属性

#custom_params：客户端配置通道上的自定义参数，可定义需要携带到客户端的用户属性信息。

4.2 设置本地默认值

您可以在 TDRemoteConfig SDK 中设置配置项默认值，在 AE 服务端未添加配置项、或者本地未拉取到远端值时，SDK 会获取到本地默认值。

格式

本地默认值的结构需要保持以下格式：

{
    "configId": {
        "templateId": [
            { 
              "paramater_x" : ""
            }
        ]
    }
}

直接设置

Dictionary<string, object> defaultValues = new Dictionary<string, object>
{
    { "key","value"}
};
TDRemoteConfig.SetDefaultValues(defaultValues);

清空默认值

TDRemoteConfig.ClearDefaultValues()

4.3 获取值的方式

获取配置项下某一类已经发布上线中的策略内容：

string str = TDRemoteConfig.GetAllData("configId_xxx","template_xxx")

其中：

configId：在运营后台配置中心模块创建的“配置项ID”，用于标识业务模块信息。配置项说明详见配置项管理

templateId：业务在“配置项”下添加的“模版ID”，用于标识具体的功能模块信息。配置模板说明详见配置模板管理

取值规则

某一个key 的取值过程：

• 优先取该 key 对应的远端配置的值
• 若远端没有配置该 key，则去查找该 key 的本地默认值
• 若本地默认值也没有该 key，返回空。

4.4 监听更新

SDK 初始化之前，添加 配置拉取成功 的通知监听

public class ConfigFetchListener : TDConfigFetchListener {
    public void OnFetchSuccess(string statusData) {

    }
}
TDRemoteConfig.AddConfigFetchListener(new ConfigFetchListener());

通知名称

OnFetchSuccess (拉取配置成功)

通知携带的参数

提示

通知将默认携带本次请求和上次请求期间，变更为暂停生效（suspend）、强制下线（force_offline）的策略状态，您可结合业务需求取用。若无需使用，可直接忽略。

使用以下方式获取通知参数

JSONObject map = statusData.optJSONObject("strategy_status_map");

对应的 statusData 结构如下，用来描述配置项模版中策略id为20241209 的策略状态 。

{
   "strategy_status_map":[
       {
          "configId" : {
          "templateId" : {
          "20241209" : "suspend"
        }
    ]
}

5. 发送测试

为了快速的验证接入的可用性，与配置策略的有效性，SDK 支持开启测试模式。

using ThinkingData.Core;

TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
// debug 
settings.mode = TDCoreMode.DEBUG;
TDApp.Init(settings);

客户端开启 debug 模式后，会每 5s 拉取一次测试策略。在 AE 运营模块可以创建模版测试或者策略测试，等待拉取配置的过程中，可以关注前端页面的进度节点。

参考操作文档 配置模板管理 中的客户端发送测试部分。

客户端SDK发送测试需要使用测试设备，您可在测试设备列表中选择或添加测试设备。