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 會產生兩個可執行檔：資料夾根目錄的小型引導執行檔，以及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 支援的 和 串流位置，請參閱 。您可以在 區域中 ping AWS 主控台端點，以取得近似的延遲測量。

確認您的串流群組具有新串流的容量。

確認 ConnectionTimeoutSeconds 已合理設定，以允許最終使用者有足夠的時間在 Web 用戶端逾時之前進行連線。

確保防火牆允許存取 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 使用者應停用 Location Services，因為這會導致 Wi-Fi 不時暫停，進而導致串流體驗不佳。

測試問題是否為瀏覽器規格。整體而言，我們建議使用 Google Chrome、Microsoft Edge 或自訂 Chromium 桌面應用程式，以獲得最佳的最終使用者體驗和最大的相容性，特別是遊戲控制器。

記錄從用戶端傳送並由應用程式接收的輸入事件，以識別前端程式碼中的輸入不相符之處。

請務必支援的瀏覽器和輸入檢查支援瀏覽器和輸入裝置的其他資訊，包括已知問題和限制。

問題：MacOS 上的 Command 金鑰會映射至中繼金鑰事件，而中繼金鑰事件會映射至 Microsoft Windows 上的 Windows 金鑰。當同時按下 Command 和另一個金鑰時，問題是影響 MacOS 瀏覽器的錯誤，其中 Meta 金鑰會在釋放時重設，但箭頭金鑰不會重設，因為瀏覽器未擷取箭頭金鑰的 keyup 事件，因此 Web SDK 用戶端不會將 keyup 事件傳送至伺服器，而串流應用程式仍會認為該金鑰正在按下。

解決方案：如果您不是使用 命令金鑰，則可以使用 Web SDK InputConfiguration 介面中找到的 Web SDK 鍵盤篩選機制 (keyboardFilter) 進行篩選。

問題：當您開啟特定作業系統層級 UI 元素 （例如桌面上的瀏覽器選單列，或 iOS 上的控制中心和通知中心） 時，瀏覽器會停止觸發輸入事件，而不會觸發模糊或焦點事件。這會導致伺服器繼續接收最後一個輸入狀態。這是無法可靠偵測的瀏覽器層級限制。

解決方案：在桌面瀏覽器上使用全螢幕模式，以防止存取瀏覽器選單列。對於使用連線鍵盤的 iOS 使用者，我們建議您使用 Web 檢視建立原生應用程式包裝函式，其中原生應用程式可以更好地偵測和處理焦點遺失，明確觸發瀏覽器視窗焦點和模糊事件。或者，使用前端 HTML 或遊戲內 UI 元素通知使用者仍在按下金鑰，並提供此 iOS 限制的相關資訊。

問題：Amazon GameLift Streams 使用啟發式來選擇是否以「相對」或「絕對」模式傳輸滑鼠事件。在相對模式下，新滑鼠更新會以與上一次更新不同的小幅度增量提供。在絕對模式中，滑鼠游標會持續強制至與用戶端同步的畫面位置。當作業系統游標顯示在串流內容上時，啟發式一律會挑選絕對座標。如果您的應用程式預期進行小型的相對更新，這可能會導致意外的大型移動差異。

解決方案：如果您的應用程式預期相對滑鼠動作 （例如，FPS 型攝影機控制項或以拖曳為基礎的互動），請在滑鼠互動期間隱藏作業系統游標。例如，在滑鼠下隱藏游標，並在滑鼠上再次顯示。這可確保拖曳動作使用相對座標，且絕對位置只會在釋放按鈕時同步。

應用程式掛載或當機。如需疑難排解說明，請參閱應用程式問題一節。

串流群組狀態不是 Active。驗證串流群組的狀態。

隨需容量的啟動時間比 StartStreamSession API ConnectionTimeoutSeconds中 指定的逾時時間更長。在 Windows 執行時間，隨需啟動時間可能需要 5 分鐘或更長時間。

串流位置中沒有可用的容量。確認您配置的容量大於使用中的容量，或者您有未使用的隨需容量 （配置的容量小於永遠使用容量加上隨需容量）。在 主控台中，您可以在串流群組清單或串流群組詳細資訊頁面上找到這些值。使用 服務 API，您可以使用 GetStreamGroup 尋找這些值。可用容量暫時為零的一些情況包括：

網路條件太差，無法傳送影格，特別是第一個影格。檢查用戶端和串流位置之間的網路條件，並調整或嘗試不同的位置。

配置逾時：Amazon GameLift Streams 尋找運算資源以託管串流工作階段的逾時值。

連線逾時：用戶端連線至或重新連線至串流工作階段的逾時值。

閒置逾時：串流工作階段可在沒有使用者輸入的情況下閒置的時間上限。

工作階段長度逾時：串流工作階段的時間上限。