Comprendere i flussi di lavoro per la registrazione delle chiamate per l'SDK Amazon Chime

Usa questo flusso di lavoro quando:

Per abilitare le chiamate a livello di codice, utilizza le seguenti API SDK Amazon Chime.

Per ulteriori informazioni, consulta Configurare i connettori vocali per utilizzare l'analisi delle chiamate nella Amazon Chime SDK Administrator Guide.

Il diagramma seguente mostra il flusso di dati quando un Voice Connector avvia una sessione di registrazione delle chiamate. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.

Nel diagramma:

Puoi anche archiviare i dati delle chiamate creati da Voice Connector in Kinesis Video Streams per durate variabili, che vanno da ore a giorni o addirittura anni. La scelta di non conservare i dati limita l'usabilità dei dati delle chiamate per il consumo immediato. Il costo di Kinesis Video Streams è determinato in base alla larghezza di banda e allo spazio di archiviazione totale utilizzati. È possibile regolare il periodo di conservazione dei dati in qualsiasi momento all'interno della configurazione di streaming di Voice Connector. Per abilitare la registrazione dell'analisi delle chiamate, dovete assicurarvi che Kinesis Video Stream conservi i dati abbastanza a lungo da condurre l'analisi delle chiamate. A tale scopo, è necessario specificare un periodo di conservazione dei dati adeguato.

Puoi associare una configurazione della pipeline di Call Insights a tutti i connettori vocali che desideri. Puoi anche creare una configurazione diversa per ogni Voice Connector. Voice Connectors utilizza il AWSServiceRoleForAmazonChimeVoiceConnector per chiamare l'CreateMediaInsightsPipelineAPI per tuo conto una volta per ID di transazione. Per informazioni sul ruolo, consulta Using the Amazon Chime SDK service-linked role for Amazon Chime SDK Voice Connectors nella Amazon Chime SDK Administrator Guide.

Registri stream di Amazon Kinesis Video quando:

Per utilizzare questa opzione di registrazione delle chiamate, è necessario pubblicare l'audio su Kinesis Video Streams (KVS) e quindi chiamare l'CreateMediaInsightsPipelineAPI con le informazioni sul canale di streaming KVS e un ARN di configurazione per l'analisi delle chiamate.

Quando si chiama l'CreateMediaInsightsPipelineAPI, è possibile scegliere se specificare o meno i numeri di frammento per ogni definizione di canale di streaming KVS. Se fornisci un numero di frammento, Call Analytics inizierà a processare lo stream in corrispondenza di quel frammento. Se non specifichi un ID di frammento, l'analisi delle chiamate inizia a elaborare lo stream a partire dall'ultimo frammento disponibile.

Il diagramma seguente mostra il flusso di dati quando un Voice Connector avvia una sessione di registrazione delle chiamate. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.

Nel diagramma:

Per la registrazione e gli esempi basati su API, consulta Amazon S3 recording sink in questa guida.

Gli esempi in questa sezione spiegano come eseguire le seguenti operazioni:

Esecuzione di una configurazione e avvio di una pipeline

Usa il seguente comando per eseguire una configurazione e avviare una pipeline di media insights. Il file pipeline.json contiene le impostazioni di configurazione.

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

L'esempio seguente mostra un file tipico. 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È l'ARN di configurazione che ricevi dopo aver creato una configurazione di analisi delle chiamate.

Impostazione di destinazioni, nomi e formati

L'esempio seguente utilizza una cartella denominata MyRecordingBucket come S3SinkConfiguration.Destination valore e Opus come RecordingFileFormat valore.

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

L'esempio seguente utilizza MyRecordingBucket come S3SinkConfiguration.Destination valore e Wav come RecordingFileFormat valore.

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