Comprendre les flux de travail pour l'enregistrement des appels pour le SDK Amazon Chime

Utilisez ce flux de travail lorsque :

Pour activer les appels par programmation, utilisez les API du SDK Amazon Chime suivantes.

Pour plus d'informations, consultez la section Configuration des connecteurs vocaux pour utiliser l'analyse des appels dans le Guide de l'administrateur du SDK Amazon Chime.

Le schéma suivant montre le flux de données lorsqu'un connecteur vocal lance une session d'enregistrement d'appel. Les chiffres du diagramme correspondent au texte numéroté ci-dessous.

Dans le schéma :

Vous pouvez également stocker les données d'appel créées par Voice Connector dans Kinesis Video Streams pour des durées variables, allant de quelques heures à plusieurs jours, voire plusieurs années. Le fait de ne pas conserver les données limite l'utilisabilité des données d'appel pour une consommation immédiate. Le coût de Kinesis Video Streams est déterminé en fonction de la bande passante et du stockage total utilisés. Vous pouvez ajuster la période de conservation des données à tout moment dans la configuration de streaming de Voice Connector. Pour activer l'enregistrement analytique des appels, vous devez vous assurer que le flux vidéo Kinesis conserve les données suffisamment longtemps pour effectuer l'analyse des appels. Pour ce faire, vous devez spécifier une période de conservation des données appropriée.

Vous pouvez associer une configuration de pipeline d'informations sur les appels à autant de connecteurs vocaux que vous le souhaitez. Vous pouvez également créer une configuration différente pour chaque connecteur vocal. Les connecteurs vocaux utilisent le AWSServiceRoleForAmazonChimeVoiceConnector pour appeler l'CreateMediaInsightsPipelineAPI en votre nom une fois par identifiant de transaction. Pour plus d'informations sur le rôle, consultez la section Utilisation du rôle lié au service Amazon Chime SDK pour les connecteurs vocaux Amazon Chime SDK dans le Guide de l'administrateur du SDK Amazon Chime.

Vous enregistrez des flux vidéo Amazon Kinesis lorsque :

Pour utiliser cette option d'enregistrement des appels, vous devez publier l'audio sur Kinesis Video Streams (KVS), puis appeler l'CreateMediaInsightsPipelineAPI avec les informations du canal de diffusion KVS et un ARN de configuration d'analyse des appels.

Lorsque vous appelez l'CreateMediaInsightsPipelineAPI, vous pouvez choisir de spécifier ou non des numéros de fragment pour chaque définition de canal de flux KVS. Si vous fournissez un numéro de fragment, l'analyse des appels commencera à traiter le flux correspondant à ce fragment. Si vous ne spécifiez pas d'ID de fragment, l'analyse des appels commence à traiter le flux à partir du dernier fragment disponible.

Le schéma suivant montre le flux de données lorsqu'un connecteur vocal lance une session d'enregistrement d'appel. Les chiffres du diagramme correspondent au texte numéroté ci-dessous.

Dans le schéma :

Pour un enregistrement basé sur une API et des exemples, consultez la section « récepteur d'enregistrement Amazon S3 » dans ce guide.

Les exemples de cette section expliquent comment procéder comme suit :

Exécution d'une configuration et démarrage d'un pipeline

Utilisez la commande suivante pour exécuter une configuration et démarrer un pipeline Media Insights. Le fichier pipeline.json contient les paramètres de configuration.

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

L'exemple suivant montre un pipeline.json fichier type.

{
    "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
    }
}

MediaInsightsPipelineConfigurationArnIl s'agit de l'ARN de configuration que vous recevez après avoir créé une configuration d'analyse des appels.

Définition des destinations, des noms et des formats

L'exemple suivant utilise un dossier nommé MyRecordingBucket comme S3SinkConfiguration.Destination valeur et Opus comme RecordingFileFormat valeur.

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

L'exemple suivant utilise MyRecordingBucket comme S3SinkConfiguration.Destination valeur et Wav comme RecordingFileFormat valeur.

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