UGS の使用の準備
Learn how to set up Unity Gaming Services in your project.
読み終わるまでの所要時間 3 分最終更新 1日前
このトピックでは、プロジェクトで Unity Gaming Services の使用準備を整える方法について説明します。
前提条件
オンボーディングプロセスを開始する前に、以下の手順を実行してください (まだ行っていない場合)。- Unity アカウントを作成します。
- 価格設定と請求 について学習します。
ゲームで Unity Engine を使用する場合
Unity プロジェクトで UGS の使用準備を整えるには、次の手順に従います。- 新しい Unity Cloud プロジェクトを作成します。
- 新しいプロジェクトの場合、Unity Hub で プロジェクトを作成 します。これにより、自動で Unity Dashboard にプロジェクトが作成されます。
- 既存の Unity プロジェクトの場合は、次の手順に従います。
- Unity Dashboard で プロジェクトを作成 します。
- Unity エディターのプロジェクトに 作成したプロジェクトをリンク します。
- 必要な UGS パッケージを インストール します。
- SDK の 名前空間をインポート します。
- ゲームコード内で UGS を初期化 します。
- 最初の Cloud Code スクリプトを 作成 します。
ゲームで REST API を使用する場合
別のゲームエンジンを使用する場合、REST API を使用してゲームに UGS を実装できます。UGS の使用を準備するには、次の手順に従います。 Unreal Engine を使用する場合、以下を使用して一部の UGS 機能をゲームに実装することもできます。- Unity Gaming Services SDK for the Unreal Engine。以下を実装するために使用します。
- Vivox Unreal SDK
Unity Hub でのプロジェクトの作成
Unity Cloud に接続された新しいプロジェクトを作成する最も速い方法は、Unity Hub を使用することです。- Unity Hub で、New project (新しいプロジェクト) を選択します。
- Unity Organization (組織) などの必須フィールドを入力します。
- Connect to Unity Cloud (Unity Cloud に接続する) チェックボックスが選択されていることを確認します。
Unity Dashboard でのプロジェクトの作成
プロジェクトとサービスの管理は、Unity Dashboard で行います。新しいプロジェクトを作成するには、次の手順に従います。- プライマリナビゲーションメニューから Projects (プロジェクト) を選択します。
- Projects (プロジェクト) ページの右上にある New (新規) を選択します。
- プロジェクト名と COPPA 指定を入力します。
- Create (作成) を選択します。
Unity エディター内のプロジェクトのリンク
Unity Gaming Services を使用するには、Unity エディター内のプロジェクトを Unity Cloud プロジェクトにリンクする必要があります。 エディター内のプロジェクトをリンクするには、次の手順に従います。- Edit (編集) > Project Settings (プロジェクト設定) > Services (サービス) を選択します。
- Use an existing Unity project ID (既存の Unity プロジェクト ID を使用) を選択します。
- ドロップダウンメニューから組織とプロジェクトを選択します。
- Link project ID (プロジェクト ID をリンク) を選択します。
UGS パッケージのインストール
プロジェクトに実装予定のサービスに対応したパッケージをインストールする必要があります。UGS 対応のパッケージを確認およびインストールするには、次の手順に従います。- Unity エディターで、Window (ウィンドウ) > Package Manager (パッケージマネージャー) を選択します。
- Package Manager で、Unity Registry (Unity レジストリ) のリストビューを選択します。
- パッケージ名を検索するか、レジストリリスト内で見つけます。
- このパッケージを選択し、Install (インストール) をクリックします。
SDK 名前空間のインポート
SDK の API にアクセスするには、スクリプトでその SDK の名前空間をインポートする必要があります。例えば、Analytics の場合、以下のようにします。using Unity.Services.Analytics;
ゲームコードでの Unity Services の初期化
サービスの機能を呼び出す前に、Services Core SDK を初期化する必要があります。推奨されるベストプラクティスは、ゲームのランタイムの初期 (できれば起動時) にサービスを初期化することです。注
ノート: パッケージをインストールしたり、パッケージマニフェストに追加したりする必要はありません。これに依存する UGS パッケージをインストールしたときに、自動的にプルされます。
com.unity.services.coreUnity.Services.CoreInitializeAsyncこのメソッドは、プロジェクトにインストールされているすべての Unity Gaming Services を初期化します。using System;using Unity.Services.Core;using UnityEngine;public class InitializationExample : MonoBehaviour{ async void Awake() { try { await UnityServices.InitializeAsync(); } catch (Exception e) { Debug.LogException(e); } }}
State最初の Cloud Code スクリプトの作成とその後の手順
Unity Gaming Services の最も一般的な使用方法の 1 つは、カスタムサーバー主導型の経済ロジックまたはゲームロジックです。こちらの Cloud Code ウォークスルー に、インストール、初期化、ダッシュボード設定、ゲームクライアントからのシンプルな Cloud Code スクリプトのリモート実行など、使用を開始するために必要なすべての情報が含まれています。次のステップ
- Unity の ユースケースサンプルプロジェクト で、UGS 機能の使用方法のアイデアを確認します。
- 個々のサービス を実装します。
- UGS CLI または Deployment ウィンドウ を使用して設定管理ワークフローを単純化します。