UGS の使用の準備

Learn how to set up Unity Gaming Services in your project.

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

最終更新 3ヶ月前

このトピックでは、プロジェクトで Unity Gaming Services の使用準備を整える方法について説明します。

前提条件

オンボーディングプロセスを開始する前に、以下の手順を実行してください (まだ行っていない場合)。

Unity アカウントを作成します。
価格設定と請求について学習します。

ゲームで Unity Engine を使用する場合

Unity プロジェクトで UGS の使用準備を整えるには、次の手順に従います。

新しい Unity Cloud プロジェクトを作成します。
- 新しいプロジェクトの場合、Unity Hub でプロジェクトを作成します。これにより、自動で Unity Dashboard にプロジェクトが作成されます。
- 既存の Unity プロジェクトの場合は、次の手順に従います。
  1. Unity Dashboard でプロジェクトを作成します。
  2. Unity エディターのプロジェクトに作成したプロジェクトをリンクします。
必要な UGS パッケージをインストールします。
SDK の名前空間をインポートします。
ゲームコード内で UGS を初期化します。
最初の Cloud Code スクリプトを作成します。

ゲームで REST API を使用する場合

別のゲームエンジンを使用する場合、REST API を使用してゲームに UGS を実装できます。UGS の使用を準備するには、次の手順に従います。

Unity Dashboard でプロジェクトを作成します。
REST API の使用準備に関するドキュメントを確認します。

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 プロジェクトが、Unity Dashboard 内に自動的に作成されます。手動で接続する必要はありません。

これで、Unity Dashboard でサービスを参照できるようになりました。サービスを連携するには、UGS パッケージのインストールに進んでください。

Unity Dashboard でのプロジェクトの作成

プロジェクトとサービスの管理は、Unity Dashboard で行います。新しいプロジェクトを作成するには、次の手順に従います。

プライマリナビゲーションメニューから Projects (プロジェクト) を選択します。
Projects (プロジェクト) ページの右上にある New (新規) を選択します。
プロジェクト名と COPPA 指定を入力します。
Create (作成) を選択します。

これで、Unity Dashboard でプロジェクトを設定し、Unity エディターのプロジェクトとの統合前にサービスの設定を行えるようになりました。例えば、Economy のアイテムを設定したり、Game Override を作成したりできます。その後、Unity エディターのプロジェクトに Unity Cloud プロジェクトをリンクします。

詳細については、Unity プロジェクトの管理を参照してください。

Unity エディター内のプロジェクトのリンク

Unity Gaming Services を使用するには、Unity エディター内のプロジェクトを Unity Cloud プロジェクトにリンクする必要があります。

エディター内のプロジェクトをリンクするには、次の手順に従います。

Edit (編集) > Project Settings (プロジェクト設定) > Services (サービス) を選択します。
Use an existing Unity project ID (既存の Unity プロジェクト ID を使用) を選択します。
ドロップダウンメニューから組織とプロジェクトを選択します。
Link project ID (プロジェクト ID をリンク) を選択します。

Unity Dashboard にプロジェクトをリンクする方法の詳細については、こちらを参照してください。

UGS パッケージのインストール

プロジェクトに実装予定のサービスに対応したパッケージをインストールする必要があります。UGS 対応のパッケージを確認およびインストールするには、次の手順に従います。

Unity エディターで、Window (ウィンドウ) > Package Manager (パッケージマネージャー) を選択します。
Package Manager で、Unity Registry (Unity レジストリ) のリストビューを選択します。
パッケージ名を検索するか、レジストリリスト内で見つけます。
このパッケージを選択し、Install (インストール) をクリックします。

検索バーに services と入力する方法もあります。この場合、Remote Config 以外のすべてのサービスが返されます。

バージョン 2022.1 以降のエディターでは、Package Manager の Services (サービス) タブに、UGS で使用できるすべてのパッケージが表示されます。

SDK 名前空間のインポート

SDK の API にアクセスするには、スクリプトでその SDK の名前空間をインポートする必要があります。例えば、Analytics の場合、以下のようにします。


using Unity.Services.Analytics;

ゲームコードでの Unity Services の初期化

サービスの機能を呼び出す前に、Services Core SDK を初期化する必要があります。推奨されるベストプラクティスは、ゲームのランタイムの初期 (できれば起動時) にサービスを初期化することです。

注

ノート:

com.unity.services.core

パッケージをインストールしたり、パッケージマニフェストに追加したりする必要はありません。これに依存する UGS パッケージをインストールしたときに、自動的にプルされます。

ゲームコード内で Unity Services を初期化するには、Services Core 名前空間 (

Unity.Services.Core

) をインポートするスクリプトを作成した後、

InitializeAsync

メソッドを呼び出します。例を次に示します。


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);		}	}}

このメソッドは、プロジェクトにインストールされているすべての Unity Gaming Services を初期化します。

State

メソッドを使用すると、ランタイム時にゲームの初期化ステータスを確認できます。詳細については、Services Core API のドキュメントを参照してください。

最初の Cloud Code スクリプトの作成とその後の手順

Unity Gaming Services の最も一般的な使用方法の 1 つは、カスタムサーバー主導型の経済ロジックまたはゲームロジックです。こちらの Cloud Code ウォークスルーに、インストール、初期化、ダッシュボード設定、ゲームクライアントからのシンプルな Cloud Code スクリプトのリモート実行など、使用を開始するために必要なすべての情報が含まれています。

次のステップ

Unity のユースケースサンプルプロジェクトで、UGS 機能の使用方法のアイデアを確認します。
個々のサービスを実装します。
UGS CLI または Deployment ウィンドウを使用して設定管理ワークフローを単純化します。

ドキュメント

Development

User Acquisition

Monetization

産業