Web Speech API로 React에서 TTS 음성 읽기 구현하기
시각 장애인용 PDF 읽기 사이트를 만들며 Web Speech API의 SpeechSynthesis와 SpeechSynthesisUtterance로 음성 변환 함수를 만든 기록입니다.
2023년에 쓴 글이라 지금과 다른 내용이 있을 수 있습니다.
이번 캡스톤 디자인 수업을 위해서 시각 장애인을 위한 PDF를 읽는 사이트를 개발하는 중 유저에게 음성으로 전달하는 기능이 필요했습니다. 카카오에서 제공하는 API를 이용하면 더 자연스러운 음성을 사용할 수 있지만, 유료인 관계로 Web Speech API의 interface를 사용하여 음성 변환 함수를 만들었습니다.
SpeechSynthesis: 음성 재생 컨트롤러
컨트롤러 역할을 하는 interface입니다. 디바이스에 사용가능한 목소리의 정보를 가져오고, 스피치를 시작하고 정지할 수 있습니다.
- getVoices() : speechSynthesis 인터페이스의 메서드로 현재 사용하고 있는 디바이스의 사용 가능한 목소리들을 가지고 올 수 있습니다.
- speak() : utterance(speech)를 utterance queue에 쌓아 음성으로 읽을 수 있도록 합니다.
SpeechSynthesisUtterance: 무엇을 어떻게 읽을지
speech 요청을 표현하는 interface입니다. 무엇을 읽을지 어떻게 읽을지에 대한 정보를 포함하고 있습니다.
- lang : 사용할 언어. 기본값은 lang값 또는 user-agent default 값이 됩니다.
- pitch : 스피치 pitch. 기본값 1. 0-2 사이로 설정 가능합니다.
- rate : 스피치 속도. 기본값 1. 0.1에서 10 사이로 설정 가능합니다.
- voice : 스피치 목소리, 설정되지 않으면 utterance 언어의 default 언어 세팅의 목소리로 설정됩니다.
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);!
};
실제로 잘 작동했습니다.
같은 주제의 글
스켈레톤 로딩 UI를 어디에, 언제 보여 줄지 정한 기준
스켈레톤 UI를 전체 화면과 일부 영역으로 나눠 적용한 기준, Suspense와 MUI Skeleton으로 만든 부분 로딩, 짧은 로딩에는 스켈레톤을 숨기는 지연 컴포넌트와 이미지용 공통 컴포넌트를 정리했습니다.
Recoil 훅 정리: useRecoilState부터 스냅샷까지
useRecoilState·useRecoilValue·useResetRecoilState와 selector의 set, useRecoilSnapshot·useRecoilTransactionObserver·useRecoilCallback으로 스냅샷을 다루는 법을 정리했습니다.
4분 읽기#ReactSWR suspense 옵션으로 로딩 삼항 연산자 걷어내기
SWRConfig에 suspense: true를 켜고 React Suspense의 fallback으로 로딩 UI를 맡기는 방법을 정리했습니다. React Query도 같은 방식으로 씁니다.