the_speech_to_text_button 0.0.2

A Flutter widget that provides a simple button for speech-to-text transcription, handling permissions and errors across platforms.

TheSpeechToTextButton

A Flutter widget that provides a simple button for speech-to-text transcription, handling permissions and errors across platforms.

Try the example right away in your browser.

Features

• Android and iOS support
• Web support
• MacOS support
• Customizable builder
• Permission handling
• Error handling

Why does this package exist?

Handling speech recognition is a pain. You should handle permissions, and you shouldn't ask permissions when app just started. It's better to ask permissions when user starts to use feature. Also you should handle errors and provide a good user experience.

This package handles all of this.

Getting started

To use this package, add the_speech_to_text_button as a dependency in your pubspec.yaml file.

iOS & MacOS

You need to add the following to your Info.plist file:

<key>NSMicrophoneUsageDescription</key>
<string>Allow $(PRODUCT_NAME) to access your microphone to record audio to transcribe text</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>Allow $(PRODUCT_NAME) to access your microphone to record and transcribe audio to text</string>

copied to clipboard

Please rephrase the usage description to your needs.

Add the following to your Podfile:

platform :ios, '14.0'
...

  target.build_configurations.each do |config|
    config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
      '$(inherited)',

      ## dart: PermissionGroup.microphone
      'PERMISSION_MICROPHONE=1',

      ## dart: PermissionGroup.speech
      'PERMISSION_SPEECH_RECOGNIZER=1',
    ]
  end

copied to clipboard

Android

Add the following to your AndroidManifest.xml file:

<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<queries>
        <intent>
            <action android:name="android.speech.RecognitionService" />
        </intent>
</queries>

copied to clipboard

Permission handling is done by permission_handler. Please refer to the permission_handler documentation for more information.

Speech recognition is done by speech_to_text. Please refer to the speech_to_text documentation for more information.

Usage

TheSpeechToTextButton(
  onResult: (result) {
    // Handle the result. For example, update a text field.
  },
  askPermissionDialogBuilder: askPermissionDialogBuilder,
  ),

copied to clipboard

Ask permission dialog builder

The askPermissionDialogBuilder is a function that builds a dialog to ask the user to grant permission to access the microphone and speech recognition.

void askPermissionDialogBuilder(void Function()? onOpenSettings) {
  showDialog<void>(
    context: context,
    builder:
        (context) => AlertDialog(
          title: const Text('Permission required'),
          content: const Text(
            'Please enable microphone and speech recognition',
          ),
          actions: [
            if (onOpenSettings != null)
              TextButton(
                onPressed: onOpenSettings,
                child: const Text('Open settings'),
              ),
          ],
        ),
  );
}

copied to clipboard

Take a note that onOpenSettings is optional. If it is not provided, the dialog will not have a button to open the settings.

Also you can provide a controller to the button. It allows you to control the state of the button outside of the widget. Also it allows you to handle state changes and ask for permissions.