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