메인 콘텐츠로 바로 가기
플러그인으로 돌아가기
@capgo/capacitor-speech-synthesis
튜토리얼
@capgo/capacitor-speech-synthesis

음성 합성

텍스트에서 음성을 합성하고 언어, 음성,.pitch, 속도 및 음량과 같은 모든 요소를 완벽하게 제어할 수 있습니다.

가이드

음성 합성에 대한 튜토리얼

장치에서 테스트

다운로드 Capgo 앱, 그리고 QR code를 스캔하세요.

Speech Synthesis plugin preview QR code

Using @capgo/capacitor-speech-synthesis

speech synthesis plugin을 사용하여 텍스트에서 음성으로 변환합니다.

Install

bun add @capgo/capacitor-speech-synthesis
bunx cap sync

이 플러그인은 노출합니다.

  • speak - 지정된 옵션으로 텍스트를 말합니다. 음성 큐에 음성 발화가 추가됩니다.
  • synthesizeToFile - Android/iOS에서만 음성 파일로 음성을 합성합니다. 음성 파일이 저장된 경로를 반환합니다.
  • cancel - 음성 큐에 있는 모든 발화를 취소하고 현재 음성을 중지합니다.
  • pause - 음성을 즉시 중지합니다.

사용 예

speak

지정된 옵션으로 텍스트를 말합니다. 음성 큐에 음성 발화가 추가됩니다.

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

const result = await SpeechSynthesis.speak({
  text: 'Hello, world!',
  language: 'en-US',
  rate: 1.0,
  pitch: 1.0,
  volume: 1.0,
  queueStrategy: 'Add'
});
console.log('Utterance ID:', result.utteranceId);

synthesizeToFile

음성 합성을 위한 오디오 파일을 생성 (Android/iOS만). 오디오 파일이 저장된 경로를 반환합니다.

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

const result = await SpeechSynthesis.synthesizeToFile({
  text: 'Hello, world!',
  language: 'en-US'
});
console.log('Audio file saved at:', result.filePath);

cancel

모두 중단하고 현재 음성 출력을 중단합니다.

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

await SpeechSynthesis.cancel();

pause

음성 출력을 즉시 중단합니다.

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

await SpeechSynthesis.pause();

전체 참조

Using @capgo/capacitor-speech-synthesis

이 기능을 사용하는 경우 Using @capgo/capacitor-speech-synthesis 자연 플러그인 작업을 계획하는 경우, 이 기능을 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-speech-synthesis Using @capgo/capacitor-speech-synthesis 구현 세부 정보는 @capgo/capacitor-speech-synthesis 에서 찾을 수 있습니다. Getting Started 구현 세부 정보는 Getting Started 에서 찾을 수 있습니다. Capgo 플러그인 디렉토리 구현 세부 정보는 Capgo 플러그인 디렉토리 에서 찾을 수 있습니다. Capacitor 플러그인들에 대한 Capgo 구현 세부 정보는 Capacitor 플러그인들에 대한 Capgo 에서 찾을 수 있습니다. 플러그인 추가 또는 업데이트 구현 세부 정보는 플러그인 추가 또는 업데이트 에서 찾을 수 있습니다.