注釈

Annotationsは、Studioで公開済みスプラットに配置する3D空間配置のテキストホットスポットです。ビューア側では、各注釈は訪問者がクリックできるマーカーとして表示されます。クリックすると、カメラがキュレーションされた姿勢にフェードし、タイトルと本文が表示されます。注釈を使って、機能を説明したり、ストーリーを語ったり、シーンのセルフガイドツアーを提供したりできます。

注釈のプロパティ

各注釈には以下があります：

フィールド	説明
Position	ホットスポットマーカーがシーン内で置かれるワールド空間の[x, y, z]。
Title	注釈が選択されたときに表示される短い見出し。
Text	より長い本文。HTMLは許可されますがサニタイズされます — スクリプトや安全でない属性は不可。
Camera	この注釈が選択されたときにビューアがアニメーションするカメラ姿勢。
Extras	カスタム統合や将来のStudio機能のために添付できる自由形式のメタデータ。

注釈の作成

一般的なフローは次のとおりです：

1. 訪問者にシーンのこの部分をどう見せたいかに合わせてカメラをフレーミングします。
2. 注釈を追加します。Studioはホットスポットをワールドに配置し、現在のカメラを注釈の姿勢としてキャプチャします。
3. タイトルと本文を編集します。
4. 関心のあるポイントの数だけ繰り返します。

リストパネルで注釈を並べ替えられます — 順序は、訪問者がビューア上で注釈をどう順に進むかを制御します。

訪問者の使い方

シーンページで、ビューアは各注釈をマーカーとして表示します。フローティングのナビゲータUIで、訪問者はリストをPrevious / Nextで進められます。注釈を選択するとカメラがその姿勢にアニメーションし、タイトルと本文が表示されます。訪問者はいつでも注釈オーバーレイを閉じてフリールック操作に戻れます。

ヒント：開始点としての注釈

シーンのstart modeをannotationに設定すると、訪問者がシーンページを開いたときにビューアが最初の注釈に着地します — デフォルトでガイドツアー体験を提供したい場合に有用です。

関連項目

• Cameras — 注釈が参照するカメラ姿勢
• Animations — 訪問者の操作を必要としないシネマティックなフライスルー
• Experience Settings — 注釈を格納するJSONコントラクト