Grundlegendes zu den Workflows zum Aufzeichnen von Anrufen für das Amazon Chime SDK

Verwenden Sie diesen Workflow, wenn:

Verwenden Sie die folgenden Amazon Chime SDK-APIs, um programmgesteuert Anrufe zu aktivieren.

Weitere Informationen finden Sie im Amazon Chime SDK-Administratorhandbuch unter Konfiguration von Voice Connectors für die Verwendung von Anrufanalysen.

Das folgende Diagramm zeigt den Datenfluss, wenn ein Voice Connector eine Anrufaufzeichnungssitzung initiiert. Die Zahlen im Diagramm entsprechen dem nummerierten Text unten.

Im Diagramm:

Sie können auch von Voice Connector erstellte Anrufdaten in Kinesis Video Streams für unterschiedliche Zeiträume speichern, von Stunden über Tage bis hin zu Jahren. Wenn Sie sich dafür entscheiden, keine Daten aufzubewahren, wird die Nutzbarkeit der Anrufdaten für den sofortigen Zugriff eingeschränkt. Die Kosten für Kinesis Video Streams werden auf der Grundlage der verwendeten Bandbreite und des insgesamt genutzten Speichers bestimmt. Sie können die Aufbewahrungsdauer der Daten jederzeit in der Voice Connector-Streaming-Konfiguration anpassen. Um die Aufzeichnung von Anrufanalysen zu aktivieren, müssen Sie sicherstellen, dass der Kinesis Video Stream die Daten lange genug speichert, um die Anrufanalyse durchzuführen. Dazu geben Sie eine geeignete Aufbewahrungsfrist für Daten an.

Sie können eine Call Insights-Pipeline-Konfiguration mit beliebig vielen Voice Connectors verknüpfen. Sie können auch für jeden Voice Connector eine andere Konfiguration erstellen. Voice Connectors verwenden das AWSServiceRoleForAmazonChimeVoiceConnector , um die CreateMediaInsightsPipeline API in Ihrem Namen einmal pro Transaktions-ID aufzurufen. Informationen zur Rolle finden Sie im Amazon Chime SDK-Administratorhandbuch unter Verwenden der serviceverknüpften Amazon Chime SDK-Rolle für Amazon Chime SDK Voice Connectors.

Sie zeichnen Amazon Kinesis Videostreams auf, wenn:

Um diese Option zur Anrufaufzeichnung verwenden zu können, müssen Sie Audio in Kinesis Video Streams (KVS) veröffentlichen und dann die CreateMediaInsightsPipeline API mit den KVS-Stream-Kanalinformationen und einem ARN für die Anrufanalysekonfiguration aufrufen.

Beim Aufruf der CreateMediaInsightsPipeline API können Sie wählen, ob Sie Fragmentnummern für jede KVS-Stream-Kanaldefinition angeben möchten oder nicht. Wenn Sie eine Fragmentnummer angeben, beginnt Call Analytics mit der Verarbeitung des Streams an diesem Fragment. Wenn Sie keine Fragment-ID angeben, beginnt Call Analytics mit der Verarbeitung des Streams ab dem neuesten verfügbaren Fragment.

Das folgende Diagramm zeigt den Datenfluss, wenn ein Voice Connector eine Anrufaufzeichnungssitzung initiiert. Die Zahlen im Diagramm entsprechen dem nummerierten Text unten.

Im Diagramm:

API-basierte Aufzeichnungen und Beispiele finden Sie unter Amazon S3-Aufzeichnungssenke in diesem Handbuch.

Die Beispiele in diesem Abschnitt erläutern, wie Sie Folgendes tun können:

Eine Konfiguration ausführen und eine Pipeline starten

Verwenden Sie den folgenden Befehl, um eine Konfiguration auszuführen und eine Media Insights-Pipeline zu starten. Die Datei pipeline.json enthält die Konfigurationseinstellungen.

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

Das folgende Beispiel zeigt eine typische Datei. 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
    }
}

Das MediaInsightsPipelineConfigurationArn ist der Konfigurations-ARN, den Sie erhalten, nachdem Sie eine Konfiguration für die Anrufanalyse erstellt haben.

Ziele, Namen und Formate festlegen

Im folgenden Beispiel wird ein Ordner verwendet, der MyRecordingBucket als S3SinkConfiguration.Destination Wert und Opus als RecordingFileFormat Wert benannt ist.

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

Im folgenden Beispiel wird MyRecordingBucket als S3SinkConfiguration.Destination Wert und Wav als RecordingFileFormat Wert verwendet.

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