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

ビューアのセルフホスティング

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

HTMLビューアのエクスポート

スプラットをHTMLビューアとしてエクスポートするには:

  1. SuperSplat EditorでFile > Exportサブメニューを開きます。
  2. Viewer App…を選択します。

エクスポートオプション

ビューアのエクスポートはいくつかのオプションで設定できます:

Viewer Export

オプション説明
Export Typeエクスポートされるビューアの形式を制御します:
HTML: スプラットがBase64エンコードされ、ファイルに直接埋め込まれた単一ページの.htmlファイル。すべてが1つのファイルにまとめられているため非常に便利で、ファイルをダブルクリックするだけでfile://プロトコルを使ってブラウザで動作します。ただし、Base64エンコードによりZIP Package形式よりも約30%大きくなり、ブラウザによって最大サイズに異なる制限があります(32MB未満であればどこでも読み込まれるはずですが、それ以上の場合は問題が発生する可能性があります)
ZIP Package: ビューアの.htmlファイルと、スプラットを含む別の.compressed.plyファイルを含むzipファイル。サイズが小さく、読み込みが速く、どこでも読み込まれることが保証されています。ただし、http://経由でのみ読み込まれるため、ローカルウェブサーバ(例:NodeのserveやPythonのhttp.serverpython -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を使うことです:

  1. GitHubで新しいリポジトリを作成します。

  2. エクスポートしたHTMLファイル(ビューアをZIP Packageとしてエクスポートした場合は、.compressed.plyファイルも)を追加します。

  3. リポジトリのSettingsページにアクセスします。左側でPagesを選択します。SourceDeploy from a branchに設定されていることを確認し、Branchmainに設定してSaveをクリックします。

  4. ビューアが公開されるまでに数分かかります。URLは次の形式になります:

    https://<github-username>.github.io/<repository-name>/<html-filename>

関連項目

  • SuperSplat Viewerの概要 — オープンソースのビューアとは何か、いつ使うか
  • Embedding@playcanvas/supersplat-viewer npmパッケージを自分のウェブアプリで使う
  • Experience Settings — Studioが書き、Viewerが読むJSONコントラクト