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