# keyboard-controls

为激活相机提供 WASD 或方向键的平移和旋转控制。

```typescript
import { KeyboardControls, ACTION } from 'u-space/plugins/keyboard-controls';

const keyboardControls = new KeyboardControls(viewer);

// 可选：自定义移动速度
keyboardControls.moveDistanceDelta = 0.5;
keyboardControls.rotateAngleDelta = (Math.PI / 180) * 2;

// 激活监听
keyboardControls.enable();
// 之后：
keyboardControls.disable();
```

**默认按键绑定**（`keyboardControls.keys`）：

| 按键         | 动作     |
| :----------- | :------- |
| `W`          | 向前移动 |
| `S`          | 向后移动 |
| `A`          | 向左移动 |
| `D`          | 向右移动 |
| `Q`          | 向上移动 |
| `E`          | 向下移动 |
| `ArrowLeft`  | 向左旋转 |
| `ArrowRight` | 向右旋转 |
| `ArrowUp`    | 向上旋转 |
| `ArrowDown`  | 向下旋转 |

通过 `ACTION` 常量重新绑定任意按键：

```typescript
import { ACTION } from 'u-space/plugins/keyboard-controls';
keyboardControls.keys['Space'] = ACTION.MOVE_UP;
```