기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

트랜스크립션 메시지 이해

Amazon Chime SDK 서비스는 데이터 메시지로 TranscriptEvent 객체를 전송하여 참석자와 트랜스크립션 정보를 공유합니다. TranscriptEvent는 Transcript 또는 TranscriptionStatus를 전달합니다.

Transcript에는 타임스탬프가 표시되고 사용자 속성이 지정된 단어 및 문장 부호를 포함한 결과가 있습니다. 결과는 ‘부분적’일 수 있으며, 이 경우 시스템은 보통 후속 TranscriptEvent에서 이를 업데이트합니다. 이렇게 하면 트랜스크립션을 빠르게 확인하고 나중에 필요에 따라 인라인 업데이트를 적용할 수 있습니다.

TranscriptStatus는 다음 섹션의 예제에 나열된 TranscriptionStatusType 이벤트 중 하나를 전달할 수 있습니다.

최신 버전의 Amazon Chime에는 일반적인 처리를 위한 추가 데이터 유형과 도우미 함수가 SDKs 포함되어 있습니다TranscriptEvent.

TranscriptEvent

이 예제는 일반적인 트랜스크립션 이벤트를 보여줍니다.

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

데이터 지침

진행하면서 아래 지침을 유의하세요.

에 대한 이벤트 핸들러 등록 TranscriptEvents

다음 예제에서는 에 Amazon Chime SDK 클라이언트 라이브러리를 사용합니다 JavaScript. 그러나 패턴은 모든 Amazon Chime 에서 일관됩니다SDKs.

RealtimeController 및 RealtimeControllerFacade의 TranscriptionController에는 TranscriptionEvents를 처리하는 핸들러를 추가하기 위한 특정 함수가 포함되어 있습니다.

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

TranscriptionController에는 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;
}

선택 사항인 TranscriptionController 사용

DefaultTranscriptionController라는 TranscriptionController 인터페이스의 기본 구현을 제공하고 있습니다. DefaultRealtimeController 및 DefaultAudioVideoFacade에서의 기본 구현은 DefaultTranscriptionController 객체를 반환합니다.

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

또한 DefaultRealtimeController는 생성자에서 선택 사항인 TranscriptionController 객체를 가져옵니다. 그러면 DefaultTranscriptionController 동작을 덮어쓸 수 있습니다. 개발자 애플리케이션은 AudioVideoFacade 객체의 TranscriptionController 객체를 통해 하나 이상의 콜백을 구독 및 구독 취소합니다.

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

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