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

Vibe Coding Templates

このセクションでは、既存テンプレートの編集とカスタマイズ方法を説明します。事前構築済みテンプレートに焦点を当て、構造をより詳しく解説することで、機能拡張や車・箱などのメッシュオブジェクト置き換えを行いやすくします。

Vehicle Physics Model​

Vehicle Physics Model は、Arrival.Space のインタラクティブな車両向けにすぐ使える運転テンプレートです。ホイールベース物理、サスペンション、ステアリング、コリジョン、ヘッドライト、カメラ挙動、オーディオ、プレイヤーのマウント処理を1つに統合しているため、これらをゼロから実装する必要がありません。

プレイヤーが乗り込んで運転できる車両（車、カート、サービス車両など）を作りたい場合に使用してください。ゲームプレイ可能な車両挙動を素早く立ち上げ、ハンドリング、座席位置、ホイール配置、見た目を、全ロジックを書き直さずに調整したいときに特に有効です。

Parameters​

Model Parameters
シャーシとホイールのモデルアセット、および全体スケールを編集します。
ParameterDescriptionUnitMin/Max
Chassis Model (GLB)車体シャーシ GLB モデルの URL またはアセット。asset-
Chassis Scaleシャーシモデルのスケール。factor0.01 / 10
Wheel Modelホイール GLB モデルの URL またはアセット。asset-
Wheel Scaleホイールのスケール。factor0.01 / 10
Vehicle Physics
質量、減衰、シミュレーション更新レートなどの基本物理挙動を編集します。
ParameterDescriptionUnitMin/Max
Chassis Mass車両の総質量。高いほど重く、応答が鈍くなります。kg100 / 5000
Air Friction空気抵抗 / 線形減衰。時間経過で速度を減衰させます。unitless0 / 1
Angular Damping角減衰。スピンを抑え回転を安定化します。unitless0 / 1
Physics Hz物理シミュレーション更新レート。高いほど精度は上がりますが負荷も増えます。Hz30 / 240
Physics Sub-Steps1フレーム内の追加サブステップ。安定性を向上させます。count1 / 60
Wheel Positioning
ホイールサイズと、前後ホイールの X/Y/Z 位置を正確に編集します。
ParameterDescriptionUnitMin/Max
Wheel Radiusホイール半径。車高や物理挙動に影響します。m0.1 / 1
Front Wheel X前輪の中心からの水平オフセット。m0.1 / 3
Rear Wheel X後輪の中心からの水平オフセット。m0.1 / 3
Wheel Heightホイールの垂直位置。m0.1 / 3
Wheel Front Z前輪の前後方向位置。m0 / 3
Wheel Rear Z後輪の前後方向位置。m-3 / 0
Suspension
サスペンションの硬さ、減衰、静止時長さを編集します。
ParameterDescriptionUnitMin/Max
Suspension Stiffnessサスペンション剛性。高いほど硬い挙動になります。unitless1 / 100
Suspension Dampingサスペンション減衰。過度なバウンドを防ぎます。unitless0.1 / 10
Suspension Compression圧縮時の減衰。unitless0.1 / 10
Suspension Rest静止時の標準サスペンション長。m0.05 / 1
Tire Grip & Handling
タイヤグリップとロール挙動を調整して、トラクションと操縦性を最適化します。
ParameterDescriptionUnitMin/Max
Front Friction Slip前輪のグリップ量。高いほどトラクションが増えます。unitless0 / 5
Rear Friction Slip後輪のグリップ量。unitless0 / 5
Roll Influenceロールが挙動へ与える影響度。低いほど横転しにくくなります。unitless0 / 1
Engine & Braking
加速力、制動力、入力なし時のブレーキ挙動を編集します。
ParameterDescriptionUnitMin/Max
Max Engine Force最大エンジン力 / 加速力。Chassis Mass が重い場合は増やしてください。force units0 / 10000
Max Braking Force最大ブレーキ力。force units0 / 500
Idle Brake入力がないときに自動でかかるブレーキ力。惰性移動を抑えます。force units0 / 50
Steering
操舵角、応答速度、高速時の操舵制限を編集します。
ParameterDescriptionUnitMin/Max
Max Steering低速時の最大操舵角。rad0.05 / 1
Min Steering (at speed)高速時の最小操舵角。rad0 / 0.5
Steering Falloff Speed速度に応じて操舵が制限され始める基準速度。m/s1 / 50
Steering Speed操舵応答速度。1/s1 / 30
Collision
コリジョンボックスのサイズ、Yオフセット、物理マテリアル挙動を編集します。

このユースケースでは Box Collision を使用します。十分に機能するためです。 コリジョンを可視化するには、Vibe を編集し、AI に pc.enablePhysicsDebugDraw = true で可視化トグルを追加するよう指示してください。すべてのアクティブなコリジョンが表示されます。 この機能は非常に高負荷です。 重い/複雑な Space では常時有効化しないことを推奨します。挙動異常やパフォーマンス低下の原因になります。

ParameterDescriptionUnitMin/Max
Collision Widthコリジョンボックスの幅。m0.05 / 5
Collision Heightコリジョンボックスの高さ。m0.01 / 2
Collision Lengthコリジョンボックスの長さ。m0.05 / 5
Collision Y Offsetコリジョンボックスの垂直オフセット。m0 / 3
Chassis Frictionシャーシボディの摩擦値。unitless0 / 1
Chassis Restitution反発係数 / レスティテューション。unitless0 / 1
Headlights
ヘッドライトの位置、照射形状、色、強度、到達距離を編集します。
ParameterDescriptionUnitMin/Max
Headlight Sideヘッドライトの左右オフセット。m0 / 2
Headlight Heightヘッドライトの高さ。m-1 / 2
Headlight Forwardヘッドライトの前方オフセット。m-1 / 3
Headlight Colorヘッドライトの色。color-
Headlight Intensityヘッドライトの明るさ/強度。intensity units0 / 20
Headlight Cone Angleスポットライトのコーン角。deg1 / 90
Headlight Range最大照射距離。m1 / 100
Headlight Tiltヘッドライトの上下チルト角。deg-45 / 45
Player Interaction
乗車可能距離と、車内のプレイヤー座席位置を編集します。
ParameterDescriptionUnitMin/Max
Enter Distanceプレイヤーが乗車できる距離。m1 / 10
Seat Sideプレイヤー座席の水平オフセット。m-1 / 1
Seat Heightプレイヤー座席の垂直オフセット。m-1 / 3
Seat Forwardプレイヤー座席の前後オフセット。m-1 / 1
Camera
車両基準のカメラ高さと距離を編集します。
ParameterDescriptionUnitMin/Max
Camera Height Offset車両基準のカメラ垂直オフセット。m-1 / 2
Camera Distance車両からのカメラ距離。m0.8 / 4
Animations
乗車中に使用するドライブ/アイドルアニメーションを編集します。
ParameterDescriptionUnitMin/Max
Ride Idle Animation走行中に使うアイドル/着座アニメーション。animation asset-
Audio
走行サウンドアセット、音量、ピッチ、速度連動の音挙動を編集します。
ParameterDescriptionUnitMin/Max
Drive Soundエンジン/走行音のオーディオファイル。audio asset-
Drive Sound Volume走行音の音量。gain0 / 10
Drive Sound Min Speed音が鳴り始める最小速度。m/s0 / 20
Drive Sound Pitch基本ピッチ。pitch factor0.25 / 4
Drive Speed Pitch速度に応じたピッチ上昇。pitch factor per m/s0 / 1
Drive Accel Pitch加速/負荷に応じたピッチ上昇。pitch factor0 / 2

Exchange the Model​

モデルを差し替えるには、まず新しいモデルアセットが必要です。車体（chassis） と ホイール を別々にエクスポートできることが重要です。 例えば Sketchfab から車両アセットを取得できます。形式は .glb \ .gltf である必要があります。

Arrival.Space に取り込む前に、シャーシとホイールを分離してください。 以下は Blender を使う例です。

Steps​

  1. Blender を開く
  2. New File で General を選択
  3. 初期オブジェクト（Camera, Cube, Light）を削除
  4. File > Import > glTF 2.0 (.glb/.gltf) でアセットを読み込む
  5. 車体/シャーシ と関連パーツ（ホイール除く）を選択
  1. File > Export > glTF 2.0 へ移動
  2. エクスポート前に次のみ有効化:
    • Include > Limit to > Selected Objects
    • Transform > +Y Up
    • Data > Mesh > UVs + Normals
  1. エクスポートして Chassis Model として Arrival.Space にアップロード
  2. 前左ホイール を選択し、他オブジェクトを Eye アイコン で一時非表示
  1. ホイール中心を正しく合わせるため、以下を実行: Shift + S > Selection to Cursor
  2. すべてのトランスフォームを適用:
    • CTRL + A (Windows) > All Transforms
    • Command + A (macOS) > All Transforms
  3. File > Export > glTF 2.0 へ移動
  4. ステップ7と同じ設定でエクスポート
  5. ホイールモデルを Wheel Model URL として Arrival.Space にアップロード
  6. パラメータを調整

Google 3D Tiles (Atmosphere)​

Google 3D Tiles (Atmosphere) テンプレートは、Google の Photorealistic 3D Tiles を Space にストリーミングし、場所、年間日、UTC 時刻に基づく大気の Sky、空気遠近の Haze、太陽ディスクを追加します。

実在する都市、風景、建物のコンテキストを Space の周囲に配置したい場合に使用します。特に Splat Crop テンプレートと組み合わせると便利です。Google 3D Tiles が広い環境を提供し、切り出した Gaussian Splat が特定のローカル領域を置き換えたり補強したりできます。

Access Token

Google 3D Tiles をストリーミングするには、Map Tiles API を有効化した Google Maps API Key、または Cesium Ion Token が必要です。EEA の Billing Account では、Google が Photorealistic 3D Tiles への直接アクセスをブロックする場合があるため、Cesium Ion Token (EEA) フィールドを使用してください。

Cesium Ion Token を取得するには、Cesium ion アカウントを作成または開き、Access Tokens に移動して Token を作成します。必要なアクセス権はできるだけ限定し、その Token を Cesium Ion Token (EEA) にコピーしてください。Cesium は、アプリケーションごとに個別の Token を作成し、可能であれば scopes、許可 URL、選択 Asset で制限することを推奨しています。公式ガイド: Cesium ion Access Tokens

推奨セットアップ​

  1. Google 3D Tiles (Atmosphere) Vibe テンプレートを Space に追加します。
  2. Google Maps API Key または Cesium Ion Token (EEA) を入力します。
  3. ストリーミングされる場所が Space に合うように、Latitude、Longitude、Ground Altitude (m) を設定します。
  4. Space Edit > Pro > Lighting & Skybox を開き、Skybox を非表示にして Post Effects > HDR を有効化します。Atmosphere と太陽ディスクは HDR 有効時に最もきれいに見えます。
  5. 影の先端に立って上を見ながら、Time UTC (h) と Day of Year を調整し、影の方向と空の雰囲気が合うように太陽を設定します。
  6. 大きなスケールで移動する場合は Altitude Adaptive Cam を有効のままにします。Camera のクリッピングが合わない場合は Near Clip (m) と Far Clip (m) を調整します。
  7. Google 3D Tiles 環境内のローカル領域を Gaussian Splat で置き換えたい場合は、Splat Crop を追加します。

Parameters​

アクセス & 位置
Tile ソースに接続し、Space の中心に置く実世界の位置を定義します。
ParameterDescriptionUnitMin/Max
Google Maps API KeyMap Tiles API を有効化した Google Maps Platform の API Key。プロジェクトで Google への直接アクセスが使える場合に使用します。key-
Cesium Ion Token (EEA)Google Photorealistic 3D Tiles への代替ルートとして使用する Cesium ion Access Token。特に EEA の Billing Account 向けです。token-
LatitudeVibe エンティティに中心合わせする場所の緯度。degrees-90 / 90
LongitudeVibe エンティティに中心合わせする場所の経度。degrees-180 / 180
Ground Altitude (m)Vibe エンティティ原点に配置される WGS84 楕円体高。道路、地形、建物が Space の床に合うまで調整します。m-500 / 9000
ストリーミング & スケール
Tile の Detail、シーンスケール、ロード状況の表示を編集します。
ParameterDescriptionUnitMin/Max
DetailTile の詳細度を制御します。値を上げると建物や地形は鮮明になりますが、Performance と帯域幅の負荷が増えます。factor2 / 6
ScaleTileset 全体をスケールします。ミニチュアや地球儀のようなセットアップには低い値、実寸に近い環境には高い値を使います。factor0.000001 / 10
Show Status接続、ロード、Missing-Key などのステータスメッセージを Space 内に表示します。toggle-
Camera
極小または惑星スケールのシーン向けに Camera クリッピングと Free Cam 挙動を編集します。
ParameterDescriptionUnitMin/Max
Altitude Adaptive CamCamera の高度に応じて Near Clip、Far Clip、Free Cam 速度を自動調整します。Google Tiles では推奨です。toggle-
Near Clip (m)Camera の最小描画距離。深度精度が不安定な場合は慎重に上げ、近いオブジェクトが消える場合は下げます。m0.01 / 100
Far Clip (m)Camera の最大描画距離。遠くの Tiles が早く消える場合は上げ、小さいシーンでは深度精度のために下げます。m1000 / 20000000
Free Cam Max Speed (m/s)Free Cam ナビゲーションの最大速度。m/s50 / 1000000
Tile の見た目
ストリーミングされた Google Tile マテリアルの色補正と任意の Scene Light 反応を編集します。
ParameterDescriptionUnitMin/Max
Brightness最終的な Tile の明るさを乗算します。factor0 / 3
Contrast中間グレーを基準にコントラストを調整します。factor0 / 3
Saturation色の彩度を調整します。factor0 / 2
TintTiles に色味を適用します。白は Tint なしです。color-
Direct Light (scene sun)Google の baked photo look だけでなく、Scene Sun で Tiles を再ライティングします。toggle-
Gloss (lit)Direct Light 有効時の表面 Gloss。factor0 / 1
Ambient Response (lit)Direct Light 有効時の Ambient Light 反応。factor0 / 2
Atmosphere & Sun
Atmospheric haze、Sky Exposure、太陽位置を編集します。
ParameterDescriptionUnitMin/Max
AtmosphereAtmosphere、Sky shell、空気遠近 Haze を有効化します。toggle-
Time UTC (h)太陽方向を計算する UTC 時刻。日中の影を動かすにはこの値を調整します。h0 / 24
Day of Year季節ごとの太陽高度に使う年間日。季節をシミュレートするにはこの値を調整します。day1 / 366
Sun IntensityAtmosphere 計算に使う太陽光の強さ。intensity0 / 100
Sky ExposureSky と Haze の Exposure 乗数。factor0.1 / 5
Air Pollution (haze)Aerosol haze の量。値を上げると、より厚く柔らかい Atmosphere になります。factor0 / 5
Force Tonemap OnHDR レンダリングが有効でも Atmosphere 自体に Tonemap を強制します。Post Effect HDR が有効な場合は通常オフのままにします。toggle-
Sun Disc Brightness (HDR)表示される太陽ディスクの明るさ。高い値で HDR ハイライトや Bloom が強くなります。intensity0 / 200

Splat Reveal​

Splat Reveal Template は、Space にすでに読み込まれている Gaussian Splats に表示アニメーションを適用します。Radial、Sweep、Rain、Scatter、Dissolve、明るさによる Bloom などを選択できます。Splat は小さな点から成長し、位置へ移動しながら Glow Color で発光できます。

既存の Gaussian Splat にローディング演出やスタイル付きのトランジションを追加する場合に使用します。統合 LOD ストリーミング、個別の Splat コンポーネント、WebGL、WebGPU に対応しています。この Template 自体は Splat を読み込まないため、先に Gaussian Splat を追加してください。

推奨セットアップ​

  1. Gaussian Splat を Space に追加し、読み込みが完了するまで待ちます。
  2. Splat Reveal Vibe Template を追加します。
  3. Pattern で Radial、Sweep Up、Sweep Down、Rain、Scatter、Dissolve、Bloom (by brightness) から選択します。
  4. Duration (s)、Softness、Dot Size、Entrance Motion を調整します。
  5. Glow Color と Glow Strength を設定します。
  6. 繰り返す場合は Loop と Loop Pause (s) を有効にします。単発再生では Loop を無効にします。

Parameters​

Reveal Pattern
Splat が表示される順序とスタイルを設定します。
ParameterDescriptionUnitMin/Max
PatternReveal のパターンです。option-
Duration (s)非表示から完全表示までの時間です。s0.2 / 20
SoftnessSplat の表示タイミングの重なりです。factor0 / 1
JitterSplat ごとのランダムなタイミングのずれです。factor0 / 1
Entrance Motion
表示時のサイズと移動を調整します。
ParameterDescriptionUnitMin/Max
Dot Size初期サイズの割合です。factor0.01 / 1
Entrance Motion最終位置まで移動する距離です。m0 / 10
Settle Hop成長完了時の上下方向のジャンプです。m0 / 3
End Bump完了時の一度だけの拡大パルスです。factor0 / 2
Glow
発光色と強さを設定します。
ParameterDescriptionUnitMin/Max
Glow Color表示中に Splat へ混ぜる色です。color-
Glow StrengthGlow の強さです。factor0 / 1
Playback
一度だけ再生するか、自動的に繰り返すかを設定します。
ParameterDescriptionUnitMin/Max
Loop完了後に Reveal を再スタートします。toggle-
Loop Pause (s)ループ間の待機時間です。s0 / 10

Scene Tour Camera​

Scene Tour Camera Template は、配置されたコンテンツを一覧表示する Overlay を Space 内に作成し、Free Cam で選択した対象へ移動できるようにします。GLB や Gaussian Splats を検出し、World Bounds に合わせてカメラを配置します。

ガイド付きツアー、展示、ポートフォリオ、ショールームに使用します。Panel には名前、タイプ、距離が表示されます。手動操作または Free Cam モードを離れる操作で移動や Orbit はキャンセルされます。F または Exit free cam で終了できます。

推奨セットアップ​

  1. Scene Tour Camera Vibe Template を Space に追加します。
  2. 表示したい GLB や Gaussian Splat を User Content として配置します。
  3. Type Filter で All、GLB、Splats を選択します。
  4. View Distance × と View/Orbit Height × を調整します。
  5. Smooth Fly でアニメーション移動を有効にします。
  6. Auto-Rotate と Orbit Speed (°/s) で到着後の Orbit を設定します。負の値で方向を反転します。
  7. コンテンツを変更した後は Panel の Refresh ボタンで一覧を更新します。

Parameters​

Camera Framing
対象をフレームに収める距離と高さを調整します。
ParameterDescriptionUnitMin/Max
View Distance ×対象の Bounding Radius に対するカメラ距離の倍率です。factor1 / 8
View/Orbit Height ×対象の中心からのカメラ高さの倍率です。factor-2 / 4
Tour Controls
移動、Orbit、表示するコンテンツタイプを設定します。
ParameterDescriptionUnitMin/Max
Smooth Fly現在位置から対象までアニメーション移動します。toggle-
Auto-Rotate到着後に対象の周囲を Orbit します。toggle-
Orbit Speed (°/s)Orbit の速度です。°/s-90 / 90
Type Filter一覧を All、GLB、Splats で絞り込みます。option-

Space 内の Panel​

Overlay には Display Name、コンテンツタイプ、距離が表示されます。行を選択すると Free Cam に切り替わり、対象をフレームに収めます。Exit free cam で通常のカメラモードに戻ります。

Splat Crop​

Splat Crop テンプレートは、Space 内ですでに読み込まれている Gaussian Splats 用の移動可能な Crop Box を作成します。Gizmo で Vibe エンティティを移動・回転し、Box Size (m) で寸法を設定します。デフォルトでは、Box 内の Splats が保持され、Box 外の Splats は非表示になります。

大きな Splat の一部を切り出したい場合、不要な周辺を削りたい場合、またはローカルの Gaussian Splat と Google 3D Tiles (Atmosphere) を組み合わせたい場合に使用します。併用すると、同じ Crop Box で Google Tiles にも一致する穴を開けられるため、Splat と都市コンテキストの見た目の重なりを避けられます。

Google 3D Tiles と組み合わせる推奨セットアップ​

  1. Google 3D Tiles (Atmosphere) を追加し、まずストリーミング位置を合わせます。
  2. Gaussian Splat を Additional Content として追加し、対応する Google Tile 領域の上に配置します。
  3. Splat Crop を追加し、保持したい Splat 領域の上に Crop Box を移動します。
  4. Box で Splat をクロップする場合は Crop Splats を有効のままにします。
  5. Cull Google Tiles を有効化し、同じ Box 形状の領域を Google 3D Tiles から切り抜きます。
  6. Box 内の Splat 領域を保持ではなく削除したい場合のみ、Invert (carve hole) を使用します。
  7. Crop の配置が確定したら、Show Box で視覚的なヘルパーを非表示にします。

Parameters​

Crop Box
Crop ボリュームと、境界を硬くするか柔らかくするかを編集します。
ParameterDescriptionUnitMin/Max
Box Size (m)Crop Box の幅、高さ、奥行き。Vibe エンティティの位置と回転で、Box が Space 内のどこにあるかを定義します。m0.1 / 100000
Edge SoftnessCrop 境界付近の Splats を縮小してエッジを柔らかくします。低い値ほど硬いエッジになります。factor0.01 / 1
Crop 挙動
Box が Splats、Google Tiles、またはその両方に影響するかを選択します。
ParameterDescriptionUnitMin/Max
Crop SplatsSpace 内に読み込まれたすべての Gaussian Splats に対する Cropping を有効化します。Box を Google Tiles のみに使う場合は無効化します。toggle-
Invert (carve hole)Crop 結果を反転します。オフでは Box 内の Splats を保持し、オンでは Box 内の Splats を削除します。toggle-
Show BoxCrop の位置と設定を調整している間、Space 内に Crop Box ヘルパーを表示します。toggle-
Cull Google TilesCrop Box を Google 3D Tiles Vibe に送信し、ストリーミングされた Tiles から同じ領域を削除します。Splat で Google Tiles の一部を置き換える場合に使用します。toggle-