# ContactGloveOSC 手動セットアップ
- [ 1 ]Automatic Setup Avatarを利用した自動セットアップ (opens new window)が上手くいかない場合/細かい設定を変更したい場合は、手順[ 1 ]の代わりにこちらのセットアップ手順を参照してください。
- その他細かな設定を行いたい場合や、エラー時のトラブルシューティングについてはトラブルシューティング (opens new window)を合わせてご確認ください。
手順の流れは以下の図のようになります。
# [ 1-1 ]Gesture/FX ControllerのParameter名変更
- Unitypackageをプロジェクトにインポートします。
- Unityウィンドウのタブに"ContactGloveOSC"という項目が現れます。
- Parameter Rename Toolを選択します。
- Parameter Rename Toolのウィンドウが表示されます。
- （Select Languageから日本語を選択します）
- HierarchyのアバターをAvatarフィールドにドラッグアンドドロップします。
- 「パラメータをリネーム」ボタンを押します。
TIP
成功するとステータスに以下のメッセージが表示されます。
Gesture/FXコントローラのパラメータをContactGlove専用パラメータに書き換えました！ 🎉
ハンドサインAnimationについて
OSCハンドトラッキング時にハンドサインを行う際
- ハンドトラッキングを継続する場合
- ⇒[ 1-2 ]セットアップ用Prefabの設置(ハンドトラッキング継続)に進んでください。
- 手の形を指定したAnimationで固定する場合
- ⇒[ 1-2A ]セットアップ用Prefabの設置(ハンドサイン固定)に進んでください。
- 実験的実装であり、元のアバターの実装次第で上手く動作しない可能性があります。
- ”ハンドサインを設定しない場合”で設定しなおす場合は、配置したPrefabを削除し、手順に従ってセットアップを再度行ってください。
- ⇒[ 1-2A ]セットアップ用Prefabの設置(ハンドサイン固定)に進んでください。
# [ 1-2 ]セットアップ用Prefabの設置(ハンドトラッキング継続)
- Assets/ContactGloveOSC/Prefabsを開きます。
- 用途に合わせてFull ver用/Lite ver用のPrefabをいずれか１つ選択し、アバターのhierarchy直下へ置きます。
Prefabについて
- Full ver：[ContactGloveOSC]AutoSet
- 同期パラメータ（177bit）を利用して、詳細なOSCハンドトラッキングを行う場合。
- Lite ver：[ContactGloveOSC]Lite_AutoSet
- 同期パラメータ（107bit）を利用して、一部簡略化されたOSCハンドトラッキングを行う場合。
- 親指、薬指、小指の曲げ/伸ばしが0/1の表現になります。
Modular Avatarによってアバターにギミックが組み込まれるようになりました！🎉
[ 2 ]アバターのアップロード・ギミック有効化 へ進みましょう！
# [ 1-2A ]セットアップ用Prefabの設置(ハンドサイン固定)
- Packages/ContactGloveOSC/Runtime/Prefabs/HandSign[Experimental]を開きます。
- 用途に合わせてFull ver用/Lite ver用のPrefabをいずれかを１つ選択し、アバターのhierarchy直下へ置きます。
Prefabについて
- Full ver：[ContactGloveOSC]AutoSet_HandSign
- 同期パラメータ（177bit）を利用して、詳細なOSCハンドトラッキングを行う場合。
- Lite ver：[ContactGloveOSC]Lite_AutoSet_HandSign
- 同期パラメータ（107bit）を利用して、一部簡略化されたOSCハンドトラッキングを行う場合。
- 親指、薬指、小指の曲げ/伸ばしが0/1の表現になります。
# [ 1-2B ]Avatarに設定されたハンドサインAnimationのコピー
- Unityウィンドウのタブ ContactGloveOSC > HandSign Copy Toolを選択します。
- HandSign Copy Toolのウィンドウが開きます。
- （Select Languageから日本語を選択します。）
- HierarchyのアバターをAvatarフィールドにドラッグアンドドロップします。
- HandSign Copy Tool ウィンドウ左上に「Gesture Controller から自動セットする」ボタンが出現するので押します。
- 全フィールドに自動でAnimationがセットされます。
- statusにセットされた旨が表示されます。
- ウィンドウ下部の 「ハンドサインをコピー」 ボタンを押し、Animationをコピーします。
- statusにコピー元Animationとコピー先Animationの名称、コピーが完了した旨が表示されます。
Modular Avatarによってアバターにギミックが組み込まれるようになりました！🎉
[ 2 ]アバターのアップロード・ギミック有効化へ進みましょう！
# [ 2 ]アバターのアップロード・ギミック有効化
アバターをアップロードします。
VRChat内で改変したアバターに着替えます。
ActionMenu(リングメニュー)を開き、以下を実行します。
- Expressions > [CGOSC]Enable の項目があることを確認する。
- Options > OSC > トグルを "Disabled" にする。
- Options > OSC > "Reset Config" を押す。
- Options > OSC > トグルを "Enabled" にする。
WARNING
手順2.~4.はギミック付きアバターを更新した場合にも必ず行ってください。ギミックが上手く動作しません。
OSCハンドトラッキングの有効化/無効化
- [CGOSC]Enable：ONにすると、ContactGloveのOSCを利用したハンドトラッキングを行います。
- [CGOSC]Enable：OFFにすると、アバターに設定された従来のハンドトラッキング＆ハンドサインを行います。
- [CGOSC]Enable：OFF時は、様々なコントローラで従来通りの利用が可能です
- 例）
- ContactGlove (Indexエミュレーション)
- Index Controller
- その他 他社製コントローラ
- [CGOSC]Enable：OFF時は、様々なコントローラで従来通りの利用が可能です
ON
[ ContactGlove-OSC ]OFF
[ ContactGlove ( Index-Emulate ) ]
or
[ Other-Controllers ]
セットアップ時に"ContactGloveOSC Lite ver"で設定した場合
[CGOSC]Enable：ON時にハンドサインを行うと、アバターに元々設定されていたハンドサインで手の形が固定されます。
2024/7/25のVRChat(Open-Beta)2024.3.1における動作
- [CGOSC]Enable：ONにすると、ContactGloveのOSCを利用したハンドトラッキングを行います。
- [CGOSC]Enable：OFFにすると、SteamVR skeletal hand trackingを利用した指の関節ごとの曲げ動作を行います。
ContactGloveOSCによるハンドトラッキングが作動するようになりました！🎉
# [ 3 ]Gesture Toggle (OSC) バインド設定
ContactGlove-OSCハンドトラッキング時にGestureToggle機能を利用する際は、DivingStationでContctGloveOSC用の独自Gesture Toggleバインド( = Gesture Toggle (OSC) )を設定する必要があります。
[手順]
DivingStationを開きます。
コントローラ (タブ) > 設定 をクリックします
ボタンのバインディング をクリックします。
ポップアップしたウィンドウの下部から VRChat を探します。
[OSC]ジェスチャー固定を有効化/無効化( = Gesture Toggle (OSC) )バインド に、VRChatのバインドで普段GestureToggleに割り当てているボタンを割り当てます。
ex) 普段GestureToggleに割り当てているボタン = Aボタン の場合
バインド 割り当てボタン VRChat GestureToggle Aボタン ContactGlove ボタンバインド Aボタン ボタン(下) ContactGlove VRChatバインド Gesture Toggle (OSC) ボタン(下) VRChatで対応アバターに着替え、[CGOSC]Enable：ONにした上で、バインドを割り当てたボタンを押します。
- 割り当てたボタンを押すとContactGlove本体が振動し、表情固定が有効/無効化されます。
- [ 1-2A ] & [ 1-2B ]でセットアップした場合は、同時にハンドサインを固定することが出来ます。
ContactGloveOSCでOSCハントラ時にGestureToggleが作動するようになりました！🎉
セットアップ完了！
お疲れ様でした。セットアップは以上で完了となります！ 🎉
アバターで指を動かしましょう👉