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

SuperSplat Viewer

SuperSplat Viewerは、superspl.atのすべてのシーンページをレンダリングする、オープンソースのウェブビューアです。スプラットファイルと設定JSONドキュメントを受け取り、インタラクティブな3D体験 — オービット、パン、ズーム、注釈、カメラアニメーション、ポストエフェクト、オプションのコリジョン/ウォーク操作、対応デバイス向けのWebXR — に変換する小さな自己完結型のウェブアプリです。

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

ビューアを直接使うとき

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

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

2つの配布形態

ビューアを利用する方法は2つあります:

形態使うべき場面
EditorからのHTMLエクスポートメール送信、USB配布、GitHub Pagesでのホスティングが可能な、自己完結型の.html(または.html+.compressed.ply.zip)が欲しいとき。ビューアのセルフホスティングを参照してください。
@playcanvas/supersplat-viewer npmパッケージ自分のウェブアプリにビューアを埋め込みたい、settings.jsonをテンプレート化したい、独自のUIをその上に構築したいとき。Embeddingを参照してください。

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

関連項目

  • Embedding — npmパッケージ、URLパラメータ、settings.jsonスキーマ
  • Self-Hosting — Editorから単一ファイルのHTMLビューアをエクスポートする
  • Experience Settings — ビューアを駆動するJSONコントラクト