OSCパラメータ仕様
1. 機能制御パラメータ
| パラメータ形式 | 型 | 説明 | 値の範囲 |
|---|---|---|---|
/avatar/parameters/VRCPleasure/{N}/Control |
float | N番目の機能制御値 | 0.0~1.0 |
/avatar/parameters/VRCPleasure/{N}/Mode |
int | N番目の機能のモード | 0,1,2,3,10,20 |
機能番号の付与ルール
- 接続順序ベース: デバイスが接続された順番に番号を付与
- 機能別分離: 同じデバイスが複数機能を持つ場合、機能ごとに別番号を付与
- 動的生成: 接続・切断に応じて番号が動的に変更される
制御値の解釈(統一仕様)
すべての機能で0.0~1.0の値を受信し、統一的に処理します:
| 機能タイプ | 値の解釈 | 備考 |
|---|---|---|
| 振動 | 0.0=停止, 1.0=最大強度 | - |
| 回転 | 0.0=停止, 1.0=最大速度(正回転のみ) | 逆転制御は非対応 |
| 直線運動 | 0.0=停止, 1.0=最大速度 | - |
| オシレーション | 0.0=停止, 1.0=最大速度 | - |
2. 共通制御パラメータ
| パラメータ名 | 型 | 説明 | 値の範囲 |
|---|---|---|---|
/avatar/parameters/VRCPleasure/StopAll |
float/int/bool | 全機能停止 | 0=継続, 1=停止 |
/avatar/parameters/VRCPleasure/Pause |
float/int/bool | 全機能一時停止 | 0=再開, 1=停止 |
モード値の詳細
| 値 | 動作 | 説明 |
|---|---|---|
| 0 | 停止 | 機能を停止 |
| 1 | プリセット1 | サイン波などの基本パターン |
| 2 | プリセット2 | 複雑な波形パターン |
| 3 | プリセット3 | 合成波形パターン |
| 10 | マニュアル | 手動制御モード(Control値で直接制御) |
| 20 | OSCパターン | OSC連動パターンモード |
StopAllの動作
- float, int, bool いずれの型でも受信可能です。
-
0, 0.0, false など「0/false」なら動作継続、1, 1.0, true, 0.5以上 など「0以外/true」ならすべての動作を停止します。
-
例
- float型: 0.0 → 継続、1.0 → 停止、0.5 → 停止
- int型: 0 → 継続、1 → 停止
- bool型: false → 継続、true → 停止
Pauseの動作
- float, int, bool いずれの型でも受信可能です。
- 0, 0.0, false など「0/false」なら動作継続、1, 1.0, true, 0.5以上 など「0以外/true」ならすべての動作を一時停止します。
- Pause中は、各制御値(振動強度、回転速度など)の更新は内部で行われますが、デバイスへの出力は停止されます。
- Pause解除時、最新の制御値でデバイスの動作が再開されます。
3. OSCパターン制御
| パラメータ名 | 型 | 説明 | 値の範囲 |
|---|---|---|---|
/avatar/parameters/VRCPleasure/Gimmick/* |
float | パターン制御入力 | 0.0~0.1 |
Gimmick/以下のパスをすべて受信します。
Info
/avatar/parameters/VRCPleasure/Gimmick/*は、*の部分に任意の文字列を含むアドレスを受信します。
例えば、/avatar/parameters/VRCPleasure/Gimmick/Contactや/avatar/parameters/VRCPleasure/Gimmick/Pistonなどです。
なお,/avatar/parameters/VRCPleasure/Gimmick/までの部分は設定により変更可能です。
デフォルトのアバターギミックでは
- Contact
- Piston
- Breast
- SPSPlug
- SPSSocket
の5つのアドレスに送信するようになっています。