Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de la transcripción en directo de Amazon Chime Amazon Chime SDK
Utilice la transcripción en directo de Amazon Chime SDK para generar transcripciones en directo de sus reuniones atribuidas a los usuarios. La transcripción en directo de Amazon Chime SDK se integra con los servicios Amazon Transcribe y Amazon Transcribe Medical para generar transcripciones de las reuniones de Amazon Chime SDK mientras están en curso.
La transcripción en directo de Amazon Chime SDK procesa el audio de cada usuario por separado para mejorar la precisión en escenarios con varios altavoces. Amazon Chime SDK utiliza su algoritmo de altavoz activo para seleccionar los dos principales usuarios activos y, a continuación, envía su audio a Amazon Transcribe, en canales separados, mediante una sola transmisión. Los participantes de la reunión reciben transcripciones atribuidas a los usuarios a través de mensajes de datos de Amazon Chime SDK. Puede usar las transcripciones de diversas maneras, como mostrar subtítulos, crear transcripciones de reuniones o usar las transcripciones para analizar el contenido.
La transcripción en directo utiliza una transmisión para Amazon Transcribe durante la transcripción de la reunión. Se aplican las tarifas estándar de Amazon Transcribe y Amazon Transcribe Medical. Para obtener más información, consulte los precios de [Amazon Transcribe](https://aws.amazon.com/transcribe/pricing/). Si tienes preguntas sobre el uso o la facturación, ponte en contacto con tu administrador de AWS cuentas.
**importante**
[De forma predeterminada, Amazon Transcribe puede usar y almacenar contenido de audio procesado por el servicio para desarrollar y mejorar los servicios de AWS inteligencia artificial y aprendizaje automático, tal como se describe con más detalle en la sección 50 de las Condiciones del servicio.AWS](https://aws.amazon.com/service-terms/) El uso de Amazon Transcribe puede estar sujeto a las leyes o reglamentos federales y estatales relacionados con la grabación o la interceptación de comunicaciones electrónicas. Es su responsabilidad y la de los usuarios finales cumplir con todas las leyes aplicables en relación con la grabación, incluida la notificación adecuada a todos los participantes de una sesión o comunicación grabada de que la sesión o la comunicación se está grabando y obtener todos los consentimientos necesarios. Puede optar por no AWS usar contenido de audio para desarrollar y mejorar los servicios de AWS IA/ML configurando una política de exclusión de los servicios de IA mediante Organizations AWS .
**Topics**
+ [Arquitectura del sistema](#sys-architecture)
+ [Facturación y uso](#billing-and-usage)
+ [Configuración de la cuenta para la transcripción en vivo de Amazon Chime SDK](configure-transcribe.md)
+ [Selección de las opciones de transcripción en vivo de Amazon Chime SDK](transcription-options.md)
+ [Inicio y detención de la transcripción en vivo de Amazon Chime SDK](initiate-transcription.md)
+ [Parámetros de transcripción en vivo de Amazon Chime SDK](#transcription-parameters)
+ [Descripción de los eventos de transcripción en vivo de Amazon Chime SDK](transcription-events.md)
+ [Descripción de los mensajes de transcripción en vivo de Amazon Chime SDK](process-msgs.md)
+ [Procesamiento de un evento de transcripción en vivo de Amazon Chime SDK](delivery-examples.md)
+ [Análisis de las transcripciones del Amazon Chime SDK](parse-transcripts.md)
## Arquitectura del sistema
Amazon Chime SDK crea transcripciones de reuniones en tiempo real, sin que el audio salga de la red de AWS , mediante una integración del lado del servicio con su cuenta de Amazon Transcribe o Amazon Transcribe Medical. Para mejorar la precisión, el audio de los usuarios se procesa por separado y luego se mezcla en la reunión. Amazon Chime SDK utiliza su algoritmo de altavoz activo para seleccionar los dos altavoces más activos y, a continuación, envía su audio a Amazon Transcribe o Amazon Transcribe Medical en canales separados mediante una sola transmisión. Para reducir la latencia, las transcripciones atribuidas a los usuarios se envían directamente a todos los participantes de la reunión mediante mensajes de datos. Cuando se utiliza una canalización de medios para capturar el audio de la reunión, también se captura la información de transcripción de la reunión.
![\[Un diagrama que muestra el flujo de datos de la transcripción de la reunión.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/transcription-architecture.png)
## Facturación y uso
La transcripción en directo utiliza una transmisión a Amazon Transcribe o Amazon Transcribe Medical durante la transcripción de la reunión. Se aplican las tarifas estándar de Amazon Transcribe y Amazon Transcribe Medical. Para obtener más información, consulte [Precios de Amazon Transcribe](https://aws.amazon.com/transcribe/pricing/). Si tienes preguntas sobre el uso o la facturación, ponte en contacto con tu administrador de AWS cuentas.
# Configuración de la cuenta para la transcripción en vivo de Amazon Chime SDK
Antes de poder utilizar la transcripción en directo del SDK de Amazon Chime, debe conceder permiso al SDK de Amazon Chime para llamar a Amazon Transcribe y Amazon Transcribe Medical desde su cuenta. AWS Para ello, añada a su cuenta el rol vinculado al servicio Chime Transcription. Para obtener información sobre cómo crear el rol vinculado al servicio para la transcripción en vivo, consulte [Uso de roles con transcripción en vivo](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-transcription.html) en la *Guía de administración de Amazon Chime SDK*. Para obtener más información acerca roles vinculados a servicios de IAM, consulte [Roles vinculados a servicios](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) en la *Guía del usuario de IAM*.
# Selección de las opciones de transcripción en vivo de Amazon Chime SDK
Cuando utiliza la transcripción en directo de Amazon Chime SDK, utiliza Amazon [Transcribe o Amazon](https://aws.amazon.com/transcribe/) [Transcribe Medical en su cuenta de AWS .](https://aws.amazon.com/transcribe/medical/) Tiene acceso a todos los [lenguajes de transmisión compatibles con Amazon Transcribe](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html), además de características como los [vocabularios personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary.html) y los [filtros de vocabulario](https://docs.aws.amazon.com/transcribe/latest/dg/filter-unwanted-words.html). Al utilizar Amazon Transcribe Medical, puede elegir una especialidad médica, un tipo de conversación y, si lo desea, proporcionar cualquier vocabulario personalizado. Se aplican las tarifas estándar de Amazon Transcribe y Amazon Transcribe Medical.
El proceso de elección de las opciones de transcripción sigue estos pasos.
## Paso 1: Selección de un servicio de transcripción
Debe decidir qué servicio de transcripción utilizar, [Amazon Transcribe](https://aws.amazon.com/transcribe/) o [Amazon Transcribe Medical](https://aws.amazon.com/transcribe/medical/).
Si su caso de uso requiere funciones de conversión de voz a texto en el ámbito médico, probablemente desee utilizar Amazon Transcribe Medical. Para todos los demás casos de uso, probablemente desee utilizar Amazon Transcribe.
Al llamar a la API `StartMeetingTranscription`, debe especificar el servicio de transcripción que va a utilizar:
+ Para usar Amazon Transcribe, especifique un `TranscriptionConfiguration` con `EngineTranscribeSettings`.
+ Para usar Amazon Transcribe Medical, especifique un `TranscriptionConfiguration` con `EngineTranscribeMedicalSettings`.
## Paso 2: Selección de una región de transcripción
Debe elegir una AWS región para el servicio de transcripción. Para obtener información sobre las AWS regiones disponibles para Amazon Transcribe y Amazon Transcribe Medical, consulte [AWS la](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) tabla de servicios regionales.
En general, la latencia más baja entre la región multimedia y la región de transcripción de una reunión proporciona la mejor experiencia de usuario. Para obtener la menor latencia, utilice la misma región para los medios y la transcripción siempre que sea posible. Sin embargo, es posible que tenga que tener en cuenta otros factores al seleccionar una región, como los requisitos normativos o las regiones en las que ha configurado Amazon Transcribe o Amazon Transcribe Medical.
Las características de Amazon Transcribe y Amazon Transcribe Medical, como los vocabularios personalizados o los filtros de vocabulario, son específicas de cada región. Si configura alguna de esas funciones, debe hacerlo de forma idéntica en todas las AWS regiones en las que vaya a utilizar la transcripción en directo. Como alternativa, puede usar la misma región de Amazon Transcribe para todas las reuniones.
Puede especificar la región que utiliza el servicio de transcripción. Para ello, añada el nombre de la región de `Region` al campo de la configuración del motor de transcripción cuando llame a la API `StartMeetingTranscription`. Si no especifica una región, Amazon Chime SDK intentará utilizar el servicio de transcripción en la región multimedia de la reunión. Para que Amazon Chime SDK seleccione la región para el servicio de transcripción, especifique `auto` en el campo `Region`. Al hacerlo, Amazon Chime selecciona la región del servicio de transcripción en función de la región multimedia de la reunión, tal y como se describe en las tablas siguientes. Para obtener más información sobre la API `StartMeetingTranscription`, consulte [Inicio y detención de la transcripción en vivo de Amazon Chime SDK](initiate-transcription.md) en esta guía.
**nota**
La región de transcripción seleccionada por el SDK de Amazon Chime está sujeta a cambios AWS, ya que Amazon Chime SDK, Amazon Transcribe y Amazon Transcribe Medical ofrecen más regiones.
**Selección automática de región para Amazon Transcribe**
| Región multimedia de Amazon Chime Amazon Chime SDK | Código de región | Región de transcripción |
| --- | --- | --- |
| Este de EE. UU. (Ohio) | us-east-2 | us-east-2 |
| Este de EE. UU. (Norte de Virginia) | us-east-1 | us-east-1 |
| Oeste de EE. UU. (Norte de California) | us-west-1 | us-west-2 |
| Oeste de EE. UU. (Oregón) | us-west-2 | us-west-2 |
| África (Ciudad del Cabo)**\$1** | af-south-1 | eu-west-2 |
| Asia-Pacífico (Mumbai) | ap-south-1 | eu-west-2 |
| Asia-Pacífico (Seúl) | ap-northeast-2 | ap-northeast-2 |
| Asia-Pacífico (Singapur) | ap-southeast-1 | ap-northeast-1 |
| Asia-Pacífico (Sídney) | ap-southeast-2 | ap-southeast-2 |
| Asia-Pacífico (Tokio) | ap-northeast-1 | ap-northeast-1 |
| Canadá (centro) | ca-central-1 | ca-central-1 |
| Europa (Fráncfort) | eu-central-1 | eu-central-1 |
| Europa (Irlanda) | eu-west-1 | eu-west-1 |
| Europa (Londres) | eu-west-2 | eu-west-2 |
| Europa (Milán)**\$1** | eu-south-1 | eu-central-1 |
| Europa (París) | eu-west-3 | eu-central-1 |
| Europa (Estocolmo) | eu-north-1 | eu-central-1 |
| América del Sur (São Paulo) | sa-east-1 | sa-east-1 |
| GovCloud (Este de EE. UU.) | us-gov-east-1 | us-gov-west-1 |
| GovCloud (Estados Unidos-Oeste) | us-gov-west-1 | us-gov-west-1 |
**Selección automática de regiones para Amazon Transcribe Medical**
| Región multimedia de Amazon Chime Amazon Chime SDK | Código de región | Región de transcripción |
| --- | --- | --- |
| Este de EE. UU. (Ohio) | us-east-2 | us-east-2 |
| Este de EE. UU. (Norte de Virginia) | us-east-1 | us-east-1 |
| Oeste de EE. UU. (Norte de California) | us-west-1 | us-west-2 |
| Oeste de EE. UU. (Oregón) | us-west-2 | us-west-2 |
| África (Ciudad del Cabo)**\$1** | af-south-1 | eu-west-1 |
| Asia-Pacífico (Mumbai) | ap-south-1 | eu-west-1 |
| Asia-Pacífico (Seúl) | ap-northeast-2 | us-west-2 |
| Asia-Pacífico (Singapur) | ap-southeast-1 | ap-southeast-2 |
| Asia-Pacífico (Sídney) | ap-southeast-2 | ap-southeast-2 |
| Asia-Pacífico (Tokio) | ap-northeast-1 | us-west-2 |
| Canadá (centro) | ca-central-1 | ca-central-1 |
| Europa (Fráncfort) | eu-central-1 | eu-west-1 |
| Europa (Irlanda) | eu-west-1 | eu-west-1 |
| Europa (Londres) | eu-west-2 | us-east-1 |
| Europa (Milán)**\$1** | eu-south-1 | eu-west-1 |
| Europa (París) | eu-west-3 | eu-west-1 |
| Europa (Estocolmo) | eu-north-1 | eu-west-1 |
| América del Sur (São Paulo) | sa-east-1 | us-east-1 |
**nota**
Para utilizar la transcripción en directo en las regiones marcadas con un asterisco (**\$1**), primero debe habilitar la región en su cuenta de AWS . Para obtener más información, consulte [Cómo habilitar una región](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) en Referencia general de AWS.
Para obtener más información acerca de regiones y puntos de conexión, para cada servicio, consulte:
+ [Regiones multimedia de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)
+ [Puntos de conexión y cuotas de Amazon Transcribe](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region)
+ [Puntos de conexión y cuotas de Amazon Transcribe Medical](https://docs.aws.amazon.com/general/latest/gr/transcribe-medical.html)
## Paso 3: Revisar las Service Quotas
Cada reunión de Amazon Chime SDK con transcripción en directo requiere exactamente una transmisión HTTP/2 a Amazon Transcribe o Amazon Transcribe Medical. Ambos servicios tienen Service Quotas regionales para el número de transmisiones HTTP/2 simultáneas y para las transacciones de transmisión inicial por segundo. Para obtener más información sobre las cuotas, consulte [Directrices y cuotas](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html) en la *Guía para desarrolladores de Amazon Transcribe*. Para obtener información sobre los aumentos de cuota, consulte Service Quotas en la AWS consola.
# Inicio y detención de la transcripción en vivo de Amazon Chime SDK
Utilice la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html) de Amazon Chime SDK para iniciar la transcripción de la reunión aplicando un `TranscriptionConfiguration` a la reunión. El controlador de Amazon Chime SDK reenvía la configuración a la reunión de forma asíncrona. El éxito o el fracaso de la transcripción de la reunión se indica mediante un mensaje a través de Amazon Simple Notification Service (Amazon SNS) y Amazon. EventBridge
**Iniciar una transcripción**
En este ejemplo se muestra cómo iniciar una transcripción en directo con 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"
}
}
}
```
En este ejemplo se muestra cómo iniciar la transcripción en directo con 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`: inicia la transcripción de la reunión.
`meetingId`: el ID de la reunión, devuelto por la [API CreateMeeting](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax).
`TranscriptionConfiguration`: encapsula los parámetros de la transcripción en directo. Debe especificar exactamente una configuración, `EngineTranscribeSettings` o `EngineTranscribeMedicalSettings`.
`EngineTranscribeSettings`: especifica el uso de Amazon Transcribe y transfiere su configuración a [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`: obligatorio.
`VocabularyFilterMethod`: opcional.
`VocabularyFilterName`: opcional.
`VocabularyName`: opcional.
`Region`: opcional.
`EnablePartialResultsStabilization`: opcional.
`PartialResultsStability`: opcional.
` ContentIdentificationType`: opcional.
`ContentRedactionType`: opcional.
`PiiEntityTypes `: opcional.
`LanguageModelName`: opcional.
`EngineTranscribeMedicalSettings`: especifica el uso de Amazon Transcribe Medical y transfiere su configuración a [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`: obligatorio.
`Speciality`: obligatorio.
`Type`: obligatorio.
`VocabularyName`: opcional.
`Region`: opcional.
` ContentIdentificationType`: opcional.
**Respuestas**
Amazon Transcribe y Amazon Transcribe Medical responden a las siguientes preguntas:
+ `OK` (200) con el cuerpo vacío, si lo aplica correctamente `TranscriptionConfiguration` a la reunión.
**Mensajes de error**
Amazon Transcribe y Amazon Transcribe Medical muestran los siguientes mensajes de error:
+ **BadRequestException (400):** Los parámetros de entrada no coinciden con las restricciones del servicio.
+ **ForbiddenException (403):** El cliente tiene prohibido permanentemente realizar la solicitud.
+ **NotFoundException (404):** `meetingId` No existe.
+ **ResourceLimitExceededException (400):** La solicitud supera el límite de recursos. Por ejemplo, demasiadas reuniones tienen habilitada la transcripción en directo.
+ **ServiceFailureException (500):** El servicio detectó un error inesperado.
+ **ServiceUnavailableException (503):** El servicio no está disponible en este momento.
+ **ThrottledClientException (429):** El cliente superó el límite de frecuencia de solicitudes.
+ **UnauthorizedClientException (401):** El cliente no está autorizado actualmente a realizar la solicitud.
Si se llama a `StartMeetingTranscription` por segunda vez, se actualiza el `TranscriptionConfiguration` aplicado a la reunión.
**Detener una transcripción**
Utilice la API [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) para eliminar la `TranscriptionConfiguration` de una `meetingID` determinada y finalizar la transcripción de la reunión. Al finalizar una reunión, se detiene la transcripción automáticamente.
En este ejemplo se muestra la sintaxis de solicitud que invoca `StopMeetingTranscription`.
```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```
**Respuestas**
Amazon Transcribe y Amazon Transcribe Medical responden a las siguientes preguntas:
+ `OK` (200) con el cuerpo vacío, si elimina correctamente el `TranscriptionConfiguration` de la reunión.
**Mensajes de error**
Amazon Transcribe y Amazon Transcribe Medical muestran los siguientes mensajes de error:
+ **BadRequestException (400):** Los parámetros de entrada no coinciden con las restricciones del servicio.
+ **ForbiddenException (403):** El cliente tiene prohibido permanentemente realizar la solicitud.
+ **NotFoundException (404):** `meetingId` No existe.
+ **ServiceFailureException (500):** El servicio detectó un error inesperado.
+ **ServiceUnavailableException (503):** El servicio no está disponible en este momento.
+ **ThrottledClientException (429):** El cliente superó el límite de frecuencia de solicitudes.
+ **UnauthorizedClientException (401):** El cliente no está autorizado actualmente a realizar la solicitud.
## Parámetros de transcripción en vivo de Amazon Chime SDK
Amazon Transcribe y Amazon Transcribe APIs Medical ofrecen varios parámetros al iniciar la transcripción en streaming, como y. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html) Puede usar esos parámetros en la API `StartMeetingTranscription`, a menos que Amazon Chime SDK predetermine el valor del parámetro. Por ejemplo, los parámetros `MediaEncoding` y `MediaSampleRateHertz` no están disponibles porque Amazon Chime SDK los establece automáticamente.
Amazon Transcribe y Amazon Transcribe Medical validan los parámetros, lo que le permite utilizar nuevos valores de parámetros tan pronto como estén disponibles. Por ejemplo, si Amazon Transcribe Medical lanza la compatibilidad con un nuevo idioma, solo tiene que especificar el valor del nuevo idioma en el parámetro `LanguageCode`.
# Descripción de los eventos de transcripción en vivo de Amazon Chime SDK
Amazon Chime SDK envía eventos del ciclo de vida de la transcripción, que puede utilizar para activar notificaciones e iniciar flujos de trabajo posteriores. Algunos ejemplos de uso de eventos de transcripción incluyen:
+ Medición de la adopción de la transcripción en directo en las reuniones de Amazon Chime SDK
+ Seguimiento de las preferencias de idioma
Puedes enviar eventos a Amazon EventBridge, Amazon Simple Notification Service y Amazon Simple Queue Service. Para obtener más información, consulta la sección [Eventos de AWS los servicios](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) en la *Guía del EventBridge usuario de Amazon*.
## Transcripción de la reunión de Amazon Chime SDK iniciada
Amazon Chime SDK envía este evento cuando se inicia la transcripción de la reunión o se actualiza la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html).
**Ejemplo: datos del evento**
El siguiente es un ejemplo de los datos de este evento.
```
{
"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)": "{...}"
}
}
```
## Transcripción de la reunión de Amazon Chime SDK detenida
Amazon Chime SDK envía este evento cuando se detiene la transcripción de la reunión.
**Ejemplo: datos del evento**
El siguiente es un ejemplo de los datos de este evento.
```
{
"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)": "{...}"
}
}
```
## Transcripción de la reunión de Amazon Chime SDK interrumpida
Amazon Chime SDK envía este evento si se interrumpe la transcripción de la reunión.
**Ejemplo: datos del evento**
El siguiente es un ejemplo de los datos de este evento.
```
{
"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)": "{...}"
}
}
```
## Transcripción de la reunión de Amazon Chime SDK reanudada
Amazon Chime SDK envía este evento si la transcripción de la reunión se reanuda tras una interrupción.
**Ejemplo: datos del evento**
El siguiente es un ejemplo de los datos de este evento.
```
{
"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)": "{...}"
}
}
```
## Transcripción de la reunión de Amazon Chime SDK fallida
Amazon Chime SDK envía este evento si la transcripción de la reunión no se ha iniciado o no se ha reanudado tras una interrupción.
**Ejemplo: datos del evento**
El siguiente es un ejemplo de los datos de este evento.
```
{
"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)": "{...}"
}
}
```
# Descripción de los mensajes de transcripción en vivo de Amazon Chime SDK
El servicio Amazon Chime SDK comparte la información de transcripción con los asistentes mediante el envío de objetos de `TranscriptEvent` en mensajes de datos. Un `TranscriptEvent` entrega un `Transcript` o un `TranscriptionStatus`.
Un `Transcript` incluye los resultados con marcas de tiempo, palabras y signos de puntuación atribuidos al usuario. Un resultado puede ser «parcial», en cuyo caso el sistema normalmente lo actualiza en un `TranscriptEvent` posterior. Esto le permite ver las transcripciones rápidamente y aplicar las actualizaciones en línea más adelante, según sea necesario.
Un `TranscriptStatus` puede ofrecer uno de los eventos de `TranscriptionStatusType`, que se enumeran en el ejemplo de la siguiente sección.
Las versiones más recientes de Amazon Chime SDKs incluyen tipos de datos adicionales y funciones de ayuda para el procesamiento común a. `TranscriptEvent`
## TranscriptEvent
Este ejemplo muestra un evento de transcripción típico.
```
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;
}
```
## Directrices de datos
Tenga en cuenta estas pautas a medida que avanza.
1. `transcription.results` puede tener más de un resultado.
1. Si `transcription.results[i].isPartial = true`, es posible que haya una actualización para todo el resultado. La actualización es probable, pero no está garantizada. La actualización tiene el mismo `transcript.result[i].resultId`. Si desea evitar las transcripciones poco fiables, puede omitir por completo los resultados parciales. Si desea resultados de baja latencia, puede mostrar resultados parciales y sobrescribirlos por completo cuando llegue la actualización.
1. `transcription.results[i].alternatives` contiene siempre como mínimo una entrada. Si contiene más de una entrada, la entrada más segura será la primera de la lista. En la mayoría de los casos, puede realizar la primera entrada en `transcription.results[i].alternatives` e ignorar las demás.
1. `transcription.results[i].alternatives[j].items` incluye una entrada para cada palabra o signo de puntuación.
1. El contenido de `transcription.results[i].alternatives[j].items[k].` es lo que se ha dicho.
1. `transcription.results[i].alternatives[j].items[k].attendee` es la atribución (quién) del contenido por parte del usuario.
1. `transcription.results[i].alternatives[j].items[k].startTimeMs` es el «cuándo» del contenido. Esto permite word-by-word reproducir las transcripciones atribuidas al usuario entre diferentes usuarios en el orden en que se pronunciaron las palabras.
1. Por lo general, el campo `transcription.results[i].alternatives[j].items[k].endTimeMs` se puede ignorar, pero se proporciona para completar quién dijo qué y cuándo.
1. `transcription.results[i].alternatives[j].items[k].vocabularyFilterMatch` es verdadero si el contenido coincide con una palabra del filtro; de lo contrario, es falso.
1. `transcription.results[i].alternatives[j].items[k].confidence` es un valor comprendido entre 0 y 1. Indica la confianza del motor en que el contenido del elemento coincide correctamente con la palabra hablada, siendo 0 la confianza más baja y 1 la confianza más alta.
1. `transcription.results[i].alternatives[j].items[k].stable` indica si la palabra actual cambiará en futuras actualizaciones de resultados parciales. Este valor solo puede ser válido si habilita la característica de estabilización de resultados parciales configurando `EnablePartialResultsStabilization` como `true` en su solicitud.
1. `transcription.results[i].alternatives[j].entities` incluye una entrada para cada entidad que detecten las características de identificación o redacción de contenido. La lista solo se rellena si habilita la identificación o la redacción del contenido. Una entidad puede ser información como información de identificación personal o información de salud personal. Puede utilizar entidades para resaltar palabras de interés o tomar medidas al respecto durante la transcripción.
1. `transcription.results[i].alternatives[j].entities[k].category` es la categoría de la entidad. Es igual al tipo de identificación o redacción del contenido, como «PII» o «PHI», que se proporciona en la solicitud.
1. `transcription.results[i].alternatives[j].entities[k].confidence` mide la potencia del motor para que el contenido en particular sea realmente una entidad. Tenga en cuenta que esto es diferente de la confianza a nivel de elemento, que mide la confianza del motor en la exactitud de las propias palabras.
1. `transcription.results[i].alternatives[j].entities[k].content` es el texto real que constituye la entidad. Pueden ser varios elementos, como una dirección.
1. `transcription.results[i].alternatives[j].entities[k].startTimeMs` captura el momento en el que se empezó a hablar con la entidad.
1. `transcription.results[i].alternatives[j].entities[k].endTimeMs` captura el momento en el que la entidad terminó de hablar.
1. `transcription.results[i].alternatives[j].entities[k].type` solo es compatible con el motor de transcripción y proporciona el subtipo de la entidad. Estos son valores como “DIRECCIÓN”, “NÚMERO\$1TARJETA\$1CRÉDITO”, etc.
## Registro de controladores de eventos para TranscriptEvents
En los siguientes ejemplos se utiliza la biblioteca de cliente del SDK de Amazon Chime para. JavaScript Sin embargo, el patrón es uniforme en todos los Amazon Chime SDKs.
El `TranscriptionController` en el `RealtimeController` y `RealtimeControllerFacade` incluye funciones específicas para añadir un controlador que procese `TranscriptionEvents`:
```
/**
* Returns the [[TranscriptionController]] for this real-time controller.
*/
readonly transcriptionController?: TranscriptionController;
```
`TranscriptionController` tiene dos funciones para gestionar la suscripción y la cancelación de la suscripción a las devoluciones de llamadas de `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;
}
```
**Uso del `TranscriptionController` opcional**
Proporcionamos una implementación predeterminada de la interfaz de `TranscriptionController` denominada `DefaultTranscriptionController`. La implementación predeterminada en `DefaultRealtimeController` y `DefaultAudioVideoFacade` devuelve un objeto `DefaultTranscriptionController`:
```
/**
get transcriptionController(): TranscriptionController {
return this.realtimeController.transcriptionController;
}
```
`DefaultRealtimeController` también toma un objeto de `TranscriptionController` opcional en su constructor. Eso le permite anular el comportamiento de `DefaultTranscriptionController`. Las aplicaciones para desarrolladores se suscriben y cancelan la suscripción a una o más llamadas mediante el objeto de `TranscriptionController` del objeto `AudioVideoFacade`:
```
// Subscribe
this.audioVideo.transcriptionController?.subscribeToTranscriptEvent(this.transcriptEventHandler);
// Unsubscribe
this.audioVideo.transcriptionController?.unsubscribeFromTranscriptEvent(this.transcriptEventHandler););
```
# Procesamiento de un evento de transcripción en vivo de Amazon Chime SDK
En los siguientes ejemplos se muestra cómo procesar un `TranscriptEvent` recibido.
**nota**
El resultado exacto depende de varios factores, como la rapidez con la que las personas hablan y el momento en que hacen una pausa.
## Ejemplo 1: StartMeetingTranscription
En este ejemplo se muestra una operación de `StartMeetingTranscription` típica.
```
meeting.StartMeetingTranscription(
{ EngineTranscribeSettings: { Languagecode: ‘en-US’ } } );
```
La operación genera un `TranscriptEvent`.
```
{
status: {
type: 'started',
eventTimeMs: 1620118800000,
transcriptionConfig: {
LanguageCode: 'en-US'
}
}
}
```
## Ejemplo 2: Un resultado de transcripción parcial
En este ejemplo, un asistente dice: «El veloz zorro marrón salta sobre el perro perezoso». En este ejemplo, el valor de `isPartial` es `true`. Si profundiza en el mensaje, verá que el sistema ha procesado la palabra «zorro» como «hechos». El sistema usa la misma `resultId` para actualizar la transcripción.
```
{
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
}]
}]
}]
}
}
```
## Ejemplo 3: Un resultado de transcripción final
En el caso de una transcripción parcial, el sistema vuelve a procesar la frase. Este ejemplo `isPartial` tiene un valor de `false` y el mensaje contiene «zorro» en lugar de «hechos». El sistema vuelve a emitir el mensaje con el mismo identificador.
```
{
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
}]
}]
}]
}
}
```
# Análisis de las transcripciones del Amazon Chime SDK
Use el siguiente comando para analizar el contenido de la transcripción de un mensaje de transcripción. El comando analiza frases completas de los archivos 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"])
```