APIと統合
SuperSplat APIを使うと、アプリケーションからGaussian Splatをsuperspl.atに公開し、認証済みユーザーが所有するシーンを確認できます。キャプチャアプリケーション、トレーニングパイプライン、変換ツール、社内コンテンツワークフローをSuperSplatに直接接続できます。
アップロードされたシーンはユーザーのManageページに表示され、編集したり、Studioで開いたり、公開シーンページから共有したりできます。
エンドポイント定義、リクエストスキーマ、レスポンス例については、SuperSplat APIリファレンスを参照してください。
APIを使用する場面
APIは次のような場合に便利です：
- SuperSplat Editorを開かずにスプラットを公開する。
- キャプチャまたは再構築アプリケーションにSuperSplat公開機能を追加する。
- トレーニングまたは変換パイプラインの出力を一括アップロードする。
- ユーザーが所有するシーンを一覧表示または確認する。
- 接続が中断された後に大容量アップロードを再開する。
認証
すべてのAPI操作にはPlayCanvasアクセストークンが必要です。REST APIの認証を参照してトークンを作成し、Authorizationヘッダーで送信します：
Authorization: Bearer YOUR_ACCESS_TOKEN
アクセストークンは秘密情報として扱ってください。公開されるクライアント側コードに埋め込んだり、別のユーザーと共有したりしないでください。
再開可能なアップロードフロー
SuperSplatは、大容量のシーンファイルを確実に転送できるようマルチパートアップロードを使用します：
- ソース形式とオプションのシーンメタデータを指定してアップロードセッションを作成します。
- 1つ以上のファイルパート用に署名付きアップロードURLを要求します。
- 各パートをストレージへ直接アップロードします。
- 返されたパートETagを使用してアップロードを完了します。
アップロードが完了するとSuperSplatがシーンを作成します。変換と最適化が終わるまで、シーンがprocessingのままになることがあります。新しいシーンはデフォルトで限定公開です。
クライアント統合
同じAPIをエンドユーザー向け統合とカスタム自動化の両方で利用できます：
- LichtFeld Studio向けSuperSplatプラグインはPLYまたはSOGシーンを書き出し、進捗表示と再開可能なアップロードを使ってSuperSplatに公開します。
クライアントはオプションのuploadClientフィールドで自身を識別できます：
{
"uploadClient": {
"id": "example-client",
"version": "1.0.0"
}
}
uploadClientはアップロードを実行するアプリケーションに使用します。シーンの作成に使用したツールを記録する場合は、別途softwareToolsを使用します。
関連項目
- SuperSplat APIリファレンス — 完全なエンドポイントとスキーマのドキュメント
- Direct Upload — superspl.atインターフェースからファイルを公開
- Manage — アップロード済みシーンを操作
- Studio — 公開後の視聴体験をキュレーション