通話を記録するためのワークフローを理解する

本セクションのこのトピックでは、通話と Kinesis Video Streams の録音および録画に関する各種ワークフローについて説明します。

このワークフローの用途:

Voice Connector を既に使用しているか、使用を計画してSIP、メディアを通話分析に取り込みます。

注記
Voice Connectors は SIPとをサポートしていますSIPREC。詳細については、「Amazon Chime 管理者ガイド」の「Amazon Chime SDK Voice Connectors の管理」を参照してください。 SDK
Amazon Simple Storage Service の送信先に対して、レイテンシーの低い SIPまたは SIPRECの呼び出しを自動的に記録します。
Amazon Chime SDKコンソールを使用して設定を作成し、Voice Connector に関連付けます。
すべての Voice Connector の通話に同じ録音設定を適用する。1 つまたは複数の Voice Connector に複数の設定を適用する場合は、次のセクションを参照してください。

プログラムで呼び出しを有効にするには、次の Amazon Chime SDK を使用しますAPIs。

を使用するCreateMediaInsightsPipelineConfiguration API コール分析設定を作成するには
を使用するCreateVoiceConnector Voice Connector を作成します。
を使用するPutVoiceConnectorStreamingConfiguration API 設定を Voice Connector に関連付けます。

詳細については、「Amazon Chime 管理者ガイド」の「通話分析を使用するように Voice Connectors を設定する」を参照してください。 SDK

次の図は、Voice Connector によって通話録音セッションを開始するときのデータフローを示しています。図の数字は、次の各説明の番号に対応しています。

Voice Connector によって通話録音を開始するデータフローを示す画像。

図中の手順を説明します。

Amazon Chime SDKコンソールまたはを使用する CreateMediaInsightsPipelineConfiguration API コール分析設定を作成します。設定のプロセスでは、通話録音の有効化、対象の録音ファイル形式の選択、録音ファイルの送信先となる Amazon S3 の指定のみ行います。詳細については、「Amazon Chime 管理者ガイド」の「通話分析設定の作成」を参照してください。 SDK
Amazon Chime SDKコンソールまたは PutVoiceConnectorStreamingConfiguration API 設定を Voice Connector に関連付けます。コンソールを使用するには、「Configuring Voice Connectors to use call analytics」を参照してください。
発信中には、Voice Connector によって、各通話参加者の音声を受信します。
通話分析の録音設定を Voice Connector にアタッチしている場合は、Voice Connector サービスによって、メディアパイプラインサービスを使用した通話分析録音セッションが開始されます。
メディアパイプラインサービスによって、進行中の通話をモニタリングする通話録音プロセッサが起動します。
通話が終了すると、メディアパイプラインサービスによって通話録音ファイルが指定の Amazon S3 バケットに配信され、Amazon Kinesis Data Streams を介して録音メタデータが提供されます。データウェアハウスを有効にしている場合、通話メタデータも Amazon Simple Storage Service データウェアハウスに送信されます。SIPREC が通話分析にSIP音声を組み込むために利用される場合、通話メタデータにはテーブル形式のSIPRECメタデータが含まれます。録音テーブルの詳細については、このセクションで後述する「AWS Glue データカタログテーブルについて」を参照してください。
メディアパイプラインサービスは、パイプラインステータスイベントをデフォルトの Amazon に送信します EventBridge。詳細については、このガイド EventBridge の通知の使用を参照してください。

注記

Voice Connector による録音を有効にするには、Voice Connector のストリーミングを有効にする必要があります。この機能によって、アカウント内の Voice Connector で管理する Kinesis Video Streams に通話データをストリーミングできるようになるからです。詳細については、「Amazon Chime 管理者ガイド」の「Kinesis Video Streams への Amazon Chime SDK Voice Connector メディアのストリーミング」を参照してください。 SDK

また、Voice Connector で作成した通話データは、数時間、数日、数年まで、さまざまな期間、Kinesis Video Streams に保存できます。データ保持を行わない場合、通話データをすぐに使用しなければならなくなります。Kinesis Video Streams のコストは、使用する帯域幅と合計ストレージに基づいて判断します。データ保持期間は、Voice Connector のストリーミング設定内でいつでも調整できます。通話分析の記録を有効にするには、通話分析の実行に十分な期間のデータを Kinesis Video Streams 内に保持する必要があります。これを行うには、適切なデータ保持期間を指定します。

通話インサイトパイプライン設定は、必要な数の Voice Connector に関連付けることができます。Voice Connector ごとに異なる設定を行うことも可能です。Voice Connectors はを使用して AWSServiceRoleForAmazonChimeVoiceConnector を呼び出します。 CreateMediaInsightsPipeline API トランザクション ID ごとに 1 回。ロールの詳細については、「Amazon Chime 管理者ガイド」の「Amazon Chime SDK Voice Connectors の Amazon Chime SDKサービスにリンクされたロールの使用」を参照してください。 SDK

Amazon Kinesis Video Streams の録画が必要なケースを次に示します。

Voice Connector のすべての通話に同じ設定を使用せず、各通話に異なる設定を適用する。
Voice Connector で処理されない音声SIPまたは非SIP音声を録音したい。

この通話録音オプションを使用するには、音声を Kinesis Video Streams (KVS) に発行してから、 CreateMediaInsightsPipeline API KVSストリームチャネル情報と通話分析設定。 ARN

注記

通話分析は、最大 2 つのオーディオチャネルAPIsをサポートします。Voice Connector ストリーミングを有効にし、Voice Connector EventBridge の通知で公開されたKVS情報を使用して通話録音を開始することもできます。

を呼び出す場合 CreateMediaInsightsPipeline ではAPI、KVSストリームチャネル定義ごとにフラグメント番号を指定するかどうかを選択できます。フラグメント番号を指定すると、そのフラグメントからストリームの処理が開始されます。フラグメント ID を指定しない場合、利用可能な最新のフラグメントからストリームの処理が開始されます。

図中の手順を説明します。

Amazon Chime SDKコンソールまたは CreateMediaInsightsPipelineConfiguration API 通話録音設定を作成します。
を使用して AWS SDK、外部オーディオをにプッシュするアプリケーションを作成するかKVS、Voice Connector ストリーミングを有効にして通話オーディオを自動的にに発行しますKVS。詳細については、「Amazon Chime 管理者ガイド」の「Kinesis Video Streams への Amazon Chime SDK Voice Connector メディアのストリーミング」を参照してください。 SDK
Voice Connector ストリーミングが有効になっている場合、Voice Connector サービスはデフォルトのに通知を送信します EventBridge。
Voice Connector ストリーミングの場合、アプリケーションはからの Amazon Chime Voice Connector KVS ストリーミングSTARTEDイベントを使用して EventBridge 、通話のレッグに関するストリーム情報を収集できます。
アプリケーションが Voice Connector ストリーミングイベントまたは外部ソースからのオーディオ情報を取得すると、アプリケーションは Amazon Chime を呼び出します。 SDK CreateMediaInsightsPipeline API.
メディアパイプラインサービスによって、進行中の通話をモニタリングする通話録音プロセッサが起動します。
メディアパイプラインサービスは、パイプラインステータスイベントをデフォルトの Amazon に送信します EventBridge。詳細については、 EventBridge 「通知の使用」を参照してください。
通話が終了すると、メディアパイプラインサービスによって通話録音ファイルが指定の Amazon S3 バケットに配信され、Amazon Kinesis Data Streams を介して録音メタデータが提供されます。データウェアハウスが有効にしている場合、通話メタデータも Amazon S3 データウェアハウスに送信されます。SIPREC がSIP音声を通話分析に組み込むために利用される場合、通話メタデータには便利なテーブル形式のSIPRECメタデータが含まれます。録音テーブルの詳細については、このセクションで後述する「AWS Glue データカタログテーブルについて」を参照してください。
アプリケーションはパイプラインをモニタリングでき、Voice Connector の場合は Amazon に公開されたイベントを使用して通話ステータスをモニタリングできます EventBridge。詳細については、このガイド EventBridge の通知の使用を参照してください。
録音を終了するには、を呼び出します。 DeleteMediaPipeline API 通話録音を終了します。

API ベースの録画と例については、このガイドのAmazon S3 録画シンク」を参照してください。

このセクションの例では、次の操作について説明します。

を使用して通話分析設定CLIを実行し、を呼び出す CreateMediaInsightsPipeline.
を使用してCLI、録音先オーディオファイル形式とオーディオファイル名を指定します。

設定を実行してパイプラインを開始する

次のコマンドを使用して設定を実行し、メディアインサイトパイプラインを開始します。pipeline.json ファイルには設定情報が記述されています。


aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json

一般的な pipeline.json ファイルの例を次に示します。


{
    "MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
    "KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
        "Streams": [
            {
                "StreamArn": kinesis_video_stream_arn_1
            },
            {
                "StreamArn": kinesis_video_stream_arn_2
            }
        ],
        "FragmentSelector": {
            "FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
            "TimestampRange": {
                "StartTimestamp": epoch_time_seconds,
                "EndTimestamp": epoch_time_seconds
            }
        }
    },
    "S3RecordingSinkRuntimeConfiguration": {
        "Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
        "RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
    }
}

MediaInsightsPipelineConfigurationArn は、通話分析設定を作成した後にARN受け取る設定です。

録音先、ファイル名、ファイル形式を設定する

次の例では、MyRecordingBucket という名前のフォルダを S3SinkConfiguration.Destination 値として使用し、Opus を RecordingFileFormat 値として使用しています。


arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg

次の例では、MyRecordingBucket を S3SinkConfiguration.Destination 値として使用し、Wav を RecordingFileFormat 値として使用しています。


arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

通話分析の設定を使用する

機械学習ベースの分析のワークフローを理解する