Input

描述

旧版输入系统的接口。

注意： Input 类是旧版输入管理器功能的一部分，不建议在新项目中使用。以下提供的文档是为了支持使用旧版输入管理器和 Input 类的旧项目。对于新项目，您应该使用输入系统包。(了解更多)

KeyCode 仅当在 输入管理器设置 中启用“使用物理键”时才映射到物理键，否则它会映射到布局和平台相关的键映射。从 2022.1 开始，“使用物理键”默认启用。

使用此类读取在 传统游戏输入 中设置的轴，以及访问移动设备上的多点触控/加速度计数据。

要读取轴，请使用 Input.GetAxis 和以下默认轴之一：“Horizontal”和“Vertical”映射到操纵杆、A、W、S、D和箭头键。“Mouse X”和“Mouse Y”映射到鼠标增量。“Fire1”、“Fire2”、“Fire3”映射到Ctrl、Alt、Cmd键和三个鼠标或操纵杆按钮。可以添加新的输入轴。有关此内容，请参阅 输入管理器。

如果您正在将输入用于任何类型的移动行为，请使用 Input.GetAxis。它为您提供了平滑且可配置的输入，可以映射到键盘、操纵杆或鼠标。仅对类似于操作的事件使用 Input.GetButton。不要将其用于移动。 Input.GetAxis 将使脚本代码更小更简单。

注意： Input 标志在 Update 之前不会重置。您应该在 Update 循环中进行所有 Input 调用。

其他资源：KeyCode，其中列出了所有按键、鼠标和操纵杆选项。

移动设备

iOS 和 Android 设备能够同时跟踪多个手指触摸屏幕。您可以使用 Input.touches 属性数组访问上帧触摸屏幕的每个手指的状态数据。

当设备移动时，其加速度计硬件会报告沿三维空间中的三个主要轴的线性加速度变化。您可以使用此数据来检测设备的当前方向（相对于地面）以及该方向的任何即时变化。

每个轴上的加速度由硬件直接报告为 G 力值。值 1.0 表示沿给定轴大约 +1g 的载荷，而值 -1.0 表示 -1g。如果您将设备直立（主页按钮在底部）放在您面前，则 X 轴沿右侧为正，Y 轴沿垂直向上为正，Z 轴沿朝向您为正。

您可以使用 Input.acceleration 属性获取加速度计读数。您还可以使用 Input.deviceOrientation 属性获取设备在三维空间中方向的离散评估。如果您想在用户旋转设备以以不同方式握住设备时创建游戏行为，则检测方向变化可能很有用。

请注意，加速度计硬件可以每帧轮询多次。要访问自上一帧以来的所有加速度计样本，您可以使用 Input.accelerationEvents 属性数组。当重建玩家动作、将加速度数据馈送到预测器或实现其他精确运动分析时，这可能很有用。

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    public void Update()
    {
        if (Input.GetButtonDown("Fire1"))
        {
            Debug.Log(Input.mousePosition);
        }
    }
}

此组件与用于将 UI 纹理和图像绘制到屏幕上的旧版方法相关。您应该改用 UI 系统。这与 IMGUI 系统无关。

静态属性

静态方法