HTC Vive Trackerの仕様・使い方まとめ

Tweet

公式資料

1. Viveトラッカー開発者ガイドライン
2. Viveトラッカー3Dモデル

ペアリング方法

1. USBワイヤレスドングルをPCに接続
2. SteamVRメニューから、デバイス>コントローラーのペアリング
3. 電源ボタン（Viveマーク）長押しでLEDが青く点滅
4. ペアリングに成功するとLEDが緑に点灯

充電方法

1. ACアダプタでMicroUSB接続
   • 最大5V/1000mA。最大充電時間1.5時間。
2. PCとMicroUSB接続
   • 最大5V/500mA。最大充電時間3時間。
3. Pogo Pinの3番に5V給電
   • 最大5V/500mA。最大充電時間3時間。

ファームウェアアップデート

• USB接続してSteamVRメニューから、デバイス>ファームウェアの更新
• 設定からBluetoothコミュニケーションを有効化しておくと無線での更新が可能。（管理者ユーザーじゃないとBluetoothドライバが正しく入らない可能性有り）

視野角(FOV)

接続例

Use Case 1 : Tracker USB通信

Use Case 2 : Tracker USB通信 + アクセサリ 別途通信

Use Case 3 : Tracker 無線通信

Use Case 4 : Tracker 無線通信 + アクセサリ 別途通信

Use Case 5 : Tracker&アクセサリ 無線通信

Pogo Pin（ポゴピン）

ピン配置

1. Digital output（アクセサリーとの連携用）
2. GND
3. Digital / Power input（グリップボタン）
4. Digital input（トリガーボタン）
5. Digital input（トラックパッドボタン）
6. Digital input（メニューボタン）

ピン情報

• 3.5mmピッチ
• パッド部は縦幅4.1mm x 横幅2mm
• 謎規格すぎてどこにも対応コネクタが見つからない…。あまりに酷すぎるので、公式がそのうちコネクタ販売開始するんじゃないかな？

使用方法

1. ボタンシミュレーション
   • Digital inputピンをGNDにショートさせるとボタン押下状態になる
2. 外部アクセサリー（バイブレーションなど）との連携
   • 1ピンからのDigital outputをアクセサリ側で受け取って、アクチュエーター等と連携させる。
   • ONにすると約3.3Vが出力される。振動モーターとかなら回せる。
   • 現状、API的に1~3999(ms = ミリ秒)しか連続してONにできない。
   • update内で叩きまくっても瞬断してしまうので、Output Pinで他のマイコン等を動作させるにはコンデンサを挟む必要がありそう。
   • SteamVR PluginからOutput PinをONにするにはTriggerHapticPulse()を呼ぶ。

     SteamVR_Controller.Device device;
     device = SteamVR_Controller.Input((int)index);
     device.TriggerHapticPulse((ushort)millisec);
     

     ※Pulseという名前が付いてるけど実際はDuration(期間(ms))なので注意。（1~3999の範囲）

Vive Tracker用アダプタ作ってみた

• HTC Vive Tracker Hot Shoe Adapter
  http://www.thingiverse.com/thing:2213549

• HTC Vive Tracker Band Adapter
  https://www.thingiverse.com/thing:2213567

Output Pinを使ったコマンド送信がしたい

一部の人が切望しそうなPogoPinコミュニケーション(#ViveTracker (#unity )→Arduino)機能が実装できた。
Trackerでラジコンやロボットや照明制御したり、簡単な事ならTrackerの無線だけで完結できる。
USBは電源用で通信には使ってない。 pic.twitter.com/3w4Nmu3Q9U

— Teruaki Tsubokura (@kohack_v) 2017年4月10日

USB接続

• HIDのレポートにはInput、Output、Featureの3種類があるらしい。
  http://wiki.onakasuita.org/pukiwiki/?%E3%83%AC%E3%83%9D%E3%83%BC%E3%83%88%E3%83%87%E3%82%A3%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%82%BF
• AVRマイコンでV-USBを使えばHID対応のアクセサリが作れるかもしれない。
  http://jsdiy.web.fc2.com/vusb_hid/
  http://qiita.com/takeru@github/items/42873e1a7e0aef830eea

• Arduinoで使えるVive Trackerライブラリを作ろうとしてる人のブログ
  http://www.talariavr.com/blog/vive-tracker-initial-documentation/

Unity上での使い方

1. 公式のSteamVRプラグインをインポート
2. [CameraRig]プレハブのControllerをコピーして名前をTrackerとかに変えておく。
3. [CameraRig]にアサインされているSteamVR_ControllerManagerのObjectsにTrackerのゲームオブジェクトを追加すれば使える。
4. ボタンの入力を取得したい場合は、TrackerのゲームオブジェクトにSteamVR_TrackedControllerをAddして、キーに応じたイベントリスナーを登録しておく。

_controller = GetComponent<SteamVR_TrackedController>();
_controller.TriggerClicked += TriggerClickedFunction; //トリガーがクリックされたらTriggerClickedFunction()を実行
_controller.MenuButtonClicked += MenuButtonClickedFunction; //メニューボタンがクリックされたらMenuButtonClickedFunction()を実行
_controller.PadClicked += PadClickedFunction; //パッドボタンがクリックされたらPadClickedFunction()を実行
_controller.Gripped += GrippedFunction; //グリップボタンがクリックされたらGrippedFunction()を実行
_controller.SteamClicked += SteamClickedFunction; //SteamボタンがクリックされたらSteamClickedFunction()を実行

void TriggerClickedFunction(object sender,ClickedEventArgs e)
{
  //トリガーが押された時の処理
}

Unityで使うときの注意

DeviceIndexが何番に割り当てられるかわからない問題

• SteamVR_RenderModel の、renderModelName（描画されるモデルの名前）によって処理を分岐させると良いかも。

string renderModelName = GetComponentInChildren<SteamVR_RenderModel>().renderModelName;
if (renderModelName.IndexOf("{htc}vr_tracker_vive_1_0") > -1)
{
  // Trackerの時だけ実行
}

• ViveTrackerの場合はモデル名は「{htc}vr_tracker_vive_1_0」
• Viveコントローラーの場合はモデル名は「vr_controller_vive_1_5」
• これらの名前はSteamVRやデバイスのファームウェアのアップデートによって変わるかもしれない。

Viveコントローラー2本の接続が必要？

• Viveコントローラー2本が接続されていない状態ではTrackerの挙動が安定しなかった。（位置や角度がおかしくなる）
• SteamVR PluginデフォルトのプレハブについてるSteamVR_ControllerManagerでは左手右手のコントローラーを指定しなければいけないためかもしれない。コントローラーを登録せずにTrackerのみ登録すればいけるかも？

アクセサリーの位置合わせ

• 公式ドキュメントには毎フレームGameObject.Find()かけて位置と角度を代入するという重そうなサンプルスクリプトが書いてある。
• スクリプトからやらなくてもTrackerゲームオブジェクトの子にアクセサリー用の3Dモデルを配置して位置合わせするだけでよさそう。

HTC VIVE本体（HMD）も接続が必要

• 公式フォーラムでも回答のあった通り、HMD無しでViveコントローラーやTrackerのみをつかう事が「現状」ではできない。今後修正される可能性あり。
• HMD無しではSteamVRが利用不可状態に。
• PythonからHMD無しで使えてる人がいる？
  https://www.triadsemi.com/2017/03/28/steamvr-tracking-without-an-hmd/
  上記の方法を試してみたところ、確かにHMD無しで接続することはできた。
  
  ただ、Unityエディタ上でも書き出したアプリからもTrackerやコントローラーが表示されることは無かった…。
  しかもしばらくするとSteamVRがフリーズしてしまう。おとなしく公式の対応を待った方がいいかも。

プロトタイプ作ってみた

• 1-10drive 試作室 prototyping project
  http://prototyping-project.com/