アプリケーションツールリファレンス

使用前に接続先サーバーのツールを検出してください。利用可否と操作の成否は、実行中のアプリケーション、読み込んだコンテンツ、動作モード、ライセンス機能に依存します。

アプリケーションツールの引数は文字列です。数値や真偽値も "true"、"10"、"0.5" のように指定します。必須・任意の引数は各ツールの検出されたスキーマに従ってください。Variable Exposer ツールは、それぞれのスキーマを使用します。

ライブラリ、モデル、ステート

ツール	用途
list_libraries / select_library	モデルまたは背景のライブラリを検出して選択します。選択は閲覧対象を変更します。
list_library_models / load_model	元アセットを検出し、ライブラリアセット ID または一意の名前で読み込みます。
list_loaded_models / select_model	シーンインスタンスを検出し、実行時の操作対象を選択します。
get_model	表示、トランスフォーム、選択、ロックを読み取ります。
set_model_visibility	通常の表示ルールに従って、読み込み済みモデルを表示・非表示にします。
set_model_transform	position、rotation、scale を absolute または relative モードで変更します。
delete_model	シーンインスタンスを削除します。ライブラリの元ファイルは保持されます。
list_model_states / set_model_state	ステートのグループとオプションを検出して適用し、選択結果を読み戻します。
get_model_animation	再生を変更せずに再生クロックをサンプリングします。

カメラと XR

ツール	用途
get_camera	デスクトップカメラの位置・回転とレンズを読み取ります。
set_camera_view	モデル軸に基づく六つのビューからモデルをフレーミングします。
frame_model	現在の視線方向でモデルを画面に収める移動を開始します。
move_camera / rotate_camera	デスクトップカメラの移動、見回し、周回を行います。
set_camera_fov	透視カメラの垂直視野角を設定します。
get_xr_mode / set_xr_mode	XR の状態を読み取り、開始・終了し、切り替え状態を確認します。

カメラ操作にはデスクトップモードが必要です。位置操作とキャプチャの動作はビューと XRを参照してください。

実行時 UI とスクリーンショット

ツール	用途
list_windows / show_window	実行時パネルを検出して開き、必要に応じて設定セクションを選択します。
hide_window	パネルまたは all を非表示にします。動作は現在のインターフェース構成に従います。
show_library	models または backgrounds のサムネイルを表示します。
list_ui_scrolls / scroll_ui	表示中のスクロール領域を検出し、現在の領域 ID でスクロールします。
capture_screenshot	アプリケーションの画像プレビューを返し、任意で PNG を保存します。

背景、グラフィックス、Turntable

ツール	用途
list_backgrounds / set_background	背景を検出し、返された ID または一意の名前で読み込みます。
get_environment / set_environment	対応する設定を取得し、返された範囲内で1項目を変更します。
get_graphics_options / set_graphics_option	対応するグラフィックス操作を検出し、変更後の実際の状態を読み戻します。
get_turntable	割り当て、再生、角度、速度、利用可否を読み取ります。
assign_model_to_turntable	読み込み済みモデルを割り当て、accepted と confirmed を確認します。
release_turntable_model	モデルを読み込んだまま割り当てを解除します。
set_turntable	play、reverse、pause、angle、speed を設定します。MCP の速度は 0 から 30 の度/秒です。

ネットワーク経由で行う割り当て・解除は、リクエストが受理された後も処理中の場合があります。実際の割り当てが要求と一致するまで get_turntable を読み取ってください。安定した読み戻しが必要な角度設定では、先に再生を一時停止します。