As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Entendendo as mensagens de transcrição

O SDK serviço Amazon Chime compartilha informações de transcrição com os participantes TranscriptEvent enviando objetos em mensagens de dados. Um TranscriptEvent entrega uma Transcript ou um TranscriptionStatus.

Uma Transcript inclui resultados com registro de data e hora, palavras atribuídas pelo usuário e pontuação. Um resultado pode ser “parcial”; nesse caso, o sistema geralmente o atualiza em um TranscriptEvent posterior. Isso permite que você veja as transcrições rapidamente e aplique atualizações em linha posteriormente, conforme necessário.

Um TranscriptStatus pode realizar um dos eventos TranscriptionStatusType, listados no exemplo na próxima seção.

As versões mais recentes do Amazon SDKs Chime incluem tipos de dados adicionais e funções auxiliares para processamento comum a. TranscriptEvent

TranscriptEvent

Este exemplo mostra um evento de transcrição típico.

type TranscriptEvent = Transcript | TranscriptionStatus;

export class TranscriptEventConverter {
  static from(dataMessage: DataMessage): TranscriptEvent[] {
    // convert DataMessage to TranscriptEvents
    return ...
  }
}

export default class TranscriptionStatus {
    type: TranscriptionStatusType;
    eventTimeMs:                   number;
    transcriptionRegion:           string;
    transcriptionConfiguration:    string;
    message?:                      string;
}

enum TranscriptionStatusType {
    STARTED        =    'started',
    INTERRUPTED    =    'interrupted',
    RESUMED        =    'resumed',
    STOPPED        =    'stopped',
    FAILED         =    'failed',
}

export default class Transcript {
    results: TranscriptResult[];    // at least one
}

export class TranscriptResult {
    resultId:        string;
    isPartial:       boolean;
    startTimeMs:     number;
    endTimeMs:       number;
    alternatives:    TranscriptAlternative[];    // most confident first
    }

export default class TranscriptAlternative {
    items: TranscriptItem[];    // in start time order
    transcript: string; //concatenated transcript items
    entities?: TranscriptEntity[];
}

export default class TranscriptItem {
    type:                      TranscriptItemType;
    startTimeMs:               number;
    endTimeMs:                 number;
    attendee:                  Attendee;
    content:                   string;
    vocabularyFilterMatch?:    boolean;
    confidence?:               number;  
    stable?:                   boolean;
}

enum TranscriptItemType {
    PRONUNCIATION    =    'pronunciation',// content is a word
    PUNCTUATION      =    'punctuation',// content is punctuation
}

export default class TranscriptEntity {  
    category:       string;  
    confidence:     number;  
    content:        string;  
    endTimeMs:      number;  
    startTimeMs:    number;  
    type?:          string;
}

// This is an existing SDK model
export default class Attendee {
    attendeeId:        string;
    externalUserId:    string;
}

Diretrizes de dados

Lembre-se dessas diretrizes à medida que avança.

Registrando manipuladores de eventos para TranscriptEvents

Os exemplos a seguir usam a biblioteca de SDK cliente Amazon Chime para. JavaScript No entanto, o padrão é consistente em todo o Amazon ChimeSDKs.

O TranscriptionController no RealtimeController e no RealtimeControllerFacade inclui funções específicas para adicionar um manipulador que processa TranscriptionEvents:

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

O TranscriptionController tem duas funções para gerenciar a assinatura e o cancelamento da assinatura de retornos de chamada de TranscriptionEvent:

import TranscriptEvent from './TranscriptEvent';

export default interface TranscriptionController {
  /**
   * Subscribe a callback to handle received transcript event
   */
  subscribeToTranscriptEvent(callback: (transcriptEvent: TranscriptEvent) => void): void;

  /** 
   * Unsubscribe a callback from receiving transcript event 
   */
  unsubscribeFromTranscriptEvent(callback: (transcriptEvent: TranscriptEvent) => void): void;
}

Como usar o TranscriptionController opcional

Nós fornecemos uma implementação-padrão da interface TranscriptionController chamada DefaultTranscriptionController. A implementação-padrão em DefaultRealtimeController e DefaultAudioVideoFacade retorna um objeto DefaultTranscriptionController:

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

O DefaultRealtimeController também usa um objeto TranscriptionController opcional em seu construtor. Isso permite que você anule o comportamento DefaultTranscriptionController. Os aplicativos do desenvolvedor assinam e cancelam a assinatura de um ou mais retornos de chamada por meio do objeto TranscriptionController do objeto AudioVideoFacade:

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

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