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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Les rubriques de cette section répertorient et décrivent les flux de travail pour l'enregistrement des appels et des Kinesis Video Streams.

Utilisez ce flux de travail lorsque :

  • Vous utilisez déjà, ou prévoyez d'utiliser, un connecteur vocal pour intégrer le contenu multimédia SIP dans l'analyse des appels.

    Note

    Les connecteurs vocaux prennent en charge les protocoles SIP et SIPREC. Pour plus d'informations, reportez-vous à la section Gestion des connecteurs vocaux du SDK Amazon Chime, dans le guide de l'administrateur du SDK Amazon Chime.

  • Vous souhaitez enregistrer automatiquement les appels SIP ou SIPREC avec une faible latence vers les destinations Amazon Simple Storage Service de votre choix.

  • Vous souhaitez utiliser la console Amazon Chime SDK pour créer la configuration et l'associer à un connecteur vocal.

  • Vous souhaitez appliquer la même configuration d'enregistrement à chaque appel du Voice Connector. Si vous souhaitez appliquer plusieurs configurations à un ou plusieurs connecteurs vocaux, reportez-vous à la section suivante.

Pour activer les appels par programmation, utilisez le SDK Amazon Chime suivant. APIs

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'appels. Les chiffres du schéma correspondent au texte numéroté ci-dessous.

Image montrant le flux de données lorsqu'un connecteur vocal commence à enregistrer un appel.

Dans le schéma :

  1. Utilisez la console Amazon Chime SDK ou le CreateMediaInsightsPipelineConfigurationAPI pour créer une configuration d'analyse des appels. Au cours du processus de création de la configuration, il vous suffit d'activer l'enregistrement des appels, de choisir le format de fichier d'enregistrement souhaité et de spécifier la destination Amazon S3 pour le stockage des fichiers d'enregistrement. Pour plus d'informations, reportez-vous à la section Création de configurations d'analyse des appels dans le guide de l'administrateur du SDK Amazon Chime.

  2. Vous utilisez la console Amazon Chime SDK ou le PutVoiceConnectorStreamingConfigurationAPI pour associer la configuration à un connecteur vocal. Pour utiliser la console, reportez-vous à la section Configuration des connecteurs vocaux pour utiliser l'analyse des appels.

  3. Pendant un appel sortant, le connecteur vocal reçoit le son de chaque participant à l'appel.

  4. Si une configuration d'enregistrement d'analyse des appels est attachée au connecteur vocal, le service Voice Connector utilise le service de pipeline multimédia pour lancer une session d'enregistrement d'analyse des appels.

  5. Le service Media Pipeline lance le processeur d'enregistrement des appels qui surveille l'appel en cours.

  6. À la fin de l'appel, le service Media Pipeline envoie le fichier d'enregistrement des appels au compartiment Amazon S3 désigné et fournit les métadonnées d'enregistrement via le flux de données Amazon Kinesis. Si un entrepôt de données est activé, les métadonnées des appels sont également transmises à l'entrepôt de données Amazon Simple Storage Service. Dans les cas où le SIPREC est utilisé pour intégrer l'audio SIP dans l'analyse des appels, les métadonnées des appels incluent les métadonnées SIPREC sous forme de tableau. Pour plus d'informations sur les tables d'enregistrementComprendre les tables du catalogue de AWS Glue données pour le SDK Amazon Chime, reportez-vous à la section suivante.

  7. Le service Media Pipeline envoie les événements relatifs à l'état du pipeline à Amazon par défaut EventBridge. Pour plus d'informations, voir Utilisation EventBridge des notifications dans ce guide.

Note

Veuillez noter que vous devez activer le streaming par connecteur vocal pour permettre l'enregistrement avec un connecteur vocal. Cette fonctionnalité permet de diffuser les données d'appel vers Kinesis Video Streams géré par le Voice Connector dans votre compte. Pour plus d'informations, reportez-vous à la section Diffusion du contenu multimédia du SDK Amazon Chime Voice Connector vers Kinesis Video Streams dans le guide de l'administrateur du SDK Amazon Chime.

Vous pouvez également stocker les données d'appel créées par Voice Connector dans Kinesis Video Streams pendant des durées variables, allant de quelques heures à plusieurs jours, voire plusieurs années. Le fait de ne pas conserver de 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 du Voice Connector. Pour activer l'enregistrement des analyses d'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 définir une période de conservation des données appropriée.

Vous pouvez associer une configuration de pipeline Call Insights à 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 AWSService RoleForAmazonChimeVoiceConnector pour appeler CreateMediaInsightsPipelineAPI en votre nom une fois par numéro de transaction. Pour plus d'informations sur ce rôle, consultez la section Utilisation du rôle lié au service Amazon Chime SDK pour les connecteurs vocaux du SDK Amazon Chime dans le guide de l'administrateur du SDK Amazon Chime.

Vous enregistrez des flux vidéo Amazon Kinesis lorsque :

  • Vous devez appliquer des configurations différentes à un appel au lieu d'utiliser la même configuration pour chaque appel du Voice Connector.

  • Vous souhaitez enregistrer du son SIP ou non SIP qui n'est pas traité par un connecteur vocal.

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

Note

L'analyse des appels APIs prend en charge un maximum de deux canaux audio. Vous pouvez également activer le streaming du Voice Connector, puis utiliser les informations KVS publiées dans les EventBridge notifications du Voice Connector pour lancer un enregistrement d'appel.

Lorsque vous appelez le CreateMediaInsightsPipelineAPI, vous pouvez choisir de spécifier ou non les numéros de fragments 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 à partir de ce fragment. Si vous ne spécifiez pas d'ID de fragment, Call Analytics 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'appels. Les chiffres du schéma correspondent au texte numéroté ci-dessous.

Image montrant le flux de données lorsqu'un connecteur vocal commence à enregistrer un appel.

Dans le schéma :

  1. Vous pouvez utiliser la console Amazon Chime SDK ou CreateMediaInsightsPipelineConfigurationAPI pour créer une configuration d'enregistrement des appels.

  2. Utilisez le AWS SDK pour créer une application qui transfère le son externe dans le KVS, ou activez le streaming Voice Connector pour publier automatiquement le son des appels sur un KVS. Pour plus d'informations, consultez la section Diffusion du contenu multimédia Amazon Chime SDK Voice Connector vers Kinesis Video Streams dans le guide de l'administrateur du SDK Amazon Chime.

  3. Si le streaming Voice Connector est activé, le service Voice Connector envoie les notifications par défaut EventBridge.

  4. Dans le cas de la diffusion en continu du Voice Connector, votre application peut utiliser les STARTED événements de diffusion Amazon Chime Voice Connector EventBridge pour recueillir des informations sur le flux KVS concernant les étapes d'un appel.

  5. Une fois que votre application dispose des informations audio provenant des événements de streaming Voice Connector ou d'une source externe, elle invoque le SDK Amazon Chime CreateMediaInsightsPipelineAPI.

  6. Le service Media Pipeline lance le processeur d'enregistrement des appels qui surveille l'appel en cours.

  7. Le service Media Pipeline envoie les événements relatifs à l'état du pipeline à Amazon par défaut EventBridge. Pour plus d'informations, reportez-vous à la section Utilisation EventBridge des notifications.

  8. Une fois l'appel terminé, le service Media Pipeline transmet le fichier d'enregistrement des appels au compartiment Amazon S3 désigné et fournit les métadonnées d'enregistrement via Amazon Kinesis Data Stream. Si un entrepôt de données est activé, les métadonnées des appels seront également envoyées à l'entrepôt de données Amazon S3. Dans les cas où le SIPREC est utilisé pour intégrer l'audio SIP dans l'analyse des appels, les métadonnées des appels incluront les métadonnées SIPREC dans un format de tableau pratique. Pour plus d'informations sur les tables d'enregistrementComprendre les tables du catalogue de AWS Glue données pour le SDK Amazon Chime, reportez-vous à la section suivante.

  9. Votre application peut surveiller le pipeline et, dans le cas d'un connecteur vocal, le statut des appels à l'aide d'événements publiés sur Amazon EventBridge. Pour plus d'informations, voir Utilisation EventBridge des notifications dans ce guide.

  10. Pour terminer l'enregistrement, appelez le DeleteMediaPipelineAPI pour mettre fin à l'enregistrement des appels.

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

Les exemples présentés dans cette section expliquent comment effectuer les opérations suivantes :

  • Utilisez la CLI pour exécuter une configuration d'analyse des appels et invoquer le CreateMediaInsightsPipeline.

  • Utilisez la CLI pour spécifier les destinations d'enregistrement, les formats de fichiers audio et les noms de fichiers audio.

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 typique.

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