Remote Config 示例教程

1. 准备工作

请确保您已经创建 UOS APP 并开启 Remote Config 服务，进入 「Remote Config -> 配置管理」 页面。

2. 创建Config

在「管理配置」页面的「配置（CONFIG）」下点击「立即创建」，字段类型有int、float、long、bool、string、json 六个选项，可以按照需求自行创建一个或多个，对于同一 UOS App 来说，名称（key）是不能重复的：

在本次示例中，创建了名为“Test-int”和“Test-string“两个config：

3. 创建Override

切换到「覆盖（OVERRIDE）」页面，点击「立即创建」，首先填写名称、描述和优先级。

配置项：

名称（Name）: Override的名称
描述（Description）: Override的描述
优先级（Priority）: 1-1000的整数，其中1为最高优先级，1000为最低优先级，针对有多个覆盖（Override）作用于同一个配置（Config）的情况

在「目标玩家」步骤，Expr条件语句填写完毕并调整玩家覆盖比例，点击「下一步」会触发Expr语句的语法校验，若是出现红色文字提示则表示校验失败需要修改，通过校验则顺利进入下一步。

配置项：

玩家覆盖比例（RolloutPercentage）: 应用百分比，是 0-100 的值，表示使用Override的用户所占的百分比
Expr（Condition）: Override条件，可以根据游戏传入的值进行逻辑判断
- 默认通过为 true
- 针对三个类别的变量进行逻辑判断：unity, app, user
- 逻辑判断使用 Expr
- 例子：user.score >= 10 || (unity.language == 'EN' && app.version == '1.2')

注：对于单独的bool值，需要显式表达，例如 user.IsNewPlayer == true

在「内容」步骤，填写需要更改的字段的值，可根据需求创建一组或多组变体（Variant），本次示例仅测试一组变体，并修改创建的两个字段：

配置项：

变体（Variants）: 这是Override值的组合以及对应的权重
- Variants 是一列 Variant，每个variant有名称（Name），权重（Weight）和内容（Content）。所有weight加起来必须是100
- 每个内容（Content）是一些被覆盖的配置（Config）的组合
- Variant的作用是让用户随机被分到多个不同组合
- 对于同一个用户（UserID），他被分配到的variant保持一致
- 下面的例子中，用户有30%的概率会被应用第一个变体，有70%的概率会被应用第二个变体

{
  "variants":[
    {
      "name":"variant1",
      "weight":30,
      "content":[
        {
          "values":[
            {
              "key":"key1",
              "type":"string",
              "value":"value111"
            }
          ]
        }
      ]
    },
    {
      "name":"variant2",
      "weight":70,
      "content":[
        {
          "values":[
            {
              "key":"key1",
              "type":"string",
              "value":"value222"
            }
          ]
        },
        {
          "values":[
            {
              "key":"key2",
              "type":"int",
              "value":"200"
            }
          ]
        }
      ]
    }
  ]
}

在「时间表」步骤，需要选择Override的生效和过期时间，为空时表示立即生效且永久有效，本次示例不填写时间，直接「保存」：

配置项：

生效时间（StartDate）: Override的生效时间，空值为立即生效
过期时间（EndDate）: Override的过期时间，空值为永久有效

创建完成后可点击「Override」的名称查看详情，并修改：

4. 模拟命中

若要测试创建的Override，首先要「启用」需要测试的记录，不启用的Override在模拟时并不生效，启用后点击「测试」按钮：

命中模拟可以选择单人（用户ID为虚拟ID，仅为测试阶段区分不同测试数据的临时标识，不可作为模拟场景的筛选条件，不影响实际数据），也可以指定模拟次数（目前最高20次），本次示例的模拟参数为：

{
  "unity": {
    "appVersion": "1.0",
    "appBuildVersion": "23",
    "country": "US"
  },
  "app": {
    "packageVersion": "2.1.1"
  },
  "user": {
    "level": 10,
    "score": 2500
  }
}

测试完毕后会自动跳转到模拟结果页面，返回后不再保留：