Flutter SDK

SORI Flutter SDKを使用すると、Android、iOS、WebのFlutterアプリに、SORIによる音声認識、キャンペーン検出、アクションリンク処理を追加できます。

前提条件

• Flutter 3.3.0以降
• パッケージ制約を満たすDart SDK
• Android API level 24以降
• iOS 13.0以降
• Webの場合: セキュアコンテキスト（https://またはhttp://localhost）、Web AudioとgetUserMedia()に対応したモダンブラウザ、bridge準備用のNode.jsとnpm

Flutterパッケージは、ネイティブのSORI Android SDKとiOS SDKをラップし、ビルド時bridgeを通じてSORI Web SDKを適応させます。Flutterアプリで、認識の開始、キャンペーンイベントの受信、サポート対象プラットフォームでの認識データベースの更新、処理済みアクションURLのレポートを1つのDart APIで扱いたい場合に使用します。

WARNING

app_idとsecret_keyは、モバイルアプリをSORI API Serverで認証するための値です。実際の値をリポジトリ、サンプルアプリ、Issue、スクリーンショット、公開ドキュメントにコミットしないでください。Webアプリでは長期有効なsecretをサーバーに保持し、ephemeral key endpointを使用する必要があります。

ガイド

• インストール
• 実装

APIメモ

Flutterパッケージは、認識lifecycleイベント、キャンペーン/結果/エラーイベント、opt-inオーディオマーカーイベント、データベース更新、明示的なaction URL処理を提供します。位置情報、metadata provider、raw audio buffer、自動action URLオープンはpublic Flutter APIには含まれていません。

sorisdk_flutter 0.4.0パッケージとDart APIリファレンスを参照してください。

サンプルアプリのリファレンス

SDKをFlutterアプリに統合する方法を示すFlutterサンプルアプリを提供しています。

SORI Example Flutter

v0.4.0

Android 5.1.0とiOS 5.1.0を含みます。Web SDK 0.6.10とWeb bridge 0.1.5に変更はありません。

• 最新のnative SDKを採用し、AndroidとiOSで認識を中断せずに対象マテリアルを更新できるようになりました。更新中の安定性と継続性が向上しています。

v0.3.8

Android 5.0.13、iOS 5.0.12、Web SDK 0.6.10、Web bridge 0.1.5を含みます。

• すべてのプラットフォームでデフォルトのAudio Marker検出器を更新しながら、markerのオプトイン、fingerprint-onlyのデフォルト動作、既存のDart APIを維持します。
• Flutter Web利用者はnpm依存関係とlockfileを更新し、sori-flutter-web prepareを実行してから再ビルド、再デプロイする必要があります。デプロイ済みのアセットは自動更新されません。

v0.3.7

Android 5.0.12とiOS 5.0.11を含みます。

• AndroidとiOSで連続認識中のキャンペーン識別を改善しました。

v0.3.6

Android 5.0.11とiOS 5.0.10を含みます。

• Androidで連続認識中のバッテリー効率を改善しました。
• Android、iOS、Webで認識の安定性を改善しました。

v0.3.5

Android 5.0.10とiOS 5.0.9を含みます。新しいマーカー状態のライフサイクルはこれらのモバイルプラットフォームに適用され、Webの動作は維持されます。

• SDKが管理する現在のオーディオマーカー状態とアクティビティ結果APIを追加しました。
• 有効なマーカーtraitで認識結果を補完し、マーカーが後から識別された場合は同じアクティビティを更新します。
• 現在の状態がクリアされても過去の結果のマーカーを保持します。状態の保持は条件付きであり、必ず4秒間表示されるわけではありません。
• 既存のキャンペーンコールバックと開始・停止の連携を維持します。オーディオマーカー認識は明示的な有効化が必要です。

状態・アクティビティ結果の連携とインストール・更新手順を参照してください。