スマートグラス SDK Rust：ストリーミングコアの範囲
スマートグラス SDK Rust版のv0.1.0は、Android向け層と組み合わせるプラットフォーム共通のストリーミングコアです。汎用の映像検索クライアントではありません。このタグにはルートREADMEがないため、Cargoマニフェストとソースを基準に、入力、バッファ、再接続、サーバー側検索との境界を説明します。
更新日:
スマートグラス SDK Rust版の固定ソースを確認する
v0.1.0タグのsystem_core/Cargo.tomlから始めます。パッケージはvmodal-smartglass-system-core、バージョンは0.1.0、ライブラリ名はvmodal_smartglass_coreです。rlibとcdylibを出力する構成が定義されています。製品へ組み込む前に、マニフェストで宣言されたライセンスも確認してください。
以下は確認済みタグを取得する設定コマンドです。依存関係の評価はsystem_coreと対応するCargo.lockを使います。未コンパイルのRustアプリ例は掲載しません。開始文書がないタグでは、推測した検索メソッドより公開エクスポートとAndroidブリッジが確かな出発点です。
git clone --branch v0.1.0 --depth 1 https://github.com/v-modal/vmodal_sdk_smartglass.git参照: v0.1.0タグ・system_core/Cargo.toml・Cargo.lock
カメラ撮影とエンコード済み入力を分ける
コアはEncodedSample、SampleFlags、H264Framingを公開します。サンプルにはバイト列、提示時刻、フラグ、世代値があります。これは転送側の境界であり、Rustコアがあらゆるカメラや機器を直接制御するという意味ではありません。撮影と符号化を行う側が必要な入力を渡します。
どの部品が撮影し、どこがエンコードし、どこからコアへ渡すかを明示します。時刻の単位とフラグの意味を境界で保持してください。呼び出し成功だけでは、受信側が復号できることや意図した時間軸を保つことは分かりません。実機パイプラインで確認します。
バッファ結果を運用上の信号として扱う
bufferモジュールはAccepted、BackpressureDrop、NeedKeyframe、Stopped、InvalidSampleなどを定義しています。入力した全サンプルが配送済みと考えないでください。バックプレッシャーとキーフレーム要求は、撮影頻度、エンコーダー出力、ストリーム状態と一緒に扱います。
バッファとセッションを読んでから統合方針を決めます。低速な受信条件を作り、生成側が結果へ適切に応じるかを観察します。状態とメトリクスを端末の診断で確認できるようにしてください。全フレームの無損失保持や検索用アーカイブへの自動変換を約束するものではありません。
再接続の待機と状態遷移を理解する
再接続ポリシーは設定された待機時間、ジッター、切断タイムアウトを参照します。試行ごとの待機と切断期間の判定を行うため、Android側で単純な無限再試行へ置き換えず、セッションと転送モジュールを含めて評価します。
短い切断、長い停止、正常な終了を別々に試します。再接続後にコアが示す状態と受信映像を比較してください。接続が戻っても、過去の全サンプルが届いた証明にはなりません。失われた区間があれば、接続済み表示だけで隠さず記録します。
AndroidとJNIの所有権を整理する
リポジトリにはKotlinクライアント、ブリッジ、JNI実装、動画パイプラインがあります。Androidのライフサイクルや符号化と、共通コアを分ける構成です。Androidが対象なら同じタグの層を起点にし、設定、入力、イベントの流れを追います。
エラーと状態はネイティブ境界を越えてアプリへ戻ります。実際のブリッジ契約で状態画面を設計し、入力中の停止と破棄も試します。Rustクレートを一般的に組み込むだけでAndroid実機の撮影経路が再現されるとは考えず、別アダプターはそれぞれ検証します。
検索は別途検証したサーバー側の経路で行う
コアの公開面はサンプル、設定、セッション、転送です。ウェアラブル映像を検索するには、受信側の保持、コレクションへの取り込み、インデックス準備を別に確認します。その後、対応するAPIや検索SDKを使います。端末内で汎用の意味検索を行う機能として案内しないでください。
見える出来事を実機、受信、保存、インデックス、検索結果まで追う試験を行います。提示時刻と後続素材の対応を残し、提案段階の接続はその旨を明記します。機器、撮影層、受信形式、最後に検証できた地点を持って相談すると、ストリーミングと検索の主張を実際の確認に結びつけられます。