개요
“개요” 섹션@capgo/capacitor-speech-synthesis 접근성, 언어 학습, 핸즈프리 내비게이션을 위한 플랫폼 텍스트 음성 변환 엔진을 구동합니다. 목소리를 선택하고 속도와 피치를 조절하며, 긴 문장을 일시 정지하거나 다시 재생할 수 있습니다. 또한 iOS 및 Android에서 오프라인 재생을 위한 오디오 파일을 렌더링합니다.
실행하세요: initialize() iOS에서 더 빠른 첫 음성 출력을 위해, 그리고 activateAudioSession() 특정 iOS 오디오 카테고리가 필요한 경우에 사용하세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS에서는 | 예 | AVSpeechSynthesizer, 오디오 세션 헬퍼 |
| Android에서는 | 예 | Android TTS 엔진 |
| 웹 | 부분적 지원 | 지원되는 경우 브라우저 음성 합성 사용 |
핵심 기능
“핵심 기능” 섹션speak- 지정된 옵션으로 텍스트를 읽습니다. 음성은 음성 대기열(queue)에 추가됩니다.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 | 음성 출력 중 단어 경계(word boundaries)를 감지합니다. |
addListener | 합성 오류를 감지합니다. |
removeAllListeners | 모든 이벤트 리스너를 제거합니다. |
기준 소스
“기준 소스” 섹션이 레퍼런스는 다음에서 동기화됩니다: 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 플러그인 디렉토리의 제품 워크플로우를 보려면, Capgo 제공 Capacitor 플러그인 Capgo 제공 Capacitor 플러그인의 구현 세부 사항을 보려면, 플러그인 추가 및 업데이트 플러그인 추가 및 업데이트의 구현 세부 사항을 확인하고, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우를 확인하세요.
