# 스피치 투 텍스트 API

> Use the speech-to-text API to transcribe voice messages.

Vivox는 다음과 같은 스피치 투 텍스트 트랜스크립션 메서드를 사용합니다.

## 트랜스크립션 활성화 또는 비활성화##enable-or-disable-transcription

### `IVivoxService.SpeechToTextEnableTranscription`##ivivoxservice.speechtotextenabletranscription

```cs
await VivoxService.Instance.SpeechToTextEnableTranscription( _channelName);
```

이 메서드를 사용하여 채널 내에서 스피치 투 텍스트 오디오 트랜스크립션 기능을 활성화합니다. 이 메서드는 다음 파라미터를 갖습니다.

`ChannelName`: 트랜스크립션을 활성화하는 채널의 이름입니다.

### `IVivoxService.SpeechToTextDisableTranscription`##ivivoxservice.speechtotextdisabletranscription

```cs
await VivoxService.Instance.SpeechToTextDisableTranscription( _channelName);
```

이 메서드를 사용하여 채널 내에서 스피치 투 텍스트 오디오 트랜스크립션 기능을 비활성화합니다. 이 메서드는 다음 파라미터를 갖습니다.

`ChannelName`: 트랜스크립션을 비활성화하는 채널의 이름입니다.

### `IVivoxService.IsSpeechToTextEnabled`##ivivoxservice.isspeechtotextenabled

```cs
bool isSpeechToTextEnabled = VivoxService.Instance.IsSpeechToTextEnabled(_channelName);
```

이 메서드를 사용하여 채널 내에서 트랜스크립션이 활성화되었는지 비활성화되었는지 확인합니다. 이 메서드는 다음 파라미터를 갖습니다.

`ChannelName`: 트랜스크립션이 활성화되었는지 확인할 채널의 이름입니다.

## 트랜스크립션 알림##transcription-notification

### `IVivoxService.SpeechToTextMessageReceived`##ivivoxservice.speechtotextmessagereceived

```cs
VivoxService.Instance.SpeechToTextMessageReceived += OnSpeechTotextMessageAdded;

VivoxService.Instance.SpeechToTextMessageReceived -= OnSpeechTotextMessageAdded;

private void OnSpeechTotextMessageReceived(VivoxMessage message)
{
    // Add your code here. “message” is the new transcribed message
    // added to the queue.
}
```

이 이벤트 핸들러를 메서드에 바인드/바인드 해제하여 트랜스크립션 메시지가 추가될 때 알림을 받습니다.

## 트랜스크립션 언어 설정##set-transcription-languages

### `LoginOptions.SpeechToTextLanguages`##loginoptions.speechtotextlanguages

```cs
loginOptions = loginOptions ?? new LoginOptions();
loginOptions.SpeechToTextLanguages = new List<string>{"en", "es", "fr"};
```

오디오 트랜스크립션의 힌트로 사용되는 언어 목록입니다. 기본값은 빈 배열로, `en`을 의미합니다. 트랜스크립션 채널에서 모든 사용자의 트랜스크립션을 알리기 위해 최대 3개의 언어를 선호하는 순서대로 지정할 수 있습니다. IETF 언어 태그 문자열을 검증하지는 않지만, [BCP47](https://tools.ietf.org/html/bcp47)을 준수해야 합니다(RFC 에디터).