Appearance
按键与行动
属性
虚拟按键
gamepad
设置虚拟按键图片
实体按键
disableInputDirection
默认值：GameInputDirection.NONE
禁用指定方向的摇杆输入偏移量，当横纵两个方向均被禁用时，将不显示此玩家的触屏虚拟摇杆。
enableAction0
默认值：true
启动鼠标左键/移动端虚拟按钮 A 键
enableAction1
默认值：true
启动鼠标右键/移动端虚拟按钮 B 键
action0Button
默认值：false
鼠标左键/移动端虚拟按钮 A 键
action1Button
默认值：false
鼠标右键/移动端虚拟按钮 B 键
jumpButton
默认值：false
跳跃按钮
walkButton
默认值：false
步行按钮
行动
swapInputDirection
默认值：false
是否交换方向按键
警告
相对摄像机视角而言：
不开启：w：前进，s：后退，a：左走，d：右走
开启：w：右走，s：左走，a：后退，d：前进
reverseInputDirection
默认值：GameInputDirection.NONE
反转指定方向的摇杆
facingDirection
默认值：GameVector3(1, 0, 0)
玩家朝向
canFly
默认值：false
如果为真(true)，则允许玩家飞行
spectator
默认值：false
如果为真(true)，则玩家是一个幽灵，可以穿墙
enableJump
默认值：true
如果为假(false)，则不允许玩家跳跃
## enableDoubleJump
默认值：true
如果为假(false)，则不允许玩家二段跳跃
walkSpeed
默认值：0.22
最大步行速度
runSpeed
默认值：0.4
最大奔跑速度
runAcceleration
默认值：0.35
奔跑加速度
jumpPower
默认值：0.96
跳跃力度
jumpSpeedFactor
默认值：0.85
跳跃速度
jumpAccelerationFactor
默认值：0.55
跳跃加速率
doubleJumpPower
默认值：0.9
二段跳力度
crouchSpeed
默认值：0.1
蹲着走路的速度
crouchAcceleration
默认值：0.09
蹲着走路的加速度
flySpeed
默认值：2
最大飞行速度
flyAcceleration
默认值：2
飞行加速度
swimAcceleration
默认值：0.1
游泳加速度
swimSpeed
默认值：0.4
最大游泳速度
walkAcceleration
默认值：0.19
步行加速度
moveState
默认值：GamePlayerMoveState.FALL
玩家的运动状态
walkState
默认值： GamePlayerWalkState.NONE
玩家的步行状态
cameraPitch
默认值：0
玩家视角准心绕水平方向的旋转弧度
cameraYaw
默认值：0
玩家视角准心绕垂直方向的旋转弧度
方法
onPress()
当玩家按下按钮时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家按下按钮时的处理函数 |
onRelease()
当玩家松开按钮时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家松开按钮时的处理函数 |
onKeyDown()
当玩家按下键盘时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家按下键盘时的处理函数 |
onKeyUp()
当玩家松开键盘时调用
输入参数
| 参数 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
| handler | 是 | function | 监听到玩家松开键盘时的处理函数 |
kick()
把玩家"踢出"当前地图
接口
GameKeyBoardEvent
输入事件，在玩家按下或松开按键时触发。
| 参数 | 类型 | 说明 |
|---|---|---|
| keyCode | number | 按下/松开按键的keyCode |
| tick | number | 按下/松开按钮的时间 |
## Gamepad
虚拟按键背景图片配置
| 参数 | 类型 | 说明 |
|---|---|---|
| joystickBackground | string | 操纵杆背景 |
| joystickController | string | 操纵杆控制器 |
| flyButton | string | 飞行按钮 |
| flyingBackground | string | 飞行按钮背景 |
| flyingController | string | 飞行按钮控制器 |
| jump | string | 跳跃按钮 |
| crouch | string | 蹲下按钮 |
| actionA | string | A 键按钮 |
| actionB | string | B 键按钮 |
枚举
GamePlayerMoveState
玩家的运动状态
| 属性 | 说明 |
|---|---|
| FLYING | 飞行中 |
| GROUND | 在地上 |
| SWIM | 游泳中 |
| FALL | 下落中 |
| JUMP | 跳跃中 |
| DOUBLE_JUMP | 二段跳中 |
GamePlayerWalkState
玩家的行走状态
| 属性 | 说明 |
|---|---|
| NONE | 非行走中 |
| CROUCH | 下蹲行走 |
| WALK | 正常步行 |
| RUN | 奔跑 |
GameInputDirection
玩家通过输入设备控制移动时的方向
| 属性 | 说明 |
|---|---|
| NONE | 无，代表不禁用 |
| VERTICAL | 垂直方向 |
| HORIZONTAL | 水平方向 |
| BOTH | 所有方向 |
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 |