틀:TTS/설명문서
 |
이 문서는 틀에 대한 설명문서입니다. 이 문서는 직접 보이지 않게 되어 있습니다. 만일 이 문서가 직접 보인다면, 링크를 확인해 주시기 바랍니다. |
음성 합성을 통해 텍스트를 읽어줍니다.
예시
이번 역은 함정, 함정 역입니다. 내리실 문은 없습니다. 계속해서 안드로메다 방면으로 갈아타실 승객께서는 이번 역에서 내리시기 바랍니다.
{{TTS|이번 역은 함정, 함정 역입니다. 내리실 문은 없습니다. 계속해서 안드로메다 방면으로 갈아타실 승객께서는 이번 역에서 내리시기 바랍니다.|ko|숨김=no}}
사용법
{{TTS|(텍스트)|(언어)|숨김=(부울)|volume=(숫자)|pitch=(숫자)|rate=(숫자)}}
- 텍스트: 읽어줄 내용을 입력해 주세요.
- 언어(기본값:
ko): 텍스트의 언어를 지정해 주세요. 정확하게 지정하지 않을 경우 제대로 읽어주지 못할 수 있습니다.ko,en과 같은 형식으로 지정해 주세요. 사용자 환경에 따라 읽을 수 없는 언어가 있을 수 있습니다. 숨김(기본값:true): 입력한 텍스트를 화면에 표시할 지 여부를 결정합니다.volume(기본값:1): 음량을 조절합니다. (범위: 0~1)pitch(기본값:1): 목소리의 높낮이를 조절합니다. (범위: 0~2)rate(기본값:1): 재생 속도를 조절합니다. (범위: 0~2)
HTML
틀이나 고급 스타일, 클래스를 활용하려면 HTML speech 클래스를 이용할 수도 있습니다.
<span class="speech" lang="(언어)" data-volume="(숫자)" data-pitch="(숫자)" data-rate="(숫자)">(텍스트)</span>
언어는 lang속성으로, volume, pitch, rate는 앞에 data-를 붙여 이용할 수 있습니다. 모두 틀과 같은 방식으로 설정하실 수 있습니다.
차단
TTS 재생을 일시적으로 차단하려면 urlget notts키에 아무 값이나 지정해주세요.
항상 차단하려면 특수:환경설정의 소도구 탭에서 TTS 기능을 꺼주세요.
개인화
자바스크립트를 통해 언어별로 선호하는 목소리를 선택하고, 음량, 높낮이, 속도의 기본값을 설정할 수 있습니다. 틀에 별도의 설정이 있어도 개인적으로 설정한 기본값의 상대 비율로 계산됩니다. 여기서 다루는 내용은 자바스크립트에 대한 기초적인 지식이 필요합니다.
개인 설정은 전역 스코프의 voiceSettings 객체에서 이루어집니다. 해당 객체에 언어 코드별로 설정 객체를 등록할 수 있습니다. 설정 객체는 다음과 같이 구성됩니다.
voiceSettings./* 언어 코드 */ = {
voice: /* 음성 객체 또는 null */,
pitch: /* 숫자 (범위: 0~2) */,
volume: /* 숫자 (범위: 0~1) */,
rate: /* 숫자 (범위: 0~2) */
};
pitch, volume, rate는 틀의 설정과 동일하고, 설정 방법도 동일합니다. voice는 목소리를 선택합니다. 언어 별로 제공되는 목소리가 2개 이상일 경우, 이 속성을 통해 원하는 목소리로 선택할 수 있습니다. 목소리와 음성 객체의 목록은 SpeechSynthesis.getVoices()에서 가져올 수 있으며, 함수의 값에 나오는 음성 객체 중 언어에 맞는 하나를 값으로 입력하면 됩니다.
모든 언어의 기본 설정은 voiceSettings.default 객체에서 가져오며, 일부 항목만 설정할 경우 나머지 항목은 기본 설정 객체에서 가져옵니다. 물론 이 객체도 수정할 수 있습니다.
도보시오