SpeechRecognition.Recognize
---------------------------

Recognizes some text.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Speech](component_Speech.md) | [9.4](newinversion94.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "SpeechRecognition.Recognize"; FilePath { ; Locale; Hint; Flags; contextualStrings } ) 

**MBS**( **"SpeechRecognition.Recognize";** /\* Recognizes some text. \*/  
**$FilePath**; /\* The file path to the audio file to analyze.e.g. "/Users/cs/Desktop/test.m4a" \*/   
**$Locale**; /\* Optional; The locale to use.  
Leave empty to use user's current locale.e.g. "en-US" \*/   
**$Hint**; /\* Optional; The hint on what kind of speech recognition being performed  
Can be Search, Dictation, Confirmation or Unspecified.  
Default is Unspecified.e.g. "Dictation" \*/   
**$Flags**; /\* Optional; Various flags to control output:  
Add 1 to require on device recognition.  
Add 2 to output as JSON.  
Add 4 to include all transcriptions variants in JSON, not just the best one.  
Add 8 to include voice analysis in JSON.e.g. 1 + 2 \*/   
**$contextualStrings**) /\* Optional; Phrases which should be recognized even if they are not in the system vocabulary.e.g. "Monkeybread Software¶Plugin" \*/ 

### Parameters

| 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 |
| Flags | Various flags to control output:   Add 1 to require on device recognition.   Add 2 to output as JSON.   Add 4 to include all transcriptions variants in JSON, not just the best one.   Add 8 to include voice analysis in JSON. | 1 + 2 | Optional      Added in version **16.3**. |
| contextualStrings | Phrases which should be recognized even if they are not in the system vocabulary. | "Monkeybread Software¶Plugin" | Optional |

### Result

Returns text, JSON or error.

### Description

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

- [SpeechRecognition.Initialize](SpeechRecognitionInitialize.md)

### Release notes

- **Version 16.3**
    - Added flags to return JSON for SpeechRecognition.Recognize function.

### Example Databases

- [Mac and iOS/Speech Recognition](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Speech%20Recognition.shtml#6ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 16.3pr1](https://www.mbsplugins.de/archive/2026-06-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [From speech to text with FileMaker and MBS](https://www.mbsplugins.de/archive/2025-05-01/From_speech_to_text_with_FileM/monkeybreadsoftware_blog_filemaker)
- [Neue Funktionen des MBS FileMaker Plugin 9.4](https://www.mbsplugins.de/archive/2019-10-05/Neue_Funktionen_des_MBS_FileMa/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 22nd August 2019 , last changed 11st May 2026

  
[SpeechRecognition.IsInitialized](SpeechRecognitionIsInitialized.md) - [SpeechRecognition.RequestAuthorization](SpeechRecognitionRequestAuthorization.md)

[HTML Version](SpeechRecognitionRecognize.shtml)