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

SuperSplat Viewer

SuperSplat Viewerは、superspl.atのすべてのシーンページをレンダリングする、オープンソースのウェブビューアです。スプラットと設定JSONドキュメントを受け取り、インタラクティブな3D体験に変換します。オービット・フライ・ウォークの各カメラモード、注釈、カメラアニメーション、ポストエフェクト、ウォーカブルなシーン向けのコリジョン、WebXR対応デバイスでのVRとARに対応しています。

ビューアはMITライセンスの下でGitHubでオープンソースであり、npmで@playcanvas/supersplat-viewerとして配布されています。

SuperSplat Viewerを埋め込んだブログ記事

ビューアの使い方​

シーンページ、埋め込み、Editorからエクスポートしたビューアのどこで動いていても、訪問者には同じビューアが表示されます。

  • ビューアの操作 — ツールバー、カメラモード、コントロール・設定・情報の各パネル、キーボードショートカット、注釈
  • VRとARでの表示 — セッションの開始、テレポート、つかんでの移動とスケール変更、ARでのスプラットの配置、ハンドメニュー

ビューアを直接使うとき​

superspl.atの公開シーンページは、通常スプラットを共有する最も簡単な方法です。ビューアを直接使う場合は次のようなニーズがあるときです:

  • superspl.atのクロームのないページが欲しい。 自分のウェブサイト、アプリ、プロダクトに、自前のUIで囲んでビューアを埋め込みたい。
  • ビューアの設定方法を完全に制御したい。 設定、コンテンツ、スカイボックス、ポスター画像、コリジョンを、URLパラメータ、自前のsettings.json、またはコードで上書きしたい。
  • 自分のコードから制御したい。 自分のウェブアプリ内でビューアを作成し、再生、カメラ、注釈、フルスクリーン、XRを操作したり、組み込みUIを独自のものに置き換えたりしたい。
  • 自己完結型でオフラインフレンドリーなバンドルが欲しい。 EditorのHTMLエクスポートを使って、スプラットと一緒に単一ファイルのビューアを配布する。
  • superspl.atからの独立性が欲しい。 自分のインフラでビューアをセルフホストし、ランタイムでPlayCanvasサーバーへリクエストしないようにする。

利用方法​

形態使うべき場面
superspl.atからの埋め込みスプラットがsuperspl.atで公開されていて、<iframe>で十分なとき。シーンページのEmbedダイアログを使います。
EditorからのHTMLエクスポートメール送信、USB配布、GitHub Pagesでのホスティングが可能な、自己完結型の.html(またはビューアとスプラットをまとめた.zip)が欲しいとき。ビューアのセルフホスティングを参照してください。
npmのビルド済みビューアビューアのファイルを自分で配信し、URLパラメータで各ページにスプラットとsettings.jsonを指定したいとき。ビューアの埋め込みを参照してください。
renderViewerHtmlサーバーやビルドが、アセットのURLと設定を埋め込んだビューアのページを生成するとき。ビューアの埋め込みを参照してください。
createViewer自分のウェブアプリがページを管理し、ビューアの作成・制御・破棄を自ら行うとき。ビューアAPIを参照してください。

どの形態も同じExperience Settings JSONを読みますので、Studioで作成した内容はそのまま反映されます。

関連項目​

  • ビューアの操作 — 訪問者がシーンをナビゲートする方法
  • VRとARでの表示 — ヘッドセットとスマートフォンでのAR
  • Embedding — npmパッケージ、URLパラメータ、生成されるページ、settings.json
  • ビューアAPI — createViewerとコードからのビューアの制御
  • Self-Hosting — Editorから単一ファイルのHTMLビューアをエクスポートする
  • Experience Settings — ビューアを駆動するJSONコントラクト