# Five SDK

公開版 Five SDK で空間を表示し、カメラ、空間操作、画像出力を制御します。

Canonical: https://developer.realsee.ai/ja/docs/five-sdk
Source: https://developer.realsee.ai/ja/docs/five-sdk.md
Language: ja

Five SDK で空間ビューアーを作ります。動作する React + TypeScript プロジェクトから始め、必要な機能を追加します。

スターターと拡張例は Five SDK **6.9.2**、Three.js **0.117.1**、React **18.3.1**、Node **24** を使います。

<span id="start-with-a-result" class="docs-anchor-alias" aria-hidden="true"></span>

## 動作する結果から始める

アカウント・キー不要で [公開シーンを実行](https://developer.realsee.ai/ja/docs/five-sdk/quickstart) できます。同じスターターは [サーバー側の Team データ](https://developer.realsee.ai/ja/docs/open-api/quickstart) にも対応します。

スターターの **SDK examples** で移動、モード、点選択、ラベル、画像出力を試せます。以下のガイドは同梱の実ソースを参照します。

<span id="choose-a-capability" class="docs-anchor-alias" aria-hidden="true"></span>

## 機能を選ぶ

| 目的 | ガイド | 使用する公開 API |
| --- | --- | --- |
| Work の読み込みと解放 | [シーン読み込み](https://developer.realsee.ai/ja/docs/five-sdk/load-a-scene) | `parseWork`, `appendTo`, `load`, `refresh`, `dispose` |
| モード・視点・カメラの変更 | [カメラとモード](https://developer.realsee.ai/ja/docs/five-sdk/camera-and-modes) | `changeMode`, `moveToPano`, `updateCamera`, `getCurrentState` |
| タップ応答とラベル配置 | [イベントと座標](https://developer.realsee.ai/ja/docs/five-sdk/events-and-coordinates) | `on`, `model.intersectRaycaster`, `project2d` |
| 現在フレームの出力 | [画像キャプチャー](https://developer.realsee.ai/ja/docs/five-sdk/capture-images) | `getSize`, `getPixels` |
| React 内への設置 | [React ライフサイクル](https://developer.realsee.ai/ja/docs/five-sdk/react-lifecycle) | マウント、キャンセル、サイズ変更、破棄 |
| 公開アプリの接続 | [本番チェックリスト](https://developer.realsee.ai/ja/docs/five-sdk/production) | アセット、サーバー認可、ブラウザーリソース |
| メソッドやイベントの検索 | [API 対応表](https://developer.realsee.ai/ja/docs/five-sdk/api-reference) | 固定版の型定義と AI ガイド |

Dnalogel は [空間 UI と計測](https://developer.realsee.ai/ja/docs/dnalogel)、Vreo は [ストーリー再生](https://developer.realsee.ai/ja/docs/vreo)、Live は [ルーム単位の同期](https://developer.realsee.ai/ja/docs/live) を追加します。それぞれ独自の依存関係とサービス要件があります。

<span id="versioned-sources" class="docs-anchor-alias" aria-hidden="true"></span>

## バージョン付き参照元

- [Five SDK 6.9.2 パッケージ情報](https://www.npmjs.com/package/@realsee/five/v/6.9.2)
- [公開 API 型定義](https://unpkg.com/@realsee/five@6.9.2/five/index.d.ts)
- [AI 文書索引](https://unpkg.com/@realsee/five@6.9.2/llms.txt)

メソッドの引数、イベントデータ、型はバージョン付きの定義を確認してください。