ビューと XR の操作

デスクトップビューのフレーミング

アシスタントに get_xr_mode を読み取るよう依頼します。
デスクトップモードで、list_loaded_models からモデルを選びます。
front、back、left、right、top、bottom のいずれかを指定して set_camera_view を依頼します。
get_camera を読み取り、結果を確認します。

これらのビューはモデルのローカル軸に従います。+Z が正面、+X が右、+Y が上です。モデルの形状から意味上の正面を推測するものではありません。

現在の視線方向を維持してモデルを画面に収めるには frame_model を使用します。カメラのアニメーション移動が始まるため、リクエストが受け付けられたことは、カメラが最終位置に到達したことを意味しません。

move_camera は現在のカメラ方向を基準にメートル単位で移動します。rotate_camera はカメラの向きを変更するか、現在の注視点の周囲を周回します。set_camera_fov は 15 から 90 度の垂直視野角を受け付けます。

XR レビューでの MCP 使用

get_xr_mode を読み取り、XR を利用できることを確認します。
XR に入る場合は enabled: "true" を指定して set_xr_mode を依頼します。
読み戻しで要求したモードになっていることを確認し、切り替え処理が完了するまで待ちます。
レビュー中に利用できるモデル、ステート、環境、実行時 UI のツールを使用します。

デスクトップカメラの位置操作は XR では利用できず、ヘッドセット利用者の位置を変更するものではありません。作成済みの名前付きビューが必要な場合はモデルのステートを指定し、XR モードやモデルのトランスフォームを維持したい場合はその条件を明示してください。

XR を終了するには enabled: "false" を指定して set_xr_mode を依頼し、デスクトップカメラ操作の前にモードを再確認します。

操作パネルの表示とキャプチャ

list_windows で利用できる実行時パネルを検出します。show_window でパネルを開きます。例えば window: "system" と section: "external-connections" で接続設定を開けます。パネルを開いた後に list_ui_scrolls を使用し、返された領域 ID を指定して scroll_ui を呼び出します。

見た目の結果を確認させたい場合は、アシスタントに capture_screenshot を呼び出すよう依頼します。アプリケーションの UI が含まれ、XR ではデスクトップミラーを使用します。

save: "true" が既定値です。{PersistentDataPath}/Screenshots にフル解像度の PNG を保存し、保存先パスと画像プレビューを返します。
save: "false" はフル解像度ファイルを保存せず、プレビューのみを返します。

プレビューは圧縮され、保存画像より小さい場合があります。アニメーションは、時間を空けてキャプチャした画面を比較してください。get_model_animation は再生クロックを読み取りますが、見た目の動きが正しいことを証明するものではありません。