ビューアの操作
SuperSplat Viewerは、すべてのシーンページとその埋め込み、そしてEditorからエクスポートしたビューアで、訪問者が使うビューアです。このページでは、その組み込みインターフェースについて説明します。ヘッドセットやスマートフォンでのARについては、VRとARでの表示を参照してください。
読み込み
シーンの読み込み中、ビューアはポスター画像(設定されている場合)と、パーセンテージ付きのローディングバーを表示します。ストリーミングされるシーンは、レンダリングに十分なディテールがそろった時点で表示され、ストリーミングが進むにつれて精細になっていきます。コリジョンデータはバックグラウンドで読み込みが続き、読み込みが完了するとウォークモードが使えるようになります。
その後、カメラが動き始めます。シーンが開いたときにカメラアニメーションを再生する場合はそのアニメーションが再生され、そうでない場合は、開始カメラから始まる20秒間のゆっくりとしたループが再生されます。オブジェクトならその周囲を周回し、シーンなら内部でゆるやかな8の字を描きます。シーンを操作するとこの動きが止まり、カメラの操作が訪問者に移ります。
ツールバー
ツールバーはビューアの下部に沿って配置されています。左から順に、次のボタンがあります:
| ボタン | 機能 |
|---|---|
| Play / Pause | カメラアニメーションを再生・一時停止します。シーンにカメラアニメーションがある場合にのみ表示されます。再生中はツールバーの上にタイムラインが表示され、再生ヘッドの位置を示します。再生ヘッドをドラッグするとスクラブでき、再生は一時停止します。 |
| Orbit Camera | オービットモードに切り替えます。 |
| Fly Camera | フライモードに切り替えます。 |
| Walk Mode | ウォークモードに切り替えるか、直前のモードに戻ります。ウォークできるシーンでのみ表示されます。 |
| Settings | 設定パネルを開きます。 |
| Controls | コントロールパネルを開きます。 |
| Info | 情報パネルを開きます。 |
| Enter AR / Enter VR | ARまたはVRセッションを開始します。デバイスとブラウザが対応している場合にのみ表示されます。VRとARでの表示を参照してください。 |
| Fullscreen | フルスクリーン表示を切り替えます。 |
最後の操作から3秒たつとツールバーは薄暗くなり、その後非表示になります。次に操作すると再び表示されます。パネルが開いている間や、ポインターがツールバー上にある間は表示されたままです。ビューアの幅が狭い場合は、ボタンが小さくなることでFullscreenを含むすべてのボタンが表示範囲に収まります。スマートフォンやタブレットでは、デバイスを横向きにするとフルスクリーンが要求され、縦向きに戻すとフルスクリーンが解除されます。
カメラモード
| モード | キー | 機能 |
|---|---|---|
| Orbit | 1 | 焦点を中心にカメラを周回させます。オブジェクトの開始モードです。 |
| Fly | 2 | シーン内でカメラを自由に移動させます。 |
| Walk | 3 | シーンの床の上を、目の高さ(1.5 m)で重力とジャンプ付きで歩きます。コリジョンと、幅が5 m以上のシーンが必要です。ウォークできるシーンの開始モードです。 |
| Animation | — | カメラアニメーションを再生します。このモードはPlayで選択されます。 |
ビューアは、開始カメラがスプラットの範囲の外側にある場合はスプラットをオブジェクトとして、内側にある場合はシーンとして扱います。ウォークできないシーンは、フライモードで始まります。
デスクトップでは、フライモードとウォークモード以外でW、A、S、Dのいずれかを押すと、ウォークモード(ウォークできない場合はフライモード)に切り替わると同時にGaming Controlsがオンになります。
Gaming Controls
フライモードとウォークモードには、2種類の操作方式があります。デフォルトでは、行きたい場所をクリックまたはタップして移動し、ドラッグで見回します。これに対してGaming Controlsをオンにすると、次のようになります:
- デスクトップでは、ビューアがマウスをキャプチャします。マウスを動かすと見回し、W A S Dで移動します。Escでマウスが解放され、Gaming Controlsがオフになります。Gでオン・オフを切り替えられます。
- タッチデバイスでは、移動用のジョイスティックが表示され、ドラッグで見回します。設定パネルのGaming Controlsスイッチでオンにします。
コントロールパネル
Controlsを押すとツールバーの上にパネルが開き、現在のカメラモードの操作方法が、最後に使った入力方法(マウスとキーボード、またはタッチ)に合わせて一覧表示されます。モードを切り替えたり、Gaming Controlsのオン・オフを切り替えたりすると、表示が更新されます。初めての訪問者にはパネルが開いた状態で表示され、閉じるとビューアがそれを記憶します。Hで表示を切り替えます。
パネルには次の操作が表示されます。カメラアニメーションにはタッチ操作はなく、どこかに触れるとカメラの操作が訪問者に移ります。
オービットモード
| アクション | マウスとキーボード | タッチ |
|---|---|---|
| Orbit | 左ドラッグ | 1本指ドラッグ |
| Pan | 右ドラッグ | 2本指ドラッグ |
| Zoom | マウスホイール | ピンチ |
| Set Focus | クリック | タップ |
| Fly to Point | ダブルクリック | ダブルタップ |
| Frame Scene | F | — |
| Reset Camera | R | — |
フライモード
| アクション | マウスとキーボード | タッチ |
|---|---|---|
| Fly To | クリック | タップ |
| Look Around | 左ドラッグ | タッチ+ドラッグ |
| Pan | 右ドラッグ | — |
| Focus Point | ダブルクリック | ダブルタップ |
| Move | W A S D | ピンチ / 2本指ドラッグ |
| Run / Slow | Shift / Ctrl | — |
| Reset Camera | R | — |
Gaming Controlsがオンのときは、キャプチャされたマウス(またはタッチ+ドラッグ)でLook Aroundを、W A S D(またはジョイスティック)でMoveを、Q / EでVerticalを行い、EscがRelease Mouseになります。
ウォークモード
| アクション | マウスとキーボード | タッチ |
|---|---|---|
| Walk To | クリック | タップ |
| Look Around | 左ドラッグ | タッチ+ドラッグ |
| Fly to Point | ダブルクリック | ダブルタップ |
| Move | W A S D | — |
| Run / Slow | Shift / Ctrl | — |
| Reset Camera | R | — |
| Exit Walk | Esc | — |
Gaming Controlsがオンのときは、キャプチャされたマウス(またはタッチ+ドラッグ)でLook Aroundを、W A S D(またはジョイスティック)でMoveを、Space(またはタップ)でJumpを行い、EscがRelease Mouseになります。
アニメーション
| アクション | マウスとキーボード |
|---|---|
| Play / Pause | Space |
| Exit / Cancel | Esc |
設定パネル
Settingsを押すと、ツールバーの上に次のパネルが開きます:
| 設定 | 機能 |
|---|---|
| Show Annotations | 注釈のホットスポットとナビゲータの表示・非表示を切り替えます。注釈のあるシーンでのみ表示されます。 |
| Show Collision | シーンのコリジョンジオメトリをスプラットに重ねて描画します(V)。シーンのコリジョンを描画できる場合にのみ表示されます。ボクセルコリジョンの描画にはWebGPUが必要です。 |
| Gaming Controls | Gaming Controlsをオンにします。タッチデバイスで表示されます。デスクトップではGを使います。 |
| Quality | Performance / Default / High / Maxの4段階のスライダーです。各段階にはDefault · 4Mのように、その段階で得られるガウシアンバジェットがラベルとして表示されます。Qualityを参照してください。 |
| Performance Mode | ビューアの代替スプラットレンダラーに切り替えます。Performance Modeを参照してください。 |
| Frame | オービットモードで、シーン全体をフレーミングします。 |
| Reset | カメラをリセットします。オービットモードでは開始時のビューに、フライモードとウォークモードではそのモードに入った位置に戻ります。 |
Show Annotations / Gaming Controls / Quality / Performance Modeの各設定はブラウザに保存されるため、訪問者が同じサイトで開くすべてのシーンに引き継がれます。
Quality
Qualityスライダーは、ガウシアンバジェット(ストリーミングされるシーンでビューアが一度に描画するガウシアンの最大数)を、デバイスごとに用意された段階から設定します。たとえばデスクトップでは2M、4M、8M、16Mです。Performanceでは、ビューアは解像度も半分にしてレンダリングします。すべてのデバイスの段階と開始位置、バジェットの仕組みはストリーミングとパフォーマンスで説明しています。
Performance Mode
Performance Modeは、ガウシアンをソートしない別のレンダラーで描画します。カメラが止まると、数フレームかけて画像が精細になります。デフォルトではオフで、WebGPUでのみ利用でき、Meta QuestやPicoのブラウザでは利用できません。
情報パネル
Infoパネル(Shift+H)には、ビューアのバージョン、使用中のレンダラーであるWebGPUまたはWebGL 2とGPU、PlayCanvas Engineのバージョンが表示されます。デスクトップでは、グローバルなキーボードショートカットも一覧表示されます。
キーボードショートカット
| キー | アクション |
|---|---|
| 1 | オービットモード |
| 2 | フライモード |
| 3 | ウォークモード、または直前のモードに戻る |
| W A S D | 移動。フライモードとウォークモード以外では、Gaming Controlsを有効にしてウォーク(またはフライ)モードに切り替え |
| G | Gaming Controlsの切り替え |
| V | Show Collision |
| F | Frame Scene(ウォークモードを除く) |
| R | Reset Camera |
| Space | Play / Pause(ウォークモードではJump) |
| H | コントロールパネルの表示切り替え |
| Shift+H | 情報パネルの表示切り替え |
| Esc | マウスの解放、ウォークモードの終了、またはパネルを閉じる |
ショートカットは、キーボードレイアウトで入力される文字に従います。キリル文字やギリシャ文字など、ラテン文字を入力しないレイアウトでは、USレイアウトのキー位置にフォールバックします。W A S Dは常にキー位置を使います。
注釈
注釈のあるシーンでは、注釈ごとに番号付きのホットスポットが表示されます。
- ホットスポットをクリックまたはタップすると選択されます。カメラが注釈のビューへなめらかに移動し、到着するとホットスポットの横のパネルにタイトルと本文が表示されます。タイトルも本文もない注釈ではパネルは表示されません。そこからオービットすると注釈の位置の近くを中心に回転し、パネルは開いたままになります。
- 注釈を順にたどるには、ナビゲータの前へ・次へ矢印を使います。ナビゲータには、注釈の番号とタイトルが表示されます。ナビゲータは注釈が2つ以上あるシーンで表示され、端まで進むと反対側の端に戻ります。
- ビューア内のほかの場所をクリックすると選択が解除されます。ドラッグはクリックとみなされないため、オービットしても選択はそのまま残ります。ナビゲータには最後の注釈がグレーアウトして残り、クリックすると再び選択できます。
シーンの一部に隠れているホットスポットは、カメラが止まると薄く表示されます。設定パネルのShow Annotationsで、ホットスポットとナビゲータを非表示にできます。
関連項目
- VRとARでの表示 — ヘッドセットとスマートフォンでのAR
- ストリーミングとパフォーマンス — ストリーミングされるシーンとガウシアンバジェット
- シーンページ — superspl.atで訪問者がビューアに出会う場所
- ビューアAPI — 同じ機能を自分のコードから制御する