Flutter 動画検索 SDK：Dartアプリへの組み込み
Flutter 動画検索 SDKは、検索対象の映像とDartアプリの画面をつなぎます。ここではv1.2.2のREADMEを参照し、設定、コレクション検索、画像表示、キャンセルまでを説明します。ログイン、画面遷移、認証情報の保存はアプリが担当します。
更新日:
Flutter 動画検索 SDKを固定バージョンで導入する
タグ付きREADMEはGit依存としての導入を案内しています。評価条件をそろえるには、移動するブランチではなくv1.2.2を指定します。既存アプリの依存関係へ追加し、通常のFlutterツールで解決してください。pub.devのページは発見用リンクとして参照し、すべてのGitタグが公開済みとは考えません。
対象アプリのFlutter・Dart制約を確認し、ロックファイルと評価に使ったタグを残します。このページでは設定宣言を示し、完全なDart呼び出し例は固定版READMEへ案内しています。別言語のSDKからメソッド名や引数を推測して移植しないでください。
dependencies:
vmodal_sdk_flutter:
git:
url: https://github.com/v-modal/vmodal_sdk_flutter.git
ref: v1.2.2参照: v1.2.2 README.md：依存宣言のmainを固定タグへ変更
プロジェクトとコレクション範囲を設定する
READMEでは、認証済みアプリが読み込んだキーからプロジェクトを作り、コレクションとストリームを指定する不変のスコープを保持します。ログイン画面やアカウント切り替えはアプリの責任です。プロジェクトを作ったセッションと一緒に管理してください。
アップロード、インデックス作成、検索、画像取得で同じ範囲を使います。別ユーザーや別環境のコレクション名を転用せず、利用可能な一覧を先に確認します。プロジェクトが変わったら以前の処理中表示や選択結果を破棄し、古い応答が新しい画面へ入らないようにします。
コレクションを検索して候補を確認する
最初は内容が分かっている映像を使い、見える行動やシーンを具体的に記述します。利用する検索ソースは、コレクションと対象リリースが対応する値を選びます。空の結果をクエリの問題と判断する前に、対象インデックスの準備が完了しているか確認します。
読み込み中、結果なし、成功、失敗を別の状態として表示します。候補には元映像と時間の文脈を添え、人が正しさを判断できるようにします。意図的に無関係な質問も試すと、弱い候補をどのように扱うか検討できます。
検索結果からフレーム画像を取得する
検索応答のメタデータと、タイルに表示する画像は別の処理です。固定版の画像リソース例に従い、返された識別子からURLを取得します。画像の問い合わせにも元のコレクションとストリームを引き継ぎ、多数の個別リクエストを無制限に開始しないでください。
署名付きURLでの画像取得に失敗しても、検索メタデータを捨てる必要はありません。URLが期限切れなら画像の問い合わせをやり直します。サムネイルが表示できない場合も、素材参照と時刻を保持すると、利用者はどの瞬間が候補だったかを理解できます。
キャンセルと画面のライフサイクル
このリリースは処理のキャンセルとアップロード進捗のストリームを扱います。進捗を購読した画面は破棄時に購読を解除し、キャンセルボタンは表示だけでなく基礎の処理へ通知します。結果がまだ必要かを判断できる画面やセッションに所有権を持たせます。
キーの更新だけでは、別アカウントへの切り替えにはなりません。READMEにある永続化状態、認証情報、プロジェクト資源の整理を確認してください。画面を離れた直後に検索が完了しても、現在のスコープと一致する応答だけを表示します。
エラーを発生した段階で扱う
認証、利用できないコレクション、処理中のインデックス、通信、画像表示の失敗を区別します。画像URLの更新だけで済む場面で全ファイルを再送しないよう、対象版の型付きエラーと回復方法を確認してください。
小さな受け入れ試験では、既知の録画を取り込み、準備状態を見て、検索して再生まで進みます。さらにアップロードの中止、検索中のコレクション変更、画像表示の再試行を試します。問題報告にはタグと失敗した段階を添えると、データの境界を追いやすくなります。