Amazon GameLift Streams のトラブルシューティング

IAM ロールに明示的な「すべて拒否」ポリシーがある場合は、NotAction 要素に を追加して、Amazon GameLift Streams "gameliftstreams:*"をそのポリシーの例外として明示的にリストする必要があります。例えば、次のようになります。

{
    "Sid": "DenyAllExceptListedIfNoMFA",
    "Effect": "Deny",
    "NotAction": [
        "iam:CreateVirtualMFADevice",
        "iam:EnableMFADevice",
        "iam:GetUser",
        "iam:ListMFADevices",
        "iam:ListVirtualMFADevices",
        "iam:ResyncMFADevice",
        "sts:GetSessionToken",        
        "gameliftstreams:*"                    // Add this
    ],
    "Resource": "*",
    "Condition": {
        "BoolIfExists": {"aws:MultiFactorAuthPresent": "false"}
    }
}

詳細については、「セキュリティ」章Amazon GameLift Streams の Identity and Access Managementの「」および「IAM ユーザーガイド」の「アクセス拒否エラーメッセージのトラブルシューティング」を参照してください。

別のマシンでアプリケーションを実行して、正しくパッケージ化されていることを確認します。これにより、アプリケーションコンテンツに、他のデバイスで機能しない可能性のあるハードコードされたパス、欠落しているアセット、ライブラリ、またはバイナリが含まれていないことを確認します。

アプリケーションが Proton と互換性があることを確認します。Amazon GameLift Streams サーバーを使用せずにローカル環境でアプリケーションをテストし、Proton と互換性があることを確認します。手順については、「Proton for Amazon GameLift Streams との互換性のテストとトラブルシューティング」を参照してください。

ランタイムを確認します。Amazon GameLift Streams アプリケーション設定で、実行可能起動パスで指定したファイルが実行可能ファイルまたはスクリプトであり、選択したランタイム環境に適していることを確認します。Windows アプリケーションは、ファイルタイプが「.exe」、「.bat」、または「.cmd」で、Windows または Proton ランタイムのいずれかをターゲットにする必要があります。ネイティブ Linux アプリケーションは、Ubuntu 22.04 LTS ランタイムをターゲットとする実行可能ファイルである必要があります。

必要な DLLsを確認します。Windows アプリケーションに必要な DLLsがない可能性があります。たとえば、アプリケーションがデバッグビルドの場合、Microsoft C および C++ (MSVC) ランタイムライブラリのデバッグバージョンが必要です。これを解決するには、ビルドと DLLs side-by-sideパッケージ化することをお勧めします。手順については、「Microsoft によるデバッグ実行可能ファイルを実行するテストマシンを準備する」を参照してください。

正しい実行可能ファイルを使用します。アプリケーションが Amazon GameLift Streams で正しく動作するには、アプリケーションパスを Binaries/Win64/ (または同様の) サブフォルダにある完全な実行可能ファイルに設定します。Unreal Engine は 2 つの実行可能ファイルを生成します。1 つはフォルダのルートに小さなブートストラップ実行可能ファイル、もう 1 つはBinaries/Win64/サブフォルダにプラットフォームターゲット実行可能ファイルです。前提条件を検証しようとするルート試行時のブートストラップ実行可能ファイルが正しいため、Amazon GameLift Streams でアプリケーションの起動を妨げる誤検出が発生する可能性があります。プラットフォームターゲット実行可能ファイルがない場合、アプリケーションが正しく構築されていない可能性があります。たとえば、サンプルの Unreal アプリケーションの次のフォルダ構造を参照してください。

BuildApp
|-> MyUnrealApp.exe
|-> MyUnrealApp
            |-> Binaries
                    |-> Win64
                            |-> MyUnrealApp.exe 

Unreal Engine Asserts をオフにします。check、verify、および ensureマクロを無効にします。これにより、アプリケーションがクラッシュダンプを作成できなくなる可能性があります。詳細については、Unreal Engine ドキュメントの「アサート」を参照してください。

マシンには、Amazon GameLift Streams よりも強力なハードウェアがある可能性があります。Amazon GameLift Streams が使用するハードウェアと同様のパフォーマンスのマシンでアプリケーションをテストしてください。

これにより、アプリケーションのレンダリング設定が GPU と互換性があり、パフォーマンスが期待を満たしていることを確認します。

問題は、ネットワーク接続または Amazon GameLift Streams の設定が原因である可能性があります。ストリーム接続の問題 「」セクションのトラブルシューティングのヒントを試してください。

Unreal Engine ゲームについては、「」を参照してくださいUnreal Engine のパフォーマンスのプロファイリング。

ドライバーベースのキャッシュ – このアプローチは、ランタイム環境の GPU とドライバーのバージョンに固有のものです。このオプションはすべてのアプリケーションに適用できるため、デフォルトの推奨アプローチです。このアプローチのステップは、GPU/ドライバーの組み合わせごとにレプリケートする必要があります。

エンジンベースのキャッシュ – このアプローチにより、利用可能な場合はゲームエンジンを介したシェーダーキャッシュが可能になります。これにより、事前にベイクされたパイプライン状態オブジェクト (PSO) キャッシュを開発者に作成する負担がかかります。また、エンジンが同じ GPU ハードウェア上の異なるドライバーのキャッシュサポートを処理できることを前提としています。

エンドユーザー AWS リージョン に最も近いものを選択します。クライアントからストリームをホストするリージョンへのレイテンシーが高いと、ストリームの品質に影響する可能性があります。ストリーミング元の場所のリストAWS リージョン Amazon GameLift Streams でサポートされている およびリモートロケーションについては、「」を参照してください。リージョンの AWS コンソールエンドポイントに ping を実行して、おおよそのレイテンシー測定値を取得できます。

ストリームグループに新しいストリームの容量があることを確認します。

ウェブクライアントConnectionTimeoutSecondsがタイムアウトする前に、エンドユーザーが接続に十分な時間を確保できるように が合理的に設定されていることを確認します。

ファイアウォールが UDP ポート範囲 33435-33465 へのアクセスを許可し、Amazon GameLift Streams からのストリーミングを許可していることを確認します。Amazon GameLift Streams がこれらのポートに到達できない場合、黒や灰色の画面などのストリーミングの問題が発生する可能性があります。

インターネット接続が 1080p ストリームで少なくとも 10 Mbps の接続速度を維持できることを確認します。Amazon GameLift Streams で再生中にネットワークの問題を検出すると、インターネット速度が変動し、少なくとも 10 Mbps が一貫して得られない可能性があります。インターネット速度テストを実行し、トラブルシューティングの手順に進みます。

可能であれば、有線ネットワークを使用します。Wi-Fi を使用する場合は、デバイスをルーターの近くに移動して、信号強度を強化します。

2.4 GHz 帯と 5 GHz 帯の両方の Wi-Fi ルーターを使用している場合は、別の帯に接続してみてください。ルーターを別のバンドに切り替える方法がわからない場合は、Wi-Fi ルーターの製造元またはプロバイダーのサポートページにアクセスしてください。カスタマーサービスに連絡することもできます。

同じネットワーク上の他のユーザー (特にホーム Wi-Fi の場合) が、ビデオストリーミング、ダウンロード、オンラインゲーム、バックアップなどの高帯域幅アプリケーションを実行しているかどうかを特定します。

帯域幅を使用するデバイス上の他のアプリケーションを閉じます。

ストリーミング中に VPN またはプロキシを使用しないでください。レイテンシーが高くなり、ゲームプレイに影響を与える可能性があります。

iPad または iPhone で再生するときに、セルラーネットワークの代わりに Wi-Fi を使用していることを確認します。セルラーネットワークを使用すると、接続の問題が発生する可能性があります。

MacOS ユーザーは、Wi-Fi が時々一時停止し、ストリーミングエクスペリエンスが低下するため、位置情報サービスを無効にする必要があります。

テストして、問題が browser-specifc かどうかを確認します。全体として、特にゲームコントローラーとの互換性を最大限に高めるために、Google Chrome、Microsoft Edge、またはカスタム Chromium ベースのデスクトップアプリケーションをお勧めします。

クライアントから送信され、アプリケーションによって受信された入力イベントをログに記録し、フロントエンドコードの入力ミスマッチがある場所を特定します。

既知の問題や制限など、サポートされているブラウザと入力デバイスに関するサポートされているブラウザと入力追加情報を必ず確認してください。

問題: MacOS の コマンドキーは Meta キーイベントにマッピングされ、Microsoft Windows の Windows キーにマッピングされます。問題は、コマンドと別のキーを同時に押すと MacOS ブラウザに影響するバグです。ここでは、リリース時に Meta キーがリセットされますが、ブラウザが矢印キーのキーアップイベントをキャプチャしなかったため、Web SDK クライアントはキーアップイベントをサーバーに送信せず、ストリーミングアプリケーションはキーが押されていると見なします。

解決策: コマンドキーを使用していない場合は、Web SDK のInputConfigurationインターフェイスにある Web SDK キーボードフィルターメカニズム (keyboardFilter) を使用してフィルタリングできます。

問題: Amazon GameLift Streams はヒューリスティックを使用して、マウスイベントを「相対」モードで送信するか「絶対」モードで送信するかを選択します。相対モードでは、新しいマウス更新は、以前の更新との小さな増分的な違いとして提供されます。絶対モードでは、マウスカーソルはクライアントと同期された画面位置に継続的に強制されます。ストリーミングされたコンテンツにオペレーティングシステムカーソルが表示されると、ヒューリスティックは常に絶対座標を選択します。これにより、アプリケーションが小さな相対的な更新を想定している場合、予期しない大きな移動デルタが発生する可能性があります。

解決策: アプリケーションでマウスの相対モーション (FPS 形式のカメラコントロールやドラッグベースのインタラクションなど) が予想される場合は、マウスインタラクション中にオペレーティングシステムカーソルを非表示にします。たとえば、マウスダウンでカーソルを非表示にし、マウスアップで再度表示します。これにより、ドラッグモーションは相対座標を使用し、絶対位置はボタンが放されたときにのみ同期されます。

アプリケーションがハングしているかクラッシュしています。トラブルシューティングの手順については、アプリケーションに関する問題「」セクションを参照してください。

ストリームグループのステータスは ではありませんActive。ストリームグループのステータスを確認します。

オンデマンドキャパシティのスピンアップには、StartStreamSession API ConnectionTimeoutSecondsで で指定されたタイムアウトよりも時間がかかります。Windows ランタイムでは、オンデマンドのスピンアップに 5 分以上かかる場合があります。

ストリーミングロケーションに使用可能な容量がありません。割り当てられた容量が使用中の容量より大きいか、使用されていないオンデマンド容量があることを確認します (割り当てられた容量が常時オン容量にオンデマンド容量を加えたものより小さい）。コンソールでは、これらの値はストリームグループのリストまたはストリームグループの詳細ページで確認できます。サービス API を使用すると、GetStreamGroup を使用してこれらの値を見つけることができます。使用可能な容量が一時的にゼロになるシナリオには、次のようなものがあります。

ネットワーク条件が非常に悪いため、フレーム、特に最初のフレームは送信されません。クライアントとストリーミングロケーション間のネットワーク状態を確認し、別のロケーションを調整または試します。

配置タイムアウト: ストリームセッションをホストするコンピューティングリソースを見つけるための Amazon GameLift Streams のタイムアウト値。

接続タイムアウト: クライアントがストリームセッションに接続または再接続するためのタイムアウト値。

アイドルタイムアウト: ユーザー入力なしでストリームセッションをアイドル状態にできる最大時間。

セッション長タイムアウト: ストリームセッションの最大時間。