Amazon Chime SDK の通話を記録するためのワークフローについて

PDF

RSS

フォーカスモード

Amazon Chime SDK の通話を記録するためのワークフローについて - Amazon Chime SDK

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

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

Voice Connector を既に使用し SIP メディアを通話分析に取り込んでいる、または使用する予定がある。

注記
Voice Connector は SIP と SIPREC に対応しています。詳細については、「Amazon Chime SDK Administrator Guide」の「 Managing Amazon Chime SDK Voice Connectors」を参照してください。
選択した Amazon Simple Storage Service の送信先に、SIP または SIPREC の通話を低レイテンシーかつ自動的に録音する。
Amazon Chime SDK コンソールから設定を行い、それを Voice Connector に関連付ける。
すべての Voice Connector の通話に同じ録音設定を適用する。1 つまたは複数の Voice Connector に複数の設定を適用する場合は、次のセクションを参照してください。

プログラムによる呼び出しを有効にするには、次の Amazon Chime SDK API を使用してください。

CreateMediaInsightsPipelineConfiguration API を使用して通話分析を設定する。
CreateVoiceConnector を使用して Voice Connector を作成する。
PutVoiceConnectorStreamingConfiguration API を使用して、設定を Voice Connector に関連付ける。

詳細については、「Amazon Chime SDK Administrator Guide」の「Configuring Voice Connectors to use call analytics」を参照してください。

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

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

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

Amazon Chime SDK コンソールまたは CreateMediaInsightsPipelineConfiguration API を使用して、通話分析を設定します。設定のプロセスでは、通話録音の有効化、対象の録音ファイル形式の選択、録音ファイルの送信先となる Amazon S3 の指定のみ行います。詳細については、「Amazon Chime SDK Administrator Guide」の「Creating call analytics configurations」を参照してください。
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 メタデータが含まれることになります。録音テーブルの詳細については、このセクションで後述する「Amazon Chime SDK AWS Glue のデータカタログテーブルについて」を参照してください。
メディアパイプラインサービスによって、パイプラインステータスイベントがデフォルトの Amazon EventBridge に送信されます。詳細については、このガイドの「Event Bridge 通知の使用」を参照してください。

注記

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

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

通話インサイトパイプライン設定は、必要な数の Voice Connector に関連付けることができます。Voice Connector ごとに異なる設定を行うことも可能です。Voice Connector では、AWSServiceRoleForAmazonChimeVoiceConnector を使用して、トランザクション ID ごとに一度 CreateMediaInsightsPipeline API を自動的に呼び出します。詳細については、「Amazon Chime SDK Administrator Guide」の「Using the Amazon Chime SDK service-linked role for Amazon Chime SDK Voice Connectors」を参照してください。

Voice Connector の通話を録音する

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

Voice Connector を既に使用し SIP メディアを通話分析に取り込んでいる、または使用する予定がある。

注記
Voice Connector は SIP と SIPREC に対応しています。詳細については、「Amazon Chime SDK Administrator Guide」の「 Managing Amazon Chime SDK Voice Connectors」を参照してください。
選択した Amazon Simple Storage Service の送信先に、SIP または SIPREC の通話を低レイテンシーかつ自動的に録音する。
Amazon Chime SDK コンソールから設定を行い、それを Voice Connector に関連付ける。
すべての Voice Connector の通話に同じ録音設定を適用する。1 つまたは複数の Voice Connector に複数の設定を適用する場合は、次のセクションを参照してください。

プログラムによる呼び出しを有効にするには、次の Amazon Chime SDK API を使用してください。

CreateMediaInsightsPipelineConfiguration API を使用して通話分析を設定する。
CreateVoiceConnector を使用して Voice Connector を作成する。
PutVoiceConnectorStreamingConfiguration API を使用して、設定を Voice Connector に関連付ける。

詳細については、「Amazon Chime SDK Administrator Guide」の「Configuring Voice Connectors to use call analytics」を参照してください。

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

Amazon Chime SDK コンソールまたは CreateMediaInsightsPipelineConfiguration API を使用して、通話分析を設定します。設定のプロセスでは、通話録音の有効化、対象の録音ファイル形式の選択、録音ファイルの送信先となる Amazon S3 の指定のみ行います。詳細については、「Amazon Chime SDK Administrator Guide」の「Creating call analytics configurations」を参照してください。
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 メタデータが含まれることになります。録音テーブルの詳細については、このセクションで後述する「Amazon Chime SDK AWS Glue のデータカタログテーブルについて」を参照してください。
メディアパイプラインサービスによって、パイプラインステータスイベントがデフォルトの Amazon EventBridge に送信されます。詳細については、このガイドの「Event Bridge 通知の使用」を参照してください。

注記

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

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

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

注記

通話分析 API は最大 2 つの音声チャネルに対応しています。通話録音は、Voice Connector ストリーミングを有効にし、Voice Connector の EventBridge 通知内に発行済みの KVS 情報を使用することでも開始できます。

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

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

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

API ベースの録音と例については、このガイドの「Amazon S3 recording sink」を参照してください。

Amazon Kinesis Video Streams プロデューサーを使用して録画する

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

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

注記

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

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

API ベースの録音と例については、このガイドの「Amazon S3 recording sink」を参照してください。

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

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

CLI を使用して録音を開始する

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

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 を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

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

機械学習ベースの分析を目的としたワークフローについて

次のトピック

機械学習ベースの分析を目的としたワークフローについて

前のトピック:

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

ヘルプが必要ですか?

このページは役に立ちましたか?

フィードバックを送信

プライバシーサイト規約 Cookie の設定

Cookie の設定を選択する

Cookie の設定をカスタマイズする

Essential

Performance

Functional

Advertising

Cookie の設定を保存できません

Amazon Chime SDK の通話を記録するためのワークフローについて

注記

注記

Voice Connector の通話を録音する

注記

注記

注記

Amazon Kinesis Video Streams プロデューサーを使用して録画する

注記

トピック

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

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

CLI を使用して録音を開始する

トピック

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

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

次のトピック

前のトピック:

ヘルプが必要ですか?

このページは役に立ちましたか?

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

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