コンテンツにスキップ

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

機能番号の付与ルール

  1. 接続順序ベース: デバイスが接続された順番に番号を付与
  2. 機能別分離: 同じデバイスが複数機能を持つ場合、機能ごとに別番号を付与
  3. 動的生成: 接続・切断に応じて番号が動的に変更される

制御値の解釈(統一仕様)

すべての機能で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つのアドレスに送信するようになっています。