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コントラクト