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.

Transkriptionsnachrichten verstehen

Der Amazon Chime SDK Chime-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

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

Behalten Sie diese Richtlinien stets im Hinterkopf.

Registrierung von Event-Handlern für TranscriptEvents

In den folgenden Beispielen wird die Amazon Chime SDK Chime-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 verarbeitetTranscriptionEvents:

/** 
 * 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 namedDefaultTranscriptionController. Die Standardimplementierung in DefaultRealtimeController und DefaultAudioVideoFacade gibt ein DefaultTranscriptionController Objekt zurück:

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

DefaultRealtimeControllernimmt 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););