资讯

历史

科技

环境与自然

成长

游戏

财经

文学与艺术

美食

健康

家居

文化

情感

汽车

三农

军事

旅行

运动

教育

生活

星座命理

Unity Remote Config：游戏覆盖和Settings使用指南

创作时间:

作者:

@小白创作中心

Unity Remote Config：游戏覆盖和Settings使用指南

引用

来源

https://docs.unity.com/ugs/zh-cn/manual/remote-config/manual/game-overrides-and-settings

Unity Remote Config通过"游戏覆盖"（之前称为"广告系列"）功能，可以精准定位到特定用户群体，并向不同群体提供不同的设置。游戏覆盖与"Settings"关联，开发者可以在满足游戏覆盖的受众条件时，通过映射到游戏代码中的变量来覆盖其默认值。

Unity Remote Config使用游戏覆盖（之前称为广告系列）来定向到特定用户群体并向不同的群体提供不同的设置。游戏覆盖与Settings关联。您需将 Settings 映射到游戏代码中的变量，从而在满足游戏覆盖的受众条件时覆盖其默认值。

您可以在设计游戏时或开始新的部署之前提早规划 Remote Config 设置。Unity 建议在初始部署中包含不活跃的 Remote Config 设置，以便您可以稍后在了解受众如何使用您的游戏以及在不同设备上的效果后应用这些设置。

在 Unity 编辑器中，选择Window（窗口）>Remote Config，打开Remote Config窗口即可开始进行 Settings 相关操作。

您可以使用Remote Config窗口来配置 Remote Config 设置。游戏覆盖可以在 Web Dashboard（Web 控制面板）中配置。该控制面板可通过 Open Dashboard（打开控制面板）按钮打开。游戏覆盖决定了使用 Settings 需满足的条件或玩家细分段。默认情况下，您可以从Settings Config开始入手。此配置包含所有用户都会收到的默认 Settings，除非应用了一个具有更高优先级的活跃游戏覆盖。

重要提示：每个环境都有一个唯一的游戏覆盖集。在为您的游戏配置游戏覆盖之前，请确保在Remote Config窗口中选择正确的 Remote Config 环境。

一个 Settings 就是一个键值对。您可以将键名映射到游戏代码中的变量，这样您无需更改代码即可动态更改其值。

添加新的 Settings

默认的Settings Config配置包含您为给定环境创建的所有 Settings。要创建新的 Settings，请高亮显示Settings Config配置，然后单击右侧面板底部的 Add Setting（添加设置）按钮。

注意：鉴于游戏代码可以在编辑器中使用 Settings，因此必须在编辑器中创建 Settings。不过，在游戏二进制文件中创建 Settings 后，也可以使用 Remote Config REST API 或 Remote Config Web 控制面板对其进行更新。有关更多信息，请参阅界面。

每个 Settings 都包含Key、Type和Value：

参数	描述	示例
Key	Settings 的名称，必须符合以下游戏覆盖的规定：必须在其环境中是唯一的。必须以字母开头。只能包含字母、数字、句点、下划线或连字符。不得超过 255 个字符。	enemyHealtheventPackPriceenableBetaFeature
Type	Settings 值的 C# 变量数据类型。受支持的类型包括：IntFloatBoolStringLongJson	intfloatboolstringlongjson
Value	此 Settings 的值，必须符合以下游戏覆盖的规定：整型值为 32 位整数（–2147483648 至 2147483647）。浮点值为单精度、32 位浮点数。字符串限制为 10000 个字符。布尔值只能为 true 或 false。长整值为 64 位带符号整数（-9,223,372,036,854,775,808 至 9,223,372,036,854,775,807）。Json 值为 ECMA-404 标准支持的任何有效 json。	1004.99true‘jack-o-lantern’123456789012345{"jsonKey1": {"jsonSubKey1": "on","jsonSubKey2": "off"}}

添加新的游戏覆盖

要创建新的 Remote Config 游戏覆盖，请单击 Open Dashboard（打开控制面板）按钮，打开您的 Web 浏览器并跳转到 Remote Config 页面，然后依次单击 View Overrides（查看覆盖）按钮和Create Override（创建覆盖）。每个游戏覆盖均包含五个参数，详见下文：

名称

名称是指游戏覆盖的名称。例如，您可以将难度曲线的游戏覆盖命名为
level_1_enemies
，或者将季节性活动的游戏覆盖命名为
halloween_event
。

定向策略

定向策略定义游戏覆盖的受众类型。该策略可以是
Stateful
，此时您可以选择 All Spenders（所有消费玩家）或 Existing Players（现有玩家）等受众；该策略也可以是
Stateless
，此时您可以根据
Condition
定义目标受众。

条件

条件是上下文数据属性的 JEXL 表达式（请参阅下文的JEXL 支持部分），用于定义要将游戏覆盖应用到的受众。您可以使用多个标准来定义此细分段。Remote Config 目前支持三个属性类别：

用户类别包含由开发者定义用于描述用户（例如，订阅状态、姓名、年龄）的自定义属性，您必须将其传递给RemoteConfigService.Instance.FetchConfigs<T, T2>(T userAttributes, T2 appAttributes)。

注意：使用
SetCustomUserId
时，您传递的 ID 会自动作为
customUserId
附加到您的
user
属性。

应用类别包含由开发者定义用于描述应用程序（例如，连接状态、应用程序版本、当前等级）的自定义属性，您必须将其传递给RemoteConfigService.Instance.FetchConfigs<T, T2>(T userAttributes, T2 appAttributes)。
unity类别包含预定义的属性，详见下表：

属性	描述	示例
unity.appBuildVersion	应用程序所运行的版本号（在编辑器中，通过转到Edit（编辑）>Project Settings（项目设置）> Player（玩家）来设置此属性）。	unity.appBuildVersion == '1'
unity.appVersion	应用程序所运行的发布版本（在编辑器中，通过转到Edit（编辑）>Project Settings（项目设置）> Player（玩家）来设置此属性）。	unity.appVersion == '1.0'
unity.cpu	CPU 处理器的名称。	unity.cpu == 'Intel(R) Core(TM) i7-7920 HQ CPU @ 3.10GHz'
unity.cpuFrequency	运行您的应用程序的设备的处理器频率，以 MHz 为单位。	unity.cpuFrequency >= 3100
unity.country	适用的国家/地区。此属性使用ISO 3166-1 alpha2国家/地区代码。有关如何定义自定义属性的信息，请参阅关于代码集成的文档。	unity.country == 'US'
unity.language	适用的语言。此属性使用ISO 639-1语言代码。有关如何定义自定义属性的信息，请参阅关于代码集成的文档。	unity.language == 'en'
unity.osVersion	运行您的应用程序的设备的操作系统版本。	unity.osVersion == 'Mac OS X 10.14.4'
unity.platform	适用的设备或平台。以下值有效：AndroidiOSLinuxmacOSPS4PS5SwitchWebGLWiiWindowsXboxOneXboxSeriesSXboxSeriesX	unity.platform == 'iOS'
unity.timeSinceStart	自应用程序会话开始后经过的时间，以毫秒为单位。	unity.timeSinceStart >= 60000
unity.graphicsDeviceVendor	用户显卡的供应商。	unity.graphicsDeviceVendor == 'ATI Technologies Inc.'
unity.ram	设备上 RAM 内存的大小，以 MB 为单位。	unity.ram >= 16384
unity.model	设备的型号。	unity.model == "LGE Nexus 5"或unity.model.contains("Nexus")

注意：列出的
unity
属性有可能发生更改。如需更新后的完整列表，请参阅REST API 文档。

例如，如果您想要定义以得分超过 10 的用户为目标受众的游戏覆盖，可以使用点符号从
app
上下文定义一个
score
属性：

  
app.score >= 10

您还可以在一个游戏覆盖中引用多个属性：

  
user.score >= 10 && app.level == 5

要定义符合所有条件并始终应用的游戏覆盖，只需输入
true
即可。

JEXL 支持

Remote Config 支持Java 表达式语言 (JEXL) 规范，但存在一些例外情况：

Remote Config 仅支持表达式。
Remote Config 不支持脚本。
Remote Config 目前不支持函数和条件。
尽管 Remote Config 支持使用
&&
和
||
语句来设置多个条件，但 JEXL 字符串不能超过 500 个字符。

注意：不能嵌套属性（例如
app.level1.score
）。如果使用无效的 JEXL 字符串或将Condition（条件）字段留空，则会导致错误。

部署比例

部署比例决定将遵循此游戏覆盖的用户群所占的百分比。如果值小于 100，Unity 会根据用户 ID 将该游戏覆盖随机分配给该比例的玩家。虽然不同玩家的体验可能有所不同，但每个玩家都将在各个游戏会话中获得一致的体验。与分析功能结合使用来解析结果时，此参数尤其有用。

内容类型

您可以根据使用的服务为特定的游戏覆盖选择多种类型的内容，比如，Remote Config 中使用的
Config Overrides
，或者 Economy 服务中使用的
Currency
或
Inventor Item
等其他内容。

起始日期和时间

您可以选择指定起始日期和时间，即游戏覆盖的生效时间。时间戳以ISO 8601UTC 格式 (
YYYY-MM-DDThh:mm:ssZ
) 的字符串形式表示。如果您未指定值，则游戏覆盖会在激活后立即生效。

结束日期和时间

您可以选择指定结束日期和时间，即游戏覆盖的失效时间。时间戳以ISO 8601UTC 格式 (
YYYY-MM-DDThh:mm:ssZ
) 的字符串形式表示。如果您未指定值，则游戏覆盖会在您将其停用之前持续有效。

将 Settings 应用到游戏覆盖

要将 Settings 应用到游戏覆盖，请导航到所需的游戏覆盖并编辑Content（内容）代码块以查看所有可用 Settings 的列表。

启用和禁用游戏覆盖

使用 Game Override（游戏覆盖）页面顶部的按钮即可启用或禁用游戏覆盖。

在编辑器窗口中编辑 Settings

要在编辑器的 Remote Config 窗口中编辑 Settings 的键和值，请确保保存并推送更改。完成该操作之前，您的配置仅储存在本地。请确保先推送更改来进行保存，然后再切换 Remote Config 环境。

您可以通过单击要删除的相应元素旁边的 trashcan（回收站）按钮来删除 Settings。请注意，如果活跃的游戏覆盖当前正在使用某个 Settings，则不应删除该 Settings。

确定游戏覆盖的优先级

您可以为每个游戏覆盖分配一个加权优先级值，包括
Low
、
Medium
或
High
。如果您想要以数字形式分配优先级值，可以通过高级编辑器在
1
（最高优先级）和
1000
（最低优先级）之间进行设置。为此，请单击Edit Schedule（编辑计划）-> Scheduling（排期）字段（位于游戏覆盖中），然后选择 Use Advanced Editor（使用高级编辑器）并输入一个整数值。