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

# WorkSpaces 适用于 macOS 的应用程序客户端应用程序
<a name="client-application-mac-user"></a>

以下信息可帮助您使用适用于 macOS 的 WorkSpaces 应用程序客户端连接 WorkSpaces 应用程序和流式传输应用程序。

**Topics**
+ [要求](client-application-mac-requirements-user.md)
+ [适用于 macOS 的设置和安装](client-application-mac-installation-user.md)
+ [在 macOS 客户端上连接 WorkSpaces 应用程序](client-application-mac-start-streaming-session-user.md)
+ [监控](client-application-windows-mac-display-resolution-user.md)
+ [视频和音频会议](video-audio-mac.md)
+ [相对鼠标偏移](client-application-mac-relative-mouse-offset-user.md)
+ [重新映射 Windows 徽标键或 Command 键](remap-windows-logo-key.md)
+ [记住我的设置](remember-settings-mac.md)
+ [打印机重定向](client-application-mac-local-printer-redirection.md)
+ [断开连接并结束会话](disconnect-end-mac.md)
+ [问题排查](client-application-mac-troubleshooting-user.md)
+ [WorkSpaces 应用程序 macOS 客户端发行说明](client-release-versions-mac.md)

# 要求
<a name="client-application-mac-requirements-user"></a>

macOS 的 WorkSpaces 应用程序客户端必须安装在满足以下要求的计算机上：
+ 操作系统 — macOS 13（Ventura）、macOS 14（Sonoma）或 macOS 15（Sequoia）
+ 硬盘空间 - 最低 200MB

# 适用于 macOS 的设置和安装
<a name="client-application-mac-installation-user"></a>

请遵循以下步骤下载并安装客户端应用程序。

1. 在你的 macOS 设备上，打开 “[亚马逊 WorkSpaces 应用程序下载](https://clients.amazonappstream.com/)”，然后选择 macOS 链接。

1. 下载并安装该应用程序。

1. 确认您的 Mac Launchpad 上显示了 “应用程序” 客户端应用程序图标，或者签入`/Users/username/Applications/`或。 WorkSpaces `~/Applications`

# 在 macOS 客户端上连接 WorkSpaces 应用程序
<a name="client-application-mac-start-streaming-session-user"></a>

将 WorkSpaces 适用于 macOS 的应用程序客户端安装到电脑上后，您可以使用它来 WorkSpaces 连接应用程序。

**Topics**
+ [WorkSpaces 应用程序 macOS 客户端连接模式](client-application-mac-connection-modes-user.md)
+ [Connect 到 WorkSpaces 应用程序](client-application-mac-how-to-connect-user.md)

# WorkSpaces 应用程序 macOS 客户端连接模式
<a name="client-application-mac-connection-modes-user"></a>

 WorkSpaces 应用程序 macOS 客户端支持两种连接模式：*经典模式*和*桌面*视图。您的管理员将为您设置连接模式。

**经典模式**

使用经典应用程序模式时，可以在应用程序会话窗口中使用远程流式传输 WorkSpaces 应用程序。如果您的管理员为您提供了多个应用程序，则您可以在会话期间打开多个应用程序。您打开的所有应用程序都显示在同一个 WorkSpaces 应用程序会话窗口中。

在经典模式下连接到 “ WorkSpaces 应用程序” 时，“ WorkSpaces 应用程序应用程序启动器” 窗口将打开，并显示可供您流式传输的应用程序列表。在此模式下打开流媒体应用程序时，“应用程序启动器” 窗口将关闭，该应用程序将在 “ WorkSpaces 应用程序” 会话窗口中打开。

**桌面视图**

当你连接到 “ WorkSpaces 应用程序” 并选择 “**桌面” 视图**时，“ WorkSpaces 应用程序” 会为你的流媒体会话提供标准的 Windows 桌面视图。可供流式传输的应用程序的图标显示在 Windows 桌面上。此外， WorkSpaces 应用程序工具栏显示在流式传输会话窗口的左上角区域，该工具栏使您可以配置流式传输会话的设置。

# Connect 到 WorkSpaces 应用程序
<a name="client-application-mac-how-to-connect-user"></a>

按照以下步骤连接到 WorkSpaces 应用程序并启动应用程序流式传输会话。

1. 如果您的管理员要求您先通过组织的登录页面登录，请完成此步骤中的任务，然后继续执行步骤 3。

   如果您的管理员不要求您通过组织的登录页面登录，请跳过此步骤中的任务并继续执行步骤 2。

   1. 导航到您的组织登录页面，并在出现提示时输入您的域凭证。

   1. 登录后，您将被重定向到 Applications Applications Application Manager 目录页面，其中显示一个或多个可用于您的 WorkSpaces 应用程序流式传输会话的应用程序。 WorkSpaces 如果管理员启用了**桌面视图**，也可以使用该功能。

   1. 选择应用程序或**桌面视图**（如有）。

1. 如果您的管理员不要求您先通过组织的登录页面登录，请完成以下步骤以启动 WorkSpaces 应用程序客户端：

   1. 在安装了 WorkSpaces 应用程序客户端的本地计算机上，选择 **Amazon Applic WorkSpaces at** ions 以启动 WorkSpaces 应用程序客户端。

   1. 请执行以下任一操作：
      + 如果客户端登录页面预填充了 Web 地址（URL），请选择**连接**。在 macOS 客户端过渡到流式传输会话之前，您将被重定向到系统的默认 Web 浏览器进行身份验证。
      + **如果客户登录页面未预先填充网址，请输入您的 WorkSpaces 应用程序管理员为 WorkSpaces 应用程序提供的 URL，然后选择 Connect。**在 macOS 客户端过渡到流式传输会话之前，您可能也将被重定向到系统的默认 Web 浏览器进行身份验证。如果您不知道 URL，请联系您的管理员。

   1. 片刻之后，Applications WorkSpaces Applications Applications Manager 目录页面打开，显示一个或多个可用于 WorkSpaces 应用程序流式传输会话的应用程序。如果管理员启用了**桌面视图**，也可以使用该功能。

   1. 选择应用程序或**桌面视图**（如有）。

1. 根据 WorkSpaces 应用程序管理员启用的身份验证设置，在您选择应用程序或**桌面视图**后，系统可能会提示您输入 Active Directory 域凭据以登录 WorkSpaces 应用程序会话。如果是这种情况，请输入您的 Active Directory 域密码，然后选择**密码登录**。

# 监控
<a name="client-application-windows-mac-display-resolution-user"></a>

## 显示器和显示分辨率
<a name="monitors-display-resolution-mac"></a>

 WorkSpaces 应用程序客户端支持具有以下显示分辨率的多台显示器：
+ 多台显示器（分辨率高达 4K）— 最多 4 台显示器，每台显示器的最大显示分辨率为 4096x2160 像素

**重要**  
更高分辨率的显示器需要更多的计算容量和编码资源才能有效地流式传输内容，实际性能取决于您的显示配置（分辨率和显示器数量）和所使用的计算实例。如果您在 4K 显示器上体验不到最佳性能，我们建议您降低显示分辨率以提高响应能力。  
任一维度（例如 5120x2160）分辨率超过 4096 像素的超宽显示器将在侧面显示黑条，因为支持的最大分辨率限制为每个维度 4096 像素。

如果您希望使用固定分辨率（即使调整客户端窗口大小，该分辨率也不会改变），请依次选择**设置**、**显示**、**显示分辨率**，并指定所需的分辨率。要重新启用自动调整大小功能，请选择**自动调整**。

## 使用多个显示器
<a name="using-multiple-monitors-mac"></a>

使用多个显示器时，可以从以下选项中进行选择：
+ 跨*单个*显示器扩展全屏
+ 跨*所有*显示器扩展全屏
+ 跨*选定的*显示器扩展全屏

### 跨单个显示器扩展全屏
<a name="full-screen-single-monitor-mac"></a>

只有多个显示器连接到您的本地计算机时，才能在当前显示器上扩展全屏。要启用此功能，请完成以下步骤：

1. 在窗口顶部的工具栏上，选择全屏（交叉箭头）图标。

1. 从下拉菜单中选择**全屏显示当前显示器**。

### 在所有显示器上扩展全屏
<a name="full-screen-all-monitors-mac"></a>

您可以在所有显示器上以全屏分辨率扩展会话显示内容。扩展后的显示与您的物理显示器布局和屏幕分辨率相匹配。例如，三个显示器连接到您的本地计算机。服务器将会话的显示内容扩展到所有三个显示器，并与显示器的特定屏幕分辨率匹配。

要启用此功能，请完成以下步骤：

1. 在窗口顶部的工具栏上，选择全屏（交叉箭头）图标。

1. 从下拉菜单中选择**全屏显示所有显示器**。

### 在选定的显示器上扩展全屏
<a name="full-screen-selected-monitors-mac"></a>

如果连接了三台或更多显示器，则 WorkSpaces 应用程序还可以在选定的可用显示器上扩展全屏模式。如果无法全屏显示您选择的显示器，则会显示一条错误消息，您需要再次执行该过程。在您的显示设置中，选定的显示器必须设置为相邻或一侧是挨着的。

以下是相邻显示器放置的示例。如果显示器未设置在显示配置旁边，则必须退出 WorkSpaces 应用程序并在本地计算机上更改显示设置。

**注意**  
蓝色方框是 WorkSpaces 支持应用程序的显示器，灰色方框是其他显示器。

![\[相邻和不相邻的显示器放置\]](http://docs.aws.amazon.com/zh_cn/appstream2/latest/developerguide/images/monitors.PNG)


要启用此功能，请完成以下步骤：

1. 在窗口顶部的工具栏上，选择全屏（交叉箭头）图标。

1. 从下拉菜单中选择**全屏显示选定显示器**。

1. 系统将显示**全屏显示选定显示器**窗口，其中显示当前的显示器布局。选择您希望 DCV 全屏显示的显示器，然后选择**应用**。

# 视频和音频会议
<a name="video-audio-mac"></a>

WorkSpaces 应用程序实时音频-视频 (AV) 将您的本地网络摄像头视频输入重定向到 WorkSpaces 应用程序流式传输会话。这样，您就可以在 WorkSpaces 应用程序流式传输会话中使用本地设备进行视频和音频会议。

要在 WorkSpaces 应用程序中使用摄像头或麦克风，请在系统菜单上选择 “**设置**”，然后选择 “**音频和视频**” 以启用或禁用麦克风和摄像头。如果您有多个网络摄像头（例如，如果您有一个 USB 网络摄像头连接到笔记本电脑，还有一个内置网络摄像头），也可以从**活动网络摄像头**中选择一个网络摄像头。

如果您选择了**显示工具栏**，也可以通过选择麦克风或视频图标来启用或禁用麦克风和网络摄像头。如果您有多个网络摄像头，则可以选择视频图标旁边的向下箭头，然后选择一个要使用的网络摄像头。

**注意**  
如果 “ WorkSpaces 应用程序” 工具栏中未显示视频图标，请联系您的 WorkSpaces 应用程序管理员。您的管理员可能需要执行其他配置任务，如[实时音频-视频](feature-support-real-time-av.md)中所述。

# 相对鼠标偏移
<a name="client-application-mac-relative-mouse-offset-user"></a>

默认情况下，在流式传输会话期间，A WorkSpaces pplications 通过使用绝对坐标并在本地渲染鼠标移动来传输有关鼠标移动的信息。对于图形密集型应用程序，例如计算机辅助设计（CAD）/计算机辅助制造（CAM）软件或视频游戏，启用相对鼠标模式后，鼠标性能会得到改善。相对鼠标模式使用相对坐标（表示自上一帧以来鼠标移动了多远），而不是窗口或屏幕内的绝对 x-y 坐标值。启用相对鼠标模式时， WorkSpaces 应用程序会远程渲染鼠标移动。

您可以通过以下任一方式在 WorkSpaces 应用程序流式传输会话期间启用此功能：
+ 按 Ctrl\$1Shift\$1Fn\$1F8
+ 从**设置**中选择**启用相对鼠标**并启用该模式。

# 重新映射 Windows 徽标键或 Command 键
<a name="remap-windows-logo-key"></a>

您可以重新映射 Mac 键盘上的 Option 和 Command 键。

同时使用这两个键时，*修改键* 会修改另一个键的操作。您可以将修改键与另一个键一起使用，以执行诸如打印之类的任务。*Meta 键* 是一种特殊类型的修改键。同时使用这两个键时，可以使用 Meta 键暂时更改另一个键的功能。

要重新映射 Mac 的 Option 和 Command 键，请依次选择**设置**和**键盘和鼠标**。

在流式传输会话期间，您可以将 Option 键重新映射到以下键：
+ 远程 Alt 键
+ 本地修改键

在流式传输会话期间，您可以将 Command 键重新映射到以下键：
+ 远程 Ctrl 键
+ Meta 键

# 记住我的设置
<a name="remember-settings-mac"></a>

 WorkSpaces 应用程序 macOS 客户端应用程序可以保存您在 **“设置”** 中配置的首选项，以备将来的会话使用，但**音频和视频**设置除外。如果您想记住音频（麦克风）和视频（网络摄像头）设置以备将来的会话使用，请依次选择**设置**、**音频和视频**和**记住音频和视频（启用/禁用）以备将来的会话使用**。启用此功能后，您的音频（麦克风）和视频（网络摄像头）设置将被保存，当您在同一个设备上从 macOS 客户端访问同一个堆栈时，系统将在多个会话中继续使用这些设置。

# 打印机重定向
<a name="client-application-mac-local-printer-redirection"></a>

WorkSpaces 应用程序本地打印机重定向允许您通过 WorkSpaces 应用程序流式传输会话访问连接到本地计算机的打印机。这样，您就可以将打印作业从流应用程序重定向到本地打印机或已映射的网络打印机。

**重要**  
要使用 WorkSpaces 应用程序打印机重定向，必须在本地计算机上安装 WorkSpaces 应用程序客户端，并且必须使用该客户端连接到流式传输会话。当您使用 Web 浏览器连接到 WorkSpaces 应用程序时，打印机重定向不可用。

**将打印作业重定向到本地打印机**

1. 打开 WorkSpaces 应用程序客户端并连接到直播会话。

1. 在您的流应用程序中，选择**文件**、**立即打印**。

1. 此时将打开流应用程序的**打印**对话框。

1. **打印**对话框将显示可用本地打印机的列表。选择要使用的本地打印机，然后继续打印。

# 断开连接并结束会话
<a name="disconnect-end-mac"></a>

要断开流式传输会话的连接，请选择以下选项之一：
+ 在 “ WorkSpaces 应用程序” 工具栏上，选择 “**断开连接**”。
+ 在 Mac 上，在屏幕顶部的菜单栏上，选择 “**亚马逊 WorkSpaces 应用程序**和**断开连接**”。

在超时时间间隔内断开连接后，您可以重新连接之前的流式传输会话。断开连接后流式传输会话保持活动状态的时间由您的管理员配置。

要结束当前会话，请选择以下选项之一：
+ 在 “ WorkSpaces 应用程序” 工具栏上，选择 “**结束会话**”。
+ 在 Mac 上，在屏幕顶部的菜单栏上，选择 “**亚马逊 WorkSpaces 应用程序**” 和 “**结束会话**”。

当您结束会话时，系统将提示您保存任何打开的文档，并且您会立即断开与流实例的连接。

# 问题排查
<a name="client-application-mac-troubleshooting-user"></a>

按照以下步骤启用诊断日志上传功能并确定您的客户端版本和客户端 ID。

## 启用诊断日志上传功能
<a name="client-application-troubleshooting-find-client-ID-user-mac"></a>

要解决 WorkSpaces 应用程序客户端的问题，可以启用诊断日志记录。发送到 WorkSpaces 应用程序的日志文件包括有关您的设备和 AWS 网络连接的详细信息。您可以在 WorkSpaces 应用程序流式传输会话之前或期间启用诊断日志上传，这样这些文件就会自动发送到 WorkSpaces 应用程序。作为最佳实践，我们建议您启用日志上传，以帮助 WorkSpaces 应用程序团队解决问题。

要启用文件日志记录功能，请按照以下步骤操作：

1. 从系统菜单栏中选择 **AppStream 2.0**，或导航到 **Connect** 页面的右上角。

1. 依次选择**客户端选项**和**客户端自动日志记录**。

## 为适用于 macOS 的 WorkSpaces 应用程序客户端收集日志
<a name="collect-logs-troubleshooting-mac"></a>

WorkSpaces 您的管理员可以使用应用程序日志来识别和解决配置问题。它们还可以帮助 AWS 支持 Support 对案例进行诊断和故障排除。要收集和共享日志，请从以下选项中进行选择：
+ 选项 1：打开终端并输入 **open \$1/Library/Containers/com.amazon.appstreamclient/Data/logs**
+ 选项 2：打开**查找器**，然后依次选择**用户**、**User\$1Name**、**库**、**容器**、**Appstream**、**数据**和**日志**
+ 选项 3：打开**查找器**，然后从左上角的系统菜单栏中依次选择**转到**和 **Go to folder**。输入 **\$1/Library/Containers/com.amazon.appstreamclient/Data/logs** 

## 确定客户端版本和客户端 ID
<a name="client-application-windows-troubleshooting-find-client-version-number-user-mac"></a>

如果您在使用适用于 macOS 的 WorkSpaces 应用程序客户端时出现问题，则您的 WorkSpaces 应用程序版本号和客户端 ID 可以帮助您的管理员和 AWS 支持团队进行故障排除。要查找已安装的 WorkSpaces 应用程序客户端的版本，请打开 WorkSpaces 应用程序客户端。在系统菜单栏上，选择 “**亚马逊 WorkSpaces 应用程序**” 和 “**关于亚马逊 AppStream 2.0**”。客户端版本显示在 Amazon WorkSpaces 应用程序徽标下方。

要查找您已安装的 WorkSpaces 应用程序客户端的客户端 ID，请在系统菜单栏上选择 **Amazon A WorkSpaces ** pplications，或者导航到 **Connect** 页面的右上角并选择**客户端选项**。

# WorkSpaces 应用程序 macOS 客户端发行说明
<a name="client-release-versions-mac"></a>

下表描述了 macOS WorkSpaces 应用程序客户端已发布版本中可用的最新更新。


| 客户端版本 | 发行日期 | 更改 | 
| --- | --- | --- | 
|  1.3.0  | 02-10-2026 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appstream2/latest/developerguide/client-release-versions-mac.html)  | 
|  1.2.0  | 11-06-2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appstream2/latest/developerguide/client-release-versions-mac.html)  | 
|  1.1.0  | 06-02-2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appstream2/latest/developerguide/client-release-versions-mac.html)  | 
|  1.0.1  | 03-25-2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appstream2/latest/developerguide/client-release-versions-mac.html)  | 
|  1.0.0  | 12-19-2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/appstream2/latest/developerguide/client-release-versions-mac.html)  |