对亚马逊 GameLift 直播进行故障排除

如果 IAM 角色有明确的 “全部拒绝” 政策，则必须通过添加"gameliftstreams:*"元素来明确将 Amazon GameLift Streams 列为该策略的例外情况。NotAction例如：

{
    "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 管理中的，并查看 IAM 用户指南中的访问被拒绝错误消息故障排除。

在另一台计算机上运行您的应用程序，以验证其是否已正确打包。这可以确认您的应用程序内容不包含任何可能无法在其他设备上运行的硬编码路径、缺失的资产、库或二进制文件。

验证您的应用程序是否与 Proton 兼容。在没有 Amazon GameLift Streams 服务器的本地环境中测试您的应用程序，以验证它是否与 Proton 兼容。有关说明，请参阅测试和排除与 Proton for Amazon Streams 的兼容性 GameLift。

验证运行时间。在 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/（或类似）子文件夹中的完整可执行文件。虚幻引擎生成了两个可执行文件：一个位于文件夹根目录的小型引导程序可执行文件，另一个位于子文件夹中的平台目标可执行文件。Binaries/Win64/根目录下的引导程序可执行文件会尝试验证前提条件是否正确，并且可能会在 Amazon GameLift Streams 上创建误报，从而阻止应用程序启动。如果缺少平台目标可执行文件，则可能无法正确构建应用程序。例如，请参阅以下示例虚幻应用程序的文件夹结构：

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

关闭虚幻引擎断言。禁用checkverify、和ensure宏。它们可以防止应用程序创建崩溃转储。如需了解更多信息，请参阅虚幻引擎文档中的断言。

您的计算机可能拥有比 Amazon GameLift Streams 更强大的硬件。请务必在性能与 Amazon GameLift Streams 使用的硬件相似的计算机上测试应用程序：

这可以验证应用程序的渲染设置是否与 GPU 兼容，以及性能是否符合您的预期。

问题可能是由于您的网络连接或 Amazon GameLift Streams 的设置造成的。请尝试本直播连接问题节中的疑难解答提示。

有关虚幻引擎游戏的信息，请参阅分析虚幻引擎的性能。

基于驱动程序的缓存-此方法特定于运行时环境 GPU 和驱动程序版本。此选项可以应用于所有应用程序，因此是默认推荐的方法。每种 GPU/driver 组合都需要复制这种方法的步骤。

基于引擎的缓存 — 此方法允许通过游戏引擎（如果可用）进行着色器缓存。它将创建预先烘焙的管道状态对象 (PSO) 缓存的负担交给了开发人员。它还假设引擎能够在同一 GPU 硬件上处理对不同驱动程序的缓存支持。

选择 AWS 区域 尽可能接近最终用户的。从您的客户到托管直播的区域的高延迟会影响直播质量。有关AWS 区域 以及 Amazon GameLift Streams 支持的直播地点您可以从中直播的位置的列表，请参阅。您可以 ping 该区域的 AWS 控制台终端节点，以获得近似的延迟测量结果。

确认您的直播组是否有容纳新直播的容量。

请验证其设置ConnectionTimeoutSeconds是否合理，以便最终用户在 Web 客户端超时之前有足够的时间进行连接。

确保防火墙允许访问 UDP 端口范围 33435-33465，以允许从 Amazon Streams 进行直播。 GameLift 如果 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 上玩游戏时，请确认你使用的是无线网络，而不是蜂窝网络。使用蜂窝网络可能会导致连接问题。

macOS 用户应禁用 “定位服务”，因为这会导致 Wi-Fi 不时暂停，从而导致直播体验不佳。

测试问题是否与浏览器有关。总体而言，我们建议使用谷歌浏览器、Microsoft Edge或基于Chromium的定制桌面应用程序，以获得最佳的最终用户体验和最大的兼容性，尤其是与游戏控制器的兼容性。

记录从客户端发送并由应用程序接收的输入事件，以确定前端代码中存在输入不匹配的地方。

请务必查看支持的浏览器和输入有关支持的浏览器和输入设备的更多信息，包括已知问题和限制。

问题：macOS 上的命令键映射到元密钥事件，该事件映射到微软 Windows 上的 Windows 密钥。问题是同时按下 C om mand 键和另一个键时会影响 macOS 浏览器的错误，其中元键在释放时会重置，但箭头键没有重置，因为浏览器没有捕获箭头键的按键事件，因此 Web SDK 客户端不会向服务器发送 keyup 事件，流媒体应用程序仍会认为该键被按下。

解决方案：如果您不使用命令键，则可以使用 Web SDK InputConfiguration 界面中的 Web SDK 键盘筛选机制 (keyboardFilter) 将其过滤掉。

问题：当您打开某些操作系统级别的用户界面元素（例如桌面上的浏览器菜单栏或 iOS 上的 “控制中心” 和 “通知中心”）时，浏览器会停止触发输入事件，而不会触发模糊或焦点事件。这会导致服务器继续接收上次输入状态。这是浏览器级别的限制，无法可靠地检测到。

解决方案：在桌面浏览器上使用全屏模式以防止访问浏览器菜单栏。对于连接了键盘的 iOS 用户，我们建议使用网络视图创建原生应用封装器，让原生应用可以更好地检测和处理焦点丢失，从而显式触发浏览器窗口焦点和模糊事件。或者，使用前端 HTML 或游戏内界面元素通知用户仍按下按键，并提供有关 iOS 限制的信息。

问题：Amazon GameLift Streams 使用启发式方法来选择是以 “相对” 还是 “绝对” 模式传输鼠标事件。在相对模式下，新的鼠标更新是以与先前更新相比的微小增量差异提供的。在绝对模式下，将鼠标光标持续强制到与客户端同步的屏幕位置。当操作系统光标在流媒体内容上方可见时，启发式方法始终会选择绝对坐标。如果您的应用程序期望相对较小的更新，这可能会导致意想不到的大幅移动增量。

解决方案：如果您的应用程序需要相对的鼠标移动（例如 FPS 风格的摄像机控件或基于拖动的交互），请在鼠标交互期间隐藏操作系统光标。例如，在鼠标向下移动时隐藏光标，在鼠标向上移动时再次显示光标。这样可以确保拖动动作使用相对坐标，只有在松开按钮时才会同步绝对位置。

应用程序挂起或崩溃。有关故障排除说明，请参阅应用程序问题部分。

直播群组状态不是Active。验证直播组的状态。

按需容量启动所需的时间超过 StartStreamSessionAPI ConnectionTimeoutSeconds 中指定的超时时间。在 Windows 运行时中，按需启动时间可能需要 5 分钟或更长时间。

直播位置没有可用容量。验证您分配的容量是否大于正在使用的容量，或者您有未使用的按需容量（分配的容量小于始终开启的容量加上按需容量）。在控制台中，您可以在直播组列表或直播组详细信息页面上找到这些值。使用服务 API，您可以使用查找这些值GetStreamGroup。可用容量暂时为零的几种情况包括：

网络条件非常差，以至于无法发送帧，尤其是第一帧。检查客户端和直播位置之间的网络状况，然后调整或尝试其他位置。

放置超时：Amazon GameLift Streams 查找用于托管直播会话的计算资源的超时值。

连接超时：客户端连接或重新连接到直播会话的超时值。

空闲超时：在没有用户输入的情况下，直播会话可以处于空闲状态的最长时间。

会话长度超时：直播会话的最长时间。