OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 [ | 5 [ |
6 { | 6 { |
7 "namespace": "tts", | 7 "namespace": "tts", |
8 "description": "Use the <code>chrome.tts</code> API to play synthesized text
-to-speech (TTS). See also the related <a href='http://developer.chrome.com/exte
nsions/ttsEngine'>ttsEngine</a> API, which allows an extension to implement a sp
eech engine.", | 8 "description": "Use the <code>chrome.tts</code> API to play synthesized text
-to-speech (TTS). See also the related <a href='http://developer.chrome.com/exte
nsions/ttsEngine'>ttsEngine</a> API, which allows an extension to implement a sp
eech engine.", |
9 "types": [ | 9 "types": [ |
10 { | 10 { |
| 11 "id": "EventType", |
| 12 "type": "string", |
| 13 "enum": ["start", "end", "word", "sentence", "marker", "interrupted", "c
ancelled", "error", "pause", "resume"] |
| 14 }, |
| 15 { |
| 16 "id": "VoiceGender", |
| 17 "type": "string", |
| 18 "enum": ["male", "female"] |
| 19 }, |
| 20 { |
11 "id": "TtsEvent", | 21 "id": "TtsEvent", |
12 "type": "object", | 22 "type": "object", |
13 "description": "An event from the TTS engine to communicate the status o
f an utterance.", | 23 "description": "An event from the TTS engine to communicate the status o
f an utterance.", |
14 "properties": { | 24 "properties": { |
15 "type": { | 25 "type": { |
16 "type": "string", | 26 "$ref": "EventType", |
17 "enum": ["start", "end", "word", "sentence", "marker", "interrupted"
, "cancelled", "error", "pause", "resume"], | |
18 "description": "The type can be 'start' as soon as speech has starte
d, 'word' when a word boundary is reached, 'sentence' when a sentence boundary i
s reached, 'marker' when an SSML mark element is reached, 'end' when the end of
the utterance is reached, 'interrupted' when the utterance is stopped or interru
pted before reaching the end, 'cancelled' when it's removed from the queue befor
e ever being synthesized, or 'error' when any other error occurs. When pausing s
peech, a 'pause' event is fired if a particular utterance is paused in the middl
e, and 'resume' if an utterance resumes speech. Note that pause and resume event
s may not fire if speech is paused in-between utterances." | 27 "description": "The type can be 'start' as soon as speech has starte
d, 'word' when a word boundary is reached, 'sentence' when a sentence boundary i
s reached, 'marker' when an SSML mark element is reached, 'end' when the end of
the utterance is reached, 'interrupted' when the utterance is stopped or interru
pted before reaching the end, 'cancelled' when it's removed from the queue befor
e ever being synthesized, or 'error' when any other error occurs. When pausing s
peech, a 'pause' event is fired if a particular utterance is paused in the middl
e, and 'resume' if an utterance resumes speech. Note that pause and resume event
s may not fire if speech is paused in-between utterances." |
19 }, | 28 }, |
20 "charIndex": { | 29 "charIndex": { |
21 "type": "number", | 30 "type": "number", |
22 "optional": true, | 31 "optional": true, |
23 "description": "The index of the current character in the utterance.
" | 32 "description": "The index of the current character in the utterance.
" |
24 }, | 33 }, |
25 "errorMessage": { | 34 "errorMessage": { |
26 "type": "string", | 35 "type": "string", |
27 "description": "The error description, if the event type is 'error'.
", | 36 "description": "The error description, if the event type is 'error'.
", |
(...skipping 22 matching lines...) Expand all Loading... |
50 "type": "string", | 59 "type": "string", |
51 "optional": true, | 60 "optional": true, |
52 "description": "The name of the voice." | 61 "description": "The name of the voice." |
53 }, | 62 }, |
54 "lang": { | 63 "lang": { |
55 "type": "string", | 64 "type": "string", |
56 "optional": true, | 65 "optional": true, |
57 "description": "The language that this voice supports, in the form <
em>language</em>-<em>region</em>. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'." | 66 "description": "The language that this voice supports, in the form <
em>language</em>-<em>region</em>. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'." |
58 }, | 67 }, |
59 "gender": { | 68 "gender": { |
60 "type": "string", | 69 "$ref": "VoiceGender", |
61 "optional": true, | 70 "optional": true, |
62 "description": "This voice's gender.", | 71 "description": "This voice's gender." |
63 "enum": ["male", "female"] | |
64 }, | 72 }, |
65 "remote": { | 73 "remote": { |
66 "type": "boolean", | 74 "type": "boolean", |
67 "optional": true, | 75 "optional": true, |
68 "description": "If true, the synthesis engine is a remote network re
source. It may be higher latency and may incur bandwidth costs." | 76 "description": "If true, the synthesis engine is a remote network re
source. It may be higher latency and may incur bandwidth costs." |
69 }, | 77 }, |
70 "extensionId": { | 78 "extensionId": { |
71 "type": "string", | 79 "type": "string", |
72 "optional": true, | 80 "optional": true, |
73 "description": "The ID of the extension providing this voice." | 81 "description": "The ID of the extension providing this voice." |
(...skipping 38 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
112 "type": "string", | 120 "type": "string", |
113 "optional": true, | 121 "optional": true, |
114 "description": "The extension ID of the speech engine to use, if
known." | 122 "description": "The extension ID of the speech engine to use, if
known." |
115 }, | 123 }, |
116 "lang": { | 124 "lang": { |
117 "type": "string", | 125 "type": "string", |
118 "optional": true, | 126 "optional": true, |
119 "description": "The language to be used for synthesis, in the fo
rm <em>language</em>-<em>region</em>. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'.
" | 127 "description": "The language to be used for synthesis, in the fo
rm <em>language</em>-<em>region</em>. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'.
" |
120 }, | 128 }, |
121 "gender": { | 129 "gender": { |
122 "type": "string", | 130 "$ref": "VoiceGender", |
123 "optional": true, | 131 "optional": true, |
124 "description": "Gender of voice for synthesized speech.", | 132 "description": "Gender of voice for synthesized speech." |
125 "enum": ["male", "female"] | |
126 }, | 133 }, |
127 "rate": { | 134 "rate": { |
128 "type": "number", | 135 "type": "number", |
129 "optional": true, | 136 "optional": true, |
130 "minimum": 0.1, | 137 "minimum": 0.1, |
131 "maximum": 10, | 138 "maximum": 10, |
132 "description": "Speaking rate relative to the default rate for t
his voice. 1.0 is the default rate, normally around 180 to 220 words per minute.
2.0 is twice as fast, and 0.5 is half as fast. Values below 0.1 or above 10.0 a
re strictly disallowed, but many voices will constrain the minimum and maximum r
ates further—for example a particular voice may not actually speak faster
than 3 times normal even if you specify a value larger than 3.0." | 139 "description": "Speaking rate relative to the default rate for t
his voice. 1.0 is the default rate, normally around 180 to 220 words per minute.
2.0 is twice as fast, and 0.5 is half as fast. Values below 0.1 or above 10.0 a
re strictly disallowed, but many voices will constrain the minimum and maximum r
ates further—for example a particular voice may not actually speak faster
than 3 times normal even if you specify a value larger than 3.0." |
133 }, | 140 }, |
134 "pitch": { | 141 "pitch": { |
135 "type": "number", | 142 "type": "number", |
(...skipping 112 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
248 "name": "event", | 255 "name": "event", |
249 "$ref": "TtsEvent", | 256 "$ref": "TtsEvent", |
250 "description": "The event from the text-to-speech engine indicating
the status of this utterance." | 257 "description": "The event from the text-to-speech engine indicating
the status of this utterance." |
251 } | 258 } |
252 ], | 259 ], |
253 "description": "Used to pass events back to the function calling speak()
." | 260 "description": "Used to pass events back to the function calling speak()
." |
254 } | 261 } |
255 ] | 262 ] |
256 } | 263 } |
257 ] | 264 ] |
OLD | NEW |