ビューアのセルフホスティング
SuperSplat Viewerはオープンソースであり、superspl.atに公開する代わりに(または併用して)スプラットコンテンツをセルフホストしたい場合は、SuperSplat Editorから直接エクスポートできます。エクスポートされたビューアは、使いやすいカメラコントロールを備えた任意のモダンブラウザで動作し、WebXRをサポートするデバイスではARおよびVRの可視化にも対応しています。
HTMLビューアのエクスポート
スプラットをHTMLビューアとしてエクスポートするには:
- SuperSplat Editorで
File>Exportサブメニューを開きます。 Viewer App…を選択します。
エクスポートオプション
ビューアのエクスポートはいくつかのオプションで設定できます:

| オプション | 説明 |
|---|---|
| Export Type | エクスポートされるビューアの形式を制御します: • HTML: スプラットがBase64エンコードされ、ファイルに直接埋め込まれた単一ページの .htmlファイル。すべてが1つのファイルにまとめられているため非常に便利で、ファイルをダブルクリックするだけでfile://プロトコルを使ってブラウザで動作します。ただし、Base64エンコードによりZIP Package形式よりも約30%大きくなり、ブラウザによって最大サイズに異なる制限があります(32MB未満であればどこでも読み込まれるはずですが、それ以上の場合は問題が発生する可能性があります)• ZIP Package: ビューアの .htmlファイルと、スプラットを含む別の.compressed.plyファイルを含むzipファイル。サイズが小さく、読み込みが速く、どこでも読み込まれることが保証されています。ただし、http://経由でのみ読み込まれるため、ローカルウェブサーバ(例:NodeのserveやPythonのhttp.server(python -m http.server))を実行する必要があります |
| Start Position | ビューアのカメラに使う開始位置: • Default: ビューアが最適な開始点を自動的に選択します • Current Viewport: SuperSplat Editorのビューポートで設定された現在のカメラ位置を使います • 1st Camera Frame: タイムラインの最初のフレームで定義された最初のカメラ位置を使います |
| Animation | ビューアのカメラに適用するアニメーション: • None: アニメーションなし • Track: SuperSplat Editorのタイムラインで設定したキーフレームでカメラをアニメーションします |
| Background | ビューアの背景色 |
| Field of View | ビューアのカメラの垂直視野角(度) |
| SH Bands | 公開される圧縮済みPLYファイルに書き出される球面調和バンドの数 |
HTMLビューアのウェブホスティング
エクスポート後、HTMLビューアファイルをどこかにホストしてアクセス可能にできます。簡単なオプションの1つはGitHub Pagesを使うことです:
-
GitHubで新しいリポジトリを作成します。
-
エクスポートしたHTMLファイル(ビューアをZIP Packageとしてエクスポートした場合は、
.compressed.plyファイルも)を追加します。 -
リポジトリの
Settingsページにアクセスします。左側でPagesを選択します。SourceがDeploy from a branchに設定されていることを確認し、Branchをmainに設定してSaveをクリックします。 -
ビューアが公開されるまでに数分かかります。URLは次の形式になります:
https://<github-username>.github.io/<repository-name>/<html-filename>
関連項目
- SuperSplat Viewerの概要 — オープンソースのビューアとは何か、いつ使うか
- Embedding —
@playcanvas/supersplat-viewernpmパッケージを自分のウェブアプリで使う - Experience Settings — Studioが書き、Viewerが読むJSONコントラクト