360°・動画パイプライン
360° カメラやウォークスルー動画から WebAR³ VPS マップを生成する手順です。
フレーム抽出
ffmpeg -i hotel-tour.mp4 -vf fps=1 tour_frames/frame_%04d.jpg
- 動画の場合は 1〜2 fps で十分。
- Insta360 / Ricoh Theta などは正距円筒の JPG を書き出します。
フィーチャークラスタリング
webarvps feature cluster \
--input tour_frames/ \
--min-matches 120 \
--output clustered/
- 十分な重なりがあるフレームをグループ化し、ブレたカットを除去します。
インポート
webarvps map import \
--source clustered/ \
--name "ロビーウォークスルー"
CLI が選択したフレームを VPS 対応データセットに変換します。
ベストプラクティス
- 一定速度で歩き、急な旋回を避ける。
- 照明を均一に保ち、ハイライトが飛んだ箇所は再撮影。
- 公開後、Web SDK で経路を再生しローカリゼーションを確認。