Instance Method

startSpeakingString:

Begins speaking synthesized text through the system’s default sound output device.

Declaration

- (BOOL)startSpeakingString:(NSString *)string;

Parameters

text

Text to speak. When nil or empty, no synthesis occurs.

Return Value

YES when speaking starts successfully, NO otherwise.

Discussion

If the receiver is currently speaking synthesized speech when startSpeakingString: is called, that process is stopped before text is spoken.

When synthesis of text finishes normally or is stopped, the message speechSynthesizer:didFinishSpeaking: is sent to the delegate.

See Also

Synthesizing Speech

speaking

Indicates whether the receiver is currently generating synthesized speech.

- startSpeakingString:toURL:

Begins synthesizing text into a sound (AIFF) file.

- pauseSpeakingAtBoundary:

Pauses synthesis in progress at a given boundary.

- continueSpeaking

Resumes synthesis.

- stopSpeaking

Stops synthesis in progress.

- stopSpeakingAtBoundary:

Stops synthesis in progress at a given boundary.

NSSpeechBoundary

These constants are used to indicate where speech should be stopped and paused. See pauseSpeakingAtBoundary: and stopSpeakingAtBoundary:.