

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

# Amazon GameLift Streams でアプリケーションを準備する
<a name="applications"></a>

Amazon GameLift Streams でストリーミングを設定するには、まずストリーミングするゲームまたは他のアプリケーションをアップロードし、Amazon GameLift Streams 内でアプリケーションリソースを設定してゲームに関するメタデータを定義します。Amazon GameLift Streams アプリケーションは、アップロードしたファイル (実行可能ファイルとサポートファイル) と、ストリーミング時に実行する実行可能ファイルを Amazon GameLift Streams に指示する設定で構成されます。

各 Amazon GameLift Streams アプリケーションは、コンテンツの 1 つのバージョンを表します。複数のバージョンがある場合は、バージョンごとに個別のアプリケーションを作成する必要があります。アプリケーションを作成した後は、ファイルを更新することはできません。実行可能ファイルまたはサポートファイルを更新する必要がある場合は、新しい Amazon GameLift Streams アプリケーションを作成する必要があります。

## アップロードする前に
<a name="applications-prepare"></a>

Amazon GameLift Streams アプリケーションを作成する前に、ゲームが次の制限に従っていることを確認してください。


| 名前 | デフォルト | 引き上げ可能 | 説明 | 
| --- | --- | --- | --- | 
| アプリケーションあたりのファイル数 | 30,000 ファイル | はい\* | このアカウントで 1 つのアプリケーションに保持できるファイルの最大数。 | 
| 単一ファイルサイズ | 80 GiB | いいえ | アプリケーション内の 1 つのファイルの最大サイズ。ギビバイト (GiB) は、1024 x 1024 x 1024 バイトに等しいことに注意してください。 | 
| アプリケーションサイズ | 100 GiB | はい\* | このアカウントの Amazon GameLift Streams アプリケーションの最大合計サイズ。ギビバイト (GiB) は、1024 x 1024 x 1024 バイトに等しいことに注意してください。 | 

\*引き上げをリクエストするには、 にサインイン AWS マネジメントコンソール し、Service Quotas コンソールから [Amazon GameLift Streams](https://console.aws.amazon.com/servicequotas/home/services/gameliftstreams/quotas) を開きます。ここでは、**Applied account-level quota value 列で現在のクォータ**を確認し、値を引き上げるリクエストを送信できます。

**注記**  
 時間と労力を節約するには、アップロードする準備ができているファイルがアプリケーションの正しいバージョンであることを確認します。新しいバージョンは後でアップロードできますが、バージョンごとに[アプリケーションの作成](#applications-create)ステップを繰り返す必要があります。

## Amazon S3 バケットにアプリケーションをアップロードする
<a name="applications-upload"></a>

Amazon GameLift Streams 用にゲームを準備したので、 AWS アカウント内の Amazon Simple Storage Service (Amazon S3) バケットにアップロードします。

**注記**  
 Amazon GameLift Streams に必要な Amazon S3 ストレージクラスは、デフォルトの **S3 Standard** です。**S3 Glacier **や **S3 Intelligent-Tiering** **によって低頻度アクセス**または**アーカイブアクセス**に移動されるオブジェクトなどの他のストレージクラスは、Amazon GameLift Streams ではサポートされていません。  
 ストレージコストを最適化するには、完了[アプリケーションの作成](#applications-create)してアプリケーションが**準備完了**ステータスになったら、S3 バケットからアプリケーションを削除できます。

**アプリケーションを Amazon S3 にアップロードするには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) で Amazon S3 コンソールを開きます。

1. Amazon S3 バケットを作成する。バケット名を入力し、 を選択します AWS リージョン。このリージョンは、後で作成するアプリケーションおよびストリームグループと同じである必要があります。Amazon GameLift Streams が利用可能な AWS リージョン のリスト[AWS リージョン Amazon GameLift Streams でサポートされている および ストリーミングロケーション](regions-quotas-rande.md)については、「」を参照してください。残りのフィールドについては、デフォルト設定のままにします。

    詳細については、*「Amazon Simple Storage Service ユーザーガイド*[」の「バケットの作成](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)」を参照してください。

1. 新しいバケットを開き、アプリケーションファイルとともにフォルダをアップロードします。
**警告**  
アプリケーションファイルを非圧縮フォルダとしてアップロードする必要があります。`.zip` フォルダをアップロードしないでください。

## アプリケーションの作成
<a name="applications-create"></a>

 Amazon GameLift Streams アプリケーションは、Amazon GameLift Streams インフラストラクチャで実行され、クラウドストリーミングを通じてプレイヤーにゲームプレイ体験を提供するゲームまたはインタラクティブアプリケーションを含むリソースです。アプリケーションは AWS コンピューティングインスタンスで実行され、インターネット経由でプレイヤーのデバイスに直接ストリーミングされるゲームコンテンツをレンダリングするため、プレイヤーがゲームをローカルでダウンロード、インストール、または実行する必要がなくなります。

Amazon GameLift Streams アプリケーションを作成するときは、Amazon S3 バケットにアップロードしたアプリケーションフォルダに Amazon S3 URI を指定し、有効な実行可能ファイルまたはスクリプトファイルへの相対パスを指定します。

Amazon GameLift Streams は、アプリケーションファイルを Amazon S3 バケット内のファイルと同期させません。Amazon GameLift Streams アプリケーションのファイルを更新する場合は、新しい Amazon GameLift Streams アプリケーションを作成する必要があります。

------
#### [ Console ]

**Amazon GameLift Streams コンソールを使用して Amazon GameLift Streams アプリケーションを作成するには**

1.  にサインイン AWS マネジメントコンソール し、[Amazon GameLift Streams コンソール](https://console.aws.amazon.com/gameliftstreams/)を開きます。ファイルセットをアップロードした Amazon S3 バケット AWS リージョン と同じ を選択します。詳細については、「 入門ガイド[」の「リージョンの選択](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/select-region.html)」を参照してください。 *AWS マネジメントコンソール *

1.  ナビゲーションバーで、**アプリケーション**を選択し、**アプリケーションの作成**を選択します。

1. **ランタイム設定**で、次のように入力します。

   1. **ランタイム環境**

      これは、アプリケーションを実行するランタイム環境です。Amazon GameLift Streams は、Windows、Ubuntu 22.04 LTS、または [Proton](https://en.wikipedia.org/wiki/Proton_(software)) のいずれかで実行できます。

      **このフィールドを作成ワークフローの後に編集することはできません。**

     次のいずれかのランタイム環境から選択。
     +  Linux アプリケーションの場合: 
       +  Ubuntu 22.04 LTS (`UBUNTU, 22_04_LTS`) 
     +  Windows アプリケーションの場合: 
       + Microsoft Windows Server 2022 Base (`WINDOWS, 2022`)
       + Proton 10.0-4 (`PROTON, 20260204`)
       + Proton 9.0-2 (`PROTON, 20250516`)
       + Proton 8.0-5 (`PROTON, 20241007`)
       + Proton 8.0-2c (`PROTON, 20230704`)

     説明を確認し、比較チェックリストを使用して、アプリケーションに最適なランタイム環境を選択します。

1. **全般設定**で、次のように入力します。

   1. **説明**

       人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。

   1. **ベースパス**

       これは、Amazon S3 バケット内のアプリケーションのルートフォルダへの Amazon S3 URI です。このフォルダおよびサブフォルダには、ビルド実行ファイルとサポートファイルを含める必要があります。

       有効な URI は、アプリケーションの実行とストリーミングに必要なすべてのファイルを含むバケットプレフィックスです。例: `mygamebuild` というバケットに、完全なバージョンのゲームビルドファイルが 3 つ、それぞれ別のフォルダに含まれているとします。フォルダ `mygamebuild-EN101` 内のビルドをストリーミングします。この例では、URI は `s3://amzn-s3-demo-bucket/mygamebuild-EN101` です。

       **このフィールドを作成ワークフローの後に編集することはできません。**

   1. **実行可能な起動パス**

       これは、Amazon GameLift Streams がストリーミングする実行ファイルの Amazon S3 URI です。このファイルは、アプリケーションのルートフォルダに含める必要があります。Windows アプリケーションの場合、ファイルは、.exe、.cmd、または .bat で終わるファイル名を持つ有効な Windows 実行可能ファイルまたはバッチファイルである必要があります。Linux アプリケーションの場合、ファイルは有効な Linux バイナリ実行可能ファイルであるか、シェバン ('`#!`') で始まる最初のインタープリタ行を含むスクリプトである必要があります。

       **このフィールドを作成ワークフローの後に編集することはできません。**

1. (オプション) **アプリケーションログパス**に、次のように入力します。

   1. **アプリケーションログパス**

       Amazon GameLift Streams で保存するログファイルまたはフォルダへのパスを指定します。すべてのストリームセッションの終了時に、Amazon GameLift Streams は指定されたファイルを名前を付けた Amazon S3 バケットにコピーします。
      + パスはアプリケーションディレクトリに対する相対パス、またはサポートされているパス変数を使用する場合のユーザーのホームディレクトリに対する相対パスです。
      + ディレクトリを指定すると、`.txt`、`.log`、 ファイルのみが収集`.utrace`されます。他のファイルタイプを収集するには、正確なファイルパスを指定します。
      + コピーオペレーションはサブフォルダでは再帰的に実行されません。
      + 最大 10 個のログパスを指定できます。個々のログファイルのサイズは 50 MB を超えることはできません。

       **パス変数** 

       以下の変数は、パスの最初のコンポーネントとして表示されるときに認識されます。
      + `%USERPROFILE%` – ユーザーのホームディレクトリ (Windows および Proton)
      + `$HOME`、 `~` – ユーザーのホームディレクトリ (Linux)

       **例:** 
      + `Saved\Logs` – アプリケーションに関連する `Saved\Logs` ディレクトリから `.txt`、`.log`、 `.utrace`ファイルを収集します。
      + `Saved\Logs\debug.dmp` – 特定の名前付きファイルを収集します。
      + `%USERPROFILE%\AppData\Local\MyGame\Logs` – ユーザーのホームディレクトリに関連する `.txt`、`.log`、および `.utrace`ファイルを収集します。アプリケーションがアプリケーションディレクトリの外部にログを書き込むときは、パス変数を使用します。

       ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションのログ出力先をクリアします。

       このフィールドはいつでも編集できます。

   1. **アプリケーションログの出力**

       これは、Amazon GameLift Streams がアプリケーションログファイルをコピーする Amazon S3 バケットの URI です。このフィールドは、アプリケーションログパスを指定する場合に必須です。

       ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションのログ出力先をクリアします。

       このフィールドはいつでも編集できます。

       自動でログファイルを保存するには、Amazon GameLift Streams に S3 バケットへの保存アクセス許可を与える必要があります。ログ記録用のバケットを Amazon GameLift Streams に作成させると、作成時にアクセス許可ポリシーが自動的に適用されます。独自のバケットを指定する場合は、アクセス許可ポリシーを自分で適用する必要があります。

      **バケットアクセス許可ポリシーテンプレート**

       次のポリシーコードをコピーして、アプリケーションログに使用するバケットに適用します。必ず **amzn-s3-demo-bucket** を既存の S3 バケットの名前に置き換えてください。

      ```
      {
        "Version": "2012-10-17",		 	 	 
        "Statement": [
          {
            "Sid": "PutPolicy",
            "Effect": "Allow",
            "Principal": {
              "Service": [
                "gameliftstreams.amazonaws.com"
              ]
            },
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::{{amzn-s3-demo-bucket}}/*",
            "Condition": {
              "StringEquals": {
                "aws:SourceAccount": "{{your 12-digit account id}}"
              }
            }
          }
        ]
      }
      ```

1.  (オプション) **タグで**、このアプリケーションにタグを割り当てます。

    タグは、 AWS リソースの整理に役立つラベルです。詳細については、「[AWS リソースのタグ付け](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)」を参照してください。

    たとえば、アプリケーションバージョンを追跡するには、 などのタグを使用します`application-version : my-game-1121`。

1.  [**アプリケーションを作成**] を選択します。

------
#### [ CLI ]

**前提条件**

 ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してください[のダウンロード AWS CLI](setting-up.md#setting-up-prereqs)。

**を使用してアプリケーションを作成するには AWS CLI**

 では、コンテンツに合わせてカスタマイズされた [CreateApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_CreateApplication.html) コマンド AWS CLI を使用します。

```
aws gameliftstreams create-application \
    --description "{{MyGame v1}}" \
    --runtime-environment '{"Type":"{{PROTON}}", "Version":"{{20241007}}"}' \
    --executable-path "{{launcher.exe}}" \
    --application-source-uri "{{s3://amzn-s3-demo-bucket/example}}"
```

各一般項の意味は次のとおりです。
+ `description`:

   人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。
+ `runtime-environment`:

   これは、アプリケーションを実行するランタイム環境です。Amazon GameLift Streams は、Windows、Ubuntu 22.04 LTS、または [Proton](https://en.wikipedia.org/wiki/Proton_(software)) のいずれかで実行できます。

   **このフィールドを作成ワークフローの後に編集することはできません。**

  次のいずれかのランタイム環境から選択。
  +  Linux アプリケーションの場合: 
    + Ubuntu 22.04 LTS (`Type=UBUNTU, Version=22_04_LTS`)
  +  Windows アプリケーションの場合: 
    + Microsoft Windows Server 2022 Base (`Type=WINDOWS, Version=2022`)
    + Proton 10.0-4 (`Type=PROTON, Version=20260204`)
    + Proton 9.0-2 (`Type=PROTON, Version=20250516`)
    + Proton 8.0-5 (`Type=PROTON, Version=20241007`)
    + Proton 8.0-2c (`Type=PROTON, Version=20230704`)
+ `application-source-uri`:

   これは、Amazon S3 バケット内のアプリケーションのルートフォルダへの Amazon S3 URI です。このフォルダおよびサブフォルダには、ビルド実行ファイルとサポートファイルを含める必要があります。

   有効な URI は、アプリケーションの実行とストリーミングに必要なすべてのファイルを含むバケットプレフィックスです。例: `mygamebuild` というバケットに、完全なバージョンのゲームビルドファイルが 3 つ、それぞれ別のフォルダに含まれているとします。フォルダ `mygamebuild-EN101` 内のビルドをストリーミングします。この例では、URI は `s3://amzn-s3-demo-bucket/mygamebuild-EN101` です。

   **このフィールドを作成ワークフローの後に編集することはできません。**
+ `executable-path`:

   これは、Amazon GameLift Streams がストリーミングする実行可能ファイルの相対パスとファイル名です。への相対パスを指定します`application-source-uri`。このファイルは、アプリケーションのルートフォルダに含める必要があります。Windows アプリケーションの場合、ファイルは、.exe、.cmd、または .bat で終わるファイル名を持つ有効な Windows 実行可能ファイルまたはバッチファイルである必要があります。Linux アプリケーションの場合、ファイルは有効な Linux バイナリ実行可能ファイルであるか、シェバン ('`#!`') で始まる最初のインタープリタ行を含むスクリプトである必要があります。

   **このフィールドを作成ワークフローの後に編集することはできません。**

 リクエストが成功すると、Amazon GameLift Streams は次のようなレスポンスを返します。

```
{
    "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6",
    "Description": "MyGame v1",
    "RuntimeEnvironment": {
        "Type": "PROTON",
        "Version": "20241007"
    },
    "ExecutablePath": "launcher.exe",
    "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/example",
    "Id": "a-9ZY8X7Wv6",
    "Status": "PROCESSING",
    "CreatedAt": "2022-11-18T15:47:11.924000-08:00",
    "LastUpdatedAt": "2022-11-18T15:47:11.924000-08:00"
}
```

 アプリケーションのステータスを確認するには、次の例に示すように [GetApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetApplication.html) コマンドを呼び出します。

```
aws gameliftstreams get-application /
    --identifier {{a-9ZY8X7Wv6}}
```

------

 Amazon GameLift Streams は、アプリケーションの準備に数分かかります。この間、新しいアプリケーションは**処理**中ステータスになります。アプリケーションが**準備完了**ステータスになったら、次のステップ「」に進むことができます[ストリームグループを作成する](stream-groups.md#stream-groups-create)。

 リクエストがエラーを返した場合、またはアプリケーションが作成されても**エラー**ステータスになった場合は、Amazon S3 と Amazon GameLift Streams の両方へのアクセスを含むユーザー認証情報を使用していることを確認してください。

**注記**  
 アプリケーションが**準備完了**ステータスになると、Amazon GameLift Streams はアプリケーションファイルをプライベート Amazon S3 バケットに正常にコピーしました。新しいアプリケーションに影響を与えることなく、元のアプリケーションファイルを削除できます。これにより、ストレージコストを最適化することもできます。詳細については、「[アプリケーションの削除](#applications-delete)」を参照してください。

## アプリケーションを編集する
<a name="applications-update"></a>

 **Ready** ステータスのすべてのアプリケーションの設定を更新できます。既存のアプリケーションに変更を加えると、これらの変更は新規および既存のストリームグループのストリーミング動作に影響します。

------
#### [ Console ]

**Amazon GameLift Streams コンソールでアプリケーションを編集するには**

1.  ナビゲーションバーで、**アプリケーション**を選択して既存のアプリケーションのリストを表示します。編集するアプリケーションを選択します。

1.  アプリケーションの詳細ページで、変更する設定を含むセクションを見つけ、それに応じてタグ**の編集**または管理を選択します。 ****

1.  以下の設定を指定することができます。  
**簡単な説明**  
 人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。  
**アプリケーションのログパス**  
 Amazon GameLift Streams で保存するログファイルまたはフォルダへのパスを指定します。すべてのストリームセッションの終了時に、Amazon GameLift Streams は指定されたファイルを名前を付けた Amazon S3 バケットにコピーします。  
   + パスはアプリケーションディレクトリに対する相対パス、またはサポートされているパス変数を使用する場合のユーザーのホームディレクトリに対する相対パスです。
   + ディレクトリを指定すると、`.txt`、`.log`、 ファイルのみが収集`.utrace`されます。他のファイルタイプを収集するには、正確なファイルパスを指定します。
   + コピーオペレーションはサブフォルダでは再帰的に実行されません。
   + 最大 10 個のログパスを指定できます。個々のログファイルのサイズは 50 MB を超えることはできません。
 **パス変数**   
 以下の変数は、パスの最初のコンポーネントとして表示されるときに認識されます。  
   + `%USERPROFILE%` – ユーザーのホームディレクトリ (Windows および Proton)
   + `$HOME`、 `~` – ユーザーのホームディレクトリ (Linux)
 **例:**   
   + `Saved\Logs` – アプリケーションに関連する `Saved\Logs` ディレクトリから `.txt`、`.log`、 `.utrace`ファイルを収集します。
   + `Saved\Logs\debug.dmp` – 特定の名前付きファイルを収集します。
   + `%USERPROFILE%\AppData\Local\MyGame\Logs` – ユーザーのホームディレクトリに関連する `.txt`、`.log`、および `.utrace`ファイルを収集します。アプリケーションがアプリケーションディレクトリの外部にログを書き込むときは、パス変数を使用します。
 ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションのログ出力先をクリアします。  
 このフィールドはいつでも編集できます。  
**アプリケーションのログ出力**  
 これは、Amazon GameLift Streams がアプリケーションログファイルをコピーする Amazon S3 バケットの URI です。このフィールドは、アプリケーションログパスを指定する場合に必須です。  
 ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションのログ出力先をクリアします。  
 このフィールドはいつでも編集できます。  
 自動でログファイルを保存するには、Amazon GameLift Streams に S3 バケットへの保存アクセス許可を与える必要があります。ログ記録用のバケットを Amazon GameLift Streams に作成させると、作成時にアクセス許可ポリシーが自動的に適用されます。独自のバケットを指定する場合は、アクセス許可ポリシーを自分で適用する必要があります。  
詳細については、「[アプリケーションログバケットのアクセス許可ポリシー](#application-bucket-permission-template)」を参照してください。  
**タグ**  
 タグは、 AWS リソースの整理に役立つラベルです。詳細については、「[AWS リソースのタグ付け](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)」を参照してください。  
 たとえば、アプリケーションバージョンを追跡するには、 などのタグを使用します`application-version : my-game-1121`。

1.  **[Save changes]** (変更の保存) をクリックします。Amazon GameLift Streams コンソールはアプリケーションの詳細ページに戻り、更新された設定を表示します。

------
#### [ CLI ]

**前提条件**

 ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してください[のダウンロード AWS CLI](setting-up.md#setting-up-prereqs)。

**を使用してアプリケーションを編集するには AWS CLI**

 で、コンテンツに合わせてカスタマイズされた [UpdateApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateApplication.html) コマンド AWS CLI を使用します。

```
aws gameliftstreams update-application \
    --identifier {{a-9ZY8X7Wv6}} \
    --description "{{MyGame v2}}" \
    --application-log-paths '["{{.\\logs}}"]' \
    --application-log-output-uri "{{s3://amzn-s3-demo-bucket/mygame}}"
```

各一般項の意味は次のとおりです。
+ `identifier`: 編集するアプリケーション。

  この値は、アプリケーション[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID です。

  ARN の例: `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`

  ID の例: `a-9ZY8X7Wv6`
+ `description`:

   人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。
+ `application-log-paths`:

   Amazon GameLift Streams で保存するログファイルまたはフォルダへのパスを指定します。すべてのストリームセッションの終了時に、Amazon GameLift Streams は指定されたファイルを名前を付けた Amazon S3 バケットにコピーします。
  + パスはアプリケーションディレクトリに対する相対パス、またはサポートされているパス変数を使用する場合のユーザーのホームディレクトリに対する相対パスです。
  + ディレクトリを指定すると、`.txt`、`.log`、 ファイルのみが収集`.utrace`されます。他のファイルタイプを収集するには、正確なファイルパスを指定します。
  + コピーオペレーションはサブフォルダでは再帰的に実行されません。
  + 最大 10 個のログパスを指定できます。個々のログファイルのサイズは 50 MB を超えることはできません。

   **パス変数** 

   以下の変数は、パスの最初のコンポーネントとして表示されるときに認識されます。
  + `%USERPROFILE%` – ユーザーのホームディレクトリ (Windows および Proton)
  + `$HOME`、 `~` – ユーザーのホームディレクトリ (Linux)

   **例:** 
  + `Saved\Logs` – アプリケーションに関連する `Saved\Logs` ディレクトリから `.txt`、`.log`、 `.utrace`ファイルを収集します。
  + `Saved\Logs\debug.dmp` – 特定の名前付きファイルを収集します。
  + `%USERPROFILE%\AppData\Local\MyGame\Logs` – ユーザーのホームディレクトリに関連する `.txt`、`.log`、および `.utrace`ファイルを収集します。アプリケーションがアプリケーションディレクトリの外部にログを書き込むときは、パス変数を使用します。

   ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションのログ出力先をクリアします。

   このフィールドはいつでも編集できます。
+ `application-log-output-uri`:

   これは、Amazon GameLift Streams がアプリケーションログファイルをコピーする Amazon S3 バケットの URI です。このフィールドは、アプリケーションログパスを指定する場合に必須です。

   ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションのログ出力先をクリアします。

   このフィールドはいつでも編集できます。

   自動でログファイルを保存するには、Amazon GameLift Streams に S3 バケットへの保存アクセス許可を与える必要があります。ログ記録用のバケットを Amazon GameLift Streams に作成させると、作成時にアクセス許可ポリシーが自動的に適用されます。独自のバケットを指定する場合は、アクセス許可ポリシーを自分で適用する必要があります。

  詳細については、「[アプリケーションログバケットのアクセス許可ポリシー](#application-bucket-permission-template)」を参照してください。

------

## アプリケーションの削除
<a name="applications-delete"></a>

 不要になったアプリケーションを削除します。このアクションは、Amazon GameLift Streams に保存されているアプリケーションコンテンツファイルを含め、アプリケーションを完全に削除します。ただし、Amazon S3 バケットにアップロードした元のファイルは削除されません。Amazon GameLift Streams がアプリケーションを作成した後はいつでも削除できます。これは、Amazon GameLift Streams が Amazon S3 バケットにアクセスする唯一の時間です。

 削除できるのは、以下の条件を満たすアプリケーションだけです。
+  **[準備完了]** 状態または **[エラー]** 状態のアプリケーション。
+  進行中のどのストリームセッションでもストリーミングされていないアプリケーション。クライアントがストリームセッションを終了するまで待つか、Amazon GameLift Streams API の [TerminateStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_TerminateStreamSession.html) を呼び出してストリームを終了する必要があります。

 アプリケーションがいずれかのストリームグループにリンクされている場合は、削除する前に、関連するすべてのストリームグループからリンクを解除する必要があります。コンソールでは、このプロセスを説明するダイアログボックスが表示されます。

------
#### [ Console ]

**Amazon GameLift Streams コンソールを使用してアプリケーションを削除するには**

1. にサインイン AWS マネジメントコンソール し、[Amazon GameLift Streams コンソール](https://console.aws.amazon.com/gameliftstreams/)を開きます。

1. ナビゲーションバーで、**アプリケーション**を選択して既存のアプリケーションのリストを表示します。削除するアプリケーションを選択します。

1. アプリケーションの詳細ページで、**削除**を選択します。

1. **削除**ダイアログボックスで、削除アクションを確認します。

------
#### [ CLI ]

**前提条件**

 ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してください[のダウンロード AWS CLI](setting-up.md#setting-up-prereqs)。

**を使用してアプリケーションを削除するには AWS CLI**

 では、コンテンツに合わせてカスタマイズされた [DeleteApplication](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DeleteApplication.html) コマンド AWS CLI を使用します。

```
aws gameliftstreams delete-application \
    --identifier {{arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6}}
```

各一般項の意味は次のとおりです。
+ `identifier`: 削除するアプリケーション。

  この値は、アプリケーション[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID です。

  ARN の例: `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`

  ID の例: `a-9ZY8X7Wv6`

------

 Amazon GameLift Streams がアプリケーションの削除を開始します。この間、アプリケーションは `Deleting`ステータスになります。Amazon GameLift Streams がアプリケーションを削除すると、アプリケーションを取得できなくなります。

## アプリケーションログバケットのアクセス許可ポリシー
<a name="application-bucket-permission-template"></a>

独自のアプリケーションログ Amazon S3 バケットを指定する場合は、Amazon GameLift Streams がログファイルをバケットに保存できるように、バケットにアクセス許可ポリシーを適用する必要があります。次のテンプレートを使用して、Amazon S3 のアクセス許可を更新します。

**バケットアクセス許可ポリシーテンプレート**

 次のポリシーコードをコピーして、アプリケーションログに使用するバケットに適用します。必ず **amzn-s3-demo-bucket** を既存の S3 バケットの名前に置き換えてください。

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "PutPolicy",
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "gameliftstreams.amazonaws.com"
        ]
      },
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::{{amzn-s3-demo-bucket}}/*",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{{your 12-digit account id}}"
        }
      }
    }
  ]
}
```

**注記**  
Amazon GameLift Streams は、クロスアカウントリソースアクセスを許可しません。Amazon S3 バケットは、アプリケーションリソースと同じ AWS アカウントによって所有されている必要があります。これはサービスによって強く適用されますが、 AWS サービスにアクセス許可を付与するときに[混乱した代理問題](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)を防ぐために、常に `aws:SourceAccount`または `aws:SourceArn`条件を含めることがベストプラクティスです。

## リンクされたストリームグループ
<a name="applications-linking"></a>

 同じコンピューティングリソースのプールを使用して複数のアプリケーションをストリーミングする場合は、複数のアプリケーションを同じストリームグループにリンクできます。同様に、複数の異なるコンピューティングリソースのセットを使用して 1 つのアプリケーションをストリーミングする場合は、アプリケーションを複数のストリームグループにリンクできます。

 アプリケーションをストリームグループにリンクする方法の詳細については、「」を参照してください[マルチアプリケーションストリームグループの概要](multi-apps.md)。