本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 排除 Amazon GameLift Streams 的 Lin
<a name="troubleshoot-linux"></a>

如果您的 Amazon GameLift Streams 应用程序在Ubuntu运行时环境中运行，则本部分可以帮助您解决与运行本机 Linux 应用程序相关的问题。有关一般故障排除，请参阅[亚马逊 GameLift 直播疑难解答](troubleshoot.md)。

## 设置一台本地计算机进行测试
<a name="troubleshoot-linux-local-test"></a>

在 Amazon GameLift Streams 上进行故障排除之前，请确认您的应用程序在本地 Ubuntu 22.04 LTS 计算机上正常运行。有关说明，请参阅[设置本地机器](troubleshoot-compatibility-setup-local.md)。

## 已知问题
<a name="troubleshoot-linux-known-issues"></a>

### 应用程序呈现黑屏
<a name="troubleshoot-linux-black-screen"></a>

如果您的应用程序出现黑屏，请尝试以下一项或两项操作：
+ 通过设置环境变量来禁用共享纹理`VK_LAYER_AMZN_BLITSURFACE_SHARED_TEXTURES=0`。
+ 切换到Vulkan渲染。对于Unity应用程序，`-force-vulkan`添加启动参数，或在**播放器 ** > ** 其他设置 ** > 图形 API 中将其设置Vulkan为唯一的**图形 API **。

### 性能不佳 OpenGL
<a name="troubleshoot-linux-opengl-performance"></a>

如果您的应用程序以目标为目标OpenGL且帧速率不佳或应用程序出现冻结状态，请通过设置环境变量强制实施 NVIDIA `__GLX_VENDOR_LIBRARY_NAME=nvidia`。

### Unity 应用程序冻结或暂停
<a name="troubleshoot-linux-unity-freeze"></a>

在流媒体环境中，应用程序窗口可能无法获得 OS-level 焦点。默认情况下，未聚焦时Unity暂停渲染。要解决此问题，请应用以下两个设置：

1. `Application.runInBackground = true`在您的应用程序代码中设置。

1. 如果您使用新的输入系统包，请设置`InputSettings.backgroundBehavior = InputSettings.BackgroundBehavior.IgnoreFocus`。

### 麦克风输入不可用
<a name="troubleshoot-linux-microphone"></a>

Ubuntu 22.04 LTS 运行时不支持麦克风输入。如果你的应用程序需要麦克风输入，请改用Proton或微软 Windows Server 2022 Base 运行时。有关更多信息，请参阅 [兼容 Amazon GameLift Streams 的设备和浏览器](compatible-devices-browsers.md)。