输入系统 · 使用说明

〇它是干什么的

先花 30 秒建立直觉，再动手写。

RevInput.Bind("Jump", RevKey.Space, RevKey.JoystickButton0);   // ① 绑一次（键盘和手柄一起绑）
RevInput.OnPressed("Jump", Jump, owner: this);                 // ② 订阅事件：按下时框架叫你
RevInput.OnAxis("MoveX", v => _moveX = v, owner: this);        // ③ 订阅轴：数值变了才叫你

一3 分钟跑起来（可粘贴）

不用初始化、不用挂脚本。推荐写法 A：事件驱动 —— 业务里连 Update 都不用写。

写法 A：事件驱动（推荐）

sealed class PlayerInput : RevInputListenerBase      // ① 继承基类：只重写你关心的方法
{
    float _moveX, _moveY;

    void OnEnable()
    {
        RevInput.Bind("Jump", RevKey.Space, RevKey.JoystickButton0);
        RevInput.Bind("Fire", RevMouseButton.Left);
        RevInput.BindAxis("MoveX", RevKey.A, RevKey.D);
        RevInput.BindAxis("MoveY", RevKey.S, RevKey.W);
        RevInput.SetRepeat("Fire", 0.35f, 0.08f);    // 想让"按住自动连发"也走事件，就先配节拍
        RevInput.AddListener(this, owner: this);     // ② 登记一次：之后输入由框架推给你
    }

    void OnDisable() => RevInput.OffAllOf(this);     // ③ 一行退订（事件 + 屏蔽一起清）

    public override void OnInputPressed(string action)
    {
        switch (action)                              // ④ 在回调里干活，不用每帧问"按了没"
        {
            case "Jump": Jump(); break;
            case "Fire": Shoot(); break;
        }
    }

    public override void OnInputRepeat(string action) => Shoot();   // 按住连发（框架按节拍推）

    public override void OnInputAxis(string axis, float value)      // 轴：只在数值变化时回调
    {
        if (axis == "MoveX") _moveX = value;         // 只记下来；什么时候用由你的移动逻辑决定
        if (axis == "MoveY") _moveY = value;
    }

    public override void OnInputGesture(RevGestureEvent g)          // 手势：点击 / 滑动 / 长按 / 双指…
    {
        if (g.Kind == RevGestureKind.Swipe) Dodge(g.Direction);
    }
}

不想继承基类也行，按事件单独订阅（可混用）：

RevInput.OnPressed("Jump", Jump, owner: this);                    // 按下
RevInput.OnRepeat("Fire", Shoot, owner: this);                    // 连发
RevInput.OnAxis("MoveX", v => _moveX = v, owner: this);           // 轴变化
RevInput.OnGesture(OnAnyGesture, owner: this);                    // 全部手势

写法 B：在 Update 里轮询（问"此刻状态"时用）

上面两种和轮询可以混用 —— 需要"当前是不是按着 / 摇杆此刻多少 / 按住多久了"这类快照式问题，直接读：

void Start()
{
    // ① 绑定（一次；写在任意启动代码里都行）
    RevInput.Bind("Jump", RevKey.Space, RevKey.JoystickButton0);   // 一个动作可绑多个键
    RevInput.Bind("Fire", RevMouseButton.Left);                    // 鼠标键也是动作
    RevInput.BindAxis("MoveX", RevKey.A, RevKey.D);                // 键位轴：A 负 / D 正
    RevInput.BindAxis("MoveY", RevKey.S, RevKey.W);
}

void Update()
{
    // ② 查相位：按下 / 按住 / 抬起
    if (RevInput.Pressed("Jump"))  Jump();          // 只成立一帧
    if (RevInput.Held("Fire"))     Shoot();         // 一直按着一直播
    if (RevInput.Released("Fire")) StopShoot();

    // ③ 查轴（-1..1，已过死区）
    float x = RevInput.Axis("MoveX");
    float y = RevInput.Axis("MoveY");
    var move = RevInput.Vector("Move");             // 约定：读 MoveX / MoveY，返回 (X, Y) 两个 float
    transform.Translate(new Vector3(move.X, 0f, move.Y) * Time.deltaTime * speed);
}

二"我要做 X" 对照表（全部 API）

左边找需求，右边抄一行。入口统一是 RevInput。

三键位、轴与"动作名"约定

只有三条约定要记。

手柄要额外做一步：摇杆这类"模拟量"要走命名轴 —— 在 Project Settings → Input Manager 里确认有 Horizontal / Vertical（Unity 默认自带），然后

RevInput.BindNamedAxis("LookX", "Mouse X");
RevInput.BindAxis("MoveX", RevKey.A, RevKey.D);      // 或者：手柄也用命名轴

没配轴名时会按 0 处理并只报警一次（不会每帧刷屏）。

四触屏与手势（7 种）

编辑器里用鼠标拖拽就能试：Unity 默认会模拟触摸（Input.simulateMouseWithTouches）。

// 相机缩放（双指）
if (RevInput.HasGesture(RevGestureKind.Pinch))
    camera.orthographicSize = Mathf.Clamp(camera.orthographicSize / RevInput.PinchScale, 2f, 12f);

// 闪避（四向滑动）
if (RevInput.Swipe(out var sw))
{
    switch (sw.Direction)
    {
        case RevSwipeDirection.Left:  Dodge(Vector3.left);  break;
        case RevSwipeDirection.Right: Dodge(Vector3.right); break;
        // 斜向也能收到：UpLeft / UpRight / DownLeft / DownRight
    }
}

五弹窗 / 暂停：屏蔽输入的正确姿势

弹窗打开时：挡世界输入，但不要把整个模块关掉（ESC、返回键会一起失灵）。

// ① 最省心：作用域（出块自动解除屏蔽 + 自动退订事件）
using (var scope = RevInput.OpenScope())
{
    scope.Block();                                       // 只挡世界输入（动作 + 手势）
    scope.OnPressed("Confirm", Save);                    // 事件也挂在这个作用域上
    ShowDialog();
}   // 出块：屏蔽解除，事件全部退订

// ② 手动管句柄
var block = RevInput.Block();
…
block.Close();

// ③ 只挡某根手指（比如"左手在拖镜头，右手点技能"）
RevInputBlock pinch = RevInput.Block(RevInputBlockKind.Pointer, RevInput.PointerId(0));

// ④ 全挡（过场/加载：指针位置也读不到）
RevInput.Block(RevInputBlockKind.All);

六改键与存档（文本格式）

绑定表可以整体导出/载入，玩家改键就存这段文本。

# RevInput 绑定表（动作 = 输入源, ...）
Jump  = Space, JoystickButton0
Fire  = Mouse0, repeat:0.20/0.05
MoveX = -A, +D
MoveY = -S, +W
LookX = axis:Mouse X

string text = RevInput.SaveBindings();      // 导出（存 PlayerPrefs / 文件都行）
RevInput.LoadBindings(text);                // 载入（整体替换，不是合并）
if (RevInput.LoadBindings(badText) == false) RevInput.Failed += (reason, detail) => …;   // 坏存档被拒绝且不落地
string conflicts = RevInput.FindConflicts(); // "Space 同时绑给了 Jump 和 Dash"（改键后必须查一次）

七新手最容易踩的 6 个坑

八出问题怎么查（3 分钟定位）

先看三样东西，再对症状。

// ① 打开诊断：绑定、屏蔽、设备切换都会走 RevLog 的 Input 标签
RevInput.VerboseLog = true;

// ② 看自检：设备名 / 动作数 / 屏蔽数 / 监听数 / 指针数 / 累计帧数
Debug.Log(RevInput.Dump());

// ③ 看失败：不为 0 就订阅 Failed 看原因码（键位名不认识 / 动作名非法 / 存档格式错…）
Debug.Log(RevInput.FailedCount);
RevInput.Failed += (reason, detail) => Debug.LogWarning($"[Input] {reason}: {detail}");

九相关文档

• 《输入系统 · 架构解析》 —— 设计论证：为什么这么分层、每帧到底做了什么、与"为帧同步设计的输入方案"相比取了什么舍了什么
• 《UI 系统 · 使用说明》 —— UI 按钮点击走它，输入模块只管世界输入
• 《公共 Mono 模块 · 使用说明》 —— 纯 C# 类要每帧跑就用它
• 文档总入口 · 在线文档站