

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Live-Transkription mit Amazon Chime SDK verwenden
<a name="meeting-transcription"></a>

Sie verwenden die Live-Transkription des Amazon Chime SDK, um Live-Transkripte Ihrer Besprechungen mit Benutzerattributionen zu erstellen. Die Live-Transkription von Amazon Chime SDK ist in die Dienste Amazon Transcribe und Amazon Transcribe Medical integriert, um während der Bearbeitung Transkripte von Amazon Chime SDK-Besprechungen zu generieren.

Die Live-Transkription des Amazon Chime SDK verarbeitet das Audio jedes Benutzers separat, um die Genauigkeit in Szenarien mit mehreren Lautsprechern zu verbessern. Das Amazon Chime SDK verwendet seinen aktiven Talker-Algorithmus, um die beiden aktivsten Sprecher auszuwählen, und sendet dann deren Audio in separaten Kanälen über einen einzigen Stream an Amazon Transcribe. Besprechungsteilnehmer erhalten vom Benutzer zugeordnete Transkriptionen über Amazon Chime SDK-Datennachrichten. Sie können Transkriptionen auf vielfältige Weise verwenden, z. B. um Untertitel anzuzeigen, Besprechungsprotokolle zu erstellen oder die Transkriptionen für die Inhaltsanalyse zu verwenden.

Bei der Live-Transkription wird für die Dauer der Meeting-Transkription ein Stream zu Amazon Transcribe verwendet. Es fallen die Standardkosten von Amazon Transcribe und Amazon Transcribe Medical an. Weitere Informationen finden Sie unter [Amazon Transcribe Pricing](https://aws.amazon.com/transcribe/pricing/). Bei Fragen zur Nutzung oder Abrechnung wenden Sie sich an Ihren AWS Kundenbetreuer.

**Wichtig**  
[Standardmäßig kann Amazon Transcribe vom Service verarbeitete Audioinhalte verwenden und speichern, um AWS KI/ML-Dienste zu entwickeln und zu verbessern, wie in Abschnitt 50 der Servicebedingungen näher beschrieben.AWS](https://aws.amazon.com/service-terms/) Die Nutzung von Amazon Transcribe kann bundesstaatlichen und staatlichen Gesetzen oder Vorschriften in Bezug auf die Aufzeichnung oder das Abfangen von elektronischer Kommunikation unterliegen. Es liegt in Ihrer Verantwortung und Ihren Endnutzern, alle geltenden Gesetze in Bezug auf die Aufzeichnung einzuhalten, einschließlich der ordnungsgemäßen Benachrichtigung aller Teilnehmer einer aufgezeichneten Sitzung oder Kommunikation darüber, dass die Sitzung oder Kommunikation aufgezeichnet wird, und alle erforderlichen Einwilligungen einzuholen. Sie können die AWS Verwendung von Audioinhalten zur Entwicklung und Verbesserung von AWS KI/ML-Diensten deaktivieren, indem Sie mithilfe AWS von Organizations eine Opt-Out-Richtlinie für KI-Dienste konfigurieren.

**Topics**
+ [Systemarchitektur](#sys-architecture)
+ [Abrechnung und Nutzung](#billing-and-usage)
+ [Konfiguration Ihres Kontos für Amazon Chime SDK Live-Transkription](configure-transcribe.md)
+ [Auswahl der Live-Transkriptionsoptionen für das Amazon Chime SDK](transcription-options.md)
+ [Live-Transkription des Amazon Chime SDK starten und beenden](initiate-transcription.md)
+ [Live-Transkriptionsparameter des Amazon Chime SDK](#transcription-parameters)
+ [Grundlegendes zu Live-Transkriptionsereignissen im Amazon Chime SDK](transcription-events.md)
+ [Live-Transkriptionsnachrichten des Amazon Chime SDK verstehen](process-msgs.md)
+ [Verarbeitung eines empfangenen Amazon Chime SDK-Live-Transkriptereignisses](delivery-examples.md)
+ [Analysieren von Amazon Chime SDK-Transkripten](parse-transcripts.md)

## Systemarchitektur
<a name="sys-architecture"></a>

Das Amazon Chime SDK erstellt über eine serviceseitige Integration mit Ihrem Amazon Transcribe- oder Amazon Transcribe Medical-Konto Besprechungstranskriptionen in Echtzeit, ohne dass Audio das AWS Netzwerk verlässt. Um die Genauigkeit zu erhöhen, werden die Audiodaten der Benutzer separat verarbeitet und dann in das Meeting gemischt. Das Amazon Chime SDK verwendet seinen aktiven Talker-Algorithmus, um die beiden aktivsten Sprecher auszuwählen, und sendet dann deren Audio in separaten Kanälen über einen einzigen Stream an Amazon Transcribe oder Amazon Transcribe Medical. Um die Latenz zu reduzieren, werden vom Benutzer zugeordnete Transkriptionen über Datennachrichten direkt an jeden Besprechungsteilnehmer gesendet. Wenn Sie eine Medienpipeline zur Audioaufnahme von Besprechungen verwenden, werden auch die Transkriptionsinformationen der Besprechung erfasst.

![\[Ein Diagramm, das den Datenfluss bei der Besprechungstranskription zeigt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/transcription-architecture.png)


## Abrechnung und Nutzung
<a name="billing-and-usage"></a>

Bei der Live-Transkription wird für die Dauer der Meeting-Transkription ein Stream zu Amazon Transcribe oder Amazon Transcribe Medical verwendet. Es fallen die Standardkosten von Amazon Transcribe und Amazon Transcribe Medical an. Weitere Informationen finden Sie unter [Amazon Transcribe Pricing.](https://aws.amazon.com/transcribe/pricing/) Bei Fragen zur Nutzung oder Abrechnung wenden Sie sich an Ihren AWS Kundenbetreuer.

# Konfiguration Ihres Kontos für Amazon Chime SDK Live-Transkription
<a name="configure-transcribe"></a>

Bevor Sie die Live-Transkription mit Amazon Chime SDK verwenden können, müssen Sie Amazon Chime SDK die Erlaubnis erteilen, Amazon Transcribe und Amazon Transcribe Medical in Ihrem Konto anzurufen. AWS Dazu fügen Sie Ihrem Konto die Rolle Chime Transcription hinzu, die mit dem Service verknüpft ist. Informationen zur Erstellung der serviceverknüpften Rolle für die Live-Transkription finden Sie unter [Rollen mit Live-Transkription verwenden](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-transcription.html) im *Amazon Chime* SDK-Administrationshandbuch. *Weitere Informationen zu serviceverknüpften IAM-Rollen finden Sie unter [Service Linked Roles im IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html).*

# Auswahl der Live-Transkriptionsoptionen für das Amazon Chime SDK
<a name="transcription-options"></a>

Wenn Sie die Live-Transkription des Amazon Chime SDK verwenden, verwenden Sie Amazon Transcribe oder [https://aws.amazon.com/transcribe/](https://aws.amazon.com/transcribe/) Medical in Ihrem Konto. AWS [Sie haben Zugriff auf alle [von Amazon Transcribe unterstützten Streaming-Sprachen](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html) sowie auf Funktionen wie [benutzerdefinierte Vokabulare](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary.html) und Vokabelfilter.](https://docs.aws.amazon.com/transcribe/latest/dg/filter-unwanted-words.html) Wenn Sie Amazon Transcribe Medical verwenden, können Sie ein medizinisches Fachgebiet und einen Konversationstyp auswählen und optional ein beliebiges benutzerdefiniertes Vokabular angeben. Es fallen die Standardkosten von Amazon Transcribe und Amazon Transcribe Medical an.

Der Prozess der Auswahl der Transkriptionsoptionen folgt diesen Schritten. 

## Schritt 1: Auswahl eines Transkriptionsdienstes
<a name="choose-service"></a>

Sie müssen entscheiden, welchen Transkriptionsdienst Sie verwenden möchten, [Amazon Transcribe oder [Amazon](https://aws.amazon.com/transcribe/medical/) Transcribe](https://aws.amazon.com/transcribe/) Medical. 

Wenn Ihr Anwendungsfall medizinische Sprach-zu-Text-Funktionen erfordert, möchten Sie wahrscheinlich Amazon Transcribe Medical verwenden. Für alle anderen Anwendungsfälle möchten Sie wahrscheinlich Amazon Transcribe verwenden.

Sie geben an, welcher Transkriptionsdienst verwendet werden soll, wenn Sie die API aufrufen: `StartMeetingTranscription`
+ Um Amazon Transcribe zu verwenden, geben Sie ein mit `TranscriptionConfiguration` an. `EngineTranscribeSettings` 
+ Um Amazon Transcribe Medical zu verwenden, geben Sie ein mit `TranscriptionConfiguration` an. `EngineTranscribeMedicalSettings`

## Schritt 2: Auswahl einer Transkriptionsregion
<a name="choose-region"></a>

Sie müssen eine AWS Region für den Transkriptionsdienst auswählen. [Informationen zu den verfügbaren AWS Regionen für Amazon Transcribe und Amazon Transcribe Medical finden Sie in der AWS Tabelle Regional Services.](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)

 Im Allgemeinen bietet die niedrigste Latenz zwischen der Medienregion und der Transkriptionsregion eines Meetings die beste Benutzererfahrung. Verwenden Sie für die niedrigste Latenz, wann immer möglich dieselbe Region für Medien und Transkription. Möglicherweise müssen Sie bei der Auswahl einer Region jedoch andere Faktoren berücksichtigen, z. B. gesetzliche Anforderungen oder die Regionen, in denen Sie Amazon Transcribe oder Amazon Transcribe Medical konfiguriert haben.

Die Funktionen von Amazon Transcribe und Amazon Transcribe Medical, wie z. B. benutzerdefinierte Vokabulare oder Vokabelfilter, sind regionsspezifisch. Wenn Sie eine dieser Funktionen konfigurieren, sollten Sie dies in allen AWS Regionen, in denen Sie die Live-Transkription verwenden möchten, identisch tun. Alternativ können Sie dieselbe Amazon Transcribe Transcribe-Region für alle Besprechungen verwenden.

Sie können die Region angeben, die der Transkriptionsservice verwendet. Sie tun dies, indem Sie den Namen der Region zum `Region` Feld der Einstellungen der Transkriptions-Engine hinzufügen, wenn Sie die `StartMeetingTranscription` API aufrufen. Wenn Sie keine Region angeben, versucht das Amazon Chime SDK, den Transkriptionsservice in der Medienregion des Meetings zu verwenden. Damit das Amazon Chime SDK die Region für den Transkriptionsservice für Sie auswählt, geben Sie diese `auto` in das `Region` Feld ein. Wenn Sie das tun, wählt Amazon Chime den Transkriptionsservice Region basierend auf der Medienregion des Meetings aus, wie in den folgenden Tabellen beschrieben. Weitere Informationen zur `StartMeetingTranscription` API finden Sie [Live-Transkription des Amazon Chime SDK starten und beenden](initiate-transcription.md) in diesem Handbuch.

**Anmerkung**  
Die vom Amazon Chime SDK ausgewählte Transkriptionsregion kann sich ändern AWS, da Amazon Chime SDK, Amazon Transcribe und Amazon Transcribe Medical mehr Regionen verfügbar machen.

**Automatische Regionsauswahl für Amazon Transcribe**  



|  Amazon Chime SDK Medienregion  |  Regionscode  |  Transkriptionsregion  | 
| --- | --- | --- | 
|  USA Ost (Ohio)  |  us-east-2  | us-east-2  | 
|  USA Ost (Nord-Virginia)  |  us-east-1  | us-east-1  | 
|  USA West (Nordkalifornien)  |  us-west-1  | us-west-2 | 
|  USA West (Oregon)  |  us-west-2  | us-west-2  | 
|  **Afrika (Kapstadt) \$1**  |  af-south-1  | eu-west-2  | 
|  Asien-Pazifik (Mumbai)  |  ap-south-1  | eu-west-2 | 
|  Asien-Pazifik (Seoul)  |  ap-northeast-2  | ap-northeast-2 | 
|  Asien-Pazifik (Singapur)  |  ap-southeast-1  | ap-northeast-1 | 
|  Asien-Pazifik (Sydney)  |  ap-southeast-2  | ap-southeast-2 | 
|  Asien-Pazifik (Tokio)  |  ap-northeast-1  | ap-northeast-1 | 
|  Kanada (Zentral)  |  ca-central-1  | ca-central-1 | 
|  Europa (Frankfurt)   |  eu-central-1  | eu-central-1  | 
|  Europa (Irland)  |  eu-west-1  | eu-west-1 | 
|  Europa (London)  |  eu-west-2  | eu-west-2  | 
|  Europa (Mailand) **\$1**  |  eu-south-1  | eu-central-1  | 
|  Europa (Paris)  |  eu-west-3  | eu-central-1  | 
|  Europa (Stockholm)  |  eu-north-1  | eu-central-1 | 
|  Südamerika (São Paulo)  |  sa-east-1  | sa-east-1 | 
|  GovCloud (US-Ost)  |  us-gov-east-1  |  us-gov-west-1  | 
|  GovCloud (US-West)  |  us-gov-west-1  |  us-gov-west-1  | 

**Automatische Regionsauswahl für Amazon Transcribe Medical**  



|  Amazon Chime SDK Medienregion  |  Regionscode  |  Transkriptionsregion  | 
| --- | --- | --- | 
|  USA Ost (Ohio)  |  us-east-2  | us-east-2 | 
|  USA Ost (Nord-Virginia)  |  us-east-1  | us-east-1 | 
|  USA West (Nordkalifornien)  |  us-west-1  | us-west-2 | 
|  USA West (Oregon)  |  us-west-2  | us-west-2 | 
|  **Afrika (Kapstadt) \$1**  |  af-south-1  |  eu-west-1  | 
|  Asien-Pazifik (Mumbai)  |  ap-south-1  | eu-west-1  | 
|  Asien-Pazifik (Seoul)  |  ap-northeast-2  | us-west-2 | 
|  Asien-Pazifik (Singapur)  |  ap-southeast-1  | ap-southeast-2 | 
|  Asien-Pazifik (Sydney)  |  ap-southeast-2  | ap-southeast-2 | 
|  Asien-Pazifik (Tokio)  |  ap-northeast-1  | us-west-2 | 
|  Kanada (Zentral)  |  ca-central-1  | ca-central-1 | 
|  Europa (Frankfurt)   |  eu-central-1  | eu-west-1 | 
|  Europa (Irland)  |  eu-west-1  | eu-west-1 | 
|  Europa (London)  |  eu-west-2  | us-east-1 | 
|  Europa (Mailand) **\$1**  |  eu-south-1  | eu-west-1 | 
|  Europa (Paris)  |  eu-west-3  | eu-west-1 | 
|  Europa (Stockholm)  |  eu-north-1  | eu-west-1 | 
|  Südamerika (São Paulo)  |  sa-east-1  | us-east-1 | 

**Anmerkung**  
Um die Live-Transkription in Regionen zu verwenden, die mit einem Sternchen (**\$1**) gekennzeichnet sind, müssen Sie zuerst die Region in Ihrem AWS Konto aktivieren. Weitere Informationen finden Sie unter [Aktivieren einer Region in der](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html). Allgemeine AWS-Referenz

Weitere Informationen zu den Regionen und Endpunkten der einzelnen Dienste finden Sie unter:
+ [Amazon Chime SDK Medienregionen](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)
+ [Amazon Transcribe Transcribe-Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region)
+ [Endpunkte und Kontingente von Amazon Transcribe Medical](https://docs.aws.amazon.com/general/latest/gr/transcribe-medical.html)

## Schritt 3: Überprüfen Sie die Servicekontingente
<a name="transcribe-quotas"></a>

Für jedes Amazon Chime SDK-Meeting mit Live-Transkription ist genau ein HTTP/2-Stream zu Amazon Transcribe oder Amazon Transcribe Medical erforderlich. Für beide Dienste gelten regionale Servicekontingente für die Anzahl gleichzeitiger HTTP/2-Streams und für Start-Stream-Transaktionen pro Sekunde. Weitere Informationen zu den Kontingenten finden Sie unter [Richtlinien und Kontingente](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html) im *Amazon Transcribe Developer Guide*. Informationen zu Kontingenterhöhungen finden Sie unter Service Quotas in der AWS Konsole.

# Live-Transkription des Amazon Chime SDK starten und beenden
<a name="initiate-transcription"></a>

Sie verwenden die Amazon Chime [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html)SDK-API, um die Meeting-Transkription zu initiieren, indem Sie a `TranscriptionConfiguration` auf das Meeting anwenden. Der Amazon Chime SDK-Controller leitet die Konfiguration asynchron an das Meeting weiter. Der Erfolg oder Misserfolg der Initiierung der Besprechungstranskription wird durch eine Nachricht über Amazon Simple Notification Service (Amazon SNS) und Amazon signalisiert. EventBridge

**Die Transkription wird gestartet**  
Dieses Beispiel zeigt, wie Sie die Live-Transkription mit Amazon Transcribe starten.

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

Dieses Beispiel zeigt, wie Sie die Live-Transkription mit Amazon Transcribe Medical starten.

```
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`— Startet die Transkription für das Meeting.  
`meetingId`— Die von der [CreateMeetingAPI](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax) zurückgegebene ID des Meetings.  
`TranscriptionConfiguration`— Kapselt die Parameter für die Live-Transkription. Sie müssen genau eine Konfiguration angeben, oder. `EngineTranscribeSettings` `EngineTranscribeMedicalSettings`

`EngineTranscribeSettings`— Spezifiziert die Verwendung von Amazon Transcribe und leitet dessen Einstellungen an weiter. [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` – Erforderlich.  
`VocabularyFilterMethod` – Optional.  
`VocabularyFilterName` – Optional.  
`VocabularyName` – Optional.  
`Region` – Optional.  
`EnablePartialResultsStabilization` – Optional.  
`PartialResultsStability` – Optional.  
` ContentIdentificationType` – Optional.  
`ContentRedactionType` – Optional.  
`PiiEntityTypes ` – Optional.  
`LanguageModelName` – Optional.

`EngineTranscribeMedicalSettings`— Spezifiziert die Verwendung von Amazon Transcribe Medical und leitet dessen Einstellungen an weiter. [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` – Erforderlich.  
`Speciality` – Erforderlich.  
`Type` – Erforderlich.  
`VocabularyName` – Optional.  
`Region` – Optional.  
` ContentIdentificationType` – Optional.

**Antworten**  
Amazon Transcribe und Amazon Transcribe Medical nehmen die folgenden Antworten entgegen:
+ `OK`(200) mit leerem Text, wenn Sie das erfolgreich auf das `TranscriptionConfiguration` Meeting anwenden.

**Fehlermeldungen**  
Amazon Transcribe und Amazon Transcribe Medical zeigen die folgenden Fehlermeldungen an:
+ **BadRequestException (400):** Die Eingabeparameter entsprechen nicht den Einschränkungen des Dienstes.
+ **ForbiddenException (403): Dem** Client ist es dauerhaft untersagt, die Anfrage zu stellen.
+ **NotFoundException (404):** Das `meetingId` existiert nicht.
+ **ResourceLimitExceededException (400):** Die Anfrage überschreitet das Ressourcenlimit. Beispielsweise ist bei zu vielen Besprechungen die Live-Transkription aktiviert.
+ **ServiceFailureException (500):** Beim Dienst ist ein unerwarteter Fehler aufgetreten.
+ **ServiceUnavailableException (503):** Der Dienst ist derzeit nicht verfügbar.
+ **ThrottledClientException (429):** Der Client hat sein Limit für die Anforderungsrate überschritten.
+ **UnauthorizedClientException (401):** Der Client ist derzeit nicht berechtigt, die Anfrage zu stellen.

Wenn Sie `StartMeetingTranscription` ein zweites Mal anrufen, `TranscriptionConfiguration` wird der für das Meeting verwendete Wert aktualisiert.

**Die Transkription wird beendet**  
Sie verwenden die [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, um die Transkription `TranscriptionConfiguration` für ein bestimmtes Meeting zu entfernen `meetingID` und zu beenden. Wenn Sie ein Meeting beenden, wird die Transkription automatisch beendet.

Dieses Beispiel zeigt die Anforderungssyntax, die aufgerufen wird`StopMeetingTranscription`.

```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```

**Antworten**  
Amazon Transcribe und Amazon Transcribe Medical nehmen die folgenden Antworten entgegen:
+ `OK`(200) mit leerem Text, wenn Sie den erfolgreich aus dem `TranscriptionConfiguration` Meeting entfernen.

**Fehlermeldungen**  
Amazon Transcribe und Amazon Transcribe Medical zeigen die folgenden Fehlermeldungen an:
+ **BadRequestException (400):** Die Eingabeparameter entsprechen nicht den Einschränkungen des Dienstes.
+ **ForbiddenException (403): Dem** Client ist es dauerhaft untersagt, die Anfrage zu stellen.
+ **NotFoundException (404):** Das `meetingId` existiert nicht.
+ **ServiceFailureException (500):** Der Dienst ist auf einen unerwarteten Fehler gestoßen.
+ **ServiceUnavailableException (503):** Der Dienst ist derzeit nicht verfügbar.
+ **ThrottledClientException (429):** Der Client hat sein Limit für die Anforderungsrate überschritten.
+ **UnauthorizedClientException (401):** Der Client ist derzeit nicht berechtigt, die Anfrage zu stellen.

## Live-Transkriptionsparameter des Amazon Chime SDK
<a name="transcription-parameters"></a>

Amazon Transcribe und Amazon Transcribe Medical APIs bieten beim Initiieren der Streaming-Transkription eine Reihe von Parametern, z. B. und. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html) Sie können diese Parameter in der `StartMeetingTranscription` API verwenden, es sei denn, das Amazon Chime SDK legt den Wert des Parameters fest. Beispielsweise sind die `MediaSampleRateHertz` Parameter `MediaEncoding` und nicht verfügbar, da das Amazon Chime SDK sie automatisch festlegt.

Amazon Transcribe und Amazon Transcribe Medical validieren die Parameter, sodass Sie neue Parameterwerte verwenden können, sobald sie verfügbar sind. Wenn Amazon Transcribe Medical beispielsweise die Unterstützung für eine neue Sprache einführt, müssen Sie nur den neuen Sprachwert im `LanguageCode` Parameter angeben. 

# Grundlegendes zu Live-Transkriptionsereignissen im Amazon Chime SDK
<a name="transcription-events"></a>

Das Amazon Chime SDK sendet Ereignisse im Transkriptionslebenszyklus, mit denen Sie Benachrichtigungen auslösen und nachgelagerte Workflows einleiten können. Einige Beispiele für die Verwendung von Transkriptionsereignissen sind:
+ Messung der Akzeptanz von Live-Transkription in Amazon Chime SDK-Besprechungen
+ Sprachpräferenzen verfolgen

Sie können Ereignisse an Amazon EventBridge, Amazon Simple Notification Service und Amazon Simple Queue Service senden. Weitere Informationen finden Sie unter [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) im * EventBridge Amazon-Benutzerhandbuch*.

## Die Transkription der Amazon Chime SDK-Besprechung wurde gestartet
<a name="transcript-start"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription gestartet oder aktualisiert [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)wird. 

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung wurde gestoppt
<a name="transcript-stop"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription gestoppt wird.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung wurde unterbrochen
<a name="transcript-interrupted"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription unterbrochen wird.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung wurde wieder aufgenommen
<a name="transcript-resumed"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Besprechungstranskription nach einer Unterbrechung wieder aufgenommen wird.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung ist fehlgeschlagen
<a name="transcript-failed"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription nicht gestartet oder nach einer Unterbrechung nicht fortgesetzt werden konnte.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

# Live-Transkriptionsnachrichten des Amazon Chime SDK verstehen
<a name="process-msgs"></a>

Der Amazon Chime SDK-Service gibt Transkriptionsinformationen an die Teilnehmer weiter, indem er `TranscriptEvent` Objekte in Datennachrichten sendet. A `TranscriptEvent` liefert ein `Transcript` oder ein. `TranscriptionStatus` 

A `Transcript` beinhaltet Ergebnisse mit Zeitstempel, vom Benutzer zugewiesenen Wörtern und Satzzeichen. Ein Ergebnis kann „teilweise“ sein. In diesem Fall aktualisiert das System es in der Regel zu einem späteren Zeitpunkt. `TranscriptEvent` Auf diese Weise können Sie Transkriptionen schnell einsehen und bei Bedarf später Inline-Aktualisierungen vornehmen.

A `TranscriptStatus` kann eines der `TranscriptionStatusType` Ereignisse auslösen, die im Beispiel im nächsten Abschnitt aufgeführt sind.

Neuere Versionen von Amazon Chime SDKs enthalten zusätzliche Datentypen und Hilfsfunktionen für die allgemeine Verarbeitung a. `TranscriptEvent`

## TranscriptEvent
<a name="transcript-event"></a>

Dieses Beispiel zeigt ein typisches Transkriptionsereignis.

```
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;
}
```

## Richtlinien für Daten
<a name="data-guidelines"></a>

Behalten Sie diese Richtlinien stets im Hinterkopf.

1. `transcription.results`kann mehr als ein Ergebnis haben.

1. Wenn`transcription.results[i].isPartial = true`, dann gibt es möglicherweise ein Update für das gesamte Ergebnis. Das Update ist wahrscheinlich, aber nicht garantiert. Das Update hat dasselbe`transcript.result[i].resultId`. Wenn Sie Transkriptionen mit geringer Zuverlässigkeit vermeiden möchten, können Sie Teilergebnisse komplett überspringen. Wenn Sie Ergebnisse mit niedriger Latenz wünschen, können Sie Teilergebnisse anzeigen und sie dann vollständig überschreiben, wenn das Update eintrifft.

1. `transcription.results[i].alternatives`enthält immer mindestens einen Eintrag. Wenn es mehr als einen Eintrag enthält, steht der vertrauenswürdigste Eintrag an erster Stelle in der Liste. In den meisten Fällen können Sie den ersten Eintrag übernehmen `transcription.results[i].alternatives` und die anderen ignorieren.

1. `transcription.results[i].alternatives[j].items`enthält einen Eintrag für jedes Wort oder Satzzeichen.

1. `transcription.results[i].alternatives[j].items[k].`Inhalt ist das, was gesprochen wurde.

1. `transcription.results[i].alternatives[j].items[k].attendee`ist die Benutzerzuweisung (wer) des Inhalts.

1. `transcription.results[i].alternatives[j].items[k].startTimeMs`ist das „Wann“ des Inhalts. Auf diese Weise kann die vom Benutzer zugeordnete Transkription für verschiedene Benutzer in der Reihenfolge word-by-word wiedergegeben werden, in der die Wörter gesprochen wurden.

1. Das `transcription.results[i].alternatives[j].items[k].endTimeMs` Feld kann im Allgemeinen ignoriert werden, wird aber nur der Vollständigkeit halber angegeben, wer was wann gesagt hat.

1. `transcription.results[i].alternatives[j].items[k].vocabularyFilterMatch`ist wahr, wenn der Inhalt mit einem Wort im Filter übereinstimmt, andernfalls ist es falsch.

1. `transcription.results[i].alternatives[j].items[k].confidence`ist ein Wert zwischen 0 und 1. Er gibt die Gewissheit der Engine an, dass der Inhalt des Elements korrekt mit dem gesprochenen Wort übereinstimmt, wobei 0 die niedrigste und 1 die höchste Konfidenz darstellt.

1. `transcription.results[i].alternatives[j].items[k].stable`gibt an, ob sich das aktuelle Wort bei future Aktualisierungen von Teilergebnissen ändern wird. Dieser Wert kann nur wahr sein, wenn Sie die Funktion zur Stabilisierung von Teilergebnissen aktivieren, indem Sie `true` in Ihrer Anfrage `EnablePartialResultsStabilization` auf einstellen.

1. `transcription.results[i].alternatives[j].entities`enthält einen Eintrag für jede Entität, die von den Funktionen zur Inhaltserkennung oder Redaktion erkannt wird. Die Liste wird nur aufgefüllt, wenn Sie die Option Inhaltsidentifizierung oder Schwärzung aktivieren. Bei einer Entität kann es sich um Daten wie personenbezogene Daten oder persönliche Gesundheitsinformationen handeln. Sie können Entitäten verwenden, um interessante Wörter während der Transkription hervorzuheben oder entsprechende Maßnahmen zu ergreifen.

1. `transcription.results[i].alternatives[j].entities[k].category`ist die Kategorie der Entität. Sie entspricht dem Typ „Inhaltsidentifikation“ oder „Redaktion“, wie z. B. „PII“ oder „PHI“, der in der Anfrage angegeben ist.

1. `transcription.results[i].alternatives[j].entities[k].confidence`misst, wie stark der Motor dafür ist, dass der jeweilige Inhalt wirklich eine Einheit ist. Beachten Sie, dass dies etwas anderes ist als die Konfidenz auf Artikelebene, mit der gemessen wird, wie sicher die Engine von der Richtigkeit der Wörter selbst ist.

1. `transcription.results[i].alternatives[j].entities[k].content`ist der eigentliche Text, aus dem die Entität besteht. Dies können mehrere Elemente sein, z. B. eine Adresse.

1. `transcription.results[i].alternatives[j].entities[k].startTimeMs`erfasst den Zeitpunkt, zu dem die Entität anfängt, gesprochen zu werden.

1. `transcription.results[i].alternatives[j].entities[k].endTimeMs`erfasst den Zeitpunkt, zu dem das Sprechen der Entität beendet wurde.

1. `transcription.results[i].alternatives[j].entities[k].type`wird nur für die Transcribe-Engine unterstützt und stellt den Untertyp der Entität bereit. Dies sind Werte wie `ADDRESS`, `CREDIT\$1DEBIT\$1NUMBER` usw.

## Registrierung von Event-Handlern für TranscriptEvents
<a name="register-handler"></a>

In den folgenden Beispielen wird die Amazon Chime SDK-Clientbibliothek für JavaScript verwendet. Das Muster ist jedoch in allen Amazon Chime SDKs einheitlich.

Das `TranscriptionController` im `RealtimeController` und `RealtimeControllerFacade` beinhaltet spezifische Funktionen zum Hinzufügen eines Handlers, der Folgendes verarbeitet`TranscriptionEvents`:

```
/** 
 * Returns the [[TranscriptionController]] for this real-time controller. 
 */
readonly transcriptionController?: TranscriptionController;
```

Der `TranscriptionController` hat zwei Funktionen zur Verwaltung des An- und Abmeldens von Callbacks: `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;
}
```

**Verwenden der optionalen `TranscriptionController`**  
Wir bieten eine Standardimplementierung der `TranscriptionController` Schnittstelle named`DefaultTranscriptionController`. Die Standardimplementierung in `DefaultRealtimeController` und `DefaultAudioVideoFacade` gibt ein `DefaultTranscriptionController` Objekt zurück:

```
/** 
get transcriptionController(): TranscriptionController {
   return this.realtimeController.transcriptionController;
}
```

`DefaultRealtimeController`nimmt auch ein optionales `TranscriptionController` Objekt in seinen Konstruktor auf. Dadurch können Sie das `DefaultTranscriptionController` Verhalten überschreiben. Entwickleranwendungen abonnieren oder kündigen einen oder mehrere Callbacks über das `TranscriptionController` Objekt des `AudioVideoFacade` Objekts:

```
// Subscribe
this.audioVideo.transcriptionController?.subscribeToTranscriptEvent(this.transcriptEventHandler);

// Unsubscribe
this.audioVideo.transcriptionController?.unsubscribeFromTranscriptEvent(this.transcriptEventHandler););
```

# Verarbeitung eines empfangenen Amazon Chime SDK-Live-Transkriptereignisses
<a name="delivery-examples"></a>

Die folgenden Beispiele zeigen, wie eine empfangene Datei verarbeitet wird. `TranscriptEvent`

**Anmerkung**  
Die genaue Leistung hängt von mehreren Faktoren ab, unter anderem davon, wie schnell Personen sprechen und wann sie eine Pause einlegen.

## Beispiel 1: StartMeetingTranscription
<a name="example-1"></a>

Dieses Beispiel zeigt eine typische `StartMeetingTranscription` Operation.

```
meeting.StartMeetingTranscription(
    { EngineTranscribeSettings: { Languagecode: ‘en-US’ } } );
```

Die Operation generiert eine`TranscriptEvent`.

```
{   
    status: {        
        type: 'started',        
        eventTimeMs: 1620118800000,        
        transcriptionConfig: {                    
            LanguageCode: 'en-US'        
        }    
    }
}
```

## Beispiel 2: Ein teilweises Transkriptergebnis
<a name="example-2"></a>

In diesem Beispiel sagt ein Teilnehmer: „Der schnelle braune Fuchs springt über den faulen Hund.“ Beachten Sie, dass in diesem Beispiel der `isPartial` Wert ist. `true` Wenn Sie sich die Nachricht genauer ansehen, können Sie feststellen, dass das System das Wort „Fuchs“ als „Fakten“ verarbeitet hat. Das System verwendet dasselbe`resultId`, um das Protokoll zu aktualisieren. 

```
{
    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
                }]
            }]
        }]
    }
}
```

## Beispiel 3: Ein endgültiges Transkriptergebnis
<a name="example-3"></a>

Im Falle eines unvollständigen Transkripts verarbeitet das System die Phrase erneut. Dieses Beispiel hat den `isPartial` Wert`false`, und die Nachricht enthält „fox“ statt „facts“. Das System gibt die Nachricht mit derselben ID erneut aus.

```
{
    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
                }]
            }]
        }]
    }
}
```

# Analysieren von Amazon Chime SDK-Transkripten
<a name="parse-transcripts"></a>

Verwenden Sie den folgenden Befehl, um den Transkriptionsinhalt einer Transkriptionsnachricht zu analysieren. Der Befehl analysiert vollständige Sätze aus den Dateien 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"])
```