# はじめに

キー不要の公開空間アプリを起動し、SDK 操作を変更して、必要に応じて Team データや画像再構成へ進みます。

Canonical: https://developer.realsee.ai/ja/docs/get-started
Source: https://developer.realsee.ai/ja/docs/get-started.md
Language: ja

公式スターター **1.3.0**：[ZIP](https://developer.realsee.ai/starters/react-five/1.3.0/starter.zip)・[マニフェストと SHA-256](https://developer.realsee.ai/starters/react-five/1.3.0/manifest.json)・[AI 用の実行手順（英語）](https://developer.realsee.ai/starters/react-five/1.3.0/agent.md)

新しいディレクトリに展開する前にマニフェストの SHA-256 を確認し、ロックファイルと固定された依存関係を保持してください。

# はじめに

実シーンを含む完全な React + TypeScript プロジェクトから始めます。ログイン、アプリ作成、トライアル開始の前に実行できます。

<span id="choose-your-first-result" class="docs-anchor-alias" aria-hidden="true"></span>

## 最初の結果を選ぶ

| 作りたいもの | 開始ガイド | 要件 |
| --- | --- | --- |
| 実際の 3D 空間を表示するローカルアプリ | [公開 Five SDK スターター](https://developer.realsee.ai/ja/docs/five-sdk/quickstart) | Node 24・WebGL・ネットワーク。アカウント・キー不要 |
| 自分の VR を使うローカルアプリ | [Team API スターター](https://developer.realsee.ai/ja/docs/open-api/quickstart) | 同じプロジェクトと Team 所有の Developer app |
| Argus の再構成結果 | [Argus クイックスタート](https://developer.realsee.ai/ja/docs/argus/quickstart) | アプリ認証情報・入力画像一式・タスク要件 |
| パノラマから生成した SaaS VR | [Pano-to-VR](https://developer.realsee.ai/ja/docs/pano-to-vr) | アプリ認証情報とパノラマ ZIP |

<span id="run-the-public-scene" class="docs-anchor-alias" aria-hidden="true"></span>

## 公開シーンを実行する

「スターター用プロンプトをコピー」を、ファイル作成とターミナル実行ができる AI ツールで使います。手動の場合は同じプロジェクトを取得し、[Five SDK クイックスタート](https://developer.realsee.ai/ja/docs/five-sdk/quickstart#install-check-and-run) に従います。

どちらも公式の版付きスターター、固定依存関係、ロックファイルを使います。表示されたローカル URL を開き、**Ready** を待ち、見回し、Panorama と Floorplan の切り替え、視点リセットを試します。

[ホスト済み公開デモ](https://developer.realsee.ai/ja/playground) も試せます。

<span id="make-the-scene-your-own" class="docs-anchor-alias" aria-hidden="true"></span>

## シーンをカスタマイズする

ローカルスターターの **Open SDK examples** を選びます。各ガイドは同梱コードを使います：

- [シーン読み込み](https://developer.realsee.ai/ja/docs/five-sdk/load-a-scene)：Work の設置、状態表示、ビューアー破棄。
- [カメラとモード](https://developer.realsee.ai/ja/docs/five-sdk/camera-and-modes)：移動、見回し、視点保存。
- [イベントと座標](https://developer.realsee.ai/ja/docs/five-sdk/events-and-coordinates)：モデル上の点選択とラベル配置。
- [画像キャプチャー](https://developer.realsee.ai/ja/docs/five-sdk/capture-images)：シーンを PNG に出力。

既存 React アプリへの導入は [React ライフサイクル](https://developer.realsee.ai/ja/docs/five-sdk/react-lifecycle) を参照し、必要に応じて [Dnalogel 空間 UI](https://developer.realsee.ai/ja/docs/dnalogel/quickstart) や [Vreo ガイド付き体験](https://developer.realsee.ai/ja/docs/vreo/quickstart) を追加します。

<span id="connect-your-team-when-you-need-its-data" class="docs-anchor-alias" aria-hidden="true"></span>

## 必要に応じて Team データに接続する

同じスターターで [Team API クイックスタート](https://developer.realsee.ai/ja/docs/open-api/quickstart) に進みます。`npm run configure -- --device` の確認リンクを開き、ログインして所有 Team と有効アプリを選び、**Authorize agent** を自分で選択します。ツールがサーバーの `.env` を設定します。利用できない場合はローカルで設定し、SK やトークンをプロンプトやブラウザーコードに含めないでください。

作成できるのは **Team オーナー** だけです。新規アプリは標準 **14 日間のトライアル** で、期限切れ・無効を含め Team ごとに **最大 10 個** です。所有権、作成、トライアル、継続利用は [Team とアプリ管理](https://developer.realsee.ai/ja/docs/team-app-management) を参照してください。

トークン交換と一覧取得を先に確認し、その後で選択した Team シーンを表示します。認可済み一覧が空でも API の正常結果です。公開デモの表示は Team API アクセスの証明ではありません。

<a id="reconstruct-a-panorama-when-you-need-a-new-scene"></a>

<span id="reconstruct-from-an-image-batch" class="docs-anchor-alias" aria-hidden="true"></span>

## 画像一式から再構成する

[Argus クイックスタート](https://developer.realsee.ai/ja/docs/argus/quickstart) は入力要件、タスク、結果確認を扱います。複数の 2:1 パノラマまたは 1:1 ピンホール画像から再構成成果物のパッケージを生成します。

パノラマから SaaS VR を作るには、Argus を利用した [Pano-to-VR](https://developer.realsee.ai/ja/docs/pano-to-vr) に従ってください。

<span id="find-the-next-answer" class="docs-anchor-alias" aria-hidden="true"></span>

## 次の答えを探す

- [SDK タスクガイド](https://developer.realsee.ai/ja/docs#sdk-guides) でシーン操作を確認できます。
- [OpenAPI エンドポイントの説明](https://developer.realsee.ai/ja/docs/open-api/reference) でサーバーの要求と応答を確認できます。
- [認証](https://developer.realsee.ai/ja/docs/authentication) はアプリ認証情報とサーバー側トークンを説明します。
- 連携の質問は [Realsee Discord コミュニティ](https://discord.gg/JvxBZJkbNZ) へ。SK やトークンを共有しないでください。