SuperSplat Studio
SuperSplat Studioは、すでに公開または直接アップロードしたスプラットの視聴体験をキュレーションする場所です。公開済みシーンの上に開き、訪問者がシーンページで見るすべて — カメラフレーミングとアニメーション、シーン上の注釈、ポストプロセッシングエフェクト、トーンマッピング、背景またはスカイボックス、ウォーカブルシーン用のコリジョンジオメトリ — を作成できます。
Studioは出力を単一のJSONドキュメント — Experience Settings — として書き出し、これをオープンソースのSuperSplat Viewerがランタイムで読み込みます。同じJSONがセルフホスト用のHTMLエクスポートにもバンドルされます。
Studioの起動
Studioは**https://superspl.at/scene/<hash>/studio**で動作します。Studioを開けるのはスプラットのオーナーのみで、他のユーザーがURLにアクセスしても404になります。
たどり着く方法は2つあります:
- Manageページから、スプラットのEdit Splatダイアログを開き、プレビューカードのOpen in Studioをクリックします。
- 自分のスプラットのシーンページから、Edit in Studioエントリポイントを使用します。
Studioはデスクトップブラウザ向けに作られています。スマートフォンやタブレットで開くと「Studio works best on desktop」という警告が表示されます。警告を閉じて続行できますが、UIの制約があります。
レイアウト
StudioはSuperSplat editorのシェルを再利用しています:
- ヘッダ — 戻るボタン、シーン名、保存インジケータ。
- 左パネル — 折りたたみ可能なツールセクション(Cameras、Annotations、Post Effects、Scene Assetsなど)。
- ビューポート — 訪問者がシーンをどう見るかのライブプレビュー。
- 右パネル — 選択しているツールの設定。
各ツールセクションには独自のページがあります:
- Cameras — 1つ以上の名前付きカメラの初期姿勢、ターゲット、視野角。
- Animations — ビューア読み込み時に自動再生できるキーフレーム駆動のカメラトラック。
- Annotations — 訪問者が移動可能な、3D空間に配置されたテキストホットスポット。
- Post Effects — シャープネス、ブルーム、カラーグレーディング、ビネット、フリンジング、トーンマッピング、高精度レンダリング。
- Skybox — 背景色またはフルのエクイレクタンギュラースカイボックス。
- Collision — シーンを「ウォーカブル」にするボクセルジオメトリ。
変更の保存
編集は自動保存されません。ヘッダには、完全なExperience Settings JSONをサーバーにプッシュするSaveアクションが表示されます。
保存フローについて知っておくべきことがいくつかあります:
- ダーティ状態の追跡 — Studioは未保存の変更を認識します。編集が未保存の状態で離脱しようとすると、失う前に警告されます。
- 再読み込み時のキャッシュバスティング — 保存に成功すると、キャッシュバスティングされた設定URLでビューアが再読み込みされ、編集内容がすぐに反映されます。それ以降、シーンページを読み込む訪問者には新しいバージョンが表示されます。
- 部分保存なし — 保存ごとに差分ではなく完全なExperience Settings JSONが書き込まれます。保存後に何かおかしく見える場合は、変更がマージされることを期待するのではなく、各パネルの値を改めて確認してください。
スキーマのバージョニング
Experience Settings JSONにはバージョン番号があり、現在のスキーマはv2です。古いv1の設定(Studioが一部の機能をサポートする前のもの)は読み込み時に自動的にv2に移行されます。特別な対応は必要ありません — ただし、ビューアをセルフホストしてsettings.jsonを直接読み込む場合は、現在のスキーマについてExperience Settingsリファレンスを参照してください。
関連項目
- Experience Settings — Studioが書き、Viewerが読むJSONコントラクト
- Viewer / embedding — 公開された設定がランタイムでどう消費されるか
- シーンページ — Studioの変更が保存された後に訪問者が見るもの