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

# Amazon Connect 客户端应用程序
<a name="amazon-connect-client-app"></a>

Windows 和 Chrome 操作系统支持 Amazon Connect 屏幕录制功能。本页提供适用于每个操作系统中屏幕录制应用程序的下载和安装说明，以及座席设备的最低系统要求。

**Topics**
+ [Windows](#windows-client)
+ [Chrome 操作系统](#chrome-os)

## Windows
<a name="windows-client"></a>

### 版本信息
<a name="version-info"></a>
+ 版本：v2.0.3（最新）
+ 发行日期：2025 年 1 月 16 日
+ 下载链接：[AmazonConnectClientWin-](https://d4yqf2f7seiym.cloudfront.net/builds/AmazonConnectClientWin-v2.0.3.zip) v2.0.3 
+ 发行说明：此版本支持 AWS GovCloud (US) 客户，并进行了安全改进。

上面的链接下载 **AmazonConnectClientWin-[版本] .zip** 文件。该 zip 文件包含 **Amazon.Connect.Client.Service.Setup.[version].msi** 文件。有关安装说明，请参阅[启用屏幕录制](enable-sr.md)。

要在 Amazon Connect 客户端应用程序有更新时收到通知，我们建议您订阅本管理员指南的 RSS feed。选择显示在此页面标题下方的 **RSS** 链接（位于 PDF 链接旁边）。

### 客户端安装说明
<a name="client-install"></a>

在此步骤中，您将把 **Amazon.Connect.Client.Service** 文件安装到座席的桌面上，或者安装到座席使用的虚拟环境中。这是 Amazon Connect 客户端应用程序。

**注意**  
如果是 Windows 多会话操作系统，则只在机器上运行一次安装程序。仅版本 2.0.0 或更高版本支持 Windows 多会话操作系统上的屏幕录制。
如果您的 Amazon Connect 实例位于 AWS GovCloud （美国西部），则必须安装 2.0.3 或更高版本。
您需要配置允许与客户端应用程序进行通信的 Amazon Connect 域的允许列表。只能从允许列表中指定的 Amazon Connect 域中捕获屏幕录制。

#### 使用软件分发工具进行编程安装
<a name="programmatic-installation"></a>
+ 下载最新版本的 **Amazon.Connect.Client.Service.Setup.msi** 文件。
+ 使用您组织的软件分发机制（例如软件中心）将 **Amazon.Connect.Client.Service** 客户端应用程序安装到座席桌面上。
+ 使用您组织的企业软件分发系统 [例如 Microsoft 系统中心配置管理器（简称 SCCM）或其他自动部署工具] 进行部署。
+ 使用以下语法，将 `ALLOWED_CONNECT_DOMAINS` 参数包括在内：

  ```
  msiexec /i Amazon.Connect.Client.Service.Setup.msi ALLOWED_CONNECT_DOMAINS="connect-dev-instance.my.connect.aws,connect-prod-instance.my.connect.aws"
  ```

#### 手动安装
<a name="manual-installation"></a>
+ 下载最新版本的 **Amazon.Connect.Client.Service.Setup.msi** 文件。
+ 双击安装程序文件。
+ 当出现提示时，输入 Amazon Connect 域名允许列表。下图给出了一个如何在**配置安装设置**对话框的允许列表中指定域的示例。有关更多示例，请参阅下方的*指定 Amazon Connect 域允许列表的准则*。  
![\[“配置安装设置”对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/domain-allowlist-windows.png)
+ 选择**安装**以完成安装。

#### 验证 Amazon Connect 客户端应用程序是否正在运行且运行正常
<a name="verify-installation"></a>

##### 验证应用程序是否正在运行：
<a name="verify-running"></a>
+ 在 Windows 任务管理器中，检查名为 **Amazon.Connect.Client.Service** 的后台进程。这是 Amazon Connect 客户端应用程序。
+ 在 Windows 任务管理器的 “**用户进程**” 下，查看另一个名为 **Amazon.Connect.Client 的进程。 RecordingSession**在用户接受启用屏幕录制的第一个联系人之后。

  下图显示了 **Amazon.Connect.Client。 RecordingSession**在任务管理器中。  
![\[亚马逊Connect.Client。 RecordingSession 在任务管理器中。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/taskmanager.png)

##### 验证该应用程序是否工作正常并在创建日志文件：
<a name="verify-functioning"></a>

1. 导航到以下目录：`C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs`

1. 打开目录中存在的日志文件。

1. 如果安装成功，日志文件中将包含以下行：`Checking that services are still running, result : true`

1. 导航到以下目录：`%USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs`

1. 打开目录中存在的日志文件。

1. 如果安装成功，日志文件中将包含以下行：`Session initiation completed with result: True`

#### 指定 Amazon Connect 域允许列表的准则
<a name="domain-allowlist-guidelines"></a>

在**允许的 Connect 域**框中输入域时，一定要遵守以下准则。否则，安装会失败。
+ 格式：逗号分隔的 Amazon Connect 域
+ Amazon Connect 域的有效字符：只能使用 A-Z、a-z、0-9、连字符（-）、句点（.）
+ 不需要协议前缀，例如 https:// 或 http://。
+ 限制：
  + 最多 500 个域条目
  + 每个域条目最多 256 个字符
  + 输入总长度最多 128000 个字符

以下是如何指定域的示例。

##### 正确
<a name="correct-examples"></a>
+ domain1.my.connect.aws,domain2.my.connect.aws
+ ddomain-1.my.connect.aws, 1-domain.my.connect.aws
+ domain-12.my.connect.aws

##### 错误
<a name="incorrect-examples"></a>
+ \$1123domain.foo
+ domain:2.foo
+ \$1domain.my.connect.aws
+ https://domain1.my.connect.aws
+ \$1.my.connect.aws

## Chrome 操作系统
<a name="chrome-os"></a>

Chrome 操作系统上的 Amazon Connect 屏幕录制功能需要两个组件：
+ 隔离的 Web 应用程序
+ Google Chrome 浏览器扩展程序

可以通过 Google 企业管理控制台在座席 Chrome 设备上安装这些组件。下面提供了 URLs 用于配置安装隔离 Web 应用程序和 Chrome 浏览器扩展程序的，可以将其设置为通过 Web 清单配置 JSON 自动更新。

### 下载位置和安装说明
<a name="download-install"></a>

在 Google 企业管理控制台上完成以下步骤。将该策略应用于所有需要启用屏幕录制功能的座席设备。

#### 安装隔离的 Web 应用程序
<a name="isolated-web-app"></a>
+ Web 捆绑包 ID：`ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
+ 更新清单 URL：`https://screenrecording.connect.aws/chromeos/amazon-connect-client-iwa/releases/update_manifest.json`

**安装隔离的 Web 应用程序**

1. 导航到 [Google 管理门户](https://admin.google.com) (https://admin.google.com)，然后使用您的 Google 企业管理员凭据登录。

1. 选择**添加隔离的 Web 应用程序**。

1. 复制并粘贴以下详细信息，然后选择**保存**：
   + Web 捆绑包 ID：`ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
   + 更新清单网址：https://screenrecording.connect。 aws/chromeos/amazon-connect-client-iwa/releases/update\$1manifest.json

   下图给出一个已完成的**添加隔离的 Web 应用程序**对话框的示例。  
![\[已完成的“添加隔离的 Web 应用程序”对话框。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/addisolatedwebapp.png)

1. 将**安装策略**配置为 `Force Install + Pin to ChromeOS Taskbar`，将**登录时启动**改为 `Force Launch and Prevent Closing`，以确保用户登录计算机以及系统重启时，隔离的 Web 应用程序会自动启动。  
![\[“安装策略”和“登录时启动”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/installationpolicy.png)

1. 配置**托管配置**，将允许在座席电脑上启用屏幕录制功能的 Amazon Connect 域加入允许列表。下图显示**托管配置**的一个示例。  
![\[“托管配置”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/managedconfiguration.png)
   + 键名必须是 `allowListedDomain`。域名不应包含任何路径、查询字符串或尾部斜线（/）。
   + 将 `your-instance-alias-*` 替换为您实际使用的 Amazon Connect 实例别名。

   ```
   {
   "allowListedDomain": [
   "https://your-instance-alias-1.my.connect.aws",
   "https://your-instance-alias-2.my.connect.aws"]
   }
   ```

1. 完成以下步骤，将隔离的 Web 应用程序配置为允许直接套接字、屏幕录制和窗口管理权限：
   + 依次导航到**设备**、**Chrome**、**Web 功能**、**添加源**。
   + 输入 `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`，然后选择**保存**。

   下图显示“设备”、“Chrome”和“Web 功能”在 Chrome 左侧导航菜单中的位置。  
![\[Chrome 操作系统中的左侧导航菜单。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/allorigins.png)

下图显示了“Web 功能”页面上**直接套接字**、**屏幕录制**和**窗口管理**的位置。

![\[“Web 功能”页面上“直接套接字”、“屏幕录制”和“窗口管理”的位置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/directsockets.png)


#### 安装 Google Chrome 浏览器扩展程序
<a name="chrome-extension"></a>
+ 扩展程序 ID：cjmichfmnimgeoadokmeaiclklkdccod
+ 自定义 URL：`https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`

**安装 Google Chrome 浏览器扩展程序**

1. 导航到**通过 ID 添加 Chrome 应用程序或扩展程序**，如下图所示。  
![\[左侧导航栏中的“通过 ID 添加 Chrome 应用程序或扩展程序”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/appandextensions.png)

1. 在**通过 ID 添加 Chrome 应用程序或扩展程序**中，选择**从自定义 URL**，然后输入以下信息：
   + 扩展程序 ID: `cjmichfmnimgeoadokmeaiclklkdccod`
   + 自定义 URL：`https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`  
![\[“通过 ID 添加 Chrome 应用程序或扩展程序”对话框，“从自定义 URL”选项。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/chromeapp.png)

1. 将**安装策略**配置为**强制安装**，然后选择**保存**，如下图所示。  
![\[“安装策略”选项设置为“强制安装”。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/forceinstall.png)