Appearance
按键与行动
属性
虚拟按键
gamepad
设置虚拟按键图片
定义于 #L11745
实体按键
disableInputDirection
默认值：GameInputDirection.NONE
禁用指定方向的摇杆输入偏移量，当横纵两个方向均被禁用时，将不显示此玩家的触屏虚拟摇杆。
定义于 #L11967
enableAction0
默认值：true
启动鼠标左键/移动端虚拟按钮A键
定义于 #L11984
enableAction1
默认值：true
启动鼠标右键/移动端虚拟按钮B键
定义于 #L11989
action0Button
默认值：false
鼠标左键/移动端虚拟按钮A键
定义于 #L11993
action1Button
默认值：false
鼠标右键/移动端虚拟按钮B键
定义于 #L11997
jumpButton
默认值：false
跳跃按钮
定义于 #L11979
walkButton
默认值：false
步行按钮
定义于 #L11971
行动
swapInputDirection
默认值：false
是否交换方向按键
警告
相对摄像机视角而言：
不开启：w：前进，s：后退，a：左走，d：右走
开启：w：右走，s：左走，a：后退，d：前进
定义于 #L11959
reverseInputDirection
默认值：GameInputDirection.NONE
反转指定方向的摇杆
定义于 #L11963
facingDirection
默认值：GameVector3(1, 0, 0)
玩家朝向
定义于 #L12017
canFly
默认值：false
如果为真(true)，则允许玩家飞行
定义于 #L11868
spectator
默认值：false
如果为真(true)，则玩家是一个幽灵，可以穿墙
定义于 #L11873
enableJump
默认值：true
如果为假(false)，则不允许玩家跳跃
定义于 #L12001
enableDoubleJump
默认值：true
如果为假(false)，则不允许玩家二段跳跃
定义于 #L12005
walkSpeed
默认值：0.22
最大步行速度
定义于 #L11878
runSpeed
默认值：0.4
最大奔跑速度
定义于 #L11888
runAcceleration
默认值：0.35
奔跑加速度
定义于 #L11893
jumpPower
默认值：0.96
跳跃力度
定义于 #L11938
jumpSpeedFactor
默认值：0.85
跳跃速度
定义于 #L11928
jumpAccelerationFactor
默认值：0.55
跳跃加速率
定义于 #L11933
doubleJumpPower
默认值：0.9
二段跳力度
定义于 #L11943
crouchSpeed
默认值：0.1
蹲着走路的速度
定义于 #L11898
crouchAcceleration
默认值：0.09
蹲着走路的加速度
定义于 #L11903
flySpeed
默认值：2
最大飞行速度
定义于 #L11918
flyAcceleration
默认值：2
飞行加速度
定义于 #L11923
swimAcceleration
默认值：0.1
游泳加速度
定义于 #L11913
swimSpeed
默认值：0.4
最大游泳速度
定义于 #L11908
walkAcceleration
默认值：0.19
步行加速度
定义于 #L11883
moveState
默认值：GamePlayerMoveState.FALL
玩家的运动状态
定义于 #L11951
walkState
默认值： GamePlayerWalkState.NONE
玩家的步行状态
定义于 #L11955
cameraPitch
默认值：0
玩家视角准心绕水平方向的旋转弧度
定义于 #L12025
cameraYaw
默认值：0
玩家视角准心绕垂直方向的旋转弧度
定义于 #L12021
方法
onPress()
当玩家按下按钮时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家按下按钮时的处理函数 |
定义于 #L11629
onRelease()
当玩家松开按钮时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家松开按钮时的处理函数 |
定义于 #L11635
onKeyDown()
当玩家按下键盘时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家按下键盘时的处理函数 |
定义于 #L11743
onKeyUp()
当玩家松开键盘时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家松开键盘时的处理函数 |
定义于 #L11744
kick()
把玩家"踢出"当前地图
定义于 #L12211
接口
GameKeyBoardEvent
输入事件，在玩家按下或松开按键时触发。
| 参数 | 类型 | 说明 |
|---|---|---|
| keyCode | number | 按下/松开按键的keyCode |
| tick | number | 按下/松开按钮的时间 |
定义于 #L13075
Gamepad
虚拟按键背景图片配置
| 参数 | 类型 | 说明 |
|---|---|---|
| joystickBackground | string | 操纵杆背景 |
| joystickController | string | 操纵杆控制器 |
| flyButton | string | 飞行按钮 |
| flyingBackground | string | 飞行按钮背景 |
| flyingController | string | 飞行按钮控制器 |
| jump | string | 跳跃按钮 |
| crouch | string | 蹲下按钮 |
| actionA | string | A键按钮 |
| actionB | string | B键按钮 |
定义于 #L11599
枚举
GamePlayerMoveState
玩家的运动状态
| 属性 | 说明 |
|---|---|
| FLYING | 飞行中 |
| GROUND | 在地上 |
| SWIM | 游泳中 |
| FALL | 下落中 |
| JUMP | 跳跃中 |
| DOUBLE_JUMP | 二段跳中 |
定义于 #L11215
GamePlayerWalkState
玩家的行走状态
| 属性 | 说明 |
|---|---|
| NONE | 非行走中 |
| CROUCH | 下蹲行走 |
| WALK | 正常步行 |
| RUN | 奔跑 |
定义于 #L11226
GameInputDirection
玩家通过输入设备控制移动时的方向
| 属性 | 说明 |
|---|---|
| NONE | 无，代表不禁用 |
| VERTICAL | 垂直方向 |
| HORIZONTAL | 水平方向 |
| BOTH | 所有方向 |
定义于 #L11571
keyCode映射表
字母和数字键的键码值
| 按键 | 键码 | 按键 | 键码 | 按键 | 键码 | 按键 | 键码 | |||
|---|---|---|---|---|---|---|---|---|---|---|
| A | 65 | J | 74 | S | 83 | 1 | 49 | |||
| B | 66 | K | 75 | T | 84 | 2 | 50 | |||
| C | 67 | L | 76 | U | 85 | 3 | 51 | |||
| D | 68 | M | 77 | V | 86 | 4 | 52 | |||
| E | 69 | N | 78 | W | 87 | 5 | 53 | |||
| F | 70 | O | 79 | X | 88 | 6 | 54 | |||
| G | 71 | P | 80 | Y | 89 | 7 | 55 | |||
| H | 72 | Q | 81 | Z | 90 | 8 | 56 | |||
| I | 73 | R | 82 | 0 | 48 | 9 | 57 |
数字键盘上的键的键码值 | 功能键键码值
| 按键 | 键码 | 按键 | 键码 | 按键 | 键码 | 按键 | 键码 | |||
|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 96 | 8 | 104 | F1 | 112 | F7 | 118 | |||
| 1 | 97 | 9 | 105 | F2 | 113 | F8 | 119 | |||
| 2 | 98 | * | 106 | F3 | 114 | F9 | 120 | |||
| 3 | 99 | + | 107 | F4 | 115 | F10 | 121 | |||
| 4 | 100 | Enter | 108 | F5 | 116 | F11 | 122 | |||
| 5 | 101 | - | 109 | F6 | 117 | F12 | 123 | |||
| 6 | 102 | . | 110 | |||||||
| 7 | 103 | / | 111 |
控制键键码值
| 按键 | 键码 | 按键 | 键码 | 按键 | 键码 | 按键 | 键码 | |||
|---|---|---|---|---|---|---|---|---|---|---|
| BackSpace | 8 | Esc | 27 | Right Arrow | 39 | -_ | 189 | |||
| Tab | 9 | Spacebar | 32 | Dw Arrow | 40 | .> | 190 | |||
| Clear | 12 | Page Up | 33 | Insert | 45 | /? | 191 | |||
| Enter | 13 | Page Down | 34 | Delete | 46 | `~ | 192 | |||
| Shift | 16 | End | 35 | Num Lock | 144 | [{ | 219 | |||
| Control | 17 | Home | 36 | ;: | 186 | \| | 220 | |||
| Alt | 18 | Left Arrow | 37 | =+ | 187 | ]} | 221 | |||
| Caps Lock | 20 | Up Arrow | 38 | ,< | 188 | '" | 222 |
多媒体键码值
| 按键 | 键码 |
|---|---|
| 音量加 | 175 |
| 音量减 | 174 |
| 停止 | 179 |
| 静音 | 173 |
| 浏览器 | 172 |
| 邮件 | 180 |
| 搜索 | 170 |
| 收藏 | 171 |