埋め込み
自社プロダクトに Nodaro を組み込む 2 つの方法(公開済みワークフローを実行するミニアプリと、状態を持たない 3D シーンビューポート)と、それぞれの使いどころを説明します。
埋め込みを使うと、Nodaro の一部を自社プロダクトの中に組み込めます。埋め込みには 2 種類あり、それぞれ異なる課題を解決します。ミニアプリの埋め込みは、ユーザーのために公開済みワークフローを実行し、3D シーンビューポートは、何も実行せずに 3D シーンを表示し、必要に応じて編集もできます。
埋め込みを選ぶ
| ミニアプリ | 3D シーンビューポート | |
|---|---|---|
| できること | 公開済みのミニアプリを実行します。入力を集め、実行を開始し、結果を表示します。 | 3D シーンプランを描画します。ビューポート、再生、オブジェクトの一覧、ポーズエディター、リビジョン履歴です。 |
| 埋め込み方法 | REST API の上に作る独自のインターフェース、またはミニアプリの埋め込みコードによるフレームです。 | postMessage で操作する、/embed/scene3d のフレームです。 |
| 認証 | 独自のインターフェースでは、サーバーに保管した個人用 API トークンまたは OAuth トークンを使います。フレームは、閲覧者自身の Nodaro セッションで動作します。 | 不要です。フレームはセッションを持たず、ネットワーク呼び出しも行いません。 |
| クレジット | 実行のたびにクレジットがかかり、実行の名義となるアカウントが支払います。 | かかりません。ビューアーはジョブを実行しません。 |
| 状態の保存場所 | 実行は Nodaro に保存されます。 | シーンは自分のページが保持します。フレームは、再読み込みをまたいで何も保持しません。 |
ミニアプリを埋め込むタイミング
- ワークフローをミニアプリとして公開していて、自社のサイトやアプリから、ユーザーにそれを実行してもらいたいとき。アプリを参照してください。
- アプリの周りに、独自のフォームとスタイルを用意したいとき。REST API の上に組み立てます。
- 最も手早い方法を使いたいとき。ミニアプリの埋め込みコードを、自分のページに貼り付けます。
ミニアプリを埋め込むを参照してください。
3D シーンビューポートを埋め込むタイミング
- 自分のプロダクトが、3D シーン生成や 3D シーン編集のジョブによる 3D シーンプランを保存していて、ユーザーがそれを見られるようにしたいとき。
- ユーザーがシーンを再生、スクラブし、シーン内のオブジェクトを選択できるようにしたいとき。デフォルトは読み取り専用です。
- ユーザーがポーズ、色、ロックを編集できるようにし、新しいリビジョンはそのつど自分のページで保存したいとき。
3D シーンビューポートを埋め込むを参照してください。ビューポートが描画するデータについては、3D シーン形式を参照してください。
どちらも、トークンをブラウザーに置かない
どちらの埋め込みも、Nodaro のトークンを Web ページの中に置くことはありません。独自のミニアプリのインターフェースを作る場合、トークンは自分のサーバーに置かれたままです。3D シーンビューポートのメッセージには、トークンが一切含まれません。自分のページが、シーンのアセットを自分のセッションで取得し、そのバイトデータを送ります。
よくある質問
Nodaro から何を埋め込めますか?
2 つあります。シンプルなフォームを持つ公開済みワークフローである「ミニアプリ」と、自分のページが送った 3D シーンプランを描画する「3D シーンビューポート」です。
AI の生成を実行するのは、どちらの Nodaro 埋め込みですか?
ミニアプリの埋め込みだけです。3D シーンビューポートは何も実行せず、セッションを持たず、ネットワーク呼び出しも行わず、クレジットも一切使いません。
3D シーンビューポートを埋め込むのに、API トークンは必要ですか?
必要ありません。ビューポートには、トークンもセッションも不要です。自分のページが postMessage でシーンを送り、シーンのバイナリアセットは、自分のセッションで取得します。
ミニアプリ用に独自のインターフェースを作る場合、トークンはどこに置きますか?
自分のサーバーに置きます。ブラウザーのコードは自分のサーバーと通信し、自分のサーバーがそのトークンで Nodaro API を呼び出すので、トークンがブラウザーに渡ることはありません。
関連ページ
ミニアプリの埋め込み
3D シーンビューポートの埋め込み
3D シーン形式
アプリ(ミニアプリ)
最終更新