# 针对 Unity Remote Config 配置项目

> Configure your project for Remote Config.

## 要求##requirements

* 此版本的 Unity Remote Config Runtime 要求使用 Unity 2020.2 或更高版本。
* 将您的[编辑器脚本运行时](https://docs.unity3d.com/2018.4/Documentation/Manual/ScriptingRuntimeUpgrade.html)设置为 **.NET 4.X 等效版本**（或更高版本）。
* 将您的 [API 兼容性级别](https://docs.unity3d.com/Manual/dotnetProfileSupport.html)设置为 **.NET 4.x**。
* 为您的项目[启用 Unity Services](https://docs.unity3d.com/Manual/SettingUpProjectServices.html)。
* 安装 Remote Config 软件包（详见下文）。
* 设置 Assembly Definition 引用（详见下文）。

## 安装 Remote Config 软件包##installing-the-remote-config-package

有关在项目中使用软件包的更多信息，请参阅有关[软件包](https://docs.unity3d.com/Manual/Packages.html)的文档。安装步骤可能因所使用的 Unity 编辑器版本而异。

### 已验证发布版本##verified-release

1. 在 Unity 编辑器中，选择 **Window（窗口）**> **Package Manager（包管理器）**。
2. 从 Package Manager（包管理器）窗口的 Packages List（包列表）视图中找到 Remote Config 并将其选中。
3. 在 Package Specific Detail（包具体详情）视图中，选择相应版本并安装，以将包导入您的项目。

### 预览发布版本##preview-release

1. 在 Package Manager（包管理器）窗口中，通过单击 \*\*Advanced（高级）\*\*按钮可以将 \*\*Show Preview Packages（显示预览包）\*\*切换为在 Packages List（包列表）视图中进行显示。
2. 按照适用于[已验证发布版本安装](#verified-release)的说明操作。

### Beta 版客户##beta-customers

收到客户经理提供的 Remote Config 软件包后，请按照以下步骤操作：

1. 下载并解压缩软件包。
2. 在 Unity 编辑器中，选择 **Window（窗口）**> **Package Manager（包管理器）**。
3. 在 Package Manager（包管理器）窗口中，选择 **Add（添加）**(**+**) 以打开 \*\*Add package from disk...（从磁盘添加软件包...）\*\*对话框。
4. 在 Remote Config 软件包的解压缩副本中找到 *package.json* 文件。
5. 选择 \*\*Open（打开）\*\*以将该包导入您的项目。

## Remote Config 环境##remote-config-environments

要开始使用，请创建一个环境并为其指定名称。

1. 转到 [Web Dashboard（Web 控制面板）](http://dashboard.unity3d.com/remote-config)。
2. 选择相应的项目。
3. 选择 **Add Environment（添加环境）**。
4. 输入环境的名称并选择 **Create（创建）**。

### 请注意，环境名称是无法更改的。

您创建的第一个环境会设置为默认环境。除非客户端另外指定，否则该环境即为所请求的环境。您可以在 Web Dashboard（Web 控制面板）中或通过 REST API 将默认环境分配到 **EnvironmentID**。

配置好项目后，在 [Web Dashboard（Web 控制面板）](http://dashboard.unity3d.com/remote-config)中配置您的规则和设置

## Assembly Definition 引用##assembly-definition-references

Remote Config 软件包依赖于 Unity 的 Authentication 和 Core 服务。这些依赖关系需要使用少量的用户代码，才能正确进行配置。

要使用 Remote Config，您将需要包含以下引用：

* com.unity.remote-config-runtime
* Unity.Services.Authentication
* Unity.Services.Core

使用 Remote Config 之前，您将需要完成以下操作：

* 初始化 Unity Services
  * `UnityServices.InitializeAsync()`
* 通过 Unity Authentication 进行身份验证
  * `AuthenticationService.Instance.SignInAnonymously()` 用于匿名身份验证
  * `AuthenticationService.Instance.SignInWithAppleAsync()` 用于 Apple 身份验证
  * `AuthenticationService.Instance.SignInWithFacebookAsync()` 用于 Facebook 身份验证
  * `AuthenticationService.Instance.SignInWithGoogleAsync()` 用于 Google 身份验证
  * `AuthenticationService.Instance.SignInWithSteamAsync()` 用于 Steam 身份验证
  * `AuthenticationService.Instance.SignInWithSessionTokenAsync()` 用于通过现有令牌进行身份验证