/ Audio

A Flutter plugin to use speech recognition on iOS & Android

A Flutter plugin to use speech recognition on iOS & Android

speech_recognition

A flutter plugin to use the speech recognition iOS10+ / Android 4.1+

Installation

  1. Depend on it
    Add this to your package's pubspec.yaml file:
dependencies:
  speech_recognition: "^0.2.0+1"
  1. Install it
    You can install packages from the command line:
$ flutter packages get

Alternatively, your editor might support 'packages get'. Check the docs for your editor to learn more.

  1. Import it
    Now in your Dart code, you can use:
import 'package:speech_recognition/speech_recognition.dart';

Usage

//..
_speech = new SpeechRecognition();

// The flutter app not only call methods on the host platform,
// it also needs to receive method calls from host.
_speech.setAvailabilityHandler((bool result) 
  => setState(() => _speechRecognitionAvailable = result));

// handle device current locale detection
_speech.setCurrentLocaleHandler((String locale) =>
 setState(() => _currentLocale = locale));

_speech.setRecognitionStartedHandler(() 
  => setState(() => _isListening = true));

// this handler will be called during recognition. 
// the iOS API sends intermediate results,
// On my Android device, only the final transcription is received
_speech.setRecognitionResultHandler((String text) 
  => setState(() => transcription = text));

_speech.setRecognitionCompleteHandler(() 
  => setState(() => _isListening = false));

// 1st launch : speech recognition permission / initialization
_speech
    .activate()
    .then((res) => setState(() => _speechRecognitionAvailable = res));
//..

speech.listen(locale:_currentLocale).then((result)=> print('result : $result'));

// ...

speech.cancel();

// ||

speech.stop();

Recognition

Permissions

iOS

infos.plist, add :

  • Privacy - Microphone Usage Description
  • Privacy - Speech Recognition Usage Description
<key>NSMicrophoneUsageDescription</key>
<string>This application needs to access your microphone</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>This application needs the speech recognition permission</string>

:warning: Swift project

This plugin is written in swift, so to use with in a Flutter/ObjC project,
you need to convert the project to "Current swift syntax" ( Edit/Convert/current swift syntax)

Android

<uses-permission android:name="android.permission.RECORD_AUDIO" />

Limitation

On iOS, by default the plugin is configured for French, English, Russian, Spanish.
On Android, without additional installations, it will probably works only with the default device locale.

GitHub