# 手トラッカー調整ツール QT （テスト版） Questコントローラーの操作はそのまま。 手のトラッキングをTracker側へ切り替えるための補助ツールです。 特に、Offset設定時の変換数値を簡単に測定・割り出してくれる機能が便利。 かんろみ様の記事を参考に作成したツールです。こちらの記事も見てね！ 『(VRC向け)コントローラーのトラッキングをトラッカーで上書きする』 https://note.com/kanromi/n/naab2e9c4042f VRChatでダンスやパフォーマンスをするとき、 「Questコントローラーを持ったままだと踊りにくい」 「でもスティックやボタン操作は残したい」 「手の位置はTrackerで取りたい」 そんな使い方をしやすくするために作ったWindows用ツールです。 --- ## QTでできること QTでは、SteamVRの設定を利用して、 **Questコントローラーによる手の位置トラッキングを停止し、 代わりにTrackerを左右の手として使用するための設定を補助します。** Questコントローラーの * ボタン * スティック * トリガー * グリップ などの操作を残しながら、手の位置・向きをTracker側へ切り替える構成を想定しています。 ブレイキン、ダンス、DJ、ライブパフォーマンスなど、 **コントローラーを手に持たず、自由に手を動かしたい場面**におすすめです。 --- # 主な機能 ### Dance Mode ON / OFF QTからSteamVRの`TrackingOverrides`を設定し、 ```text 通常モード Questコントローラー → 手のトラッキング Dance Mode Tracker → 手のトラッキング ``` を切り替えるための設定を行います。 設定変更後はSteamVRの再起動が必要です。 --- ### 左右Trackerかんたん設定 初期設定では、 ```text 左手TrackerだけON ↓ QTで検索 ↓ 左手として登録 右手TrackerをON ↓ 再検索 ↓ 追加されたTrackerを右手として登録 ``` という流れで設定できます。 Trackerのシリアル番号を覚えて設定する必要はありません。 --- ### Controller Offset推定 QuestコントローラーとTrackerの位置関係から、 ```text Position X / Y / Z Rotation Pitch / Yaw / Roll ``` のController Offset値を推定します。 「左手だけ」「右手だけ」「両手」の測定に対応。 測定開始後は5秒のカウントダウンを行い、 その後約1～2秒間Poseを取得して推定します。 取得した数値は、SteamVRのController Offset設定時に使用できます。 ※自動設定ではなく推定値です。 VRChat上で手の位置を確認しながら微調整してください。 --- ### Step by Step 初期設定 初めて使う場合でも設定しやすいように、 QT内に初期設定ガイドを用意しています。 Tracker登録、Offset推定、Dance Mode設定、SteamVR側のController Offset設定まで、順番に進められます。 SteamVR側の操作についても画像付きで案内します。 --- ## 対応Tracker 現在、以下を想定しています。 ```text VIVE Tracker 2.0 / 3.0 Tundra Tracker VIVE Ultimate Tracker ``` VIVE Trackerは対応確認済みです。 Tundra Trackerは対応実装済みですが、実機環境による確認を推奨します。 VIVE Ultimate TrackerについてはSteamVR上での認識方式が環境によって異なる可能性があるため、実機確認を進めています。 左右で異なる種類のTrackerを使用する構成にも対応できる設計です。 --- # 想定環境 主に以下の構成を想定して開発しています。 ```text Windows PC VRChat PC版 SteamVR Meta Quest 3 Quest Touch Plus Controller Virtual Desktop VIVE Tracker等 Space Calibrator ``` ※すべてのVR環境・組み合わせでの動作を保証するものではありません。 --- # 重要：完全自動ツールではありません QTは**補助ツール**です。 SteamVRの仕様上、Dance Modeと通常モードの切り替えには、ユーザー自身で行う作業があります。 ### モード切替時 手のトラッキング設定を変更するには、 ```text SteamVRを完全終了 ↓ QTでDance ON / OFF ↓ SteamVRを起動 ``` という操作が必要です。 SteamVR起動中にQTから設定を書き換えることは、安全性を優先して禁止しています。 --- ### コントローラーバインド Dance Modeと通常モードでは、SteamVR側で使用するコントローラーバインドをユーザー自身で切り替えてください。 QTからBindingを自動変更する機能はありません。 これはSteamVRやQuestコントローラーの設定を必要以上に変更しないための安全設計です。 --- # 安全性について QTでは、Questコントローラー周辺の設定をできるだけ直接変更しない設計にしています。 以下のような機能は使用していません。 ```text 仮想コントローラー 仮想Tracker 独自SteamVR Driver Bindingの自動書き換え Bindingの自動切り替え ``` Dance Modeの変更時には設定ファイルのバックアップを作成し、書き込み後にも設定内容を再確認します。 また、初期状態を保存しておくことで、設定を戻すための復元機能も用意しています。 --- # こんな人におすすめ * VRChatでダンスをする * ブレイキンなど大きく腕を動かす * DJ・ライブパフォーマンスをする * Questコントローラーを手から離したい * 手首や手の甲にTrackerを装着したい * Trackerで手を動かしながらQuestコントローラーのボタン操作も使いたい 特に、**VRChatで身体を大きく使うパフォーマンスをする方**を想定しています。 --- # 使用イメージ ```text 通常時 Questコントローラー ↓ 手の位置 + ボタン操作 Dance Mode Tracker ↓ 手の位置 Questコントローラー ↓ ボタン / スティック操作 ``` 手の動きと操作デバイスの役割を分けることで、ダンス時の自由度を高めることを目的としています。 --- # ご購入前に QTはSteamVRの設定を利用するツールです。 PC環境、SteamVR、VRChat、Virtual Desktop、Trackerなどのバージョン変更によって動作が変化する可能性があります。 また、 * Trackerのペアリング * Space Calibrator等による座標合わせ * SteamVR Controller Bindingの作成 * Controller Offsetの最終的な微調整 などはユーザー側で行っていただく必要があります。 **「ボタン1つですべて自動化するツール」ではありません。** その代わり、SteamVRやQuestコントローラー周辺を必要以上に変更せず、できるだけ安全に設定できることを重視しています。 --- # QT **Quest Controller × Tracker** VRChatで、もっと自由に手を動かすために。 **手トラッカー調整ツール QT**