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.
# Utilisation de la transcription en direct du SDK Amazon Chime
Vous utilisez la transcription en direct du SDK Amazon Chime pour générer des transcriptions en direct attribuées par l'utilisateur de vos réunions. La transcription en direct du SDK Amazon Chime s'intègre aux services Amazon Transcribe et Amazon Transcribe Medical pour générer des transcriptions des réunions du SDK Amazon Chime pendant leur déroulement.
La transcription en direct du SDK Amazon Chime traite le son de chaque utilisateur séparément pour une meilleure précision dans les scénarios à haut-parleurs multiples. Le SDK Amazon Chime utilise son algorithme Active Talker pour sélectionner les deux principaux locuteurs actifs, puis envoie leur audio à Amazon Transcribe, sur des canaux distincts, via un flux unique. Les participants à la réunion reçoivent des transcriptions attribuées par l'utilisateur via les messages de données du SDK Amazon Chime. Vous pouvez utiliser les transcriptions de différentes manières, par exemple en affichant des sous-titres, en créant des transcriptions de réunions ou en utilisant les transcriptions pour l'analyse de contenu.
La transcription en direct utilise un flux vers Amazon Transcribe pendant toute la durée de la transcription de la réunion. Les frais médicaux standard d'Amazon Transcribe et Amazon Transcribe s'appliquent. Pour plus d'informations, consultez les tarifs d'[Amazon Transcribe.](https://aws.amazon.com/transcribe/pricing/) Pour toute question concernant l'utilisation ou la facturation, contactez votre responsable de AWS compte.
**Important**
[Par défaut, Amazon Transcribe peut utiliser et stocker du contenu audio traité par le service pour développer et améliorer les services d'intelligence artificielle et d'apprentissage AWS automatique, comme décrit plus en détail dans la section 50 des conditions de service.AWS](https://aws.amazon.com/service-terms/) L'utilisation d'Amazon Transcribe peut être soumise aux lois ou réglementations fédérales et nationales concernant l'enregistrement ou l'interception de communications électroniques. Il est de votre responsabilité et de celle de vos utilisateurs finaux de respecter toutes les lois applicables concernant l'enregistrement, notamment en informant correctement tous les participants à une session ou à une communication enregistrée que la session ou la communication est enregistrée, et en obtenant tous les consentements nécessaires. Vous pouvez refuser d' AWS utiliser du contenu audio pour développer et améliorer les services d' AWS IA et d'apprentissage automatique en configurant une politique de désinscription des services d'IA à l'aide de AWS Organizations.
**Topics**
+ [Architecture du système](#sys-architecture)
+ [Facturation et utilisation](#billing-and-usage)
+ [Configuration de votre compte pour la transcription en direct du SDK Amazon Chime](configure-transcribe.md)
+ [Choisir les options de transcription en direct du SDK Amazon Chime](transcription-options.md)
+ [Démarrage et arrêt de la transcription en direct du SDK Amazon Chime](initiate-transcription.md)
+ [Paramètres de transcription en direct du SDK Amazon Chime](#transcription-parameters)
+ [Comprendre les événements de transcription en direct du SDK Amazon Chime](transcription-events.md)
+ [Comprendre les messages de transcription en direct du SDK Amazon Chime](process-msgs.md)
+ [Traitement d'un événement de transcription en direct du SDK Amazon Chime reçu](delivery-examples.md)
+ [Analyse des transcriptions du SDK Amazon Chime](parse-transcripts.md)
## Architecture du système
Le SDK Amazon Chime crée des transcriptions de réunions en temps réel, sans que le son ne quitte le AWS réseau, via une intégration côté service avec votre compte Amazon Transcribe ou Amazon Transcribe Medical. Pour une précision accrue, le son des utilisateurs est traité séparément, puis mixé dans la réunion. Le SDK Amazon Chime utilise son algorithme Active Talker pour sélectionner les deux principaux locuteurs actifs, puis envoie leur audio à Amazon Transcribe ou Amazon Transcribe Medical sur des canaux distincts via un flux unique. Pour réduire la latence, les transcriptions attribuées à l'utilisateur sont envoyées directement à chaque participant à la réunion via des messages de données. Lorsque vous utilisez un pipeline multimédia pour capturer le son d'une réunion, les informations de transcription de la réunion sont également capturées.
![\[Schéma illustrant le flux de données de la transcription des réunions.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/transcription-architecture.png)
## Facturation et utilisation
La transcription en direct utilise un flux vers Amazon Transcribe ou Amazon Transcribe Medical pendant toute la durée de la transcription de la réunion. Les frais médicaux standard d'Amazon Transcribe et Amazon Transcribe s'appliquent. Pour plus d'informations, consultez les tarifs [d'Amazon Transcribe.](https://aws.amazon.com/transcribe/pricing/) Pour toute question concernant l'utilisation ou la facturation, contactez votre responsable de AWS compte.
# Configuration de votre compte pour la transcription en direct du SDK Amazon Chime
Avant de pouvoir utiliser la transcription en direct du SDK Amazon Chime, vous devez autoriser le SDK Amazon Chime à appeler Amazon Transcribe et Amazon Transcribe Medical sur votre compte. AWS Pour ce faire, ajoutez le rôle lié au service Chime Transcription à votre compte. Pour plus d'informations sur la création du rôle lié à un service pour la transcription en direct, consultez la section [Utilisation des rôles avec la transcription en direct](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-transcription.html) dans le guide d'administration du *SDK Amazon Chime*. Pour plus d'informations sur les rôles liés à un service IAM, reportez-vous à la section [Rôles liés à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) dans le guide de l'utilisateur *IAM*.
# Choisir les options de transcription en direct du SDK Amazon Chime
Lorsque vous utilisez la transcription en direct du SDK Amazon Chime, vous utilisez Amazon Transcribe [ou Amazon](https://aws.amazon.com/transcribe/) [Transcribe](https://aws.amazon.com/transcribe/medical/) Medical dans votre compte. AWS [Vous avez accès à toutes les [langues de streaming prises en charge par Amazon Transcribe](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html), ainsi qu'à des fonctionnalités telles que des [vocabulaires personnalisés](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary.html) et des filtres de vocabulaire.](https://docs.aws.amazon.com/transcribe/latest/dg/filter-unwanted-words.html) Lorsque vous utilisez Amazon Transcribe Medical, vous pouvez choisir une spécialité médicale, un type de conversation et éventuellement fournir un vocabulaire personnalisé. Les frais médicaux standard d'Amazon Transcribe et Amazon Transcribe s'appliquent.
Le processus de sélection des options de transcription suit les étapes suivantes.
## Étape 1 : Choisir un service de transcription
Vous devez choisir le service de transcription à utiliser, [Amazon Transcribe ou Amazon Transcribe](https://aws.amazon.com/transcribe/) [Medical](https://aws.amazon.com/transcribe/medical/).
Si votre cas d'utilisation nécessite des fonctionnalités de synthèse vocale médicale, vous souhaiterez probablement utiliser Amazon Transcribe Medical. Pour tous les autres cas d'utilisation, vous souhaiterez probablement utiliser Amazon Transcribe.
Vous spécifiez le service de transcription à utiliser lorsque vous appelez l'`StartMeetingTranscription`API :
+ Pour utiliser Amazon Transcribe, spécifiez un `TranscriptionConfiguration` avec. `EngineTranscribeSettings`
+ Pour utiliser Amazon Transcribe Medical, spécifiez un `TranscriptionConfiguration` avec. `EngineTranscribeMedicalSettings`
## Étape 2 : Choix d'une région de transcription
Vous devez choisir une AWS région pour le service de transcription. Pour plus d'informations sur les AWS régions disponibles pour Amazon Transcribe et Amazon Transcribe Medical, reportez-vous au tableau [AWS des](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) services régionaux.
En général, la latence la plus faible entre la région multimédia et la région de transcription d'une réunion garantit la meilleure expérience utilisateur. Pour une latence minimale, utilisez la même région pour les médias et la transcription dans la mesure du possible. Cependant, vous pouvez avoir d'autres facteurs à prendre en compte lors de la sélection d'une région, tels que les exigences réglementaires ou les régions dans lesquelles vous avez configuré Amazon Transcribe ou Amazon Transcribe Medical.
Les fonctionnalités d'Amazon Transcribe et Amazon Transcribe Medical, telles que les vocabulaires personnalisés ou les filtres de vocabulaire, sont spécifiques à chaque région. Si vous configurez l'une de ces fonctionnalités, vous devez le faire de la même manière dans toutes les AWS régions dans lesquelles vous souhaitez utiliser la transcription en direct. Vous pouvez également utiliser la même région Amazon Transcribe pour toutes les réunions.
Vous pouvez spécifier la région utilisée par le service de transcription. Pour ce faire, ajoutez le nom de la région `Region` dans le champ des paramètres du moteur de transcription lorsque vous appelez l'`StartMeetingTranscription`API. Si vous ne spécifiez pas de région, le SDK Amazon Chime tente d'utiliser le service de transcription dans la région multimédia de la réunion. Pour que le SDK Amazon Chime sélectionne pour vous la région du service de transcription, spécifiez-la `auto` dans le champ. `Region` Dans ce cas, Amazon Chime sélectionne la région du service de transcription en fonction de la région multimédia de la réunion, comme décrit dans les tableaux ci-dessous. Pour plus d'informations sur l'`StartMeetingTranscription`API, reportez-vous [Démarrage et arrêt de la transcription en direct du SDK Amazon Chime](initiate-transcription.md) à ce guide.
**Note**
La région de transcription sélectionnée par le SDK Amazon Chime est sujette à modification car le SDK Amazon AWS Chime, Amazon Transcribe et Amazon Transcribe Medical mettent à disposition d'autres régions.
**Sélection automatique des régions pour Amazon Transcribe**
| Région multimédia du SDK Amazon Chime | Code région | Région de transcription |
| --- | --- | --- |
| USA Est (Ohio) | us-east-2 | us-east-2 |
| USA Est (Virginie du Nord) | us-east-1 | us-east-1 |
| US West (N. California) | us-west-1 | us-west-2 |
| USA Ouest (Oregon) | us-west-2 | us-west-2 |
| Afrique (Le Cap) **\$1** | af-south-1 | eu-west-2 |
| Asie-Pacifique (Mumbai) | ap-south-1 | eu-west-2 |
| Asie-Pacifique (Séoul) | ap-northeast-2 | ap-northeast-2 |
| Asie-Pacifique (Singapour) | ap-southeast-1 | ap-northeast-1 |
| Asie-Pacifique (Sydney) | ap-southeast-2 | ap-southeast-2 |
| Asia Pacific (Tokyo) | ap-northeast-1 | ap-northeast-1 |
| Canada (Central) | ca-central-1 | ca-central-1 |
| Europe (Francfort) | eu-central-1 | eu-central-1 |
| Europe (Irlande) | eu-west-1 | eu-west-1 |
| Europe (Londres) | eu-west-2 | eu-west-2 |
| Europe (Milan) **\$1** | eu-south-1 | eu-central-1 |
| Europe (Paris) | eu-west-3 | eu-central-1 |
| Europe (Stockholm) | eu-north-1 | eu-central-1 |
| Amérique du Sud (São Paulo) | sa-east-1 | sa-east-1 |
| GovCloud (USA Est) | us-gov-east-1 | us-gov-west-1 |
| GovCloud (US-Ouest) | us-gov-west-1 | us-gov-west-1 |
**Sélection automatique des régions pour Amazon Transcribe Medical**
| Région multimédia du SDK Amazon Chime | Code région | Région de transcription |
| --- | --- | --- |
| USA Est (Ohio) | us-east-2 | us-east-2 |
| USA Est (Virginie du Nord) | us-east-1 | us-east-1 |
| US West (N. California) | us-west-1 | us-west-2 |
| USA Ouest (Oregon) | us-west-2 | us-west-2 |
| Afrique (Le Cap) **\$1** | af-south-1 | eu-west-1 |
| Asie-Pacifique (Mumbai) | ap-south-1 | eu-west-1 |
| Asie-Pacifique (Séoul) | ap-northeast-2 | us-west-2 |
| Asie-Pacifique (Singapour) | ap-southeast-1 | ap-southeast-2 |
| Asie-Pacifique (Sydney) | ap-southeast-2 | ap-southeast-2 |
| Asia Pacific (Tokyo) | ap-northeast-1 | us-west-2 |
| Canada (Centre) | ca-central-1 | ca-central-1 |
| Europe (Francfort) | eu-central-1 | eu-west-1 |
| Europe (Irlande) | eu-west-1 | eu-west-1 |
| Europe (Londres) | eu-west-2 | us-east-1 |
| Europe (Milan) **\$1** | eu-south-1 | eu-west-1 |
| Europe (Paris) | eu-west-3 | eu-west-1 |
| Europe (Stockholm) | eu-north-1 | eu-west-1 |
| Amérique du Sud (São Paulo) | sa-east-1 | us-east-1 |
**Note**
Pour utiliser la transcription en direct dans les régions marquées d'un astérisque (**\$1**), vous devez d'abord activer la région dans votre AWS compte. Pour plus d'informations, reportez-vous à la section [Activation d'une région](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) dans le Références générales AWS.
Pour plus d'informations sur les régions et les points de terminaison de chaque service, reportez-vous à :
+ [Régions multimédia du SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)
+ [Points de terminaison et quotas Amazon Transcribe](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region)
+ [Points de terminaison et quotas Amazon Transcribe Medical](https://docs.aws.amazon.com/general/latest/gr/transcribe-medical.html)
## Étape 3 : Réviser les quotas de service
Chaque réunion du SDK Amazon Chime avec transcription en direct nécessite exactement un flux HTTP/2 vers Amazon Transcribe ou Amazon Transcribe Medical. Les deux services ont des quotas de service régionaux pour le nombre de flux HTTP/2 simultanés et pour les transactions de début de flux par seconde. Pour plus d'informations sur les quotas, reportez-vous aux [directives et quotas](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html) du manuel *Amazon Transcribe Developer Guide*. Pour plus d'informations sur les augmentations de quotas, reportez-vous à la section Service Quotas dans la AWS console.
# Démarrage et arrêt de la transcription en direct du SDK Amazon Chime
Vous utilisez l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html)API du SDK Amazon Chime pour lancer la transcription de la réunion en appliquant un `TranscriptionConfiguration` à la réunion. Le contrôleur Amazon Chime SDK transmet la configuration à la réunion de manière asynchrone. Le succès ou l'échec du lancement de la transcription d'une réunion est signalé par un message via Amazon Simple Notification Service (Amazon SNS) et Amazon. EventBridge
**Commencer la transcription**
Cet exemple montre comment démarrer la transcription en direct avec Amazon Transcribe.
```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1
Content-type: application/json
{
"TranscriptionConfiguration": {
"EngineTranscribeSettings": {
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "en-US",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "tag",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "profanity",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "lingo",
"Region": "us-east-1"
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": true,
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "high",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "ALL",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "language-model"
}
}
}
```
Cet exemple montre comment démarrer la transcription en direct avec Amazon Transcribe Medical.
```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1
Content-type: application/json
{
"TranscriptionConfiguration": {
"EngineTranscribeMedicalSettings": {
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "en-US",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PRIMARYCARE",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "CONVERSATION",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "lingo",
"Region": "us-east-1",
"[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PHI",
}
}
}
```
`StartMeetingTranscription`— Lance la transcription de la réunion.
`meetingId`— L'identifiant de la réunion, renvoyé par l'[CreateMeetingAPI](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax).
`TranscriptionConfiguration`— Encapsule les paramètres pour la transcription en direct. Vous devez spécifier exactement une configuration, `EngineTranscribeSettings` ou`EngineTranscribeMedicalSettings`.
`EngineTranscribeSettings`— Spécifie l'utilisation d'Amazon Transcribe et transmet ses paramètres à. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters)
`LanguageCode` : obligatoire.
`VocabularyFilterMethod` : facultatif.
`VocabularyFilterName` : facultatif.
`VocabularyName` : facultatif.
`Region` : facultatif.
`EnablePartialResultsStabilization` : facultatif.
`PartialResultsStability` : facultatif.
` ContentIdentificationType` : facultatif.
`ContentRedactionType` : facultatif.
`PiiEntityTypes ` : facultatif.
`LanguageModelName` : facultatif.
`EngineTranscribeMedicalSettings`— Spécifie l'utilisation d'Amazon Transcribe Medical et transmet ses paramètres à. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters)
`LanguageCode` : obligatoire.
`Speciality` : obligatoire.
`Type` : obligatoire.
`VocabularyName` : facultatif.
`Region` : facultatif.
` ContentIdentificationType` : facultatif.
**Réponses**
Amazon Transcribe et Amazon Transcribe Medical répondent aux questions suivantes :
+ `OK`(200) avec un corps vide, si vous l'appliquez avec succès `TranscriptionConfiguration` à la réunion.
**Messages d’erreur**
Amazon Transcribe et Amazon Transcribe Medical affichent les messages d'erreur suivants :
+ **BadRequestException (400) :** Les paramètres d'entrée ne correspondent pas aux restrictions du service.
+ **ForbiddenException (403) :** Il est définitivement interdit au client de faire la demande.
+ **NotFoundException (404) :** Le `meetingId` n'existe pas.
+ **ResourceLimitExceededException (400) :** La demande dépasse la limite de ressources. Par exemple, la transcription en direct est activée pour de trop nombreuses réunions.
+ **ServiceFailureException (500) :** Le service a rencontré une erreur inattendue.
+ **ServiceUnavailableException (503) :** Le service est actuellement indisponible.
+ **ThrottledClientException (429) :** Le client a dépassé sa limite de taux de demandes.
+ **UnauthorizedClientException (401) :** Le client n'est actuellement pas autorisé à faire la demande.
Le fait `StartMeetingTranscription` d'appeler une deuxième fois met à jour les informations `TranscriptionConfiguration` appliquées à la réunion.
**Arrêt de la transcription**
Vous utilisez l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html)API pour supprimer la `TranscriptionConfiguration` transcription d'une réunion donnée `meetingID` et de fin de réunion. La fin d'une réunion arrête automatiquement la transcription.
Cet exemple montre la syntaxe de la demande qui `StopMeetingTranscription` invoque.
```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```
**Réponses**
Amazon Transcribe et Amazon Transcribe Medical répondent aux questions suivantes :
+ `OK`(200) avec un corps vide, si vous réussissez `TranscriptionConfiguration` à le supprimer de la réunion.
**Messages d’erreur**
Amazon Transcribe et Amazon Transcribe Medical affichent les messages d'erreur suivants :
+ **BadRequestException (400) :** Les paramètres d'entrée ne correspondent pas aux restrictions du service.
+ **ForbiddenException (403) :** Il est définitivement interdit au client de faire la demande.
+ **NotFoundException (404) :** Le `meetingId` n'existe pas.
+ **ServiceFailureException (500) :** Le service a rencontré une erreur inattendue.
+ **ServiceUnavailableException (503) :** Le service est actuellement indisponible.
+ **ThrottledClientException (429) :** Le client a dépassé sa limite de taux de demandes.
+ **UnauthorizedClientException (401) :** Le client n'est actuellement pas autorisé à faire la demande.
## Paramètres de transcription en direct du SDK Amazon Chime
Amazon Transcribe et Amazon Transcribe APIs Medical proposent un certain nombre de paramètres lors du lancement de la transcription en streaming, tels que et. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html) Vous pouvez utiliser ces paramètres dans l'`StartMeetingTranscription`API, sauf si le SDK Amazon Chime prédétermine la valeur du paramètre. Par exemple, les `MediaSampleRateHertz` paramètres `MediaEncoding` et ne sont pas disponibles car le SDK Amazon Chime les définit automatiquement.
Amazon Transcribe et Amazon Transcribe Medical valident les paramètres, ce qui vous permet d'utiliser de nouvelles valeurs de paramètres dès qu'elles sont disponibles. Par exemple, si Amazon Transcribe Medical lance la prise en charge d'une nouvelle langue, il vous suffit de spécifier la nouvelle valeur de langue dans le `LanguageCode` paramètre.
# Comprendre les événements de transcription en direct du SDK Amazon Chime
Le SDK Amazon Chime envoie des événements du cycle de vie de transcription, que vous pouvez utiliser pour déclencher des notifications et lancer des flux de travail en aval. Voici quelques exemples d'utilisation d'événements de transcription :
+ Mesurer l'adoption de la transcription en direct dans les réunions du SDK Amazon Chime
+ Suivi des préférences linguistiques
Vous pouvez envoyer des événements à Amazon EventBridge, Amazon Simple Notification Service et Amazon Simple Queue Service. Pour plus d'informations, reportez-vous à la section [Événements liés AWS aux services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) dans le *guide de EventBridge l'utilisateur Amazon*.
## La transcription de la réunion du SDK Amazon Chime a commencé
Le SDK Amazon Chime envoie cet événement lorsque la transcription de la réunion démarre ou est mise à jour. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)
**Exemple : données d'événements**
Voici un exemple de données pour cet événement.
```
{
"version": "0",
"source": "aws.chime",
"account": "111122223333",
"id": "12345678-1234-1234-1234-111122223333",
"region": "us-east-1",
"detail-type": "Chime Meeting State Change",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"eventType": "chime:TranscriptionStarted",
"timestamp": 12344566754,
"meetingId": "87654321-4321-4321-1234-111122223333",
"externalMeetingId": "mymeeting",
"mediaRegion": "us-west-1",
"transcriptionRegion": "us-west-2",
"[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html)": "{...}"
}
}
```
## La transcription de la réunion du SDK Amazon Chime s'est arrêtée
Le SDK Amazon Chime envoie cet événement lorsque la transcription de la réunion est arrêtée.
**Exemple : données d'événements**
Voici un exemple de données pour cet événement.
```
{
"version": "0",
"source": "aws.chime",
"account": "111122223333",
"id": "12345678-1234-1234-1234-111122223333",
"region": "us-east-1",
"detail-type": "Chime Meeting State Change",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"eventType": "chime:TranscriptionStopped",
"timestamp": 12344566754,
"meetingId": "87654321-4321-4321-1234-111122223333",
"externalMeetingId": "mymeeting",
"mediaRegion": "us-west-1",
"transcriptionRegion": "us-west-2",
"[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html)": "{...}"
}
}
```
## Interruption de la transcription de la réunion Amazon Chime SDK
Le SDK Amazon Chime envoie cet événement si la transcription de la réunion est interrompue.
**Exemple : données d'événements**
Voici un exemple de données pour cet événement.
```
{
"version": "0",
"source": "aws.chime",
"account": "111122223333",
"id": "12345678-1234-1234-1234-111122223333",
"region": "us-east-1",
"detail-type": "Chime Meeting State Change",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"eventType": "chime:TranscriptionInterrupted",
"timestamp": 12344566754,
"meetingId": "87654321-4321-4321-1234-111122223333",
"externalMeetingId": "mymeeting",
"message": "Internal server error",
"mediaRegion": "us-west-1",
"transcriptionRegion": "us-west-2",
"[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)": "{...}"
}
}
```
## Reprise de la transcription de la réunion Amazon Chime SDK
Le SDK Amazon Chime envoie cet événement si la transcription de la réunion est reprise après une interruption.
**Exemple : données d'événements**
Voici un exemple de données pour cet événement.
```
{
"version": "0",
"source": "aws.chime",
"account": "111122223333",
"id": "12345678-1234-1234-1234-111122223333",
"region": "us-east-1",
"detail-type": "Chime Meeting State Change",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"eventType": "chime:TranscriptionResumed",
"timestamp": 12344566754,
"meetingId": "87654321-4321-4321-1234-111122223333",
"externalMeetingId": "mymeeting",
"mediaRegion": "us-west-1",
"transcriptionRegion": "us-west-2",
"[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)": "{...}"
}
}
```
## Échec de la transcription de la réunion du SDK Amazon Chime
Le SDK Amazon Chime envoie cet événement si la transcription de la réunion ne démarre pas ou ne reprend pas après une interruption.
**Exemple : données d'événements**
Voici un exemple de données pour cet événement.
```
{
"version": "0",
"source": "aws.chime",
"account": "111122223333",
"id": "12345678-1234-1234-1234-111122223333",
"region": "us-east-1",
"detail-type": "Chime Meeting State Change",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"eventType": "chime:TranscriptionFailed",
"timestamp": 12344566754,
"meetingId": "87654321-4321-4321-1234-111122223333",
"externalMeetingId": "mymeeting",
"message": "Internal server error",
"mediaRegion": "us-west-1",
"transcriptionRegion": "us-west-2",
"[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)": "{...}"
}
}
```
# Comprendre les messages de transcription en direct du SDK Amazon Chime
Le service Amazon Chime SDK partage les informations de transcription avec les participants en envoyant des `TranscriptEvent` objets dans des messages de données. A `TranscriptEvent` livre un `Transcript` ou un`TranscriptionStatus`.
A `Transcript` inclut les résultats horodatés, les mots attribués par l'utilisateur et la ponctuation. Un résultat peut être « partiel », auquel cas le système le met généralement à jour ultérieurement`TranscriptEvent`. Cela vous permet de consulter rapidement les transcriptions et d'appliquer des mises à jour en ligne ultérieurement si nécessaire.
A `TranscriptStatus` peut présenter l'un des `TranscriptionStatusType` événements répertoriés dans l'exemple de la section suivante.
Les nouvelles versions d'Amazon Chime SDKs incluent des types de données supplémentaires et des fonctions d'assistance pour le traitement courant a. `TranscriptEvent`
## TranscriptEvent
Cet exemple montre un événement de transcription typique.
```
type TranscriptEvent = Transcript | TranscriptionStatus;
export class TranscriptEventConverter {
static from(dataMessage: DataMessage): TranscriptEvent[] {
// convert DataMessage to TranscriptEvents
return ...
}
}
export default class TranscriptionStatus {
type: TranscriptionStatusType;
eventTimeMs: number;
transcriptionRegion: string;
transcriptionConfiguration: string;
message?: string;
}
enum TranscriptionStatusType {
STARTED = 'started',
INTERRUPTED = 'interrupted',
RESUMED = 'resumed',
STOPPED = 'stopped',
FAILED = 'failed',
}
export default class Transcript {
results: TranscriptResult[]; // at least one
}
export class TranscriptResult {
resultId: string;
isPartial: boolean;
startTimeMs: number;
endTimeMs: number;
alternatives: TranscriptAlternative[]; // most confident first
}
export default class TranscriptAlternative {
items: TranscriptItem[]; // in start time order
transcript: string; //concatenated transcript items
entities?: TranscriptEntity[];
}
export default class TranscriptItem {
type: TranscriptItemType;
startTimeMs: number;
endTimeMs: number;
attendee: Attendee;
content: string;
vocabularyFilterMatch?: boolean;
confidence?: number;
stable?: boolean;
}
enum TranscriptItemType {
PRONUNCIATION = 'pronunciation',// content is a word
PUNCTUATION = 'punctuation',// content is punctuation
}
export default class TranscriptEntity {
category: string;
confidence: number;
content: string;
endTimeMs: number;
startTimeMs: number;
type?: string;
}
// This is an existing SDK model
export default class Attendee {
attendeeId: string;
externalUserId: string;
}
```
## Directives relatives aux données
Gardez ces directives à l'esprit au fur et à mesure.
1. `transcription.results`peut avoir plus d'un résultat.
1. Si c'est `transcription.results[i].isPartial = true` le cas, il se peut qu'il y ait une mise à jour pour l'ensemble du résultat. La mise à jour est probable, mais elle n'est pas garantie. Il en va de même pour la mise à jour`transcript.result[i].resultId`. Si vous souhaitez éviter les transcriptions peu fiables, vous pouvez ignorer complètement les résultats partiels. Si vous souhaitez obtenir des résultats à faible latence, vous pouvez afficher des résultats partiels, puis les remplacer complètement lorsque la mise à jour arrive.
1. `transcription.results[i].alternatives`contient toujours au moins une entrée. S'il contient plusieurs entrées, l'entrée la plus sûre est la première de la liste. Dans la plupart des cas, vous pouvez accepter la première entrée `transcription.results[i].alternatives` et ignorer les autres.
1. `transcription.results[i].alternatives[j].items`inclut une entrée pour chaque mot ou signe de ponctuation.
1. `transcription.results[i].alternatives[j].items[k].`le contenu est ce qui a été dit.
1. `transcription.results[i].alternatives[j].items[k].attendee`est l'attribution du contenu à l'utilisateur (qui).
1. `transcription.results[i].alternatives[j].items[k].startTimeMs`est le « quand » du contenu. Cela permet de word-by-word restituer la transcription attribuée par l'utilisateur à différents utilisateurs dans l'ordre dans lequel les mots ont été prononcés.
1. Le `transcription.results[i].alternatives[j].items[k].endTimeMs` champ peut généralement être ignoré, mais il est fourni par souci d'exhaustivité pour savoir qui a dit quoi et quand.
1. `transcription.results[i].alternatives[j].items[k].vocabularyFilterMatch`est vrai si le contenu correspond à un mot du filtre, sinon il est faux.
1. `transcription.results[i].alternatives[j].items[k].confidence`est une valeur comprise entre 0 et 1. Cela indique que le moteur est sûr que le contenu de l'élément correspond correctement au mot prononcé, 0 étant le niveau de confiance le plus faible et 1 le niveau de confiance le plus élevé.
1. `transcription.results[i].alternatives[j].items[k].stable`indique si le mot actuel sera modifié lors des futures mises à jour partielles des résultats. Cette valeur ne peut être vraie que si vous activez la fonction de stabilisation des résultats partiels `true` en `EnablePartialResultsStabilization` la définissant dans votre demande.
1. `transcription.results[i].alternatives[j].entities`inclut une entrée pour chaque entité détectée par les fonctionnalités d'identification du contenu ou de rédaction. La liste n'est remplie que si vous activez l'identification ou la rédaction du contenu. Une entité peut être constituée de données telles que des informations personnelles identifiables ou des informations personnelles sur la santé. Vous pouvez utiliser des entités pour mettre en évidence les mots qui vous intéressent ou agir sur ceux-ci lors de la transcription.
1. `transcription.results[i].alternatives[j].entities[k].category`est la catégorie de l'entité. Il correspond au type d'identification ou de rédaction du contenu, tel que « PII » ou « PHI », fourni dans la demande.
1. `transcription.results[i].alternatives[j].entities[k].confidence`mesure la puissance du moteur pour faire en sorte que le contenu en question soit réellement une entité. Notez que cela est différent de la confiance au niveau de l'élément, qui mesure le degré de confiance du moteur dans l'exactitude des mots eux-mêmes.
1. `transcription.results[i].alternatives[j].entities[k].content`est le texte réel qui constitue l'entité. Il peut s'agir de plusieurs éléments, tels qu'une adresse.
1. `transcription.results[i].alternatives[j].entities[k].startTimeMs`capture l'heure à laquelle l'entité a commencé à être parlée.
1. `transcription.results[i].alternatives[j].entities[k].endTimeMs`capture l'heure à laquelle l'entité a fini d'être prononcée.
1. `transcription.results[i].alternatives[j].entities[k].type`n'est pris en charge que pour le moteur Transcribe et fournit le sous-type de l'entité. Il s'agit de valeurs telles que `ADDRESS`, `CREDIT\$1DEBIT\$1NUMBER`, etc.
## Enregistrement de gestionnaires d'événements pour TranscriptEvents
Les exemples suivants utilisent la bibliothèque cliente du SDK Amazon Chime pour. JavaScript Cependant, le schéma est le même sur tous les Amazon Chime SDKs.
Le `TranscriptionController` in the `RealtimeController` et `RealtimeControllerFacade` inclut des fonctions spécifiques pour ajouter un gestionnaire qui traite `TranscriptionEvents` :
```
/**
* Returns the [[TranscriptionController]] for this real-time controller.
*/
readonly transcriptionController?: TranscriptionController;
```
`TranscriptionController`Il dispose de deux fonctions pour gérer l'abonnement et le désabonnement aux rappels : `TranscriptionEvent`
```
import TranscriptEvent from './TranscriptEvent';
export default interface TranscriptionController {
/**
* Subscribe a callback to handle received transcript event
*/
subscribeToTranscriptEvent(callback: (transcriptEvent: TranscriptEvent) => void): void;
/**
* Unsubscribe a callback from receiving transcript event
*/
unsubscribeFromTranscriptEvent(callback: (transcriptEvent: TranscriptEvent) => void): void;
}
```
**Utilisation de l'option `TranscriptionController`**
Nous fournissons une implémentation par défaut de `TranscriptionController` l'interface nommée`DefaultTranscriptionController`. L'implémentation par défaut dans `DefaultRealtimeController` et `DefaultAudioVideoFacade` renvoie un `DefaultTranscriptionController` objet :
```
/**
get transcriptionController(): TranscriptionController {
return this.realtimeController.transcriptionController;
}
```
`DefaultRealtimeController`prend également un `TranscriptionController` objet optionnel dans son constructeur. Cela vous permet de modifier le `DefaultTranscriptionController` comportement. Les applications de développement s'abonnent et se désabonnent à un ou plusieurs rappels via l'`TranscriptionController`objet de l'`AudioVideoFacade`objet :
```
// Subscribe
this.audioVideo.transcriptionController?.subscribeToTranscriptEvent(this.transcriptEventHandler);
// Unsubscribe
this.audioVideo.transcriptionController?.unsubscribeFromTranscriptEvent(this.transcriptEventHandler););
```
# Traitement d'un événement de transcription en direct du SDK Amazon Chime reçu
Les exemples suivants montrent comment traiter un reçu`TranscriptEvent`.
**Note**
Le résultat exact dépend de plusieurs facteurs, notamment de la rapidité avec laquelle les individus parlent et du moment où ils font une pause.
## Exemple 1 : StartMeetingTranscription
Cet exemple illustre une `StartMeetingTranscription` opération typique.
```
meeting.StartMeetingTranscription(
{ EngineTranscribeSettings: { Languagecode: ‘en-US’ } } );
```
L'opération génère un`TranscriptEvent`.
```
{
status: {
type: 'started',
eventTimeMs: 1620118800000,
transcriptionConfig: {
LanguageCode: 'en-US'
}
}
}
```
## Exemple 2 : un résultat de transcription partiel
Dans cet exemple, un participant dit : « Le rapide renard brun saute par-dessus le chien paresseux ». Notez que dans cet exemple, la `isPartial` valeur est`true`. Si vous examinez de plus près le message, vous constaterez que le système a traité le mot « renard » comme des « faits ». Le système utilise la même méthode `resultId` pour mettre à jour le relevé de notes.
```
{
transcript: {
results: [{
resultId:"1", isPartial: true,
startTimeMs: 1620118800000, endTimeMs: 1620118801000,
alternatives: [{
items:[{
type: 'pronunciation',
startTimeMs: 1620118800000, endTimeMs: 1620118800200,
attendee: { attendeeId: "1", externalUserId: "A"},
content: "the", vocabularyFilterMatch: false
},
{
type: 'pronunciation',
startTimeMs: 1620118800200, endTimeMs: 1620118800400,
attendee: { attendeeId: "1", externalUserId: "A" },
content:"quick", vocabularyFilterMatch: false
},
{
type:'pronunciation',
startTimeMs: 1620118800400, endTimeMs: 1620118800750,
attendee: { attendeeId: "1", externalUserId: "A" },
content:"brown", vocabularyFilterMatch: false
},
{
type:'pronunciation',
startTimeMs: 1620118800750, endTimeMs: 1620118801000,
attendee:{ attendeeId: "1", externalUserId: "A" },
content:"facts", vocabularyFilterMatch: false
},
{
type:'punctuation',
startTimeMs: 1620118801000, endTimeMs: 1620118801500,
attendee:{ attendeeId: "1", externalUserId: "A" },
content: ",", vocabularyFilterMatch: false
}]
}]
}]
}
}
```
## Exemple 3 : le résultat final de la transcription
En cas de transcription partielle, le système traite à nouveau la phrase. Cet exemple a une `isPartial` valeur de`false`, et le message contient « fox » au lieu de « facts ». Le système réémet le message en utilisant le même identifiant.
```
{
transcript: {
results: [{
resultId:"1", isPartial: false,
startTimeMs: 1620118800000, endTimeMs: 1620118801000,
alternatives: [{
items:[{
type: 'pronunciation',
startTimeMs: 1620118800000, endTimeMs: 1620118800200,
attendee: { attendeeId: "1", externalUserId: "A"},
content: "the", vocabularyFilterMatch: false
},
{
type: 'pronunciation',
startTimeMs: 1620118800200, endTimeMs: 1620118800400,
attendee: { attendeeId: "1", externalUserId: "A" },
content:"quick", vocabularyFilterMatch: false
},
{
type:'pronunciation',
startTimeMs: 1620118800400, endTimeMs: 1620118800750,
attendee: { attendeeId: "1", externalUserId: "A" },
content:"brown", vocabularyFilterMatch: false
},
{
type:'pronunciation',
startTimeMs: 1620118800750, endTimeMs: 1620118801000,
attendee: { attendeeId: "1", externalUserId: "A" },
content:"fox", vocabularyFilterMatch: false
},
{
type:'punctuation',
startTimeMs: 1620118801000, endTimeMs: 1620118801500,
attendee: { attendeeId: "1", externalUserId: "A" },
content: ",", vocabularyFilterMatch: false
}]
}]
}]
}
}
```
# Analyse des transcriptions du SDK Amazon Chime
Utilisez la commande suivante pour analyser le contenu d'un message de transcription. La commande analyse les phrases complètes à partir des fichiers transcript-message.txt.
```
with open('transcript-message.txt') as f:
for line in f:
result_json = json.loads(line)["transcript"]["results"][0]
if result_json['isPartial'] == False:
print(result_json["alternatives"][0]["transcript"])
```