Remote Settings
在 Unity 项目中使用 Remote Settings

创建和更改 Remote Settings

在使用 Remote Settings 之前,必须首先为 Unity 项目启用 Unity 服务Unity Analytics 服务。启用 Analytics 后,请打开 Analytics Dashboard 并转至 Remote Settings 选项卡以创建和更改 Remote Settings 值。请参阅在 Unity 项目中使用 Remote Settings 了解如何在游戏或应用程序中访问这些 Remote Settings 值。

Analytics 服务提供两种 Remote Settings 配置:

1.Analytics 服务将 Release 配置设置发送到运行常规非开发版应用程序的计算机和设备。

2.Analytics 服务将 Development 配置设置发送到运行开发版(即在 Build Settings 窗口内选中 Development Build 标志而创建的版本)的计算机和设备。Unity Editor 中的 Play 模式被视为开发版。

Raging Bots 游戏的 Analytics Dashboard 上的 Remote Settings 选项卡
Raging Bots 游戏的 Analytics Dashboard 上的 Remote Settings 选项卡

每个 Remote Setting 由一个键、一个默认值和可选的细分值组成。设置包含细分值时,当前玩家所在的细分段将确定哪些值包含在配置中。如果多个细分适用,则该配置包含来自最高优先级细分段的值。

设置名称和值规则

单独的远程设置是键/值对。键名称的规则是:

  • 键名称在同一配置内必须唯一。

  • 键名称必须以字母开头。

  • 键名称只能包含字母、数字和字符:“.”、“_” 和 “-”。

一个设置值可以是以下任何原始类型:__IntFloatString__ 或 Bool。设置值的规则是:

  • Int 值是 32 位整数(–2147483648 到 2147483647)。

  • Float 值是单精度的 32 位浮点数(大约 –3.4x1038 到 3.4x1038)

  • String 值限制为 1024 个字符。

  • You must specify boolean values with the strings “true” or “false”.

添加 Remote Settings

要添加 Remote Setting:

1.在 Analytics Dashboard 中,打开 Remote Settings 选项卡。

2.将设置的 Configuration 设为 ReleaseDevelopment

3.单击 __ADD NEW KEY-VALUE__(位于设置列表的顶部)。

  1. Enter a name for the key.

  2. Set the type for the value.

  3. Enter the default value.

  4. Click the Save button.

  5. Click the Sync button to publish your changes. (You do not need to click the Sync button after creating each individual setting; you can wait to synchronize your settings until you finish making all changes to the current configuration.)

__注意:__要添加针对不同细分段的值,请保存默认的键/值设置,然后对其进行编辑。细分段选项仅在编辑某项设置时显示,而不会在第一次创建设置时显示。

编辑 Remote Settings

要编辑 Remote Setting:

1.在 Analytics Dashboard 中打开 Remote Settings 选项卡。

2.在 Configuration 中选择 ReleaseDevelopment

3.单击要更改的设置旁的编辑图标。

![](../uploads/Main/RemoteSettingsEditSetting.png) 

4.执行所需的更改。请注意,更改键名称等同于删除旧键并创建新键。

5.单击 Save 按钮。

6.单击 Sync 按钮以发布所做的更改。下次玩家启动会话时,Unity 会读取更新后的设置。

解决同时编辑冲突

如果团队中的两个人同时编辑项目的 Remote Settings,您在尝试将修改的设置与服务同步时可能会遭遇冲突。

提示在编辑同一项目时有其他人已更改设置的警告
提示在编辑同一项目时有其他人已更改设置的警告

发生冲突时,可选择以下选项:

OVERWRITE

放弃上次同步以来服务上的所有更改并将您的设置推送到服务。选择覆盖 (overwrite) 时,服务上的设置将与您当前的设置完全匹配。

MERGE

将您的当前设置与服务上已修改的设置合并,使您有机会在完成同步操作之前进行更改。

如果您编辑了同一个设置值,您的更改会覆盖服务上的版本。另外,还会恢复服务上已删除的值和设置(因为它们仍然存在于您的版本中)。自您上次同步以来服务上的其他更改将保留下来。

合并后,Remote Settings 页面将更新以反映此合并,但合并的设置不会推送到服务器。您可以查看更新后的更改,并在准备就绪后再次单击 Sync 按钮。

CANCEL

取消同步操作并关闭冲突对话框而不进行任何更改。您的设置不会保存到服务。

为不同细分段添加不同值

您可以将多个细分值分配给单个 Remote Settings 键。玩家属于特定值所在的某个细分段时,Unity 会将该值发送给玩家,而不是默认的 All Users 值。(如果玩家符合若干细分值的条件,则 Unity 会发送最高优先级细分段的值。)

要设置特定于给定细分段的值:

1.在 Analytics Dashboard 中打开 Remote Settings 选项卡。

2.在 Configuration 中选择 ReleaseDevelopment

3.添加 Remote Setting(如果尚未存在)。

4.单击该设置最右侧的编辑图标。

5.单击 ADD EXISTING SEGMENT

6.在新行中,从下拉列表选择相应细分段,然后输入值。

7.单击 Save 按钮。

删除 Remote Settings

要删除 Remote Setting,首先打开该设置的编辑视图:

1.在 Analytics Dashboard 中打开 Remote Settings 选项卡。

2.将设置的 Configuration 设为 ReleaseDevelopment

3.单击要删除的设置旁的编辑图标以打开编辑视图:

![](../uploads/Main/RemoteSettingsDelete.png) 

4.要删除特定细分段的值,请单击编辑视图右侧的__减号__按钮,然后单击 Save。(无法删除默认的 All Users 值。)

5.要删除整个设置,请单击编辑视图底部的删除图标,然后确认是否要删除该设置。

6.单击 Sync 按钮以发布所做的更改。

设置细分段优先级

When a player is a member of more than one segment, Unity sends the value assigned for highest priority segment. (If a setting doesn’t have any segmented values, or the player isn’t a member of the segments that do have different values for a key, then Unity sends the All Users value.) You can set the order of your segments to specify which segmented values should take precedence when there is an overlap.

要设置细分段优先级:

1.在 Analytics Dashboard 中打开 Remote Settings 选项卡。

2.在 Configuration 中选择 ReleaseDevelopment

  1. Click the segment priority icon.

  2. The Segment Priority window opens, showing your current order. Only segments already assigned values for any Remote Settings apear in the window.

  3. Reorder the segments by clicking and dragging the items into place.

  4. When the order is correct, click Save.

  5. Click the Sync button to publish your changes.

细分段优先级将应用于配置中的所有设置,但是 Development 和 Release 配置可以有不同的优先级。


  • 2017–08–28 Page amended with no editorial review

  • 截至 2017–08–28,服务与 Unity 5.5 之后的版本兼容,但是版本兼容性可能会发生变化。

  • 2017–06–30 - 添加:在键名称中允许使用字符 “.”、“_” 和 “-”。

  • 2017.1 中的新功能

  • 2017–08–28 - 2017.1 中添加了细分的 Remote Settings:为不同细分段设置不同值

Remote Settings
在 Unity 项目中使用 Remote Settings