Environments API

Manage logical data partitions using the Environments API.

読み終わるまでの所要時間 4 分

最終更新 9ヶ月前

環境は、プロジェクトに関連付けられたデータを含む 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 エディターで環境を選択するには、次の手順に従います。

Edit (編集) > Project Settings (プロジェクト設定) > Services (サービス) > Environments (環境) に移動します。
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>

ドキュメント

Development

User Acquisition

Monetization

産業