Unity 用プラグイン: プラグインコンポーネントをインストールして設定します - Amazon GameLift
開始する前にプラグインをゲームプロジェクトに追加する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Unity 用プラグイン: プラグインコンポーネントをインストールして設定します

このセクションでは、プラグインを Unity プロジェクトに追加する方法について説明します。プラグイン機能は、プラグインをインストール後に、Unity エディタでプロジェクトを開くと使用できます。

開始する前に

Unity 用 Amazon GameLift プラグインを使用するために必要なものは次のとおりです。

  • Unity 6.0、2021.3、または 2022.3 の LTS バージョン

  • Unity 用 Amazon GameLift プラグインをダウンロードします。Unity バージョンのサポートについては、各パッケージの readme を確認してください。[ダウンロードサイト] ダウンロードには、2 つのパッケージが含まれています。

    • Unity 用 Amazon GameLift スタンドアロンプラグイン

    • Amazon GameLift C# サーバー SDK for Unity

  • Microsoft Visual Studio 2019 以降。

  • C# ゲームコードを使ったマルチプレイヤーゲームプロジェクト。

  • サードパーティのスコープ設定されたレジストリ UnityNuGet。このツールはサードパーティ DLL を管理します。詳細については、UnityNuGet GitHub リポジトリを参照してください。

プラグインをゲームプロジェクトに追加する

Unity エディタとゲームプロジェクトファイルで作業し、以下のタスクを実行します。

手順 1: ゲームプロジェクトに UnityNuGet を追加する

ゲームプロジェクトに UnityNuget をセットアップしていない場合は、以下の手順に従って Unity パッケージマネージャーを使用してツールをインストールしてください。または、NuGet CLI を使用して DLL を手動でダウンロードすることもできます。詳細については、Unity 用の Amazon GameLift C# サーバー SDK README を参照してください。

  1. Unity エディタでプロジェクトを開いた状態で、メインメニューに移動し、[編集]、[プロジェクト設定] の順に選択します。オプションから [パッケージマネージャー] セクションを選択し、[スコープ設定レジストリ] グループを開きます。

  2. [+] ボタンを選択し、UnityNuGet スコープ設定レジストリに以下の値を入力します。

    Name: Unity NuGet
URL: https://unitynuget-registry.azurewebsites.net
Scope(s): org.nuget

Unity 2021 バージョンのユーザー:

UnityNuget をセットアップしたら、Unity コンソールにエラーが表示されていないか確認します。これらのエラーは、NuGet パッケージ内の厳密な名前付きアセンブリのバインディングリダイレクトが Unity プロジェクト内のパスに正しく解決されない場合に発生します。この問題を解決するには、Unity のアセンブリバージョンの検証を設定します。

  1. Unity エディタのメインメニューに移動し、[編集]、[プロジェクト設定] を選択し、[プレイヤー] セクションを開きます。

  2. [アセンブリバージョン検証] オプションの選択を解除します。

手順 2: プラグインと C# サーバー SDK パッケージを追加する

  1. 両方のパッケージを含む Unity ダウンロード用の Amazon GameLift プラグインを解凍します。

  2. Unity エディタでプロジェクトを開いた状態で、メインメニューに移動し、[ウィンドウ」、[パッケージマネージャー] の順に選択します。

  3. [+] ボタンを選択して新しいパッケージを追加します。[tarball からパッケージを追加] オプションを選択します。

  4. [ディスクでパッケージを選択] で、Unity ダウンロードファイル用の Amazon GameLift C# サーバー SDK プラグインを探し、com.amazonaws.gameliftserver.sdk-<version>.tgz ファイルを選択します。[開く] を選択してプラグインをインストールします。

  5. [ディスクでパッケージを選択] で、Unity ダウンロードファイル用の Amazon GameLift スタンドアロンプラグインを探し、ファイル com.amazonaws.gamelift-<version>.tgz を選択します。[開く] を選択してプラグインをインストールします。

  6. スタンドアロンプラグインがプロジェクトに追加されていることを確認します。[Unity エディタ] ウィンドウに戻ります。新しい Amazon GameLift メニューボタンのメインメニューを確認します。

手順 3: サンプルゲームをインポートする (オプション)

Unity 用プラグインには、ゲームプロジェクトに追加できるシーンを含むサンプルゲームアセット一式が付属しています。サンプルゲームをインポートすると、Amazon GameLift を使用してシンプルなマルチプレイヤーゲームのテスト、ビルド、デプロイを迅速に行うことができます。サンプルゲームはすでに Amazon GameLift SDK と完全に統合されているため、統合タスクをスキップして残りのワークフロータスクを実行できます。

サンプルゲームを使用する場合、ローカルでホストされている Amazon GameLift Anywhere フリートをわずか数分で設定して参加できます。ゲームを Amazon GameLift にデプロイすると、1 時間以内にクラウドホストのライブゲームに参加できます。

サンプルゲームをインポートする:

  1. Unity エディタでゲームプロジェクトを開き、Amazon GameLift メニューに移動し、[サンプルゲーム]、[サンプルゲームのインポート] の順に選択します。

  2. ファイルをインポートしたら、Amazon GameLift メニューに再度移動し、[サンプルゲーム]、[設定を初期化] の順に選択します。この手順では、ゲームクライアントとサーバーをビルドするためのプロジェクトを設定します。

インストールが完了すると、ゲームプロジェクトに 2 つの新しいシーンが追加されます。GameLiftClientSettings アセットなど、追加のプロジェクトアセットも表示されます。

サンプルの UI とゲームプレイの詳細については、サンプルゲームの readme を参照してください。