Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo della trascrizione live di Amazon Chime SDK
Utilizzi la trascrizione live di Amazon Chime SDK per generare trascrizioni live delle riunioni attribuite all'utente. La trascrizione live di Amazon Chime SDK si integra con i servizi Amazon Transcribe e Amazon Transcribe Medical per generare trascrizioni delle riunioni SDK Amazon Chime mentre sono in corso.
La trascrizione live di Amazon Chime SDK elabora l'audio di ogni utente separatamente per una maggiore precisione in scenari con più altoparlanti. L'SDK Amazon Chime utilizza il suo algoritmo Active Talker per selezionare i primi due oratori attivi, quindi invia il loro audio ad Amazon Transcribe, in canali separati, tramite un unico flusso. I partecipanti alla riunione ricevono trascrizioni attribuite dall'utente tramite messaggi di dati SDK Amazon Chime. Puoi utilizzare le trascrizioni in vari modi, ad esempio visualizzando i sottotitoli, creando trascrizioni delle riunioni o utilizzando le trascrizioni per l'analisi del contenuto.
La trascrizione in tempo reale utilizza uno stream su Amazon Transcribe per tutta la durata della trascrizione della riunione. Si applicano i costi standard di Amazon Transcribe e Amazon Transcribe Medical. Per ulteriori informazioni, consulta i prezzi di [Amazon Transcribe](https://aws.amazon.com/transcribe/pricing/). Per domande sull'utilizzo o sulla fatturazione, contatta il tuo AWS account manager.
**Importante**
[Per impostazione predefinita, Amazon Transcribe può utilizzare e archiviare contenuti audio elaborati dal servizio per sviluppare e AWS migliorare i servizi AI/ML, come ulteriormente descritto nella sezione 50 dei Termini di servizio.AWS](https://aws.amazon.com/service-terms/) L'uso di Amazon Transcribe può essere soggetto a leggi o regolamenti federali e statali riguardanti la registrazione o l'intercettazione di comunicazioni elettroniche. È tua responsabilità e dei tuoi utenti finali rispettare tutte le leggi applicabili in materia di registrazione, inclusa la corretta notifica a tutti i partecipanti a una sessione o comunicazione registrata che la sessione o la comunicazione è in corso di registrazione e l'ottenimento di tutti i consensi necessari. Puoi scegliere di non AWS utilizzare contenuti audio per sviluppare e migliorare i servizi AWS AI/ML configurando una politica di disattivazione dei servizi di intelligenza artificiale utilizzando Organizations. AWS
**Topics**
+ [Architettura del sistema](#sys-architecture)
+ [Fatturazione e utilizzo](#billing-and-usage)
+ [Configurazione dell'account per la trascrizione live dell'SDK Amazon Chime](configure-transcribe.md)
+ [Scelta delle opzioni di trascrizione live di Amazon Chime SDK](transcription-options.md)
+ [Avvio e arresto della trascrizione live di Amazon Chime SDK](initiate-transcription.md)
+ [Parametri di trascrizione live di Amazon Chime SDK](#transcription-parameters)
+ [Informazioni sugli eventi di trascrizione live di Amazon Chime SDK](transcription-events.md)
+ [Informazioni sui messaggi di trascrizione live di Amazon Chime SDK](process-msgs.md)
+ [Elaborazione di un evento di trascrizione live ricevuto da Amazon Chime SDK](delivery-examples.md)
+ [Analisi delle trascrizioni dell'SDK Amazon Chime](parse-transcripts.md)
## Architettura del sistema
L'SDK Amazon Chime crea trascrizioni delle riunioni in tempo reale, senza che l'audio esca dalla AWS rete, tramite un'integrazione lato servizio con il tuo account Amazon Transcribe o Amazon Transcribe Medical. Per una maggiore precisione, l'audio degli utenti viene elaborato separatamente, quindi mixato alla riunione. L'SDK Amazon Chime utilizza il suo algoritmo Active Talker per selezionare i primi due oratori attivi, quindi invia il loro audio ad Amazon Transcribe o Amazon Transcribe Medical in canali separati tramite un unico flusso. Per ridurre la latenza, le trascrizioni attribuite dall'utente vengono inviate direttamente a ogni partecipante alla riunione tramite messaggi di dati. Quando si utilizza una pipeline multimediale per acquisire l'audio della riunione, vengono acquisite anche le informazioni di trascrizione della riunione.
![\[Un diagramma che mostra il flusso di dati della trascrizione delle riunioni.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/transcription-architecture.png)
## Fatturazione e utilizzo
La trascrizione in tempo reale utilizza uno streaming verso Amazon Transcribe o Amazon Transcribe Medical per tutta la durata della trascrizione della riunione. Si applicano i costi standard di Amazon Transcribe e Amazon Transcribe Medical. Per ulteriori informazioni, consulta la pagina dei prezzi di [Amazon Transcribe](https://aws.amazon.com/transcribe/pricing/). Per domande sull'utilizzo o sulla fatturazione, contatta il tuo AWS account manager.
# Configurazione dell'account per la trascrizione live dell'SDK Amazon Chime
Prima di poter utilizzare la trascrizione live di Amazon Chime SDK, devi concedere ad Amazon Chime SDK l'autorizzazione a chiamare Amazon Transcribe e Amazon Transcribe Medical nel tuo account. AWS A tale scopo, aggiungi il ruolo collegato al servizio Chime Transcription al tuo account. Per informazioni sulla creazione del ruolo collegato al servizio per la trascrizione in tempo reale, consulta [Using roles with live transcription nella](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-transcription.html) Amazon *Chime* SDK Administration Guide. [https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)
# Scelta delle opzioni di trascrizione live di Amazon Chime SDK
[Quando utilizzi la trascrizione live di Amazon Chime SDK, utilizzi Amazon Transcribe [o Amazon Transcribe](https://aws.amazon.com/transcribe/) Medical nel tuo account.](https://aws.amazon.com/transcribe/medical/) AWS [Hai accesso a tutte le [lingue di streaming supportate da Amazon Transcribe](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html), oltre a funzionalità [come vocabolari personalizzati](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary.html) e filtri di vocabolario.](https://docs.aws.amazon.com/transcribe/latest/dg/filter-unwanted-words.html) Quando usi Amazon Transcribe Medical, puoi scegliere una specialità medica, un tipo di conversazione e, facoltativamente, fornire un vocabolario personalizzato. Si applicano i costi standard di Amazon Transcribe e Amazon Transcribe Medical.
Il processo di scelta delle opzioni di trascrizione segue questi passaggi.
## Fase 1: Scelta di un servizio di trascrizione
Devi decidere quale servizio di trascrizione utilizzare, Amazon Transcribe [o](https://aws.amazon.com/transcribe/medical/) [Amazon Transcribe Medical](https://aws.amazon.com/transcribe/).
Se il tuo caso d'uso richiede funzionalità mediche di sintesi vocale, probabilmente vorrai utilizzare Amazon Transcribe Medical. Per tutti gli altri casi d'uso, probabilmente vorrai usare Amazon Transcribe.
Specifichi quale servizio di trascrizione utilizzare quando chiami l'API: `StartMeetingTranscription`
+ Per utilizzare Amazon Transcribe, specifica un con. `TranscriptionConfiguration` `EngineTranscribeSettings`
+ Per utilizzare Amazon Transcribe Medical, specifica un con. `TranscriptionConfiguration` `EngineTranscribeMedicalSettings`
## Fase 2: Scelta di una regione di trascrizione
Devi scegliere una AWS regione per il servizio di trascrizione. [Per informazioni sulle AWS regioni disponibili per Amazon Transcribe e Amazon Transcribe Medical, consulta la tabella dei servizi regionali.AWS](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)
In generale, la latenza più bassa tra la regione multimediale di una riunione e la regione di trascrizione offre la migliore esperienza utente. Per la latenza più bassa, utilizzate la stessa regione per i contenuti multimediali e la trascrizione quando possibile. Tuttavia, potresti avere altri fattori da considerare nella scelta di una regione, come i requisiti normativi o le regioni in cui hai configurato Amazon Transcribe o Amazon Transcribe Medical.
Le funzionalità di Amazon Transcribe e Amazon Transcribe Medical, come i vocabolari personalizzati o i filtri di vocabolario, sono specifiche della regione. Se configuri una di queste funzionalità, devi farlo in modo identico in tutte le regioni in cui intendi utilizzare la trascrizione in tempo reale. AWS In alternativa, puoi utilizzare la stessa regione Amazon Transcribe per tutte le riunioni.
Puoi specificare la regione utilizzata dal servizio di trascrizione. Puoi farlo aggiungendo il nome della regione al `Region` campo delle impostazioni del motore di trascrizione quando chiami l'API. `StartMeetingTranscription` Se non specifichi una regione, l'SDK Amazon Chime tenta di utilizzare il servizio di trascrizione nella regione multimediale della riunione. Per fare in modo che Amazon Chime SDK selezioni la regione per il servizio di trascrizione per te, specifica nel campo. `auto` `Region` In tal caso, Amazon Chime seleziona la regione del servizio di trascrizione in base alla regione multimediale della riunione, come descritto nelle tabelle seguenti. Per ulteriori informazioni sull'`StartMeetingTranscription`API, consulta questa guida. [Avvio e arresto della trascrizione live di Amazon Chime SDK](initiate-transcription.md)
**Nota**
La regione di trascrizione selezionata da Amazon Chime SDK è soggetta a modifiche poiché Amazon Chime SDK, AWS Amazon Transcribe e Amazon Transcribe Medical rendono disponibili più regioni.
**Selezione automatica della regione per Amazon Transcribe**
| Regione multimediale Amazon Chime SDK | Codice regione | Regione di trascrizione |
| --- | --- | --- |
| Stati Uniti orientali (Ohio) | us-east-2 | us-east-2 |
| US East (N. Virginia) | us-east-1 | us-east-1 |
| US West (N. California) | us-west-1 | us-west-2 |
| Stati Uniti occidentali (Oregon) | us-west-2 | us-west-2 |
| **Africa (Città del Capo) \$1** | af-south-1 | eu-west-2 |
| Asia Pacifico (Mumbai) | ap-south-1 | eu-west-2 |
| Asia Pacific (Seoul) | ap-northeast-2 | ap-northeast-2 |
| Asia Pacific (Singapore) | ap-southeast-1 | ap-northeast-1 |
| Asia Pacifico (Sydney) | ap-southeast-2 | ap-southeast-2 |
| Asia Pacific (Tokyo) | ap-northeast-1 | ap-northeast-1 |
| Canada (Central) | ca-central-1 | ca-central-1 |
| Europa (Francoforte) | eu-central-1 | eu-central-1 |
| Europe (Ireland) | eu-west-1 | eu-west-1 |
| Europe (London) | eu-west-2 | eu-west-2 |
| Europa (Milano) **\$1** | eu-south-1 | eu-central-1 |
| Europa (Parigi) | eu-west-3 | eu-central-1 |
| Europa (Stoccolma) | eu-north-1 | eu-central-1 |
| Sud America (San Paolo) | sa-east-1 | sa-east-1 |
| GovCloud (Stati Uniti orientali) | us-gov-east-1 | us-gov-west-1 |
| GovCloud (Stati Uniti occidentali) | us-gov-west-1 | us-gov-west-1 |
**Selezione automatica della regione per Amazon Transcribe Medical**
| Regione multimediale Amazon Chime SDK | Codice regione | Regione di trascrizione |
| --- | --- | --- |
| Stati Uniti orientali (Ohio) | us-east-2 | us-east-2 |
| US East (N. Virginia) | us-east-1 | us-east-1 |
| US West (N. California) | us-west-1 | us-west-2 |
| Stati Uniti occidentali (Oregon) | us-west-2 | us-west-2 |
| **Africa (Città del Capo) \$1** | af-south-1 | eu-west-1 |
| Asia Pacifico (Mumbai) | ap-south-1 | eu-west-1 |
| Asia Pacific (Seoul) | ap-northeast-2 | us-west-2 |
| Asia Pacifico (Singapore) | ap-southeast-1 | ap-southeast-2 |
| Asia Pacifico (Sydney) | ap-southeast-2 | ap-southeast-2 |
| Asia Pacific (Tokyo) | ap-northeast-1 | us-west-2 |
| Canada (Centrale) | ca-central-1 | ca-central-1 |
| Europa (Francoforte) | eu-central-1 | eu-west-1 |
| Europa (Irlanda) | eu-west-1 | eu-west-1 |
| Europe (London) | eu-west-2 | us-east-1 |
| Europa (Milano) **\$1** | eu-south-1 | eu-west-1 |
| Europa (Parigi) | eu-west-3 | eu-west-1 |
| Europa (Stoccolma) | eu-north-1 | eu-west-1 |
| Sud America (San Paolo) | sa-east-1 | us-east-1 |
**Nota**
Per utilizzare la trascrizione in tempo reale nelle regioni contrassegnate da un asterisco (**\$1**), devi prima abilitare la regione nel tuo account. AWS Per ulteriori informazioni, consulta [Abilitazione di una regione in.](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) Riferimenti generali di AWS
Per ulteriori informazioni sulle regioni e gli endpoint di ciascun servizio, consulta:
+ [Regioni multimediali SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)
+ [Endpoint e quote Amazon Transcribe](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region)
+ [Endpoint e quote Amazon Transcribe Medical](https://docs.aws.amazon.com/general/latest/gr/transcribe-medical.html)
## Fase 3: Rivedi le quote di servizio
Ogni riunione Amazon Chime SDK con trascrizione in tempo reale richiede esattamente un flusso HTTP/2 verso Amazon Transcribe o Amazon Transcribe Medical. Entrambi i servizi prevedono quote di servizio regionali per il numero di flussi HTTP/2 simultanei e per le transazioni start-stream al secondo. Per ulteriori informazioni sulle quote, consulta le [linee guida e le quote](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html) nella *Amazon Transcribe* Developer Guide. Per informazioni sugli aumenti delle quote, consulta Service Quotas nella AWS console.
# Avvio e arresto della trascrizione live di Amazon Chime SDK
Utilizzi 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 Amazon Chime SDK per avviare la trascrizione della riunione applicando a alla riunione. `TranscriptionConfiguration` Il controller Amazon Chime SDK inoltra la configurazione alla riunione in modo asincrono. L'esito positivo o negativo dell'avvio della trascrizione delle riunioni viene segnalato tramite un messaggio tramite Amazon Simple Notification Service (Amazon SNS) e Amazon. EventBridge
**Avvio della trascrizione**
Questo esempio mostra come avviare la trascrizione in tempo reale 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"
}
}
}
```
Questo esempio mostra come avviare la trascrizione in tempo reale 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`— Avvia la trascrizione della riunione.
`meetingId`[— L'ID della riunione, restituito dall'CreateMeetingAPI.](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax)
`TranscriptionConfiguration`— Incapsula i parametri per la trascrizione dal vivo. È necessario specificare esattamente una configurazione, oppure. `EngineTranscribeSettings` `EngineTranscribeMedicalSettings`
`EngineTranscribeSettings`: specifica l'uso di Amazon Transcribe e ne trasmette le impostazioni 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`: obbligatorio
`VocabularyFilterMethod` : Opzionale.
`VocabularyFilterName` : Opzionale.
`VocabularyName` : Opzionale.
`Region` : Opzionale.
`EnablePartialResultsStabilization` : Opzionale.
`PartialResultsStability` : Opzionale.
` ContentIdentificationType` : Opzionale.
`ContentRedactionType` : Opzionale.
`PiiEntityTypes ` : Opzionale.
`LanguageModelName` : Opzionale.
`EngineTranscribeMedicalSettings`— Speciifica l'uso di Amazon Transcribe Medical e ne trasmette le impostazioni 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`: obbligatorio
`Speciality`: obbligatorio
`Type`: obbligatorio
`VocabularyName` : Opzionale.
`Region` : Opzionale.
` ContentIdentificationType` : Opzionale.
**Risposte**
Amazon Transcribe e Amazon Transcribe Medical rispondono alle seguenti domande:
+ `OK`(200) con corpo vuoto, se lo hai inviato con successo alla `TranscriptionConfiguration` riunione.
**Messaggi di errore**
Amazon Transcribe e Amazon Transcribe Medical visualizzano i seguenti messaggi di errore:
+ **BadRequestException (400):** I parametri di input non corrispondono alle restrizioni del servizio.
+ **ForbiddenException (403):** Al client è permanentemente vietato effettuare la richiesta.
+ **NotFoundException (404):** `meetingId` Non esiste.
+ **ResourceLimitExceededException (400):** La richiesta supera il limite di risorse. Ad esempio, in troppe riunioni è abilitata la trascrizione dal vivo.
+ **ServiceFailureException (500):** Il servizio ha riscontrato un errore imprevisto.
+ **ServiceUnavailableException (503):** Il servizio non è attualmente disponibile.
+ **ThrottledClientException (429):** Il client ha superato il limite di frequenza delle richieste.
+ **UnauthorizedClientException (401):** Il client non è attualmente autorizzato a effettuare la richiesta.
`StartMeetingTranscription`Una seconda chiamata aggiorna l'`TranscriptionConfiguration`applicazione alla riunione.
**Interruzione della trascrizione**
Utilizzi 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 per rimuovere la `TranscriptionConfiguration` trascrizione di una determinata riunione `meetingID` e terminare. La fine di una riunione interrompe automaticamente la trascrizione.
Questo esempio mostra la sintassi della richiesta richiamata. `StopMeetingTranscription`
```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```
**Risposte**
Amazon Transcribe e Amazon Transcribe Medical rispondono alle seguenti domande:
+ `OK`(200) con corpo vuoto, se riesci a rimuoverlo dalla `TranscriptionConfiguration` riunione.
**Messaggi di errore**
Amazon Transcribe e Amazon Transcribe Medical visualizzano i seguenti messaggi di errore:
+ **BadRequestException (400):** I parametri di input non corrispondono alle restrizioni del servizio.
+ **ForbiddenException (403):** Al client è permanentemente vietato effettuare la richiesta.
+ **NotFoundException (404):** `meetingId` Non esiste.
+ **ServiceFailureException (500):** Il servizio ha riscontrato un errore imprevisto.
+ **ServiceUnavailableException (503):** Il servizio non è attualmente disponibile.
+ **ThrottledClientException (429):** Il client ha superato il limite di frequenza delle richieste.
+ **UnauthorizedClientException (401):** Il client non è attualmente autorizzato a effettuare la richiesta.
## Parametri di trascrizione live di Amazon Chime SDK
Amazon Transcribe e Amazon Transcribe APIs Medical offrono una serie di parametri per l'avvio della trascrizione in streaming, ad esempio e. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html) Puoi utilizzare t quei parametri nell'`StartMeetingTranscription`API a meno che l'SDK Amazon Chime non predetermini il valore del parametro. Ad esempio, i `MediaSampleRateHertz` parametri `MediaEncoding` and non sono disponibili perché l'SDK Amazon Chime li imposta automaticamente.
Amazon Transcribe e Amazon Transcribe Medical convalidano i parametri e ciò consente di utilizzare nuovi valori dei parametri non appena diventano disponibili. Ad esempio, se Amazon Transcribe Medical avvia il supporto per una nuova lingua, devi solo specificare il nuovo valore della lingua nel parametro. `LanguageCode`
# Informazioni sugli eventi di trascrizione live di Amazon Chime SDK
L'SDK Amazon Chime invia eventi del ciclo di vita della trascrizione, che puoi utilizzare per attivare notifiche e avviare flussi di lavoro a valle. Alcuni esempi di utilizzo degli eventi di trascrizione includono:
+ Misurazione dell'adozione della trascrizione in tempo reale nelle riunioni dell'SDK Amazon Chime
+ Monitoraggio delle preferenze linguistiche
Puoi inviare eventi ad Amazon EventBridge, Amazon Simple Notification Service e Amazon Simple Queue Service. Per ulteriori informazioni, consulta [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) nella *Amazon EventBridge User Guide*.
## È iniziata la trascrizione delle riunioni di Amazon Chime SDK
L'SDK Amazon Chime invia questo evento quando la trascrizione della riunione viene avviata o viene aggiornata. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo 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)": "{...}"
}
}
```
## La trascrizione delle riunioni di Amazon Chime SDK è stata interrotta
L'SDK Amazon Chime invia questo evento quando la trascrizione della riunione viene interrotta.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo 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)": "{...}"
}
}
```
## Interrotta la trascrizione della riunione Amazon Chime SDK
L'SDK Amazon Chime invia questo evento se la trascrizione della riunione viene interrotta.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo 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)": "{...}"
}
}
```
## Ripresa della trascrizione della riunione Amazon Chime SDK
L'SDK Amazon Chime invia questo evento se la trascrizione della riunione viene ripresa dopo un'interruzione.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo 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)": "{...}"
}
}
```
## Trascrizione della riunione Amazon Chime SDK non riuscita
L'SDK Amazon Chime invia questo evento se la trascrizione della riunione non viene avviata o non riesce a riprendere dopo un'interruzione.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo 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)": "{...}"
}
}
```
# Informazioni sui messaggi di trascrizione live di Amazon Chime SDK
Il servizio Amazon Chime SDK condivide le informazioni di trascrizione con i partecipanti inviando oggetti nei messaggi di dati. `TranscriptEvent` A fornisce un o un. `TranscriptEvent` `Transcript` `TranscriptionStatus`
A `Transcript` include risultati con parole e punteggiatura con data e ora attribuite dall'utente. Un risultato può essere «parziale», nel qual caso il sistema di solito lo aggiorna in un secondo momento. `TranscriptEvent` Ciò consente di visualizzare rapidamente le trascrizioni e di applicare gli aggiornamenti in linea in un secondo momento, se necessario.
A `TranscriptStatus` può fornire uno degli `TranscriptionStatusType` eventi, elencati nell'esempio nella sezione successiva.
Le versioni più recenti di Amazon SDKs Chime includono tipi di dati aggiuntivi e funzioni di supporto per l'elaborazione comune a. `TranscriptEvent`
## TranscriptEvent
Questo esempio mostra un tipico evento di trascrizione.
```
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;
}
```
## Linee guida sui dati
Tieni a mente queste linee guida mentre procedi.
1. `transcription.results`può avere più di un risultato.
1. Se`transcription.results[i].isPartial = true`, allora potrebbe esserci un aggiornamento per l'intero risultato. L'aggiornamento è probabile, ma non garantito. L'aggiornamento è lo stesso`transcript.result[i].resultId`. Se vuoi evitare trascrizioni con scarsa confidenza, puoi saltare completamente i risultati parziali. Se desideri risultati a bassa latenza, puoi visualizzare i risultati parziali e sovrascriverli completamente quando arriva l'aggiornamento.
1. `transcription.results[i].alternatives`contiene sempre almeno una voce. Se contiene più di una voce, la voce più sicura è la prima dell'elenco. Nella maggior parte dei casi, è possibile inserire la prima voce `transcription.results[i].alternatives` e ignorare le altre.
1. `transcription.results[i].alternatives[j].items`include una voce per ogni parola o segno di punteggiatura.
1. `transcription.results[i].alternatives[j].items[k].`il contenuto è ciò che è stato detto.
1. `transcription.results[i].alternatives[j].items[k].attendee`è l'attribuzione dell'utente (chi) del contenuto.
1. `transcription.results[i].alternatives[j].items[k].startTimeMs`è il «quando» del contenuto. Ciò consente la word-by-word riproduzione della trascrizione attribuita dall'utente tra diversi utenti nell'ordine in cui le parole sono state pronunciate.
1. Il `transcription.results[i].alternatives[j].items[k].endTimeMs` campo può generalmente essere ignorato, ma viene fornito per completezza di chi ha detto cosa e quando.
1. `transcription.results[i].alternatives[j].items[k].vocabularyFilterMatch`è vero se il contenuto corrisponde a una parola nel filtro, altrimenti è falso.
1. `transcription.results[i].alternatives[j].items[k].confidence`è un valore compreso tra 0 e 1. Indica la fiducia del motore che il contenuto dell'elemento corrisponde correttamente alla parola pronunciata, dove 0 è la confidenza più bassa e 1 la massima.
1. `transcription.results[i].alternatives[j].items[k].stable`indica se la parola corrente cambierà nei futuri aggiornamenti parziali dei risultati. Questo valore può essere vero solo se si abilita la funzione di stabilizzazione parziale dei risultati `EnablePartialResultsStabilization` impostando su `true` nella richiesta.
1. `transcription.results[i].alternatives[j].entities`include una voce per ogni entità rilevata dalle funzioni di Content Identification o Redaction. L'elenco viene compilato solo se abiliti l'identificazione o la redazione dei contenuti. Un'entità può essere costituita da dati quali informazioni di identificazione personale o informazioni sanitarie personali. Puoi utilizzare le entità per evidenziare o agire in base alle parole che ti interessano durante la trascrizione.
1. `transcription.results[i].alternatives[j].entities[k].category`è la categoria dell'entità. È uguale al tipo di identificazione o redazione del contenuto, ad esempio «PII» o «PHI», fornito nella richiesta.
1. `transcription.results[i].alternatives[j].entities[k].confidence`misura quanto sia forte il motore del fatto che quel particolare contenuto sia realmente un'entità. Nota che questo valore è diverso dalla confidenza a livello di elemento, che misura la fiducia del motore nella correttezza delle parole stesse.
1. `transcription.results[i].alternatives[j].entities[k].content`è il testo effettivo che costituisce l'entità. Può trattarsi di più elementi, ad esempio un indirizzo.
1. `transcription.results[i].alternatives[j].entities[k].startTimeMs`registra il momento in cui l'entità ha iniziato a essere parlata.
1. `transcription.results[i].alternatives[j].entities[k].endTimeMs`cattura l'ora in cui l'entità ha finito di essere parlata.
1. `transcription.results[i].alternatives[j].entities[k].type`è supportato solo per il motore Transcribe e fornisce il sottotipo dell'entità. Si tratta di valori come `ADDRESS`, `CREDIT\$1DEBIT\$1NUMBER` e così via.
## Registrazione di gestori di eventi per TranscriptEvents
I seguenti esempi utilizzano la libreria client Amazon Chime SDK per. JavaScript Tuttavia, lo schema è coerente in tutti gli Amazon Chime SDKs.
The `TranscriptionController` in the `RealtimeController` and `RealtimeControllerFacade` include funzioni specifiche per l'aggiunta di un gestore che elabora: `TranscriptionEvents`
```
/**
* Returns the [[TranscriptionController]] for this real-time controller.
*/
readonly transcriptionController?: TranscriptionController;
```
`TranscriptionController`Ha due funzioni per gestire l'iscrizione e l'annullamento dell'iscrizione ai callback: `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;
}
```
**Utilizzando l'opzione `TranscriptionController`**
Forniamo un'implementazione predefinita dell'`TranscriptionController`interfaccia denominata`DefaultTranscriptionController`. L'implementazione predefinita in `DefaultRealtimeController` e `DefaultAudioVideoFacade` restituisce un `DefaultTranscriptionController` oggetto:
```
/**
get transcriptionController(): TranscriptionController {
return this.realtimeController.transcriptionController;
}
```
`DefaultRealtimeController`accetta anche un `TranscriptionController` oggetto opzionale nel suo costruttore. Ciò consente di sovrascrivere il `DefaultTranscriptionController` comportamento. Le applicazioni per sviluppatori si iscrivono e annullano l'iscrizione a uno o più callback tramite l'`TranscriptionController`oggetto dell'oggetto: `AudioVideoFacade`
```
// Subscribe
this.audioVideo.transcriptionController?.subscribeToTranscriptEvent(this.transcriptEventHandler);
// Unsubscribe
this.audioVideo.transcriptionController?.unsubscribeFromTranscriptEvent(this.transcriptEventHandler););
```
# Elaborazione di un evento di trascrizione live ricevuto da Amazon Chime SDK
I seguenti esempi mostrano come elaborare un messaggio ricevuto. `TranscriptEvent`
**Nota**
L'output esatto dipende da diversi fattori, tra cui la velocità con cui le persone parlano e quando fanno una pausa.
## Esempio 1: StartMeetingTranscription
Questo esempio mostra un'`StartMeetingTranscription`operazione tipica.
```
meeting.StartMeetingTranscription(
{ EngineTranscribeSettings: { Languagecode: ‘en-US’ } } );
```
L'operazione genera un`TranscriptEvent`.
```
{
status: {
type: 'started',
eventTimeMs: 1620118800000,
transcriptionConfig: {
LanguageCode: 'en-US'
}
}
}
```
## Esempio 2: risultato di una trascrizione parziale
In questo esempio, un partecipante dice: «La veloce volpe bruna salta sopra il cane pigro». Nota che in questo esempio, il valore è`isPartial`. `true` Se esamini più a fondo il messaggio, puoi vedere che il sistema ha elaborato la parola «volpe» come «fatti». Il sistema utilizza lo stesso metodo `resultId` per aggiornare la trascrizione.
```
{
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
}]
}]
}]
}
}
```
## Esempio 3: risultato di una trascrizione finale
In caso di trascrizione parziale, il sistema elabora nuovamente la frase. Questo esempio ha un `isPartial` valore di `false` e il messaggio contiene «fox» anziché «facts». Il sistema riemette il messaggio utilizzando lo stesso ID.
```
{
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
}]
}]
}]
}
}
```
# Analisi delle trascrizioni dell'SDK Amazon Chime
Utilizzate il seguente comando per analizzare il contenuto della trascrizione da un messaggio di trascrizione. Il comando analizza le frasi complete dai file 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"])
```