SFSpeechRecognizerMBS.Constructor

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	SpeechRecognition	MBS MacFrameworks Plugin	19.4	✅ Yes	❌ No	❌ No	✅ Yes	All

Creates a speech recognizer associated with the user's default language settings.

Returns an initialized speech recognizer object, or nil if there was a problem creating the object.

If the user's default language is not supported for speech recognition, this method attempts to fall back to the language used by the keyboard for dictation. If that fails, this method returns nil.
Even if this method returns a valid speech recognizer object, the speech recognition services may be temporarily unavailable. To determine whether speech recognition services are available, check the available property.

See also:

• Constructor(locale as NSLocaleMBS)

SFSpeechRecognizerMBS.Constructor(locale as NSLocaleMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	SpeechRecognition	MBS MacFrameworks Plugin	19.4	✅ Yes	❌ No	❌ No	✅ Yes	All

Creates a speech recognizer associated with the specified locale.

locale: The locale object representing the language you want to use for speech recognition. For a list of languages supported by the speech recognizer, see supportedLocales.

Returns an initialized speech recognizer object, or nil if the specified language was not supported.

If you specify a language that is not supported by the speech recognizer, this method attempts to fall back to the language used by the keyboard for dictation. If that fails, this method returns nil.
Even if this method returns a valid speech recognizer object, the speech recognition services may be temporarily unavailable. To determine whether speech recognition services are available, check the available property.

See also:

• Constructor

SFSpeechRecognizerMBS.Destructor

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	SpeechRecognition	MBS MacFrameworks Plugin	19.4	✅ Yes	❌ No	❌ No	✅ Yes	All

The destructor.

SFSpeechRecognizerMBS.recognitionTaskWithRequest(request as SFSpeechRecognitionRequestMBS) as SFSpeechRecognitionTaskMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	SpeechRecognition	MBS MacFrameworks Plugin	19.4	✅ Yes	❌ No	❌ No	✅ Yes	All

Recognizes speech from the audio source associated with the specified request, using the specified events to manage the results.

request: A request (encapsulated in an SFSpeechRecognitionRequestMBS object) to recognize speech from an audio source.

Returns the task object you can use to manage an in-progress recognition request.

Use this method to initiate the speech recognition process on the audio contained in the request object. This method executes asynchronously and returns a SFSpeechRecognitionTaskMBS object that you can use to cancel or finalize the recognition process later. As results become available, the method calls the methods of the provided delegate object.
Note that the SFSpeechRecognitionTaskMBS object returned by this method does not retain your delegate object. You must maintain a strong reference to your delegate while speech recognition is in progress.

See also:

• recognitionTaskWithRequest(request as SFSpeechRecognitionRequestMBS, delegateHandler as recognitionTaskWithRequestCompletedMBS, tag as Variant = nil) as SFSpeechRecognitionTaskMBS

Some examples using this method:

• /MacFrameworks/SpeechRecognition Test/SpeechRecognition Test

SFSpeechRecognizerMBS.recognitionTaskWithRequest(request as SFSpeechRecognitionRequestMBS, delegateHandler as recognitionTaskWithRequestCompletedMBS, tag as Variant = nil) as SFSpeechRecognitionTaskMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	SpeechRecognition	MBS MacFrameworks Plugin	19.4	✅ Yes	❌ No	❌ No	✅ Yes	All

Executes the speech recognition request and delivers the results to the specified handler delegate.

request: A request (in an SFSpeechRecognitionRequestMBS object) to recognize speech from an audio source.
delegateHandler: The method to call when partial or final results are available, or when an error occurs. If the shouldReportPartialResults property is true, this event may be called multiple times to deliver the partial and final results.

The delegare has no return value and takes the following parameters:
result: A SFSpeechRecognitionResultMBS containing the partial or final transcriptions of the audio content.
error: An error object if a problem occurred. This parameter is nil if speech recognition was successful.

Request and Tag parameters are passed through to delegate.

Returns the task object you can use to manage an in-progress recognition request.

Use this method to initiate the speech recognition process on the audio contained in the request object. This method executes asynchronously and returns a SFSpeechRecognitionTaskMBS object that you can use to cancel or finalize the recognition process later. As results become available, the method calls the delegate in the delegateHandler parameter.

See also:

• recognitionTaskWithRequest(request as SFSpeechRecognitionRequestMBS) as SFSpeechRecognitionTaskMBS