1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
/**
* @fileoverview A class for speaking navigation information.
*/
goog.provide('cvox.NavigationSpeaker');
goog.require('cvox.NavDescription');
/**
* @constructor
*/
cvox.NavigationSpeaker = function() {
/**
* This member indicates to this speaker to cancel any pending callbacks.
* This is needed primarily to support cancelling a chain of callbacks by an
* outside caller. There's currently no way to cancel a chain of callbacks in
* any other way. Consider removing this if we ever get silence at the tts
* layer.
* @type {boolean}
*/
this.stopReading = false;
/**
* An identifier that tracks the calls to speakDescriptionArray. Used to
* cancel a chain of callbacks that is stale.
* @type {number}
* @private
*/
this.id_ = 1;
};
/**
* Speak all of the NavDescriptions in the given array (as returned by
* getDescription), including playing earcons.
*
* @param {Array<cvox.NavDescription>} descriptionArray The array of
* NavDescriptions to speak.
* @param {number} initialQueueMode The initial queue mode.
* @param {Function} completionFunction Function to call when finished speaking.
*/
cvox.NavigationSpeaker.prototype.speakDescriptionArray = function(
descriptionArray, initialQueueMode, completionFunction) {
descriptionArray = this.reorderAnnotations(descriptionArray);
this.stopReading = false;
this.id_ = (this.id_ + 1) % 10000;
// Using self rather than goog.bind in order to get debug symbols.
var self = this;
var speakDescriptionChain = function(i, queueMode, id) {
var description = descriptionArray[i];
if (!description || self.stopReading || self.id_ != id) {
return;
}
var startCallback = function() {
for (var j = 0; j < description.earcons.length; j++) {
cvox.ChromeVox.earcons.playEarcon(description.earcons[j]);
}
};
var endCallbackHelper = function() {
speakDescriptionChain(i + 1, cvox.QueueMode.QUEUE, id);
};
var endCallback = function() {
// We process content-script specific properties here for now.
if (description.personality &&
description.personality[cvox.AbstractTts.PAUSE] &&
typeof(description.personality[cvox.AbstractTts.PAUSE]) == 'number') {
setTimeout(
endCallbackHelper, description.personality[cvox.AbstractTts.PAUSE]);
} else {
endCallbackHelper();
}
if ((i == descriptionArray.length - 1) && completionFunction) {
completionFunction();
}
};
if (!description.isEmpty()) {
description.speak(queueMode, startCallback, endCallback);
} else {
startCallback();
endCallback();
return;
}
if (!cvox.ChromeVox.host.hasTtsCallback()) {
startCallback();
endCallback();
}
};
speakDescriptionChain(0, initialQueueMode, this.id_);
if ((descriptionArray.length == 0) && completionFunction) {
completionFunction();
}
};
/**
* Checks for an annotation of a structured elements.
* @param {string} annon The annotation.
* @return {boolean} True if annotating a structured element.
*/
cvox.NavigationSpeaker.structuredElement = function(annon) {
// TODO(dtseng, sorge): This doesn't work for languages other than English.
switch (annon) {
case 'table':
case 'Math':
return true;
}
return false;
};
/**
* Reorder special annotations for structured elements to be spoken first.
* @param {Array<cvox.NavDescription>} descriptionArray The array of
* NavDescriptions to speak.
* @return {Array<cvox.NavDescription>} The reordered array.
*/
cvox.NavigationSpeaker.prototype.reorderAnnotations = function(
descriptionArray) {
var descs = new Array;
for (var i = 0; i < descriptionArray.length; i++) {
var descr = descriptionArray[i];
if (cvox.NavigationSpeaker.structuredElement(descr.annotation)) {
descs.push(new cvox.NavDescription({
text: '',
annotation: descr.annotation
}));
descr.annotation = '';
}
descs.push(descr);
}
return descs;
};
|
