インストール

ゼロから始める

SORI Flutter SDKは、pub.devのsorisdk_flutterパッケージとして配布されています。

sorisdk_flutter package

パッケージページで、最新の公開バージョンと生成されたDart API referenceを確認できます。

既存プロジェクトへの統合

pub.devからパッケージを追加します。

flutter pub add sorisdk_flutter

または、pubspec.yamlファイルに追加します。

dependencies:
  sorisdk_flutter: ^0.1.0

その後、次を実行します。

flutter pub get

Android設定

このパッケージは、必要なAndroid権限とforeground microphone service宣言をプラグインmanifestからマージします。これには、マイク、ネットワーク、foreground service、通知関連の権限が含まれます。

アプリのAndroid minSdkは24以上にしてください。

android {
    defaultConfig {
        minSdk = 24
    }
}

Androidでは、startRecognition()が必要に応じて実行時マイク権限をリクエストし、権限が許可されると同じ開始リクエストを続行します。

アプリがAndroid 13以降をターゲットにし、foreground-service通知を通常どおり表示する必要がある場合は、認識開始前にアプリのフローで通知権限をリクエストしてください。

iOS設定

iOSアプリでは、ios/Runner/Info.plistにマイク使用説明を含める必要があります。

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

アプリがバックグラウンド中も認識を継続する設計の場合にのみ、background audio modeを追加してください。

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

これでSDKを使用する準備ができました。 次のステップは実装です。