본문 바로가기

@capgo/capacitor-speech-synthesis

음성, 속도, 음높이, 언어 제어로 텍스트를 음성으로 재생하거나 파일로 내보냅니다.

@capgo/capacitor-speech-synthesis 플랫폼 TTS 엔진을 구동해 접근성, 언어 학습, 핸즈프리 내비게이션을 지원합니다. 음성을 고르고 속도와 음높이를 조정하며, 긴 문단을 일시정지/재개하고, iOS와 Android에서 오프라인 재생용 오디오 파일을 렌더링합니다.

호출하세요 initialize() iOS에서 첫 음성 출력을 더 빠르게 하려면, activateAudioSession() 특정 iOS 오디오 카테고리가 필요할 때.

플랫폼지원참고 사항
iOS지원AVSpeechSynthesizer, 오디오 세션 헬퍼
Android지원Android TTS 엔진
웹부분사용 가능한 브라우저 음성 합성
  • speak - 지정된 옵션으로 주어진 텍스트를 발음합니다. 발화(utterance)가 음성 큐에 추가됩니다.
  • synthesizeToFile - 음성을 오디오 파일로 합성합니다 (Android/iOS 전용). 오디오가 저장된 파일 경로를 반환합니다.
  • cancel - 대기 중인 모든 발화를 취소하고 현재 음성을 중지합니다.
  • pause - 음성 합성을 즉시 일시 중지합니다.
메서드설명
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모든 이벤트 리스너를 제거합니다.

이 레퍼런스는 다음에서 동기화됩니다. 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 플러그인 대안의 제품 워크플로우에 대해서는.