メインコンテンツまでスキップ

コリジョン

ビューア上のスプラットは、デフォルトでは物理的な存在を持たず — カメラはスプラットを通り抜けてしまいます。StudioのCollisionセクションは、シーンのボクセル表現をスプラットに付加し、ビューアがそれに対して衝突できるようにします。コリジョンが付加されると、スプラットはウォーカブルになり — 訪問者は周囲を旋回するだけでなく、徒歩で移動できるようになります。Exploreページでもwalkableの特徴フィルタによってウォーカブルシーンが浮かび上がります。

ボクセルコリジョンとは​

ボクセルコリジョンアセットは、スプラットの粗い低解像度のボックスベース再構築です — 訪問者が立てる面、寄りかかれる面、ぶつかって止まる面です。スプラット自体とは別アセットなので、ビジュアル品質ではなくランタイム物理向けに独立して最適化できます。

通常、シーンごとに1度生成し、ベースのスプラットに大きな変更があった場合のみ再生成します。

ボクセルコリジョンのアップロード​

最もシンプルな経路は、事前生成されたボクセルファイルをアップロードすることです：

  1. Scene Assetsセクションを開きます。
  2. Voxelアップロードアクションをクリックします。
  3. コリジョンを記述するファイルペアをドロップします — JSONファイルと、その隣に置かれるバイナリファイル。
  4. アップロード状態インジケータがCompleteになるまで待ちます。
状態意味
Uploadingコリジョンファイルがプラットフォームに送信中。
Completeボクセルアセットが反映され、次のビューア再読み込みでシーンがウォーカブルになります。
Errorアップロード失敗 — ファイルを確認して再試行してください。

ボクセルコリジョンの生成​

ブラウザを離れずにスプラットからボクセルコリジョンを生成するには、Convertユーティリティを使えます。出力フォーマットとしてVoxel Collision Bundle（.voxel.zip）を選び、以下を調整します：

  • ボクセル解像度（デフォルト0.05） — 値を小さくすると面が細かくなりますが、アセットは大きく遅くなります。
  • 不透明度カットオフ（デフォルト0.1） — この閾値を超える不透明度のボクセルはソリッドと見なされます。

ConvertユーティリティはJSON+BINペアを含む.voxel.zipをダウンロードします。これを上記のようにStudioのVoxelセクションからアップロードします。

スクリプトやバッチ生成には、splat-transform CLIが同じ生成をvoxel.zipの出力ターゲットで提供しています。

シーンがウォーカブルになったとき​

ボクセルアセットが付加されると、シーンを表示する訪問者は純粋なオービットではなくウォークコントロールを得ます。ビューアはシーンにwalkableフラグも設定し、以下が起こります：

  • シーンページにwalkableバッジが表示されます。
  • walkable特徴フィルタが有効なときのExploreの結果に含まれます。

関連項目​

  • Convert — ブラウザでボクセルコリジョンを生成する
  • splat-transform — スクリプトやビルドパイプラインでボクセルコリジョンを生成する
  • Experience Settings — シーンアセット参照を格納するJSONコントラクト