Skip to content

Installation

From scratch

The SORI Flutter SDK is distributed as the sorisdk_flutter package on pub.dev.

sorisdk_flutter package

Use the package page to check the latest published version and generated Dart API reference.

We also provide a Flutter example app that demonstrates how to integrate the SDK.

SORI Example Flutter

Check out the example app and test how it works.

Integrate into an existing project

Add the package from pub.dev:

bash
flutter pub add sorisdk_flutter

Or add it to your pubspec.yaml file:

yaml
dependencies:
  sorisdk_flutter: ^0.2.3

Then run:

bash
flutter pub get

Android settings

The package merges the required Android permissions and foreground microphone service declaration from the plugin manifest. These include microphone, network, foreground service, and notification-related permissions.

Your app must keep Android minSdk at 24 or higher:

kotlin
android {
    defaultConfig {
        minSdk = 24
    }
}

On Android, startRecognition() requests runtime microphone permission when needed and continues the same start request after permission is granted.

If your app targets Android 13 or later and should show the foreground-service notification normally, request notification permission from your app flow before starting recognition.

iOS settings

iOS apps must include a microphone usage description in ios/Runner/Info.plist:

xml
<key>NSMicrophoneUsageDescription</key>
<string>Audio recognition requires microphone access.</string>

Add background audio mode only when your app is designed to continue recognition while backgrounded:

xml
<key>UIBackgroundModes</key>
<array>
    <string>audio</string>
</array>

Now you are ready to use the SDK. Next step is to Implementation.