The library documents itself · Sound
stzListener
23 own methods · 2 forms written with extensions, listed under their method
the source: base/sound/stzListener.ring(opens in a new tab) · All classes · The area reference: Sound
Under each method, its extensions (Q CS XT Z ZZ IB W U): bold and ticked, it exists; struck, it does not. The extensions and what they mean
No method of this class is run on this page: the class reaches files, the network, processes, the clock, chance or sound, and an example run here would only be an example of its effects. Each method carries the explanation the library gives of itself.
Method
Explanation, as the source carries it
init
(no comment in the source: the name reads as a sentence) initno extension
Release
(no comment in the source: the name reads as a sentence) releaseno extension
IsUsable
can this machine hear at all?no extension
LastError
(no comment in the source: the name reads as a sentence) last errorno extension
Refusals
(no comment in the source: the name reads as a sentence) refusalsno extension
RecognizerCount
what it can hear, as DATAno extension
Languages
The BCP-47 tags this machine can HEAR. Compare with stzVoice's Languages(), which is what it can SPEAK -- on the machine this was built on the two lists differ, and an application that assumes otherwise will offer a control surface nobody can drive.no extension
ToRecognizerList
(no comment in the source: the name reads as a sentence) to recognizer listno extension
HasLanguage
(no comment in the source: the name reads as a sentence) has languageno extension
Accept
THE GRAMMAR: what it is allowed to hear ----------------------------- Declare every phrase this listener will accept. Anything else is a no-match, which is a RESULT rather than a failure -- "somebody said something that is not a command" is information a control surface needs.QCSXTZZZIBWU
AcceptedPhrases
(no comment in the source: the name reads as a sentence) accepted phrasesno extension
AcceptMeanings
THE AUTHOR STILL DECLARES THE MEANING. Nothing here infers one from the words -- "disk full" is a danger because somebody said so, not because a classifier guessed. That is the plane's standing rule: do not compute meanings the author should declare. What the face contributes is carrying the declaration, not making it.QCSXTZZZIBWU
MeaningHeard
The meaning of what was just heard, or "" -- and "" is a RESULT, not a failure. A no-match means somebody said something that is not a command, which is information a control surface needs; the dangerous alternative is a confident wrong meaning.no extension
AcceptedMeanings
(no comment in the source: the name reads as a sentence) accepted meaningsno extension
PhraseCount
(no comment in the source: the name reads as a sentence) phrase countno extension
HearSound
LISTENING ----------------------------------------------------------- Hear a stzSound -- which is what makes this testable with no microphone, and what lets a spoken phrase from stzVoice be fed straight back.no extension
HearMicrophoneFor
Hear the MICROPHONE. This is the consent boundary of the library: it opens an input device and listens. Local only -- nothing leaves this machine -- but a caller should still tell the operator it is listening, because an open microphone the operator cannot see is indefensible (Rule 82, visible state).no extension
HeardText
what came backno extension
Confidence
A SEPARATE CALL, on purpose: a recognised string without its confidence is a guess wearing a fact's clothes.no extension
HeardSomething
(no comment in the source: the name reads as a sentence) heard somethingno extension
WasNoMatch
A no-match is a RESULT, not an error: somebody said something that was not in the grammar, and a control surface needs to know that happened.no extension
Recognitions
countersno extension
NoMatches
(no comment in the source: the name reads as a sentence) no matchesno extension