翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon GameLift Streams でアプリケーションを準備する
Amazon GameLift Streams でストリーミングを設定するには、まずストリーミングするゲームまたは他のアプリケーションをアップロードし、Amazon GameLift Streams 内でアプリケーションリソースを設定してゲームに関するメタデータを定義します。Amazon GameLift Streams アプリケーションは、アップロードしたファイル (実行可能ファイルとサポートファイル) と、ストリーミング時に実行する実行可能ファイルを Amazon GameLift Streams に指示する設定で構成されます。
各 Amazon GameLift Streams アプリケーションは、コンテンツの 1 つのバージョンを表します。複数のバージョンがある場合は、バージョンごとに個別のアプリケーションを作成する必要があります。アプリケーションを作成した後は、ファイルを更新することはできません。実行可能ファイルまたはサポートファイルを更新する必要がある場合は、新しい Amazon GameLift Streams アプリケーションを作成する必要があります。
アップロードする前に
Amazon GameLift Streams アプリケーションを作成する前に、ゲームが次の制限に従っていることを確認してください。
| 名前 |
デフォルト |
引き上げ可能 |
説明 |
| アプリケーションあたりのファイル数 |
30,000 ファイル |
はい* |
このアカウントでアプリケーションに保持できるファイルの最大数。 |
| 単一ファイルサイズ |
80 GiB |
なし |
アプリケーション内の 1 つのファイルの最大サイズ。ギビバイト (GiB) は 1024 x 1024 x 1024 バイトに等しいことに注意してください。 |
| アプリケーションサイズ |
100 GiB |
はい* |
このアカウントの Amazon GameLift Streams アプリケーションの最大合計サイズ。ギビバイト (GiB) は 1024 x 1024 x 1024 バイトに等しいことに注意してください。 |
*引き上げをリクエストするには、 にサインイン AWS Management Console し、Service Quotas コンソールを Amazon GameLift Streams に開きます。ここでは、Applied account-level quota value 列で現在のクォータを確認し、値を引き上げるリクエストを送信できます。
時間と労力を節約するには、アップロードする準備ができているファイルがアプリケーションの正しいバージョンであることを確認します。新しいバージョンは後でアップロードできますが、バージョンごとに アプリケーションの作成ステップを繰り返す必要があります。
Amazon S3 バケットにアプリケーションをアップロードする
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 ではサポートされていません。
ストレージコストを最適化するには、完了 アプリケーションの作成してアプリケーションが準備完了ステータスになったら、S3 バケットからアプリケーションを削除できます。
アプリケーションの作成
Amazon GameLift Streams アプリケーションは、ストリーミングするゲームやその他のソフトウェアと、それを実行するための設定を含むリソースです。アプリケーションを作成するときは、Amazon S3 バケットにアップロードしたアプリケーションファイルへのパスを指定します。
Amazon GameLift Streams は、作成した Amazon S3 バケットからゲームファイルを自動同期しません。ゲームファイルを更新する場合は、新しい Amazon GameLift Streams アプリケーションを作成する必要があります。
- Console
-
Amazon GameLift Streams コンソールを使用して Amazon GameLift Streams アプリケーションを作成するには
-
にサインイン AWS Management Console し、Amazon GameLift Streams コンソールを開きます。ファイルセットをアップロードした Amazon S3 バケット AWS リージョン と同じ を選択します。詳細については、「 入門ガイド」の「リージョンの選択」を参照してください。 AWS Management Console
-
ナビゲーションバーで、アプリケーションを選択し、アプリケーションの作成を選択します。
-
ランタイム設定で、次のように入力します。
-
ランタイム環境
アプリケーションを実行するランタイム環境です。Amazon GameLift Streams は、Windows、Ubuntu 22.04 LTS または Proton のいずれかで実行できます。
このフィールドを作成ワークフローの後に編集することはできません。
次のいずれかのランタイム環境から選択。
-
Linux アプリケーションの場合:
-
Windows アプリケーションの場合:
-
Microsoft Windows Server 2022 Base (WINDOWS, 2022)
-
Proton 9.0-2 (PROTON, 20250516)
-
Proton 8.0-5 (PROTON, 20241007)
-
Proton 8.0-2c (PROTON, 20230704)
説明を確認し、比較チェックリストを使用すると、アプリケーションに最適なランタイム環境を選択できます。
-
全般設定で、次のように入力します。
-
説明
人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。
-
ベースパス
これは、Amazon S3 バケット内のアプリケーションのルートフォルダへの Amazon S3 URI です。このフォルダおよびサブフォルダには、ビルド実行ファイルとサポートファイルを含める必要があります。
有効な URI は、アプリケーションの実行とストリーミングに必要なすべてのファイルを含むバケットプレフィックスです。例えば、mygamebuild というバケットに、完全なバージョンのゲームビルドファイルが 3 つ、それぞれ別のフォルダに含まれているとします。フォルダ mygamebuild-EN101 内のビルドをストリーミングします。この例では、URI は s3://amzn-s3-demo-bucket/mygamebuild-EN101 です。
このフィールドを作成ワークフローの後に編集することはできません。
-
実行可能な起動パス
これは、Amazon GameLift Streams がストリーミングする実行ファイルの Amazon S3 URI です。このファイルは、アプリケーションのルートフォルダに含める必要があります。
このフィールドを作成ワークフローの後に編集することはできません。
-
(オプション) アプリケーションログパスに、次のように入力します。
-
アプリケーションログパス
これは、保存するログを含むアプリケーションフォルダまたはファイルへのパス (1 つまたは複数) です。各ログパスは、アプリケーションのベースパスを基準にして指定します。この機能を使用すると、各ストリームセッションの最後に、Amazon GameLift Streams は指定されたファイルを、指定された名前の Amazon S3 バケットにコピーします。コピー操作は、アプリケーションフォルダのサブフォルダでは、再帰的に実行されません。
ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションログ出力先をクリアします。
このフィールドはいつでも編集できます。
-
アプリケーションログの出力
これは、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"
}
}
}
]
}
-
(オプション) タグで、このアプリケーションにタグを割り当てます。
タグは、 AWS リソースの整理に役立つラベルです。詳細については、「AWS リソースのタグ付け」を参照してください。
例えば、アプリケーションのバージョンを追跡するには、application-version : my-game-1121 などのタグを使用します。
-
[Create application] を選択します。
- CLI
-
前提条件
ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。
を使用してアプリケーションを作成するには AWS CLI
では、コンテンツに合わせてカスタマイズされた CreateApplication コマンド 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 のいずれかで実行できます。
このフィールドを作成ワークフローの後に編集することはできません。
次のいずれかのランタイム環境から選択。
-
Linux アプリケーションの場合
-
Windows アプリケーションの場合
-
Microsoft Windows Server 2022 Base (Type=WINDOWS, Version=2022)
-
Proton 8.0-2c (Type=PROTON, Version=20230704)
-
Proton 8.0-5 (Type=PROTON, Version=20241007)
-
Proton 9.0-2 (Type=PROTON, Version=20250516)
-
executable-path:
これは、Amazon GameLift Streams がストリーミングする実行可能ファイルへのパスです。への相対パスを指定しますapplication-source-uri。このファイルは、アプリケーションのルートフォルダに含める必要があります。
このフィールドを作成ワークフローの後に編集することはできません。
-
application-source-uri:
これは、Amazon S3 バケット内のアプリケーションのルートフォルダへの Amazon S3 URI です。このフォルダおよびサブフォルダには、ビルド実行ファイルとサポートファイルを含める必要があります。
有効な URI は、アプリケーションの実行とストリーミングに必要なすべてのファイルを含むバケットプレフィックスです。例えば、mygamebuild というバケットに、完全なバージョンのゲームビルドファイルが 3 つ、それぞれ別のフォルダに含まれているとします。フォルダ mygamebuild-EN101 内のビルドをストリーミングします。この例では、URI は s3://amzn-s3-demo-bucket/mygamebuild-EN101 です。
このフィールドを作成ワークフローの後に編集することはできません。
リクエストが成功すると、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 コマンドを呼び出します。
aws gameliftstreams get-application /
--identifier a-9ZY8X7Wv6
Amazon GameLift Streams は、アプリケーションの準備に数分かかります。この間、新しいアプリケーションは処理中ステータスになります。アプリケーションが準備完了ステータスになったら、次のステップ「」に進むことができますストリームグループを作成する。
リクエストがエラーを返した場合、またはアプリケーションが作成されてもエラーステータスになった場合は、Amazon S3 と Amazon GameLift Streams の両方へのアクセスを含むユーザー認証情報を使用していることを確認してください。
アプリケーションが準備完了ステータスになると、Amazon GameLift Streams はアプリケーションファイルをプライベート Amazon S3 バケットに正常にコピーしました。新しいアプリケーションに影響を与えることなく、元のアプリケーションファイルを削除できます。これにより、ストレージコストを最適化することもできます。詳細については、「 アプリケーションの削除」を参照してください。
アプリケーションを編集する
Ready ステータスのすべてのアプリケーションの設定を更新できます。既存のアプリケーションに変更を加えると、これらの変更は新規および既存のストリームグループのストリーミング動作に影響します。
- Console
-
Amazon GameLift Streams コンソールでアプリケーションを編集するには
-
ナビゲーションバーで、アプリケーションを選択して既存のアプリケーションのリストを表示します。編集するアプリケーションを選択します。
-
アプリケーションの詳細ページで、変更する設定を含むセクションを見つけ、それに応じてタグの編集または管理を選択します。
-
以下の設定を指定することができます。
- 簡単な説明
-
人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。
- アプリケーションのログパス
-
これは、保存するログを含むアプリケーションフォルダまたはファイルへのパス (1 つまたは複数) です。各ログパスは、アプリケーションのベースパスを基準にして指定します。この機能を使用すると、各ストリームセッションの最後に、Amazon GameLift Streams は指定されたファイルを、指定された名前の Amazon S3 バケットにコピーします。コピー操作は、アプリケーションフォルダのサブフォルダでは、再帰的に実行されません。
ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションログ出力先をクリアします。
このフィールドはいつでも編集できます。
- アプリケーションのログ出力
-
これは、Amazon GameLift Streams がアプリケーションログファイルをコピーする Amazon S3 バケットの URI です。このフィールドは、アプリケーションログパスを指定する場合に必須です。
ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションログ出力先をクリアします。
このフィールドはいつでも編集できます。
自動でログファイルを保存するには、Amazon GameLift Streams に S3 バケットへの保存アクセス許可を与える必要があります。ログ記録用のバケットを Amazon GameLift Streams に作成させると、作成時にアクセス許可ポリシーが自動的に適用されます。独自のバケットを指定する場合は、アクセス許可ポリシーを自分で適用する必要があります。
詳細については、「アプリケーションログバケットのアクセス許可ポリシー」を参照してください。
- タグ
-
タグは、 AWS リソースの整理に役立つラベルです。詳細については、「AWS リソースのタグ付け」を参照してください。
例えば、アプリケーションのバージョンを追跡するには、application-version : my-game-1121 などのタグを使用します。
-
[Save changes] (変更の保存) をクリックします。Amazon GameLift Streams コンソールがアプリケーションの詳細ページに戻り、更新された設定が表示されます。
- CLI
-
前提条件
ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。
を使用してアプリケーションを編集するには AWS CLI
で、コンテンツに合わせてカスタマイズされた UpdateApplication コマンド 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) または ID です。
ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
ID の例: a-9ZY8X7Wv6
-
description:
人間が読み取れるアプリケーション用のラベルです。この値は一意である必要はありません。ベストプラクティスとして、アプリケーションのわかりやすい説明、名前、またはラベルを使用してください。このフィールドはいつでも編集できます。
-
application-log-paths:
これは、保存するログを含むアプリケーションフォルダまたはファイルへのパス (1 つまたは複数) です。各ログパスは、アプリケーションのベースパスを基準にして指定します。この機能を使用すると、各ストリームセッションの最後に、Amazon GameLift Streams は指定されたファイルを、指定された名前の Amazon S3 バケットにコピーします。コピー操作は、アプリケーションフォルダのサブフォルダでは、再帰的に実行されません。
ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションログ出力先をクリアします。
このフィールドはいつでも編集できます。
-
application-log-output-uri:
これは、Amazon GameLift Streams がアプリケーションログファイルをコピーする Amazon S3 バケットの URI です。このフィールドは、アプリケーションログパスを指定する場合に必須です。
ログ記録を無効にするには、すべてのアプリケーションログパスを削除し、アプリケーションログ出力先をクリアします。
このフィールドはいつでも編集できます。
自動でログファイルを保存するには、Amazon GameLift Streams に S3 バケットへの保存アクセス許可を与える必要があります。ログ記録用のバケットを Amazon GameLift Streams に作成させると、作成時にアクセス許可ポリシーが自動的に適用されます。独自のバケットを指定する場合は、アクセス許可ポリシーを自分で適用する必要があります。
詳細については、「アプリケーションログバケットのアクセス許可ポリシー」を参照してください。
アプリケーションの削除
不要になったアプリケーションを削除します。このアクションにより、Amazon GameLift Streams に保存されているアプリケーションコンテンツファイルを含むアプリケーションが完全に削除されます。ただし、Amazon S3 バケットにアップロードした元のファイルは削除されません。Amazon GameLift Streams がアプリケーションを作成した後はいつでも削除できます。これは、Amazon GameLift Streams が Amazon S3 バケットにアクセスする唯一の時間です。
削除できるのは、以下の条件を満たすアプリケーションだけです。
アプリケーションがいずれかのストリームグループにリンクされている場合は、削除する前に、関連するすべてのストリームグループからリンクを解除する必要があります。コンソールでは、このプロセスを説明するダイアログボックスが表示されます。
- Console
-
Amazon GameLift Streams コンソールを使用してアプリケーションを削除するには
-
にサインイン AWS Management Console し、Amazon GameLift Streams コンソールを開きます。
-
ナビゲーションバーで、アプリケーションを選択して既存のアプリケーションのリストを表示します。削除するアプリケーションを選択します。
-
アプリケーションの詳細ページで、削除を選択します。
-
削除ダイアログボックスで、削除アクションを確認します。
- CLI
-
前提条件
ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。
を使用してアプリケーションを削除するには AWS CLI
では、コンテンツに合わせてカスタマイズされた DeleteApplication コマンド AWS CLI を使用します。
aws gameliftstreams delete-application \
--identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
この場合、次のようになります。
-
identifier: 削除するアプリケーション。
この値は、アプリケーションリソースを一意に識別する Amazon リソースネーム (ARN) または ID です。
ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
ID の例: a-9ZY8X7Wv6
Amazon GameLift Streams がアプリケーションの削除を開始します。この間、アプリケーションは Deletingステータスになります。Amazon GameLift Streams がアプリケーションを削除すると、アプリケーションを取得できなくなります。
アプリケーションログバケットのアクセス許可ポリシー
独自のアプリケーションログ 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 サービスにアクセス許可を付与するときに混乱した代理問題を防ぐために、常に aws:SourceAccountまたは aws:SourceArn条件を含めることがベストプラクティスです。
リンクされたストリームグループ
同一のコンピューティングリソースプールを使用して複数のアプリケーションをストリーミングする場合は、複数のアプリケーションを同じストリームグループにリンクできます。同様に、複数の異なるコンピューティングリソースのセットを使用して 1 つのアプリケーションをストリーミングする場合は、アプリケーションを複数のストリームグループにリンクできます。
アプリケーションをストリームグループにリンクする方法の詳細については、「」を参照してくださいマルチアプリケーションストリームグループの概要。