Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Recognizes some text.

Component Version macOS Windows Linux Server iOS SDK
Speech 9.4 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "SpeechRecognition.Recognize"; FilePath { ; Locale; Hint; requiresOnDeviceRecognition; contextualStrings } )   More


Parameter Description Example Flags
FilePath The file path to the audio file to analyze. "/Users/cs/Desktop/test.m4a"
Locale The locale to use.
Leave empty to use user's current locale.
"en-US" Optional
Hint The hint on what kind of speech recognition being performed
Can be Search, Dictation, Confirmation or Unspecified.
Default is Unspecified.
"Dictation" Optional
requiresOnDeviceRecognition Whether you require on device recognition.
Pass 1 to require on device recognition or 0 for the case it doesn't matter.
1 Optional
contextualStrings Phrases which should be recognized even if they are not in the system vocabulary. "Monkeybread Software¶Plugin" Optional


Returns text or error.


Recognizes some text.
The plugin creates a new speech recognition request based on the given audio file. Then we let the system recognize the text and return it to you.
This may take a while and the plugin returns after a few seconds when work is done.

Requires MacOS 10.15 or iOS 10 or newer.

See also

Example Databases

Blog Entries

This function checks for a license.

Created 22nd August 2019, last changed 22nd August 2019

SpeechRecognition.IsInitialized - SpeechRecognition.RequestAuthorization