본문 바로가기
seungchan.dev
뒤로

Web Speech API로 React에서 TTS 음성 읽기 구현하기

시각 장애인용 PDF 읽기 사이트를 만들며 Web Speech API의 SpeechSynthesis와 SpeechSynthesisUtterance로 음성 변환 함수를 만든 기록입니다.

2분 읽기#React

2023년에 쓴 글이라 지금과 다른 내용이 있을 수 있습니다.

이번 캡스톤 디자인 수업을 위해서 시각 장애인을 위한 PDF를 읽는 사이트를 개발하는 중 유저에게 음성으로 전달하는 기능이 필요했습니다. 카카오에서 제공하는 API를 이용하면 더 자연스러운 음성을 사용할 수 있지만, 유료인 관계로 Web Speech API의 interface를 사용하여 음성 변환 함수를 만들었습니다.

SpeechSynthesis: 음성 재생 컨트롤러

컨트롤러 역할을 하는 interface입니다. 디바이스에 사용가능한 목소리의 정보를 가져오고, 스피치를 시작하고 정지할 수 있습니다.

  1. getVoices() : speechSynthesis 인터페이스의 메서드로 현재 사용하고 있는 디바이스의 사용 가능한 목소리들을 가지고 올 수 있습니다.
  2. speak() : utterance(speech)를 utterance queue에 쌓아 음성으로 읽을 수 있도록 합니다.

SpeechSynthesisUtterance: 무엇을 어떻게 읽을지

speech 요청을 표현하는 interface입니다. 무엇을 읽을지 어떻게 읽을지에 대한 정보를 포함하고 있습니다.

  1. lang : 사용할 언어. 기본값은 lang값 또는 user-agent default 값이 됩니다.
  2. pitch : 스피치 pitch. 기본값 1. 0-2 사이로 설정 가능합니다.
  3. rate : 스피치 속도. 기본값 1. 0.1에서 10 사이로 설정 가능합니다.
  4. voice : 스피치 목소리, 설정되지 않으면 utterance 언어의 default 언어 세팅의 목소리로 설정됩니다.
javascript
export const getSpeech = (text) => {
  let voices = [];
 
  //디바이스에 내장된 voice를 가져온다.
  const setVoiceList = () => {
    voices = window.speechSynthesis.getVoices();
  };
 
  setVoiceList();
 
  if (window.speechSynthesis.onvoiceschanged !== undefined) {
    //voice list에 변경됐을때, voice를 다시 가져온다.
    window.speechSynthesis.onvoiceschanged = setVoiceList;
  }
 
  const speech = (txt) => {
    const lang = "ko-KR";
    const utterThis = new SpeechSynthesisUtterance(txt);
 
    utterThis.lang = lang;
 
    /* 한국어 vocie 찾기
       디바이스 별로 한국어는 ko-KR 또는 ko_KR로 voice가 정의되어 있다.
    */
    const kor_voice = voices.find(
      (elem) => elem.lang === lang || elem.lang === lang.replace("-", "_")
    );
 
    //힌국어 voice가 있다면 ? utterance에 목소리를 설정한다 : 리턴하여 목소리가 나오지 않도록 한다.
    if (kor_voice) {
      utterThis.voice = kor_voice;
    } else {
      return;
    }
 
    //utterance를 재생(speak)한다.
    window.speechSynthesis.speak(utterThis);
  };
 
  speech(text);!
 
};

React_TTS 이미지 1

실제로 잘 작동했습니다.