틀:TTS/설명문서 문서 원본 보기

<noinclude>{{틀 설명 소개하기}}</noinclude><includeonly>{{틀 설명 연결하기}}</includeonly>
<!-- 여기에 틀에 대한 설명문서를 작성하세요. -->
음성 합성을 통해 텍스트를 읽어줍니다.

== 예시 ==
* {{linkget|정지|get=notts=1}}
 {{TTS|이번 역은 함정, 함정 역입니다. 내리실 문은 없습니다. 계속해서 안드로메다 방면으로 갈아타실 승객께서는 이번 역에서 내리시기 바랍니다.|ko|숨김=no}}
{{복붙 상자|<nowiki>{{TTS|이번 역은 함정, 함정 역입니다. 내리실 문은 없습니다. 계속해서 안드로메다 방면으로 갈아타실 승객께서는 이번 역에서 내리시기 바랍니다.|ko|숨김=no}}</nowiki>}}

== 사용법 ==
<pre>{{TTS|(텍스트)|(언어)|숨김=(부울)|volume=(숫자)|pitch=(숫자)|rate=(숫자)}}</pre>
* 텍스트: 읽어줄 내용을 입력해 주세요.
* 언어(기본값: <code>ko</code>): 텍스트의 언어를 지정해 주세요. 정확하게 지정하지 않을 경우 제대로 읽어주지 못할 수 있습니다. <code>ko</code>, <code>en</code>과 같은 형식으로 지정해 주세요. 사용자 환경에 따라 읽을 수 없는 언어가 있을 수 있습니다.
* <code>숨김</code>(기본값: <code>true</code>): 입력한 텍스트를 화면에 표시할 지 여부를 결정합니다.
* <code>volume</code>(기본값: <code>1</code>): 음량을 조절합니다. (범위: 0~1)
* <code>pitch</code>(기본값: <code>1</code>): 목소리의 높낮이를 조절합니다. (범위: 0~2)
* <code>rate</code>(기본값: <code>1</code>): 재생 속도를 조절합니다. (범위: 0~2)

=== HTML ===
틀이나 고급 스타일, 클래스를 활용하려면 HTML 클래스를 이용할 수도 있습니다.
<pre><span class="speech" lang="(언어)" data-volume="(숫자)" data-pitch="(숫자)" data-rate="(숫자)">(텍스트)</span></pre>
언어는 <code>lang</code>속성으로, <code>volume</code>, <code>pitch</code>, <code>rate</code>는 앞에 <code>data-</code>를 붙여 이용할 수 있습니다. 모두 틀과 같이 설정하세요.

== 차단 ==
TTS 재생을 일시적으로 차단하려면 urlget <code>notts</code>키에 아무 값이나 지정해주세요. 

항상 차단하려면 [[특수:mypage/common.js|사용자 자바스크립트 문서]]에 다음 코드를 추가해 주세요.
{{복붙 상자|1=var disableTTS = true;}}

== 개인화 ==
자바스크립트를 통해 언어별로 선호하는 목소리를 선택하고, 음량, 높낮이, 속도의 기본값을 설정할 수 있습니다. 틀에 별도의 설정이 있어도 개인적으로 설정한 기본값의 상대 비율로 계산됩니다. 여기서 다루는 내용은 자바스크립트에 대한 기초적인 지식이 필요합니다.

개인 설정은 전역 스코프의 <code>voiceSettings</code> 객체에서 이루어집니다. 해당 객체에 언어 코드별로 설정 객체를 등록할 수 있습니다. 설정 객체는 다음과 같이 구성됩니다.

<source lang="js">
voiceSettings./* 언어 코드 */ = {
    voice: /* 음성 객체 또는 null */,
    pitch: /* 숫자 (범위: 0~2) */,
    volume: /* 숫자 (범위: 0~1) */,
    rate: /* 숫자 (범위: 0~2) */
};
</source>

<code>pitch</code>, <code>volume</code>, <code>rate</code>는 틀의 설정과 동일하고, 설정 방법도 동일하기 때문에 두번 말하지 않겠습니다. <code>voice</code>는 목소리를 선택합니다. 언어 별로 제공되는 목소리가 2개 이상일 경우, 이 속성을 통해 원하는 목소리로 선택할 수 있으며, 목소리와 음성 객체의 목록은 <code>SpeechSynthesis.getVoices()</code>에서 가져올 수 있으며, 함수의 값에 나오는 음성 객체 중 언어에 맞는 하나를 값으로 입력하면 됩니다.

모든 언어의 기본 설정은 <code>voiceSettings.default</code> 객체에서 가져오며, 일부 항목만 설정할 경우 나머지 항목은 기본 설정 객체에서 가져옵니다. 물론 이 객체도 수정할 수 있습니다.

== [[도보시오]] ==
* [https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesisUtterance TTS 설정 레퍼런스 (영문 MDN)]

<includeonly>
<!-- 여기에 분류와 인터위키를 작성하세요. -->
[[분류:특수 효과용 틀]]
</includeonly>