# Parameters

过渡的条件可使用官方数值，只需要在”动画器-参数”添加类型和名字与官方数值相同的参数即可

## 一、数值类型

在”动画器“中添加参数有四种类型

- Float ：浮点数，可以理解为小数
- Int ：整数型，可以理解为整数
- Bool ：布尔型，只有”True“和”False“两种取值
- Trigger ：触发器，和布尔型很像，但只能被设为true，一旦被过渡使用就会自动被设为false(好像在VRC中没用？)

下表为VRChat数值类型(一个模型的“数值”上限为“256 bits”)

<table id="bkmrk-%E6%95%B0%E5%80%BC%E7%B1%BB%E5%9E%8B-%E5%8F%96%E5%80%BC%E8%8C%83%E5%9B%B4-%E5%AD%98%E5%82%A8%E5%8D%A0%E7%94%A8-%E5%A4%87%E6%B3%A8-in"><tbody><tr><td>数值类型</td><td>取值范围</td><td>存储占用</td><td>备注</td></tr><tr><td>int</td><td>`0` ~ `255`</td><td>8 bits</td><td>Unsigned 8-bit int.</td></tr><tr><td>float</td><td>`-1.0` ~ `1.0`</td><td>8 bits</td><td>Signed 8-bit [minifloat](https://en.wikipedia.org/wiki/Minifloat)</td></tr><tr><td>bool</td><td>`True` or `False`</td><td>1 bit</td><td> </td></tr></tbody></table>

如果要做开关，动画器-参数中参数名字与类型要与VRC数值中一模一样

## 二、官方数值总览

(以下表格中文为我自己翻译，可能会有错误，仅翻译可能有用或我用过的参数)

<table id="bkmrk-name%28%E5%90%8D%E5%AD%97%29-description"><tbody><tr><td>Name(名字)</td><td>Description(描述)</td><td>Type(类型)</td><td>Sync(同步)</td></tr><tr><td>IsLocal</td><td>True if the avatar is being worn locally, false otherwise</td><td>Bool</td><td>None</td></tr><tr><td>[Viseme](https://docs.vrchat.com/docs/animator-parameters#viseme-values)(口型)</td><td>[Oculus viseme index](https://developer.oculus.com/documentation/unity/audio-ovrlipsync-viseme-reference) (`0-14`). When using Jawbone/Jawflap, range is `0-100` indicating volume</td><td>Int</td><td>Speech</td></tr><tr><td>Voice</td><td>Microphone volume (`0.0-1.0`)</td><td>Float</td><td>Speech</td></tr><tr><td>[GestureLeft](https://docs.vrchat.com/docs/animator-parameters#gestureleft-and-gestureright-values)(左手手势)</td><td>Gesture from L hand control (0-7)</td><td>Int</td><td>IK</td></tr><tr><td>[GestureRight](https://docs.vrchat.com/docs/animator-parameters#gestureleft-and-gestureright-values)(右手手势)</td><td>Gesture from R hand control (0-7)</td><td>Int</td><td>IK</td></tr><tr><td>GestureLeftWeight</td><td>Analog trigger L (0.0-1.0)†</td><td>Float</td><td>IK</td></tr><tr><td>GestureRightWeight</td><td>Analog trigger R (0.0-1.0)†</td><td>Float</td><td>IK</td></tr><tr><td>AngularY</td><td>Angular velocity on the Y axis</td><td>Float</td><td>IK</td></tr><tr><td>VelocityX(X方向速度)</td><td>Lateral move speed in m/s</td><td>Float</td><td>IK</td></tr><tr><td>VelocityY(Y方向速度)</td><td>Vertical move speed in m/s</td><td>Float</td><td>IK</td></tr><tr><td>VelocityZ(Z方向速度)</td><td>Forward move speed in m/s</td><td>Float</td><td>IK</td></tr><tr><td>Upright(高度)</td><td>How “upright” you are. 0 is prone, 1 is standing straight up</td><td>Float</td><td>IK</td></tr><tr><td>Grounded(地面)</td><td>True if player touching ground(如果跳跃则为false)</td><td>Bool</td><td>IK</td></tr><tr><td>Seated</td><td>True if player in station</td><td>Bool</td><td>IK</td></tr><tr><td>AFK</td><td>Is player unavailable (HMD proximity sensor / End key)</td><td>Bool</td><td>IK</td></tr><tr><td>Expression1 – Expression16</td><td>User defined param, Int (`0`–`255`) or Float (`-1.0`–`1.0`)</td><td>Int / Float</td><td>IK or Playable</td></tr><tr><td>[TrackingType](https://docs.vrchat.com/docs/animator-parameters#trackingtype-parameter)</td><td>See description below</td><td>Int</td><td>Playable</td></tr><tr><td>VRMode</td><td>Returns `1` if the user is in VR, `0` if they are not</td><td>Int</td><td>IK</td></tr><tr><td>MuteSelf</td><td>Returns `true` if the user has muted themselves, `false` if unmuted</td><td>Bool</td><td>Playable</td></tr><tr><td>InStation</td><td>Returns `true` if the user is in a station, `false` if not</td><td>Bool</td><td>IK</td></tr></tbody></table>

## 三、手势对应数值

用于制作手势触发动画

<table id="bkmrk-index-%28%E6%95%B0%E5%80%BC%29-gesture-%28"><tbody><tr><td>Index (数值)</td><td>Gesture (手势)</td><td>PC按键</td></tr><tr><td>0</td><td>Neutral (自然)</td><td>Shift+F1</td></tr><tr><td>1</td><td>Fist (握拳)</td><td>Shift+F2</td></tr><tr><td>2</td><td>HandOpen (张开手)</td><td>Shift+F3</td></tr><tr><td>3</td><td>fingerpoint (指)</td><td>Shift+F4</td></tr><tr><td>4</td><td>Victory (剪刀手)</td><td>Shift+F5</td></tr><tr><td>5</td><td>RockNRoll (我爱你)</td><td>Shift+F6</td></tr><tr><td>6</td><td>HandGun (手枪)</td><td>Shift+F7</td></tr><tr><td>7</td><td>ThumbsUp (点赞)</td><td>Shift+F8</td></tr></tbody></table>

注：PC按键：左Shift为左手，右Shift为右手

## 四、口型对应值

口型参考：[Viseme Reference: Unity | Oculus Developers](https://developer.oculus.com/documentation/unity/audio-ovrlipsync-viseme-reference)

可用于制作说话触发动画

<table id="bkmrk-viseme-parameter-vis"><tbody><tr><td>Viseme Parameter</td><td>Viseme</td></tr><tr><td>0</td><td>`sil`</td></tr><tr><td>1</td><td>`PP`</td></tr><tr><td>2</td><td>`FF`</td></tr><tr><td>3</td><td>`TH`</td></tr><tr><td>4</td><td>`DD`</td></tr><tr><td>5</td><td>`kk`</td></tr><tr><td>6</td><td>`CH`</td></tr><tr><td>7</td><td>`SS`</td></tr><tr><td>8</td><td>`nn`</td></tr><tr><td>9</td><td>`RR`</td></tr><tr><td>10</td><td>`aa`</td></tr><tr><td>11</td><td>`E`</td></tr><tr><td>12</td><td>`ih`</td></tr><tr><td>13</td><td>`oh`</td></tr><tr><td>14</td><td>`ou`</td></tr></tbody></table>