本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 Amazon Connect Contact Lens 中设置和查看座席屏幕录制
为了帮助指导您的座席提供优质的客户服务，您可以使用 Contact Lens 屏幕录制功能来获取质量管理洞察。它会记录座席的桌面，从而帮助您确定提高绩效的机会。此信息对于确保合规性也很有用。
例如，假设大多数座席处理退款需要两分钟，而 Jane Doe 需要四分钟。当她处理退款时，您可以观看其桌面的录制，了解她花更长时间的原因。
下图显示了屏幕录制的主要组件。有关显示不同组件之间网络调用的序列图，请参阅[网络要求](sr-system-req.md#network-requirements)。
![\[屏幕录制流图表。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-flow.png)
**Topics**
+ [Amazon Connect 客户端应用程序](amazon-connect-client-app.md)
+ [系统和网络要求](sr-system-req.md)
+ [启用屏幕录制](enable-sr.md)
+ [查看座席屏幕录制](review-screen-recordings.md)
+ [下载屏幕录制应用程序的日志文件](troubleshoot-sr.md)
+ [使用 Amazon EventBridge 事件跟踪屏幕录制状态](track-screen-recording-status.md)
+ [屏幕录制功能的常见问题](faq-screenrecording.md)
# Amazon Connect 客户端应用程序
Windows 和 Chrome 操作系统支持 Amazon Connect 屏幕录制功能。本页提供适用于每个操作系统中屏幕录制应用程序的下载和安装说明，以及座席设备的最低系统要求。
**Topics**
+ [Windows](#windows-client)
+ [Chrome 操作系统](#chrome-os)
## Windows
### 版本信息
+ 版本：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 链接旁边）。
### 客户端安装说明
在此步骤中，您将把 **Amazon.Connect.Client.Service** 文件安装到座席的桌面上，或者安装到座席使用的虚拟环境中。这是 Amazon Connect 客户端应用程序。
**注意**
如果是 Windows 多会话操作系统，则只在机器上运行一次安装程序。仅版本 2.0.0 或更高版本支持 Windows 多会话操作系统上的屏幕录制。
如果您的 Amazon Connect 实例位于 AWS GovCloud （美国西部），则必须安装 2.0.3 或更高版本。
您需要配置允许与客户端应用程序进行通信的 Amazon Connect 域的允许列表。只能从允许列表中指定的 Amazon Connect 域中捕获屏幕录制。
#### 使用软件分发工具进行编程安装
+ 下载最新版本的 **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"
```
#### 手动安装
+ 下载最新版本的 **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 客户端应用程序是否正在运行且运行正常
##### 验证应用程序是否正在运行：
+ 在 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)
##### 验证该应用程序是否工作正常并在创建日志文件：
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 域允许列表的准则
在**允许的 Connect 域**框中输入域时，一定要遵守以下准则。否则，安装会失败。
+ 格式：逗号分隔的 Amazon Connect 域
+ Amazon Connect 域的有效字符：只能使用 A-Z、a-z、0-9、连字符（-）、句点（.）
+ 不需要协议前缀，例如 https:// 或 http://。
+ 限制：
+ 最多 500 个域条目
+ 每个域条目最多 256 个字符
+ 输入总长度最多 128000 个字符
以下是如何指定域的示例。
##### 正确
+ domain1.my.connect.aws,domain2.my.connect.aws
+ ddomain-1.my.connect.aws, 1-domain.my.connect.aws
+ domain-12.my.connect.aws
##### 错误
+ \$1123domain.foo
+ domain:2.foo
+ \$1domain.my.connect.aws
+ https://domain1.my.connect.aws
+ \$1.my.connect.aws
## Chrome 操作系统
Chrome 操作系统上的 Amazon Connect 屏幕录制功能需要两个组件：
+ 隔离的 Web 应用程序
+ Google Chrome 浏览器扩展程序
可以通过 Google 企业管理控制台在座席 Chrome 设备上安装这些组件。下面提供了 URLs 用于配置安装隔离 Web 应用程序和 Chrome 浏览器扩展程序的，可以将其设置为通过 Web 清单配置 JSON 自动更新。
### 下载位置和安装说明
在 Google 企业管理控制台上完成以下步骤。将该策略应用于所有需要启用屏幕录制功能的座席设备。
#### 安装隔离的 Web 应用程序
+ 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 浏览器扩展程序
+ 扩展程序 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)
# 在 Amazon Connect 中进行屏幕录制的系统和网络要求
本主题提供了使用屏幕录制的系统要求，并描述了它在每个平台中使用的具体数据流。
## 系统要求
以下为座席设备执行屏幕录制的最低系统要求。您需要为操作系统以及设备上运行的任何其他程序额外预留出内存、带宽和 CPU 资源，以避免资源争用。
+ CPU：2.0 GHz （建议使用 4 个内核或 4 个 vCPU）
+ 内存：4 GB
+ 网络：600 Kbps
### 支持的操作系统
+ 基于 x86-64 架构的 64 位 Windows 10 和 11
+ 在 Google 企业版域中注册的 Chrome 操作系统版本 140 或更高版本
**注意**
当启用 Windows 多会话配置，允许多个座席使用单个 Windows 主机时，必须确保座席的工作站为每个并发会话提供推荐的资源可用性。
## 网络要求
+ **用于屏幕录制的端口**： Amazon Connect 客户端应用程序通过端口 5431（Windows 操作系统）和端口 25431（Chrome 操作系统）上的本地 WebSocket 与 CCP 进行通信。
+ **URLs 添加到您的防火墙允许名单**：为确保屏幕录制功能流畅，请将以下 URL 模式添加到您的许可名单：
+ 从 CCP：`connect-recording-staging-*.s3.dualstack.your-region-name.amazonaws.com`。如果您不想使用通配符，则可在以下网址查看终端列表：https://screenrecording.connect。 aws/config/connect-recording-endpoint-allowlist .json。此列表未来可能会更新。请参阅文件顶部的 `createDate`，查看是否有更新。
+ 从屏幕录制客户端应用程序：`https://your-connect-instance-alias.my.connect.aws/taps/client/auth`
+ **序列图**：以下序列图显示了屏幕录制中涉及的不同组件之间的网络调用。
![\[序列图显示屏幕录制中涉及的不同组件之间的网络调用。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/sequence-diagram.png)
+ 在 Windows 中，Amazon Connect 客户端是 Amazon.Connect.Client.Service 后台流程和 Amazon.Connect.Client 的组合。 RecordingSession。
+ 在 Chrome 操作系统中，Amazon Connect 客户端是由隔离的 Web 应用程序和浏览器扩展程序组合而成的。
# 为您的 Amazon Connect 实例启用屏幕录制
本主题提供了为您的 Amazon Connect 实例启用屏幕录制、下载和安装 Amazon Connect 客户端应用程序以及执行关键配置步骤的步骤。
**Topics**
+ [步骤 1：为您的实例启用屏幕录制](#install-sr-step1)
+ [步骤 2：下载并安装 Amazon Connect 客户端应用程序](#install-sr-step2)
+ [步骤 3：配置 “设置记录和分析” 行为模块](#configure-recording-block)
+ [配置提示](#tips-sr)
## 步骤 1：为您的实例启用屏幕录制
**重要**
如果您的 Amazon Connect 实例是在 2018 年 10 月之前创建的，并且没有设置服务相关角色，请按照[使用服务相关角色](https://docs.aws.amazon.com/connect/latest/adminguide/connect-slr.html#migrate-slr)中的步骤迁移到 Amazon Connect 服务相关角色。
本节的步骤将介绍如何更新实例设置以启用屏幕录制，以及如何加密录制的构件。
1. 打开 Amazon Connect 控制台，网址为[https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)。
1. 选择您的实例别名。
1. 在导航窗格中，选择**数据存储**，向下滚动到**屏幕录制**，然后选择**编辑**，如下图所示。
![\[“数据存储”页面的“屏幕录制”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/console-screenrecordings.png)
1. 选择**座席屏幕录制**，然后选择**创建新的 S3 存储桶（推荐）**或**选择现有的 S3 存储桶**。
1. 如果您选择**创建新的 Amazon S3 存储桶（推荐）**，请在**名称**框中输入名称。如果您选择使用现有的存储桶，请从**名称**列表中选择此存储桶。
1. （可选）要对 Amazon S3 存储桶中的记录构件进行加密，请选择**启用加密**，然后选择 KMS 密钥。
**注意**
启用加密后，Amazon Connect 会使用 KMS 密钥对服务处理过程中的任何中间记录数据进行加密。
1. 完成后，选择**保存**。
有关实例设置的更多信息，请参阅 [更新您的 Amazon Connect 实例的设置](update-instance-settings.md)。
## 步骤 2：下载并安装 Amazon Connect 客户端应用程序
遵循 [Amazon Connect 客户端应用程序](amazon-connect-client-app.md)中的说明为您的操作系统下载和安装 Amazon Connect 客户端应用程序。
## 步骤 3：配置 “设置记录和分析” 行为模块
+ 在流的入口点之后立即添加[设置录音和分析行为](set-recording-behavior.md)数据块。将该数据块添加到您要启用以进行屏幕录制的每个流中。
+ 下图显示了[设置录音和分析行为](set-recording-behavior.md)数据块的属性页面。在**屏幕录制**分区，选择**打开**。
![\[“设置录制行为”数据块，“屏幕录制”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screenrecordingblock.png)
## 配置提示
+ 要使主管能够搜索拥有屏幕录制功能的联系人，请在**设置录音和分析行为**之前添加一个[设置联系属性](set-contact-attributes.md)数据块。添加一个名为**屏幕录制 = true** 之类的自定义属性。主管可以[搜索此自定义属性](search-custom-attributes.md)，以查找那些有屏幕录制功能的联系人。
+ 您可能需要在**设置录音和分析行为**之前添加一个[按百分比分配](distribute-by-percentage.md)数据块。这使您可以对部分但并非全部联系人使用屏幕录制功能。
+ 您可能需要利用[SuspendContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_SuspendContactRecording.html)和[ResumeContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_ResumeContactRecording.html) APIs 来防止在屏幕录制中捕获敏感信息。
# 在 Amazon Connect 客户端应用程序中查看座席屏幕录制
借助屏幕录制，通过观察座席在处理通话、聊天、任务联系时的一举一动，来识别座席的不足之处（例如，处理时间过长或未遵守业务流程等），以便提供针对性辅导。
屏幕录制与语音录制和联系转录同步，因此您可以同时听到或阅读所说的内容。
**注意**
屏幕录制仅对状态为“已完成”的联系可用。
**Topics**
+ [步骤 1：分配在 Amazon Connect 客户端应用程序中查看屏幕录制的权限](#assign-permissions-sr)
+ [步骤 2：查看屏幕录制](#review-sr-2)
+ [在 Picture-in-picture模式下观看](#picture-in-picture)
## 步骤 1：分配在 Amazon Connect 客户端应用程序中查看屏幕录制的权限
要允许用户查看屏幕录制，请分配以下**分析和优化**安全配置文件权限：
+ **屏幕录制 – 访问**：允许用户（例如主管或质量保证团队成员）访问和查看屏幕录制。
**重要**
屏幕录制将屏幕录制视频与未加密的通话录音文件合并。如果用户有查看屏幕录制的权限，就可以收听未加密的音频。
+ **屏幕录制：启用下载按钮**：允许用户（例如主管或质量保证团队成员）查看**联系详细信息**页面上的下载按钮，以下载屏幕录制视频。
有关如何为现有安全配置文件添加更多权限的信息，请参阅[在 Amazon Connect 中更新安全配置文件](update-security-profiles.md)。
## 步骤 2：查看屏幕录制
1. 使用安全配置文件中具有**分析和优化** – **屏幕录制 – 访问**权限的用户账户登录 Amazon Connect。
如果您还拥有**屏幕录制：启用下载按钮**权限，则可以在**联系详细信息**页面查看一个按钮，该按钮可让您下载屏幕录制并离线查看。
1. 在导航菜单上，依次选择**分析和优化**、**联系搜索**。
1. 搜索您希望查看的联系。
**提示**
如果您在流中添加了自定义属性来指示何时启用屏幕录制功能，则可以[按自定义属性进行搜索](search-custom-attributes.md)以查找包含屏幕录制的联系记录。有关更多信息，请参阅 [配置提示](enable-sr.md#tips-sr)。
1. 单击或点击联系 ID 以查看**联系详细信息**页面。
1. **录制**分区包含可显示屏幕录制的视频播放器，如下图所示。
![\[屏幕录制。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-show-recording.png)
**重要**
旧版 `https://your-instance-alias/awsapps.com` 域不支持在**联系详细信息**页面中播放屏幕录像。建议使用 `https://your-instance-alias.my.connect.aws/` 域来播放屏幕录像。有关更多信息，请参阅本指南中的[更新您的 Amazon Connect 域](update-your-connect-domain.md)。
1. 使用右侧的控件放大和缩小、将视频调整到窗口大小、下载视频、扩展到全屏以及播放。 picture-in-picture
![\[放大和缩小控件。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-zoom.png)
1. 如果您没有看到视频录制，请检查**显示屏幕录制**开关是否已打开。
如果没有视频显示，则屏幕录制可能尚未准备就绪（即上传到 Amazon S3 存储桶）。如果问题仍存在，请联系 [AWS 支持 中心](https://console.aws.amazon.com/support/home#/)。
## 在 Picture-in-picture模式下观看
在观看视频时，您可能需要将视频移到显示器上的其他位置。例如，您可以重新定位视频，以便阅读转录。使用 **Watch in Picture-in-picture** 模式可实现此目的。
1. 选择右侧控件上的 picture-in-picture按钮，如下图所示。
![\[页面右侧的“画中画”按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-picture-in-picture.png)
1. 选择右上角的 **X** 将窗口弹回。下图显示了处于 Picture-in-picture模式的视频，以及弹出窗口的 **X** 的位置。
![\[处于 picture-in-picture模式的视频和 “返回选项卡” 按钮的位置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-back-tab.png)
# 下载 Amazon Connect 客户端应用程序日志文件以进行故障排除
当你为屏幕录制问题打开 Su AWS pport 工单时，请包括代理桌面上 Amazon Connect 客户端应用程序和共享工作器的日志文件。
## Amazon Connect 客户端应用程序日志文件 (Windows)
在座席的桌面上，导航至：
+ `C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs`
**该文件包含日志，包括浏览器和客户端应用程序之间的 Websocket 连接，以及 Amazon.Connect.Client 和 **Amazon.** Connect 之间的另一个 Websocket 连接。 RecordingSession**。
+ `%USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs`
此文件包含屏幕录制活动的日志。（不适用于版本 1.x。）
## 共享工作线程日志（Windows 和 Chrome 操作系统）
打开 CCP。它必须处于打开状态，这样您才能查看**ClientAppInterface**共享工作器。
### Chrome
1. 打开 Chrome 浏览器。对于 URL 类型 `chrome://inspect/#workers`。
1. 在 “**共享工作人员**” 部分，找到名为的共享工作人员**ClientAppInterface**。
1. 选择**检查**以打开实 DevTools例。
1. 选择**控制台**选项卡，右键单击日志转储，然后选择**另存为...** 将日志转储存储到本地文件中。
### Firefox
1. 打开 Firefox 浏览器。对于 URL 类型 `about:debugging#workers`。
1. 在 “**共享工作人员**” 部分中，选择 “**检查****/connect/ccp-naws/static/client-app-interface.js**”。
1. 右键单击**控制台**选项卡，然后选择**将所有消息保存到文件**，以将日志转储存储到本地文件中。
### Edge（Chromium）
1. 打开 Chrome 浏览器。对于 URL 类型 `edge://inspect/#workers`。
1. 在 “**共享工作人员**” 部分，找到名为的共享工作人员**ClientAppInterface**。
1. 选择**检查**以打开实 DevTools例。
1. 选择**控制台**选项卡，右键单击日志转储，然后选择**另存为...** 将日志转储存储到本地文件中。
# 使用 Amazon EventBridge 事件跟踪屏幕录制状态
借助 Amazon EventBridge，您可以近乎实时地查看[代理屏幕录像](agent-screen-recording.md)的状态。每个代理屏幕录制的事件包括 success/failure 状态、带有描述的故障代码、录制位置、录制文件大小、已安装的客户端版本以及屏幕录制的开始和结束时间。
您可以与其他 AWS 服务集成，以获得代理屏幕录像的分析或监控见解：
+ 使用 A [mazon CloudWatch 日志见解](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)进行查询
+ 在 [Amazon Quick](https://aws.amazon.com/quicksight/) 控制面板中获取近乎实时的提醒
+ 在 Amazon Connect 之外创建汇总报告
+ 将您的其他自定义数据管道解决方案与 Amazon 连接起来 EventBridge
**Topics**
+ [Amazon EventBridge 事件负载格式](#eventbridge-payload-formats)
+ [创建规则以匹配 Amazon EventBridge 事件](#create-eventbridge-rule)
+ [配置已创建的 Amazon EventBridge 规则的目标](#configure-eventbridge-target)
## Amazon EventBridge 事件负载格式
### 带有屏幕录制状态的事件-已启动
当代理接受联系人时（可能是在录制开始之前），对于启用代理屏幕录制的每一次接触，都会触发此事件。
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"
],
"detail": {
"version": "1.0",
"recordingStatus": "INITIATED",
"eventDeduplicationId": "unique_uuid",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
}
}
}
```
### 显示屏幕录制状态的事件-已完成
当屏幕录制在代理桌面上结束时，会触发此事件。这并不意味着屏幕录像已成功上传到您的 Amazon S3 存储桶。
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"
],
"detail": {
"version": "1.0",
"recordingStatus": "COMPLETED",
"eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z",
"endTime": "2026-01-01T00:00:00.000Z",
}
}
}
```
### 带有屏幕录制状态的事件-已发布
当屏幕录像成功上传到您的 Amazon S3 存储桶时，就会触发此事件。详细信息包括 Amazon S3 存储桶的位置、录制大小和录制时长。
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"contactArn",
"instanceArn"
],
"detail": {
"version": "1.0",
"recordingStatus": "PUBLISHED",
"eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z",
"endTime": "2026-01-01T00:00:00.000Z",
"publishTime": "2026-01-01T00:00:00.000Z",
"location": "s3://your-bucket-name/object-prefix/object-key",
"durationInMillis": 100000,
"sizeInBytes": 1000000
}
}
}
```
### 显示屏幕录制状态的事件-失败
如果屏幕录制失败，则会发出此事件。有关故障信息的详细信息是为了尽最大努力估计我们能够检测到的可能的故障原因。
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"
],
"detail": {
"version": "1.0",
"recordingStatus": "FAILED",
"eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
},
"failureInfo": {
"code": "UNKNOWN",
"message": "UNKNOWN",
"source": "Unknown failure"
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z"
}
}
}
```
## 创建规则以匹配 Amazon EventBridge 事件
要订阅 Amazon EventBridge 事件以获取屏幕录制状态，您需要创建一个与定义的事件源和事件详细信息类型相匹配的 Amazon EventBridge 规则。这可以通过 AWS 控制台或 AWS CDK 库来实现。
### 使用 AWS 控制台创建规则
在 AWS 控制台中，在 Amazon EventBridge → 总线 → 规则中创建新规则。
#### 使用默认事件总线
![\[“创建规则” 页面显示了默认的事件总线选择。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-eventbridge-event-rule.png)
#### 使用模板事件模式
从下拉列表中选择已定义的事件模式。
![\[显示 aws.connect 的事件源下拉列表已选中。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-eventbridge-event-source.png)
![\[显示屏幕录制状态已更改的事件模式已选中。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-eventbridge-event-pattern.png)
如果事件类型未显示在下拉列表中，则也可以使用**自定义模式（JSON 编辑器）创建相同的模式**：
```
{
"source": [ "aws.connect" ],
"detailType": [ "Screen Recording Status Changed" ]
}
```
### 使用创建规则 AWS CDK
或者，如果您使用管理 AWS 资源 AWS CDK，则以下是构建 Amazon EventBridge 规则的示例 TypeScript 代码片段：
```
import { Rule } from 'aws-cdk-lib/aws-events';
const eventBridgeRule = new Rule(this, 'YourEventBridgeRuleLogicalName', {
ruleName: 'your-event-bridge-rule-name',
description: 'your rule description',
eventPattern: {
source: [ "aws.connect" ],
detailType: [ "Screen Recording Status Changed" ]
}
});
```
## 配置已创建的 Amazon EventBridge 规则的目标
Amazon EventBridge 支持将多项 AWS 服务作为目标。根据您的需求，您可以灵活地使用其他 AWS 服务构建自己的事件处理管道。您最多可以为每条规则定义五个目标。有关更多信息，请参阅《[亚马逊* EventBridge 用户指南》中的亚马逊 EventBridge *目标](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)。
### CloudWatch 以 Amazon 日志组为示例目标
以下示例使用 A [mazon CloudWatch 日志组](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)作为目标。
![\[显示所选 CloudWatch 日志组的目标配置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/screen-recording-eventbridge-target-cwl.png)
在 AWS CDK 代码中，创建资源并将其添加到 Amazon EventBridge 规则中：
```
import { LogGroup, RetentionDays } from "aws-cdk-lib/aws-logs";
import { CloudWatchLogGroup } from 'aws-cdk-lib/aws-events-targets';
const logGroup = new LogGroup(this, 'YourLogGroupLogicalName', {
logGroupName: '"/aws/events/your-log-group-name',
retention: RetentionDays.ONE_YEAR
});
eventBridgeRule.addTarget(new CloudWatchLogGroup((logGroup)));
```
#### Amazon CloudWatch 日志见解查询示例
以下是一些使用 Amazon CloudWatch Insights 查询语言的查询示例：
+ **成功率查询示例**
```
fields @timestamp, @message, detail
| stats sum(detail.recordingStatus= "PUBLISHED") as Count_Success,
sum(detail.recordingStatus= "INITIATED") as Count_Total,
Count_Success / Count_Total as Success_Ratio
```
+ **获取每个录制状态计数的示例查询**
```
fields @timestamp, @message, detail
| stats count(*) as Count group by detail.recordingStatus as recordingStatus
```
+ **带有最常见故障代码的失败联系人查询示例**
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.failureInfo.code as FailureCode
| sort by Count desc
```
+ **联系失败次数最多的代理的查询示例**
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.agentArn as AgentArn
| sort by Count desc
```
# 有关 Amazon Connect 屏幕录制功能的常见问题。
本主题提供有关使用 Amazon Connect 屏幕录制功能的常见问题。
**Topics**
+ [通用规格](#faq-sr-general)
+ [配置](#faq-sr-configuration)
+ [性能](#faq-sr-performance)
## 通用规格
+ **屏幕录制的文件格式是什么？**
屏幕录制文件以 MP4 格式保存。
+ **支持哪些 Amazon Connect 频道？**
您可以为语音、聊天和任务联系生成屏幕录制。
+ **您是否捕获整个屏幕？**
是的， Amazon Connect 客户服务会在代理的监视器上记录所有打开的应用程序，最多三台显示器。
+ **屏幕录制是否支持使用虚拟桌面基础架构 (VDI) 环境的 Windows 上的并发用户会话？**
是，当使用 Amazon Connect 客户端应用程序版本 2.0.0 或更高版本时，屏幕录制支持在 Windows 系统上并发运行多个用户会话。
+ **我的 AWS 账户中的屏幕录制文件存储在哪里？**
屏幕录制将传送到您的 Amazon S3 存储桶，并使用您指定的 KMS 密钥进行加密。这与通话录音的存储和加密方式类似。
+ **当有最新版本的客户端应用程序时，会如何通知我？**
+ 对于 Windows 系统，建议您订阅本管理员指南的 RSS 源，以便在有 Amazon Connect 客户端应用程序更新时收到通知。选择显示在此页面标题下方的 **RSS** 链接（位于 PDF 链接旁边）。
+ 对于 Chrome 操作系统，隔离的 Web 应用程序和 Chrome 扩展程序由 Amazon Connect 托管和管理。当有新版本发布时，它们会自动完成更新。
+ **我可以只选择屏幕录制而不选择通话录音吗？**
可以，您可以启用屏幕录制功能，而无需语音通话的通话录音。
+ **如何查找屏幕录制的 Amazon S3 位置？**
您可以在联系记录的 [RecordingsInfo](ctr-data-model.md#ctr-RecordingsInfo) 分区中查找屏幕录制位置。请参阅**位置**字段。
+ **如何为一定百分比的联系人启用屏幕录制？**
您可以使用流中的[按百分比分配](distribute-by-percentage.md)数据块来让一定百分比的联系人能够进行屏幕录制。
+ **屏幕录制是否符合 PCI 标准？**
Amazon Connect（包括屏幕录制功能）符合支付卡行业数据安全标准（PCI DSS）的要求。然而，您需要自行评估您的具体实施方案是否符合您的合规性要求。
**重要**
在视频通话或屏幕共享会话期间，即使客户处于等待状态，座席仍然能够看到客户的视频或屏幕共享。处理个人身份信息（PII）是客户的责任。如果您要更改此行为，可以构建一个自定义 CCP 和通信小部件。有关更多信息，请参阅 [将应用内通话、Web 通话、视频通话和屏幕共享原生集成到您的应用程序中](config-com-widget2.md)。
+ **屏幕录制是否适用于自定义 CCP 和座席桌面？**
屏幕录制专为与采用 [Amazon Connect Streams JS 库](https://github.com/amazon-connect/amazon-connect-streams)构建的 CCP 和 Agent Workspace 结合使用而设计。建议在生产环境中部署屏幕录制之前，先测试您的自定义解决方案。
+ **我可以在世界任何地方使用屏幕录制吗？**
屏幕录制功能适用于所有提供 Amazon Connect 的 AWS 商业区域。 AWS GovCloud (US) 但是，您使用屏幕录制可能需要遵守隐私和其他法律。在为您的座席启用此功能之前，请咨询您的合规性团队。
要在 AWS GovCloud （美国西部）中使用屏幕录制，需要客户端版本 2.0.3 或更高版本。
+ **为联系人启用屏幕录制功能后，座席会收到警报吗？**
默认情况下，Amazon Connect 不提供通知功能。但是，您可以使用 [Amazon Connect Streams JS 库](https://github.com/amazon-connect/amazon-connect-streams/blob/master/cheat-sheet.md)在座席的桌面上创建通知或其他可视指示器，以指示正在使用屏幕录制功能。
+ **如果座席在联系过程中或联系结束后立即关闭浏览器，会发生什么情况？**
如果在任何屏幕截图数据上传到 Amazon Connect 之前，浏览器在开始联系时关闭，则可能无法发布最终屏幕录像。如果在联系结束后但在上传最终屏幕截图数据之前立即关闭浏览器，则屏幕录像会在座席下次登录 CCP 时发布。
+ **当座席将客户置于保持状态时，屏幕录制会停止吗？**
否，当座席将客户置于保持状态时，屏幕录制仍会继续。
+ **当座席登录到多个 CCP 实例时，是否支持屏幕录制？**
否，当座席同时登录多个 CCP 实例时（无论是在同一浏览器还是不同浏览器中），均无法使用屏幕录制功能。在这些情况下，您可能会遇到屏幕录制功能表现不一致的问题。
## 配置
+ **我可以只选择屏幕录制而不选择通话录音吗？**
可以，您可以启用屏幕录制功能，而无需语音通话的通话录音。为此，请在保持屏幕录制处于启用状态的同时，在[设置录音和分析行为](set-recording-behavior.md)数据块中禁用语音录制功能。
+ **如何找到屏幕录像的 Amazon S3 位置？**
您可以在联系记录的 [RecordingsInfo](ctr-data-model.md#ctr-RecordingsInfo) 分区中查找屏幕录制位置。请参阅**位置**字段。
+ **如何为一定百分比的联系人启用屏幕录制？**
您可以使用流中的[按百分比分配](distribute-by-percentage.md)数据块来让一定百分比的联系人能够进行屏幕录制。
+ **在 S3 中，每分钟屏幕录制文件的平均大小是多少？**
屏幕录制文件的平均大小为每分钟 1.5MB。此大小可能因视频编码等因素而异。
+ **屏幕录制的帧速是多少？是否可配置？**
屏幕以每秒 5 帧的速度录制，不可配置。
+ **屏幕录制使用什么编解码器？**
屏幕录制使用 OpenH264 编解码器。
+ **有办法选择屏幕录制使用的音频（加密或未加密）吗？**
否，屏幕录制目前只使用未加密音频。
+ **屏幕录制有服务限制吗？**
否，屏幕录制服务没有服务限制或配额。
+ **屏幕录制有最长持续时间吗？**
否，屏幕录制解决方案没有规定录制的最长持续时间。
+ **可以录制多少个座席显示器？**
屏幕录制最多可以录制 3 个屏幕/显示器。
+ **我能否使用与实例数据存储配置中使用的 KMS 密钥不同的 KMS 密钥来配置我的 call/screen 记录存储 S3 存储桶，以启用存储桶级别的加密？**
否，应在存储桶级使用相同的密钥，并且也应作为实例数据存储配置的一部分。
## 性能
+ **屏幕录制的带宽要求是什么？**
建议在启用屏幕录制功能的情况下，每次并发联系需要 500kbps 的带宽。
+ **当我在 Windows 计算机上安装了屏幕录制客户端应用程序后，为什么看到更高的 CPU 使用率？**
屏幕录制通常是一个 CPU 密集型应用程序，因此预计会导致 CPU 使用率升高。建议您确保提供如[系统要求](sr-system-req.md#sr-requirements)中所述的足够资源，以避免出现任何资源争用问题。