Begins speaking a buffer of text.
- macOS 10.0–10.8Deprecated
The speech channel through which speech is to be spoken.
A pointer to the first byte of text to spoken.
The number of bytes of text to spoken.
A result code. See Result Codes.
also generates speech, but through a speech channel through which
you can exert control over the generated speech.
converts the text stream specified by the
into speech using the voice and control settings for the speech
chan, which should
be created with the
The speech is generated asynchronously. This means that control
is returned to your application before the speech has finished (and
probably even before it has begun). The maximum length of the text buffer
that can be spoken is limited only by the available RAM.
called while the channel is currently busy speaking the contents
of a prior text buffer, it immediately stops speaking from the prior
buffer and begins speaking from the new text buffer as soon as possible.
If you pass a zero-length string (or, in C, a
Speak, the Speech
Synthesis Manager stops all speech currently being synthesized by
the speech channel specified in the
without generating additional speech.
The text buffer must be locked in memory and must not move while the Speech Synthesis Manager processes it. This buffer is read at interrupt time, and moving it could cause a system crash. If your application defines a text-done callback function, then it can move the text buffer or dispose of it once the callback function is executed.