ドキュメント

サポート

Services

Services

Environments API

Manage logical data partitions using the Environments API.
読み終わるまでの所要時間 1 分最終更新 13日前
環境 は、プロジェクトに関連付けられたデータを含む Unity Gaming Services の論理パーティションです。 このセクションでは、Core パッケージの Environments API を中心に解説します。Environments API へのアクセスポイントには、
EnvironmentsApi
シングルトンを使用します。 
namespace Unity.Services.Core.Environments.Editor{    public class EnvironmentsApi    {        public static IEnvironmentsApi Instance { get; }    }}

Environment Selector

Environment Selector (環境セレクター) では、すべてのサポート対象サービスに対し現在の環境を設定します。
Unity エディターで環境を選択するには、次の手順に従います。
  1. Edit (編集) > Project Settings (プロジェクト設定) > Services (サービス) > Environments (環境) に移動します。
  2. Editor Environment (エディター環境) フィールドで、使用する環境を選択します。
環境の管理 (追加や削除など) は、Unity Dashboard で行うことができます。

アクティブ環境

アクティブ環境には、名前または GUID としてアクセスできます。環境が変更されると、
PropertyChanged
イベントで通知されます。 
namespace Unity.Services.Core.Environments.Editor{    public class EnvironmentsApi    {        public string ActiveEnvironmentName { get; set; }        public System.Nullable<System.Guid> ActiveEnvironmentId { get; }        public event System.ComponentModel.PropertyChangedEventHandler PropertyChanged;    }}

環境の管理

EnvironmentsApi
を使用すると、環境リストの更新、すべての環境の取得、アクティブ環境の設定、リモートでのアクティブ環境の存在確認を行うことができます。 
namespace Unity.Services.Core.Editor.Environments{    public class EnvironmentsApi    {        public System.Collections.Generic.IReadOnlyCollection<EnvironmentInfo> Environments { get; }        public System.Threading.Tasks.Task RefreshAsync();        public void SetActiveEnvironment(EnvironmentInfo environment);        public System.Threading.Tasks.Task<ValidationResult> ValidateEnvironmentAsync();    }}

ビルドとランタイム

ビルド時およびランタイム時には、選択した環境で以下の優先度フォールバックメカニズムを使用し、適切な環境が選択されます。 
InitializationOptions
>> Environment Selector (環境セレクター) >> デフォルト環境 (
"production"
)。 
InitializationOptions
の使用方法については、Services Core SDK の 初期化の例 を参照してください。

UI コンポーネント

EnvironmentView
コンポーネントは現在のアクティブ環境を表示します。ここから、グローバルな Environment Selector (環境セレクター) へすぐにアクセスできます。
以下の例に、UXML を使用してこのコンポーネントをツールバーに追加する方法を示します。 
<ui:UXML    xmlns:uie="UnityEditor.UIElements"    xmlns:coreUi="Unity.Services.Core.Editor.Environments.UI"    editor-extension-mode="True">    <uie:Toolbar>        <coreUi:EnvironmentView />    </uie:Toolbar></ui:UXML>