개요
“개요” 섹션@capgo/capacitor-speech-synthesis 플랫폼 TTS 엔진을 구동해 접근성, 언어 학습, 핸즈프리 내비게이션을 지원합니다. 음성을 고르고 속도와 음높이를 조정하며, 긴 문단을 일시정지/재개하고, iOS와 Android에서 오프라인 재생용 오디오 파일을 렌더링합니다.
호출하세요 initialize() iOS에서 첫 음성 출력을 더 빠르게 하려면, activateAudioSession() 특정 iOS 오디오 카테고리가 필요할 때.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | AVSpeechSynthesizer, 오디오 세션 헬퍼 |
| Android | 지원 | Android TTS 엔진 |
| 웹 | 부분 | 사용 가능한 브라우저 음성 합성 |
핵심 기능
“핵심 기능” 섹션speak- 지정된 옵션으로 주어진 텍스트를 발음합니다. 발화(utterance)가 음성 큐에 추가됩니다.synthesizeToFile- 음성을 오디오 파일로 합성합니다 (Android/iOS 전용). 오디오가 저장된 파일 경로를 반환합니다.cancel- 대기 중인 모든 발화를 취소하고 현재 음성을 중지합니다.pause- 음성 합성을 즉시 일시 중지합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
speak | 지정된 옵션으로 주어진 텍스트를 읽습니다. 발화는 음성 큐에 추가됩니다. |
synthesizeToFile | 음성을 오디오 파일로 합성합니다(Android/iOS 전용). 오디오가 저장된 파일 경로를 반환합니다. |
cancel | 큐에 있는 모든 발화를 취소하고 현재 음성을 중단합니다. |
pause | 음성 재생을 즉시 일시 중지합니다. |
resume | 일시 중지된 음성 재생을 다시 시작합니다. |
isSpeaking | 현재 음성 합성이 재생 중인지 확인합니다. |
isAvailable | 기기에서 음성 합성 기능을 사용할 수 있는지 확인합니다. |
getVoices | 사용 가능한 모든 음성 목록을 가져옵니다. |
getLanguages | 사용 가능한 모든 언어 목록을 가져옵니다. |
isLanguageAvailable | 특정 언어를 사용할 수 있는지 확인합니다. |
isVoiceAvailable | 특정 음성을 사용할 수 있는지 확인합니다. |
initialize | 음성 합성 엔진을 초기화합니다(iOS 최적화). 첫 음성 요청의 지연 시간을 줄일 수 있습니다. |
activateAudioSession | 특정 카테고리로 오디오 세션을 활성화합니다 (iOS 전용). |
deactivateAudioSession | 오디오 세션을 비활성화합니다 (iOS 전용). |
getPluginVersion | 네이티브 플러그인 버전을 가져옵니다. |
addListener | 발화가 시작될 때 이벤트를 수신합니다. |
addListener | 발화가 완료될 때 이벤트를 수신합니다. |
addListener | 음성 합성 중 단어 경계를 수신합니다. |
addListener | 음성 합성 오류를 수신합니다. |
removeAllListeners | 모든 이벤트 리스너를 제거합니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-speech-synthesis.
@capgo/capacitor-speech-synthesis에서 계속하기
“@capgo/capacitor-speech-synthesis에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-speech-synthesis 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-speech-synthesis 사용하기 ‘@capgo/capacitor-speech-synthesis 사용하기’에서 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.