Contents
推奨構成と最短手順
ここでは短時間で動作確認を終え、本運用に移すための推奨構成と最短の作業手順を示します。まず最小構成で動作を確認し、その後トラッカー等を追加して段階的に拡張することを推奨します。
最短手順（クイックガイド）
短時間で基本動作を確認する最低限の手順を番号で示します。
- PCを起動しSteamをサインイン、SteamVRを最新で起動する。
- HMD（使用する場合）を接続して起動する。
- ベースステーション／外部トラッカー電源を入れる。
- コントローラをペアリングして追跡が正常であることを確認する。
- トラッカーを1台だけペアリングしてSteamVRで認識を確認する。
- Resoniteを起動し、SteamVR入力を有効化してトラッカーを割当てる。
- Tポーズでキャリブレーションを実行し、Floor offsetを調整する。
- 基本動作が安定したらトラッカーを順次追加し、都度キャリブレーションする。
事前準備と推奨環境（ソフト・ハード）
導入前にソフト／ドライバと物理構成を整えることで、初期トラブルを大幅に減らせます。以下は 2024年6月 時点の一般的な目安と確認手順です。必ず導入前に各公式のリリースノートや対応表を確認してください。
必須ソフトとバージョン確認
各ソフトは「最新の安定版」ではなく「使用するバージョン間の互換性」を重視して揃えてください。公式のリリースノート（ResoniteのNews/ChangelogやSteamのUpdate欄）で、使用するバージョンの記載日と詳細を取得してメモします。
- Resonite（公式サイト／Steam）
- SteamVR（Steam）
- VirtualDesktop & Streamer（Quest系で顔／目を転送する場合）
- VRCFaceTracking 等（フェイシャルブリッジを使う場合）
- Ultraleap / Leap Motion ドライバ（手指トラッキング）
- 各デバイスのファームウェア（Vive Tracker, Vive Pro Eye, Quest Pro等）
（公式情報）Resoniteの「最大トラッカー数」に関する記述はリリースノートで随時更新されます。該当表記を利用する場合は、リリースノートの該当ページ（バージョン番号と公開日）を必ず記録してサポートへ提示してください。公式サイト: https://resonite.com/、Steam: https://store.steampowered.com/app/2519830/Resonite/
推奨PCスペック（目安、2024年6月確認）
以下はあくまで目安です。導入先のワークフローにより要求は増減します。
- CPU: 6コア以上推奨（最低4コア）
- GPU: RTXシリーズ推奨（GTX1660相当以上を最低ライン）
- メモリ: 16GB以上（32GB推奨のケースあり）
- ストレージ: NVMe/SSD推奨（アセットやログでI/Oが増えるため）
- USB: USB 3.x 複数ポート（マザーボード直挿しを優先）
- ネットワーク: 5GHz帯の専用WLANまたは有線接続（Quest系の転送は有線が最も安定）
更新方針: 上記は目安のため、主要ソフトの最小要件やリリースノートに変化があれば都度更新してください。
USB／Bluetooth周りの準備
USB帯域とBluetoothの干渉がトラッキング安定性に直結します。現場での作業は以下を最低限行ってください。
- トラッカー類は可能なら別々のUSBコントローラ／ルートに分散する。
- マザーボード直挿しを優先し、パワードハブは電力不足対処用に限定する。
- Bluetoothは専用ドングル（Bluetooth 5.0）をUSB延長で前面に出して配置する。
- USB構成の可視化に「USBTreeView」等のツールを使う（管理者権限で実行）。
接続・ペアリング（現場での手順）
実務では順序を守ることで混線や認識ミスを避けられます。ここでは標準的な手順と確認ポイントを示します。
物理配置の基本
ベースステーションやセンサーの設置はトラッキング安定の基礎です。対角に設置して相互視界を確保し、反射体や振動源を排除してください。
SteamVRでのトラッカーペアリング
SteamVR側でのペアリング手順の一般的な流れを示します。UIはバージョン差があるため画面上の類似メニューを探してください。
- SteamVRを起動し、メニュー → Settings（設定） → Devices（デバイス）を開く。
- 「Pair Controller」（コントローラをペアリング）を選び、画面の指示に従う。
- トラッカーのペアリングボタンを押してLEDが点滅するまで保持する。
- 1台ずつペアリングして名前を付ける（例: Tracker_Pelvis）ことで管理が楽になる。
- ペアリング後、SteamVRデバイスウィンドウでトラッキング状態（良好/赤/黄色）を確認する。
ペアリング順序と運用ヒント
順序を守ることで誤認識を減らせます。推奨順序は次の通りです。PC起動 → HMD接続 → ベースステーション起動 → コントローラ確認 → トラッカー1台ずつペアリング。複数台を同時にペアリングしないこと。
Resoniteでのマッピングとキャリブレーション
Resonite内での割当やオフセット調整を確実に行うことが、実運用での表現品質に直結します。UI名や配置はバージョン差があるため相当メニューを探してください。
フルトラッキングの割当とTポーズ
Resoniteを起動し、設定メニューの「Tracking」「Devices」等から入力ソースを有効化して割当を行います。Tポーズでキャリブレーションを行い、Floor offsetやYawリセンターで基準を合わせてください。
Vive Trackerの実践例（8点／11点構成の考え方）
ここでは一般的な構成例を示します。公式の「最大トラッカー数」表記はリリースノートで変わるため、該当のリリースノート（バージョン番号・日付・URL）を必ず取得して運用に反映してください（公式ページ: https://resonite.com/、Steam: https://store.steampowered.com/app/2519830/Resonite/）。
- 8点例（実務向け）: HMD + 左右コントローラ + トラッカー×5（腰、胸、左右足首、肩/膝）
- 11点例（高精度向け）: HMD + 左右コントローラ + トラッカー×8（腰、胸、左右肩、左右肘、左右足首）
（注意／推奨）実際の安定動作はSteamVR・USB/Bluetooth環境・ドライバ・PCスペックに依存します。高トラッカー数運用は段階的に増やして動作確認を行ってください。
Quest Pro（フェイシャル／アイト）連携の一般手順
Quest Pro等のHMDから顔／目データをPCへ転送する場合、VirtualDesktop（やOculus Link/Air Link）経由で転送し、PC側でVRCFaceTracking等を受信してResoniteへマッピングします。転送はネットワークに依存するため、5GHz帯の専用SSIDや有線Linkを推奨します。
Leap Motion（Ultraleap）の導入
センサーをHMD下部にマウントするかデスクに置き、Ultraleap/Orionドライバを導入してサービス稼働を確認します。Resonite側でLeap入力を有効化し、ハンドジョイントをマッピングしてください。
トラブルシュート・ログ収集とサポート提出
問題発生時は順序立てて切り分け、必要なログを揃えてサポートへ提出することが最短解決に繋がります。ここでは実務で使える具体的手順と注意点を示します。
初動切り分けの番号付きフロー（短縮）
問題カテゴリ別の初動対応を短文で示します。
- 未検出: バッテリー確認 → 別USBポート（裏面直挿し） → 再ペアリング → SteamVR再起動。
- ジッター/遅延: CPU/GPU負荷低減 → Bluetoothドングル位置調整 → スムージング設定を変更。
- ドロップアウト: 台数を減らして切り分け → バッテリー/ファーム更新確認。
- 干渉: 反射物除去、ベースステ角度調整、他無線機器の停止。
SteamVRのSystem Report（保存手順と注意）
SteamVRのシステムレポートはサポート提出で最も重要な情報の一つです。以下の手順で収集してください。
- 問題を再現する（発生状態を維持）。
- SteamVRを開き、メニュー → Settings → Developer（開発者）を選択。
- 「Save System Report」もしくは「Save System Report to file」を実行し、ZIPを保存する。
- 保存時にアクセス権エラーが出る場合は、Steam/SteamVRを管理者権限で再実行して再保存する。
（注意）保存先は分かりやすいフォルダ（デスクトップ等）に指定してください。
Resoniteログの取得（メニュー名と想定パス）
Resonite側のログはバージョンによって配置やエクスポートメニューが異なります。典型的な確認手順と想定パスを示します。
- アプリ内: 設定（Settings）またはヘルプ（Help）メニューに「Open logs folder」「Export logs」「Show debug logs」等の項目があれば実行してログフォルダを開く。
- 想定パス（例）: %LOCALAPPDATA%\Resonite\Saved\Logs\ または %APPDATA%\Roaming\Resonite\Logs\
- 見つからない場合: Windowsのファイル検索で「resonite」「log」などでワイルドカード検索する。
（公式）メニュー名やパスはバージョン差があるため、該当するリリースノートの「ログ取得方法」記載を確認してください。
WindowsでのUSBルート確認方法（短い手順）
USB帯域の問題切り分けの基本手順です。
- Device Manager（デバイスマネージャ）を開く。
- 「View」→「Devices by connection（接続別表示）」に切り替える。
- 「USB Root Hub（xHCI）」や「Generic USB Hub」を展開し、接続されているデバイスを確認する。
- 各デバイスのプロパティ → Details（詳細）→「Location Paths」や「Physical Device Object Name」でポート情報を確認する。
（推奨）可視化には「USBTreeView」等のツールを管理者権限で使うと分かりやすいです。
ログの個人情報マスク方法（手順とコマンド例）
サポート提出前にSSIDやMAC、ユーザ名など機密情報をマスクしてください。代表的な手順を示します。
- 手動（推奨）: ログファイルをテキストエディタ（Notepad++等）で開き、検索・置換でSSIDやMACを "
" / " " に置換する。 - PowerShell（例）: MACアドレス形式をマスクする場合（管理者で実行）
|
1 2 |
(Get-Content path\to\logfile.log) -replace '([0-9A-Fa-f]{2}[:-]){5}[0-9A-Fa-f]{2}','<REDACTED_MAC>' | Set-Content path\to\logfile_masked.log |
- SSID行をマスクする例（SSIDキーを含む行を置換）
|
1 2 |
(Get-Content path\to\logfile.log) -replace 'ssid=[^\r\n]+','ssid=<REDACTED_SSID>' | Set-Content path\to\logfile_masked.log |
（重要）マスク作業後にファイルを開いて機密情報が消えていることを必ず確認してください。
代表的なエラーメッセージと対処例（簡潔）
現場でよく見るメッセージの例と短い対処法です。具体的なコードはデバイスやソフトに依存します。
- 「Tracker not detected」→ USB差替え、ペアリング再実行、電源/バッテリー確認。
- 「Tracking lost」→ ベースステーションの視界確認、反射物の除去、再キャリブレーション。
- 「Pairing failed」→ SteamVRを完全再起動（vrserver等のプロセス終了含む）、管理者で実行してペアリング。
- 「Low battery / Battery critically low」→ バッテリー交換または充電。
トラッカーLED状態（参考）
LEDの色や点灯パターンは機種・ファームで差があります。以下は一般例であり、必ず機器の公式ドキュメントで確かめてください。
| LED状態 | 意味（参考） | 対処 |
|---|---|---|
| 消灯 | 電源オフ | 電源を入れる/充電確認 |
| 点滅（短周期） | ペアリングモード | ペアリング手順に従う |
| 点灯（緑等） | 接続・追跡中 | 正常動作、位置確認 |
| 点滅（赤/橙） | 低電池 / エラー | 充電またはファーム確認 |
（注意）色・パターンはモデル依存のため、必ず製品マニュアルのLED説明を参照してください。
セキュリティと個人情報保護上の注意（Quest Pro / VirtualDesktop等）
顔や目のデータは機微情報に該当する可能性が高く、転送や保存時の取り扱いに注意が必要です。仕組みや権限、暗号化状態を事前に確認してください。
顔・目データの権限と暗号化確認
QuestやVirtualDesktopを使う場合は次を確認してください。
- Quest側のアプリ権限（カメラ/センサー）を確認し、不要ならオフにする。
- VirtualDesktop等の転送方式が暗号化されているか公式ドキュメントで確認する。暗号化が不明な場合は社内ポリシーとして有線Link（Oculus Link）を優先する。
- 公衆Wi‑Fiや不特定ネットワーク上での転送は避け、専用の閉域ネットワークを用いる。
（注意/自己責任）個人の顔・目の生体情報を扱う場合、法令（GDPR等）や社内の個人情報保護規程に従い、参加者の同意を取得してください。
サポート提出時の個人情報配慮
ログやスクリーンショットにSSID、MAC、ユーザ名、IPアドレス等が含まれる場合があります。提出前に上記のマスク手順で赤外情報を消去し、提出先のアクセス制限と保存期間を確認してください。
公式情報と実務上の推奨の区別
- 公式情報：機能仕様、リリースノート、ファームウェアの説明は公式ドキュメントを優先する。
- 実務上の推奨：USB分散やBTドングル配置などは現場の経験則に基づく運用推奨であり、「推奨／自己責任」と明示して運用判断してください。
参考リンクと用語集
以下は主要な参照先と用語の整理です。各リンクは該当ページの「News/Changelog」や設定項目を確認してください。参照日: 2024-06-01
- Resonite 公式サイト — https://resonite.com/（リリースノート/News を確認してください）
- Resonite（Steam ストア） — https://store.steampowered.com/app/2519830/Resonite/（News/Updates 欄）
- SteamVR（Steam） — https://store.steampowered.com/（SteamVRの設定／Developerメニューを参照）
- VirtualDesktop（公式） — https://www.vrdesktop.net/（Streamer/Forward設定の説明）
- VRCFaceTracking（GitHub等のブリッジ） — https://github.com/vrchat-community/VRCFaceTracking など（バージョンを確認）
- Ultraleap（Leap Motion） — https://www.ultraleap.com/
- USBTreeView（USBトポロジ可視化ツール） — https://www.uwe-sieber.de/usbtreeview_e.html
用語集（短縮・統一表現）
- フルトラッキング = 全身トラッキング（同義）
- Vive Tracker = SteamVRトラッカー（メーカー名と規格の両方を示す場合がある）
- HMD = Head Mounted Display（ヘッドセット）
- Quest Pro = Meta Quest Pro（製品名）
- トラッカー数の「最大」表記 = 公式のリリースノートに依存。環境により実際の安定稼働数は変動する。
まとめ
Resoniteで現場運用を安定させるためには、まず最小構成で迅速に動作確認を行い、USB/Bluetoothの物理構成とソフト／ファームのバージョン管理を徹底することが近道です。トラブル時はSteamVRのSystem ReportとResoniteのログを同時に収集し、SSID/MAC等の個人情報を必ずマスクしてサポートに提出してください。顔・目データを扱う場合は転送経路の暗号化や権限設定、法令・社内規程に従うことを優先してください。
- 最小構成で動作確認 → 段階的にトラッカー追加。
- ペアリングは「PC→HMD→ベース→コントローラ→トラッカー（1台ずつ）」の順。
- ログ収集: SteamVR System Report + Resoniteログ（該当ファイルをZIP化）を添付。
- 個人情報対策: ログ提出前にSSID/MAC等をマスクし、保存先・保存期間を限定する。
- 公式表記（例: 最大トラッカー数）は必ず該当リリースノートのバージョン・日付・URLを記録して参照する。