翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect Contact Lens でエージェントの画面録画を設定および確認する
エージェントに優れたカスタマーサービスを提供できるよう指導するため、Contact Lens の画面録画機能を使用して品質管理に関する分析情報を得ることができます。エージェントのデスクトップが記録されるため、パフォーマンスを向上させる機会を特定するのに役立ちます。この情報は、コンプライアンスの確保にも役立ちます。
例えば、ほとんどのエージェントの返金処理にかかる時間が 2 分なのに対して、Jane Doe は 4 分かかるとします。彼女が払い戻しを行っているときのデスクトップの録画を見て、なぜ時間がかかっているのかを知ることができます。
次の図は、画面録画の大まかなコンポーネントを示しています。さまざまなコンポーネント間でのネットワーク呼び出しを示すシーケンス図については、「[ネットワークの要件](sr-system-req.md#network-requirements)」を参照してください。
![\[画面録画フローの図。\]](http://docs.aws.amazon.com/ja_jp/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 クライアントアプリケーション
Amazon Connect の画面録画は、Windows および Chrome OS でサポートされています。このページでは、各オペレーティングシステムでの画面記録アプリケーションのダウンロードおよびインストール手順と、エージェントデバイスの最小システム要件について説明します。
**Topics**
+ [Server](#windows-client)
+ [Chrome OS](#chrome-os)
## Server
### バージョン情報
+ バージョン: v2.0.3 (最新)
+ リリース日: 2025 年 1 月 16 日
+ ダウンロードリンク: [AmazonConnectClientWin-v2.0.3](https://d4yqf2f7seiym.cloudfront.net/builds/AmazonConnectClientWin-v2.0.3.zip)
+ リリースノート: このバージョンは AWS GovCloud (US) お客様をサポートし、セキュリティが向上しています。
上記リンクから **AmazonConnectClientWin-[version].zip** ファイルをダウンロードできます。ZIP ファイルには **Amazon.Connect.Client.Service.Setup.[version].msi** ファイルが含まれています。インストール手順については、「[画面録画を有効にする](enable-sr.md)」を参照してください。
Amazon Connect クライアントアプリケーションの更新時に通知を受け取るには、この管理者ガイドの RSS フィードにサブスクライブすることをお勧めします。このページのタイトルの下に表示される **RSS** リンク (PDF リンクの横にあります) を選択します。
### クライアントのインストール手順
このステップでは、**Amazon.Connect.Client.Service** ファイルをエージェントのデスクトップ、またはエージェントが使用する仮想環境にインストールします。これは Amazon Connect クライアントアプリケーションです。
**注記**
Windows マルチセッション OS の場合、インストーラはマシンで 1 回だけ実行する必要があります。Windows マルチセッション OS での画面録画は、バージョン 2.0.0 以降でのみサポートされています。
Amazon Connect インスタンスが AWS GovCloud (米国西部) にある場合は、バージョン 2.0.3 以降をインストールする必要があります。
クライアントアプリケーションとの通信が許可されている Amazon Connect ドメインの許可リストを設定する必要があります。画面録画は、許可リストで指定された Amazon Connect ドメインからのみキャプチャされます。
#### ソフトウェア配布ツールを使用したプログラムによるインストール
+ **Amazon.Connect.Client.Service.Setup.msi** ファイルの最新バージョンをダウンロードします。
+ Software Center などの組織のソフトウェアディストリビューションメカニズムを使用して、エージェントデスクトップに **Amazon.Connect.Client.Service** クライアントアプリをインストールします。
+ Microsoft System Center Configuration Manager (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/ja_jp/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** を示しています。
![\[タスクマネージャーの Amazon.Connect.Client.RecordingSession。\]](http://docs.aws.amazon.com/ja_jp/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 個のドメインエントリ
+ 1 個のドメインエントリあたり最大 256 文字
+ 合計で最大 128,000 文字の入力
ドメインの指定方法の例を次に示します。
##### 正しい例
+ 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 OS
ChromeOS では、Amazon Connect 画面録画機能に次の 2 つのコンポーネントが必要です。
+ 分離されたウェブアプリ
+ Google Chrome ブラウザ拡張機能
エージェント Chrome デバイスにこれらのコンポーネントをインストールするには、Google Enterprise 管理コンソールを使用します。分離されたウェブアプリと Chrome ブラウザ拡張機能のインストールを設定するための URL を以下に示します。ウェブマニフェスト設定 JSON を使用して自動更新に設定できます。
### ダウンロード場所とインストール手順
Google Enterprise 管理コンソールで次の手順を実行します。画面録画機能を有効にする必要があるすべてのエージェントデバイスに ポリシーを適用します。
#### 分離されたウェブアプリをインストールする
+ ウェブバンドル ID: `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
+ マニフェスト URL の更新: `https://screenrecording.connect.aws/chromeos/amazon-connect-client-iwa/releases/update_manifest.json`
**分離されたウェブアプリをインストールするには**
1. [Google 管理者ポータル](https://admin.google.com) (https://admin.google.com) に移動し、Google エンタープライズ管理者認証情報を使用してログインします。
1. **[分離されたウェブアプリの追加]** を選択します。
1. 次の詳細をコピーして貼り付け、**[保存]** を選択します。
+ ウェブバンドル ID: `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
+ マニフェスト URL の更新: https://screenrecording.connect.aws/chromeos/amazon-connect-client-iwa/releases/update\$1manifest.json
次の図は、完成した **[分離されたウェブアプリの追加]** ダイアログボックスの例を示しています。
![\[完成した [分離されたウェブアプリの追加] ダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/addisolatedwebapp.png)
1. **[インストールポリシー]**を `Force Install + Pin to ChromeOS Taskbar` に設定し、**[ログイン時に起動]**を `Force Launch and Prevent Closing` に変更して、コンピュータにログインして再起動したときに分離されたウェブアプリが自動的に起動されるようにします。
![\[[インストールポリシー] セクションと [ログイン時に起動] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/installationpolicy.png)
1. エージェントマシンで画面録画を開始できる Amazon Connect ドメインを許可リストに登録するように **[マネージド設定]** を構成します。次の図は、**[マネージド設定]** の例を示しています。
![\[[マネージド設定] セクション。\]](http://docs.aws.amazon.com/ja_jp/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. Direct ソケット、画面録画、およびウィンドウ管理のアクセス許可を許可するように分離されたウェブアプリを設定するには、次の手順を実行します。
+ **[デバイス]**、**[Chrome]**、**[ウェブの機能]**、**[オリジンを追加]** に移動します。
+ 「`ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`」と入力し、[**保存**] を選択します。
次の図は、Chrome の左側のナビゲーションメニューにある、[デバイス]、[Chrome]、および [ウェブの機能] の場所を示しています。
![\[Chrome OS の左側のナビゲーションメニュー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/allorigins.png)
次の図は、[ウェブの機能] ページの **[ダイレクトソケット]**、**[画面録画]**、**[ウィンドウの管理]** の場所を示しています。
![\[[ウェブの機能] ページの [ダイレクトソケット]、[画面録画]、[ウィンドウの管理]のウェブページの場所。\]](http://docs.aws.amazon.com/ja_jp/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. 次の図に示すように、**[Chrome アプリや拡張機能を ID で追加]** に移動します。
![\[左側のナビゲーションの [Chrome アプリや拡張機能を ID で追加] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/appandextensions.png)
1. **[Chrome アプリや拡張機能を ID で追加]** で **[カスタム URL から]** を選択し、次の情報を入力します。
+ 拡張機能 ID: `cjmichfmnimgeoadokmeaiclklkdccod`
+ カスタム URL: `https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`
![\[[Chrome アプリや拡張機能を ID で追加] ダイアログボックス、[カスタム URL から] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/chromeapp.png)
1. 次の図に示すように、**[インストールポリシー]** を **[強制インストール]** に設定し、**[保存]**を選択します。
![\[[強制インストール] に設定された [インストールポリシー] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/forceinstall.png)
# Amazon Connect での画面録画のシステム要件とネットワーク要件
このトピックでは、画面録画を使用するためのシステム要件と、各プラットフォームで使用する詳細なデータフローについて説明します。
## システム要件
エージェントデバイスが画面録画を実行するための最小システム要件は次のとおりです。リソースの競合を避けるために、デバイス上で実行中のオペレーティングシステムやその他の処理のための、追加のメモリ、帯域幅、および CPU の検討が必要になります。
+ CPU: 2.0 GHz (4 コア、または vCPU 4 基を推奨)
+ メモリ: 4 GB
+ ネットワーク: 600 Kbps
### サポートされるオペレーティングシステム
+ x86-64 アーキテクチャをベースにした 64 ビット Windows 10 および 11。
+ Google Enterprise Domain に登録されている Chrome OS バージョン 140 以降
**注記**
Windows マルチセッション構成が有効で、複数のエージェントで単一の Windows ホストの使用が許可されている場合は、エージェントのワークステーションに、同時セッションごとに推奨されるリソース可用性があることを確認してください。
## ネットワークの要件
+ **画面録画に使用されるポート**: Amazon Connect クライアントアプリケーションは、ポート 5431 (Windows) および 25431 (Chrome OS) のローカル WebSocket を介して CCP と通信します。
+ **ファイアウォールの許可リストに追加する URL**: 画面録画機能をスムーズにするには、許可リストに次の 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/ja_jp/connect/latest/adminguide/images/sequence-diagram.png)
+ Windows では、Amazon Connect クライアントは Amazon.Connect.Client.Service バックグラウンドプロセスと Amazon.Connect.Client.RecordingSession の組み合わせです。
+ ChromeOS では、Amazon Connect クライアントは分離されたウェブアプリとブラウザ拡張機能の組み合わせです。
# Amazon Connect インスタンスで画面録画を有効にする
このトピックでは、Amazon Connect インスタンスの画面記録を有効にする手順、Amazon Connect クライアントアプリケーションをダウンロードしてインストールする手順、主要な設定ステップを実行する手順について説明します。
**Topics**
+ [ステップ 1: インスタンスの画面録画を有効にする](#install-sr-step1)
+ [ステップ 2: Amazon Connect クライアントアプリケーションをダウンロードしてインストールする](#install-sr-step2)
+ [ステップ 3: 記録と分析動作の設定ブロックを設定する](#configure-recording-block)
+ [設定のヒント](#tips-sr)
## ステップ 1: インスタンスの画面録画を有効にする
**重要**
2018 年 10 月より前に作成された Amazon Connect インスタンスでサービスリンクロールが設定されていない場合は、「[サービスにリンクされたロールを使用する](https://docs.aws.amazon.com/connect/latest/adminguide/connect-slr.html#migrate-slr)」の手順に従って、Connect サービスリンクロールに移行してください。
このセクションの手順では、インスタンス設定を更新して画面録画を有効にする方法と、録画アーティファクトを暗号化する方法を説明します。
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスエイリアスを選択します。
1. 次の図に示すように、ナビゲーションペインで **[データストレージ]** を選択し、**[画面録画]** まで下にスクロールして **[編集]** を選択します。
![\[[データストレージ] ページの [画面録画] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/console-screenrecordings.png)
1. **[画面録画を有効にする]** を選択し、**[新しい S3 バケットを作成 (推奨)]** または **[既存の S3 バケットを選択]** を選択します。
1. **[新しい 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/ja_jp/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) API を活用して、機密情報が画面録画に取り込まれないようにすることをお勧めします。
# Amazon Connect クライアントアプリケーションでエージェントの画面録画を確認する
画面録画を使用してエージェントが通話、チャット、タスクコンタクトを処理しているときのアクションを見ることで、エージェントにコーチングが必要な領域を特定します (コンタクトの処理が長い、ビジネスプロセスを順守していないなど)。
画面録画は、音声録音および問い合わせのトランスクリプトと同期されるため、会話の内容を同時に聞いたり読むことができます。
**注記**
完了したコンタクトの画面録画のみ使用できます。
**Topics**
+ [ステップ 1: Amazon Connect クライアントアプリケーションで画面録画を確認するアクセス許可を割り当てる](#assign-permissions-sr)
+ [ステップ 2: 画面録画を確認する](#review-sr-2)
+ [ピクチャーインピクチャーモードで視聴](#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/ja_jp/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. 右側のコントロールを使用して、ズームインとズームアウト、動画をウィンドウに合わせる、動画をダウンロードする、全画面表示に拡大する、ピクチャインピクチャを再生します。
![\[ズームインおよびズームアウトのコントロール。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/screen-recording-zoom.png)
1. ビデオ録画が表示されない場合は、**[画面録画を表示]** トグルがオンになっていることを確認してください。
ビデオが表示されない場合は、画面録画がまだ準備されていない (つまり Amazon S3 バケットにアップロードされていない) 可能性があります。この問題が解決しない場合は、[AWS サポート センター](https://console.aws.amazon.com/support/home#/)までお問い合わせください。
## ピクチャーインピクチャーモードで視聴
視聴中にビデオをモニター上の別の場所に移動したい場合があるかもしれません。例えば、動画の位置を変更してトランスクリプトが読めるようにすることができます。これを実現するには **[ピクチャーインピクチャーモードで視聴]** を使用します。
1. 次の図に示すように、右側のコントロールでピクチャインピクチャボタンを選択します。
![\[ページの右側にあるピクチャインピクチャのボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/screen-recording-picture-in-picture.png)
1. ウィンドウの右上隅にある **[ギヤアイコン]** を選択します。次の画像は、ピクチャインピクチャモードの動画と、元の画面に戻るための **X** の場所を示しています。
![\[ピクチャインピクチャモードの動画と、タブに戻るボタンの場所。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/screen-recording-back-tab.png)
# トラブルシューティングのために Amazon Connect クライアントアプリケーションログファイルをダウンロードする
画面録画に関する問題のサポート AWS チケットを開くときは、エージェントデスクトップから Amazon Connect クライアントアプリケーションと共有ワーカーのログファイルを含めます。
## Amazon Connect クライアントアプリケーションログファイル (Windows)
エージェントのデスクトップで、以下に移動します。
+ `C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs`
このファイルには、ブラウザとクライアントアプリケーション間の Websocket 接続、Amazon.**Connect.Client** と Amazon**.Connect.RecordingSession** 間の別の Websocket 接続などのログが含まれています。
+ `%USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs`
このファイルには、画面録画アクティビティのログが含まれています。(バージョン 1.x には該当しません。)
## 共有ワーカーログ (Windows および ChromeOS)
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)のステータスをほぼリアルタイムで表示できます。各エージェントの画面録画のイベントには、成功/失敗ステータス、説明を含む失敗コード、録画場所、録画サイズ、インストールされたクライアントバージョン、画面録画の開始時刻と終了時刻が含まれます。
を他の AWS サービスと統合して、エージェントの画面録画の分析またはモニタリングに関するインサイトを取得できます。
+ [Amazon CloudWatch Log Insights](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 イベントペイロード形式
### 画面録画ステータスのイベント - INITIATED
このイベントは、エージェントが問い合わせを承諾したときに出力されます。これは、エージェントの画面録画が有効になっているすべての問い合わせについて、記録が開始される前である可能性があります。
```
{
"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 → Buses → Rules で新しいルールを作成します。
#### デフォルトのイベントバスを使用する
![\[デフォルトのイベントバスの選択を示すルールの作成ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/screen-recording-eventbridge-event-rule.png)
#### テンプレートイベントパターンを使用する
ドロップダウンリストから定義されたイベントパターンを選択します。
![\[aws.connect が選択されたことを示すイベントソースドロップダウン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/screen-recording-eventbridge-event-source.png)
![\[画面録画ステータスが変更されたことを示すイベントパターン。\]](http://docs.aws.amazon.com/ja_jp/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 サービスを使用して独自のイベント処理パイプラインを柔軟に構築できます。ルールごとに最大 5 つのターゲットを定義できます。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge ターゲット](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)」を参照してください。
### ターゲット例としての Amazon CloudWatch ロググループ
次の例では、[Amazon CloudWatch ロググループ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)をターゲットとして使用します。
![\[選択した CloudWatch ロググループを示すターゲット設定。\]](http://docs.aws.amazon.com/ja_jp/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 Log Insights クエリの例
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 クライアントサービスはエージェントのモニターに、最大 3 台のモニターを含むすべての開いているアプリケーションを記録します。
+ **画面録画では、Windows で仮想デスクトップインフラストラクチャ (VDI) 環境を使用する同時ユーザーセッションはサポートされていますか?**
はい。画面録画では、Amazon Connect クライアントアプリケーションバージョン 2.0.0 以降を使用する場合、Windows での同時ユーザーセッションがサポートされています。
+ **画面録画ファイルは AWS アカウントのどこに保存されていますか。**
画面録画は Amazon S3 バケットに配信され、指定した KMS キーを使用して暗号化されます。これは、通話録音の保存方法と暗号化方法に似ています。
+ **クライアントアプリケーションが最新バージョンになったときに通知を受けるにはどうすればよいですか。**
+ Windows の場合、 Amazon Connect クライアントアプリケーションが更新されたときに通知を受けるには、この管理者ガイドの RSS フィードを購読することをお勧めします。このページのタイトルの下に表示される **RSS** リンク (PDF リンクの横にあります) を選択します。
+ ChromeOS の場合、分離されたウェブアプリと Chrome 拡張機能は Amazon Connect によってホストおよび管理されます。これらは、新しいバージョンが公開されると自動的に更新されます。
+ **通話録音ではなく、画面録画のみを選択できますか。**
はい、音声通話の通話録音なしで画面録画を有効にできます。
+ **画面録画の Amazon S3 の場所を確認する方法を教えてください。**
画面録画の場所は、問い合わせ録画の [RecordingsInfo](ctr-data-model.md#ctr-RecordingsInfo) セクションにあります。**[場所]** フィールドを参照してください。
+ **特定の割合の問い合わせの画面録画を有効にするにはどうすればよいですか。**
フロー内の [分散 (%)](distribute-by-percentage.md) ブロックを使用して、特定の割合の問い合わせを画面録画できます。
+ **画面録画は PCI に準拠していますか。**
画面録画機能を含む Amazon Connect は、Payment Card Industry Data Security Standard (PCI DSS) に準拠しています。ただし、特定の実装がコンプライアンス要件を満たしているかどうかを判断する責任があります。
**重要**
ビデオ通話または画面共有セッション中、エージェントは顧客が保留中であっても、顧客のビデオまたは画面共有を表示できます。それに応じて PII に対処するのは顧客の責任です。この動作を変更する場合は、カスタム CCP とコミュニケーションウィジェットを構築します。詳細については、「[アプリ内通話、ウェブ通話、ビデオ通話、および画面共有をアプリケーションにネイティブに統合する](config-com-widget2.md)」を参照してください。
+ **画面録画はカスタム CCP とエージェントデスクトップで機能しますか。**
画面録画は、[Amazon Connect Streams JS ライブラリ](https://github.com/amazon-connect/amazon-connect-streams)で構築されたカスタム CCP およびエージェントワークスペースで動作するように設計されています。画面録画を本番環境に導入する前に、カスタムソリューションをテストすることをお勧めします。
+ **画面録画は世界中のどこでも使用できますか。**
画面録画は、 AWS GovCloud (US) および Amazon Connect が利用可能なすべての AWS 商用リージョンで利用できます。ただし、画面録画の使用は、プライバシーおよびその他の法律の遵守の対象となる場合があります。エージェントに対してこの機能を有効にする前に、コンプライアンスチームにご相談ください。
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 分あたりの画面録画ファイルの平均サイズはどれくらいですか。**
画面録画の平均サイズは 1.5 MB/分です。このサイズは、ビデオエンコーディングなどの要因によって異なる場合があります。
+ **画面録画のフレームレートはどのくらいですか。また、設定できますか。**
画面は 1 秒あたり 5 フレームで録画され、これは設定できません。
+ **画面録画にはどのコーデックが使用されますか。**
画面録画では OpenH264 コーデックを使用します。
+ **画面録画に使用するオーディオ (編集済みまたは未編集) を選択する方法はありますか。**
いいえ、現在、編集されていないオーディオのみが画面録画に使用されます。
+ **画面録画にはサービス制限がありますか。**
いいえ。画面録画サービスにはサービス制限やクォータはありません。
+ **画面録画には最大時間がありますか。**
いいえ。画面録画ソリューションでは、録画の最大時間はありません。
+ **録画できるエージェントモニターの数はいくつですか。**
画面録画では、最大 3 つの画面/モニターを録画できます。
+ **インスタンスデータストレージ設定の一部として使用される KMS キーとは異なる KMS キーを使用してバケットレベルの暗号化を有効にするように、通話/画面録画ストレージ S3 バケットを設定できますか。**
いいえ。同じキーをバケットレベルで、またインスタンスデータストレージ設定の一部として使用する必要があります。
## パフォーマンス
+ **画面録画に必要な帯域幅を教えてください。**
画面録画を有効にした状態で、同時接続あたり 500 kbps を推奨します。
+ **Windows マシンに画面録画クライアントアプリケーションをインストールした後、CPU 使用率が高くなるのはなぜですか。**
一般的に画面録画は CPU 負荷の高いアプリケーションであるため、CPU 使用率の増加が予想されます。リソースの競合の問題を避けるため、「[システム要件](sr-system-req.md#sr-requirements)」で説明されているように十分なリソースを提供することをお勧めします。