【Unity InputSystem】实用指南:在PC端(鼠标与键盘)、手机端(触摸屏)、主机手柄上同步实现角色移动与跳跃功能

前引

随着Unity的不断发展,开发者对于项目的输入系统要求也日益提高。在进行多平台适配和跨平台移植时,常常需要改变输入系统,这给开发者带来了不少困扰。而Unity官方推出的InputSystem插件,则是为了解决这一问题而推出的全新输入方式。

相较于旧版的InputManager,InputSystem的操作虽然更为繁琐复杂,但在应对跨平台项目时,面对不同的输入方式,InputSystem的输入映射机制为开发者提供了巨大的便利。因此,学习InputSystem成为必要之举。


正文

PC端-键鼠🐀

创建PC对应的键鼠InputActions

在安装好InputSystem之后我们先在项目中创建InputActions,如下所示:


创建InputActions成功后双击打开InputActions编辑页面,创建一个ActionMaps命名为PC,之后再创建Map中对应的几个Actions分别命名为Move,CameraControl,Jump:


Move,CameraControl的Action Type选择Value, Control Type为返回值类型选择Vector2:


在MoveAction的输入绑定中我们需要进行以下操作 选择方向键混合绑定:


之后在每个方向检测上绑定对应的输入检测方式,每次变更完InputAction后记得点击Save Asset保存(或者勾选右侧的Auto Save自动保存):

创建好的InputActions后,我们可以在InputActions属性面板中找到Generate C# Class并勾选,随后点击Apply生成对应的脚本,之后我们就可以在我们自己写的PlayerController 类中调用该脚本了:

万事俱备,只欠代码!


PC脚本调用初始化

初始化:

cs 复制代码
using UnityEngine;
using UnityEngine.InputSystem;

public class RPGController : MonoBehaviour
{
    public RPGInputActions rpgInputActions;
    private void Awake() {
        //实例化我们刚刚生成的rpgInputActions脚本
        rpgInputActions = new RPGInputActions();
    }
    void OnEnable()
    {
        //使用前需要将该rpgInputActions开启
        rpgInputActions.PC.Enable();
    }
    void OnDisable()
    {
        //使用完需要将该rpgInputActions关闭
        rpgInputActions.PC.Disable();
    }
    //Update生命周期函数
    private void Update() {
    }
}

PC获取Move Action输入:

cs 复制代码
    //将获取Move输入方法写在Update方法中逐帧调用
    private void Update() {
        getMoveInput();
    }
    //获取Move输入方法
    private void getMoveInput(){
        //将读取到的Move返回值赋值给moveVector2 
        Vector2 moveVector2 = rpgInputActions.PC.Move.ReadValue<Vector2>();
        //判断是否有按下对应的Move按键
        if (moveVector2  != Vector2.zero) {
            //将获取到的返回值打印出来
            Debug.Log(moveVector2);
        }
    }

PC获取Jump Action输入:

cs 复制代码
    //将获取Jump输入方法写在Update方法中逐帧调用
    private void Update() {
        getJumpInput();
    }
    //获取Jump输入方法
    private void getJumpInput(){
        //将读取到的Jump返回值赋值给isJump 
        bool isJump = rpgInputActions.PC.Jump.IsPressed();
        //判断是否有按下对应的Jump按键
        if (isJump) {
            //将获取到的返回值打印出来
            Debug.Log(isJump);
        }
    }

PC获取CameraControl Action输入:

cs 复制代码
    //将获取CameraControl输入方法写在Update方法中逐帧调用
    private void Update() {
        getCameraControlInput();
    }
    //获取CameraControl输入方法
    private void getCameraControlInput(){
        //将读取到的CameraControl返回值赋值给cameraOffset 
        Vector2 cameraOffset = rpgInputActions.PC.CameraControl.ReadValue<Vector2>();
        //判断是否有鼠标是否有产生偏移
        if (cameraOffset != Vector2.zero) {
            //将获取到的鼠标偏移值打印出来
            Debug.Log(cameraOffset );
        }
    }

将我们上面写好的脚本挂载到对应的游戏对象上,点击开始在项目运行时我们就可以通过刚刚绑定在Action上的按键触发我们写好的输入检测获取方法啦:


功能实现

既然我们可以获取到不同硬件设备的输入检测时,我们接下来就要将检测到的输入信号和我们实际的执行方法关联在一起,实现我们项目中的具体功能。我们具体功能的实现会以PC端鼠键输入检测为例。

键盘控制角色移动

根据上述PC端键鼠检测的操作,我们可以通过键盘的WASD或者小键盘的方向键获取到一个类型为Vector2的返回值。接下来我们将该方法进行一个小改动实现角色移动的功能:

cs 复制代码
public class RPGController : MonoBehaviour
{
    public RPGInputActions rpgInputActions;
    //声明一个移动速度属性初始值可以自行安排,我这里给个2
    private float moveSpeed = 2f;
    private void Update() {
        getMoveInput();
    }
    private void getMoveInput(){
        //将读取到的Move返回值赋值给moveVector2 
        Vector2 moveVector2 = rpgInputActions.PC.Move.ReadValue<Vector2>();
        //因为我们的playerMove会在Update生命周期函数中逐帧执行,所以在执行前需要判断是否有按下对应的按键
        if (moveVector2 != Vector2.zero) {
            //使用获取到的Vector2.x和Vector2.y返回值作为角色移动的参数
            playerMove(moveVector2.x,moveVector2.y);
        }
    }  
    //使角色真正移动的方法
    private void playerMove(float horizontal,float vertical){
        transform.Translate(new Vector3(horizontal,0,vertical)*Time.deltaTime*moveSpeed,Space.World);
    } 
}

来一点小小的优化让代码更加简洁:

cs 复制代码
public class RPGController : MonoBehaviour
{
    public RPGInputActions rpgInputActions;
    //声明一个移动速度属性初始值可以自行安排,我这里给个2
    private float moveSpeed = 2f;
    //表达式用于初始化moveAxis获取rpgInputActions.PC.Move的返回值赋值给moveAxis
    private Vector2 moveAxis => rpgInputActions.PC.Move.ReadValue<Vector2>();
    private void Update() {
        getMoveInput();
    }
    private void getMoveInput(){
        //因为我们的playerMove会在Update生命周期函数中逐帧执行,所以在执行前需要判断是否有按下对应的按键
        if (moveAxis!= Vector2.zero) {
            //使用获取到的Vector2.x和Vector2.y返回值作为角色移动的参数
            playerMove(moveVector2.x,moveVector2.y);
        }
    } 
    //使角色真正移动的方法
    private void playerMove(float horizontal,float vertical){
        transform.Translate(new Vector3(horizontal,0,vertical)*Time.deltaTime*moveSpeed,Space.World);
    } 
}
键盘控制角色跳跃

在我们通过键盘的空格键获取到一个类型为bool的返回值。接下来我们就使用该返回值实现角色跳跃的功能:

cs 复制代码
public class RPGController : MonoBehaviour
{
    public RPGInputActions rpgInputActions;
    //获取对象刚体用于实现跳跃功能时给其施加一个向上的力
    public Rigidbody playerRigidbody;
    //表达式用于初始化isJump 获取rpgInputActions.PC.Jump是否有按下赋值给cameraOffset 
    private bool isJump => rpgInputActions.PC.Jump.IsPressed();
    private void Update() {
        getJumpInput();
    }
    private void getJumpInput(){
        if (isJump) {
            //判断Jump输入设备被按下时给执行跳跃方法
            playerJump();
        }
    }
    //给刚体施加一个向上的力使角色模拟跳跃的效果
    public void playerJump(){
        playerRigidbody.AddForce(Vector3.up * 5);
    }
}
鼠标控制视角转动

在我们通过鼠标偏移获取到一个类型为Vector2的返回值。接下来我们就使用该返回值实现控制镜头的功能:

cs 复制代码
public class RPGController : MonoBehaviour
{
    public RPGInputActions rpgInputActions;
    //获取围绕旋转对象的Transform 
    public Transform targetFollowTransform;
    //获取需要控制旋转的相机Transform 
    public Transform cameraTransform;
    //表达式用于初始化moveAxis获取rpgInputActions.PC.CameraControl的返回值赋值给cameraOffset 
    private Vector2 cameraOffset => rpgInputActions.PC.CameraControl.ReadValue<Vector2>();
    private void Update() {
        getCameraControlInput();
    }
    private void getCameraControlInput(){
        {
            //判断获取cameraControl的输入设备是否触发偏移值
            if(cameraOffset != Vector2.zero){
                //控制相机以targetFollowTransform对象为中心围绕世界坐标垂直轴进行水平旋转,旋转角度为cameraOffset水平方向返回的偏移值
                cameraTransform.RotateAround(targetFollowTransform.position, Vector3.up, cameraOffset.x);
                //控制相机以targetFollowTransform对象围绕相机自身水平轴进行垂直旋转,旋转角度为cameraOffset垂直方向返回的偏移值
                cameraTransform.RotateAround(targetFollowTransform.position, cameraTransform.right, -cameraOffset.y);
            }
        }
    } 
}

主机端-手柄🎮

创建主机对应的手柄InputActions

绑定MoveAction的触发操作

柄控制MoveAction的输入绑定中我们需要进行以下操作 选择普通的绑定即可:

绑定操作设备选择手柄Gamepad:

因为我们Move动作选择的返回值类型为Vector2所以手柄这里默认的触发行为默认的有三个D-Pad坐标方向键, Left Stick左摇杆, Right Stick右摇杆)根据我们喜好选择Gamepad上的触发操作(一般是选择左摇杆来控制移动):

绑定JumpAction的触发操作

在手柄控制JumpAction的输入绑定中前两步的选择都是一样

1.在JumpAction上点击+号选择普通的绑定即可

2.绑定操作设备选择手柄Gamepad

3.选择右边方向键的西边按键(因为不同厂商的右边方向键显示不同,所以用东南西北方向来表示):

绑定CameraControlAction的触发操作

在手柄控制CameraControlAction的输入绑定中前两步的选择都是一样

1.在CameraControlAction上点击+号选择普通的绑定即可

2.绑定操作设备选择手柄Gamepad

3.选择右摇杆(也可以根据自己喜欢选择其他触发操作):

功能实现

在手柄上的功能实现因为我们用的都是同一套的InputAction,所以我们只需要完成上述绑定手柄的对应Actions触发即可。 这里因为我们在PC端键鼠小节的时候已经把对应的脚本写好了,这里我们就不需要重新再写脚本了(这就是InputSystem区别于旧版InputManager最大的优势无需重新写代码)点击开始在项目运行时我们就可以通过刚刚绑定在Action上的按键触发我们写好的输入检测获取方法了。

移动端-触摸屏触摸屏📱

我们要获取移动端触摸屏输入检测的话可以通过两种方式 在获取之前我们需要做几个对应的准备工作:

PC鼠标模拟触控

使用PC上鼠标模拟触摸屏上点击实现模拟触控(仅能模拟单指触控)

我们需要点击Window=>Analysis =>Input Debugger:


打开Debugger视窗之后点击左上角的Options选择Simulate Touch Input:

添加新输入设备检测后可以看到输入设备栏中从原本只有鼠键两种检测新增多了一个模拟触摸屏,这就代表成功了。


功能实现

触摸屏控制角色移动

在我们的上述章节当中其实已经实现了PC端和主机端物体移动,接下来我们完成以下几步即可实现移动端触摸屏的物体移动功能。

将虚拟摇杆中获取到的Vector2返回值作为参数赋值到我们移动方法:

cs 复制代码
public class RPGController : MonoBehaviour
{
    public Joystick moveJoystick;
    private float moveSpeed = 2f;
    //Update生命周期函数
    private void Update() {
        getTouchScreenMove();
    }
    private void getTouchScreenMove(){
        //使用获取到的虚拟摇杆Joystick的Horizontal和Vertical返回值作为角色移动的参数
        playerMove(moveJoystick.Horizontal,moveJoystick.Vertical);
    }
    //使角色真正移动的方法
    private void playerMove(float horizontal,float vertical){
        transform.Translate(new Vector3(horizontal,0,vertical)*Time.deltaTime*moveSpeed,Space.World);
    }
}

将刚刚写的公共JoyStick变量进行绑定 3.完成上述两步,我们移动端的触摸屏虚拟摇杆触发物体移动功能就完成了:

触摸屏控制角色跳跃

1.找到我们的JumpButton组件

2.在Button的属性面板上面找到OnClick绑定

3.将挂载了我们已经写好了功能实现脚本的对象拖动挂载到OnClick上面

4.找到写好的跳跃方法进行绑定

触摸屏控制视角转动

在触摸屏上上述两种功能实现因为是用到了虚拟按钮没有使用到InputAction的触发绑定,所以需要完成以上两个小节才可以实现对应的具体功能。 但在视角旋转上面的触发操作我们是绑定了InputAction的,所以我们和前文手柄的功能实现一样无需做额外的操作即可实现对应的视角转动功能。

完成上述脚本编写和绑定CameraControl在触摸屏上触摸为触发操作以触发两帧之间的偏移值为返回值。那么我们在触摸屏上进行滑动触摸便可以进行视角的转动。

触摸屏触控操作优化

由于我们是在触摸屏上进行操作触发,上述流程虽然可以完成单独的功能实现,但在进行多点触控时可能会出现触发误判或冲突(例如,物体移动和视角转动功能之间存在冲突)。尽管移动功能是通过虚拟摇杆触发的,但同时触摸屏幕也可能触发视角转动功能。因此,我们需要对脚本进行升级,以区分触发的功能。

cs 复制代码
using UnityEngine.InputSystem;//引用InputSystem包
public class RPGController : MonoBehaviour
{
    public Joystick moveJoystick;
    private float moveSpeed = 2f;
    public GameInputActions gameInputActions;
    public Transform targetFollowTransform;
    public Transform cameraTransform;
    //Update生命周期函数
    private void Update() {
        getTouchScreenMove();
    }
    private void getTouchScreenMove(){
        //使用获取到的虚拟摇杆Joystick的Horizontal和Vertical返回值作为角色移动的参数
        playerMove(moveJoystick.Horizontal,moveJoystick.Vertical);
    }
    //使角色真正移动的方法
    private void playerMove(float horizontal,float vertical){
        transform.Translate(new Vector3(horizontal,0,vertical)*Time.deltaTime*moveSpeed,Space.World);
    }
    //获取CameraControl输入方法
    private void getCameraControlInput(){
        //将读取到的CameraControl返回值赋值给cameraOffset 
        Vector2 cameraOffset = gameInputActions.PC.CameraControl.ReadValue<Vector2>();
        //判断是否有鼠标是否有产生偏移
        if (cameraOffset != Vector2.zero) {
        //     //将获取到的鼠标偏移值打印出来
            cameraTransform.RotateAround(targetFollowTransform.position, Vector3.up, cameraOffset.x);
            cameraTransform.RotateAround(targetFollowTransform.position, cameraTransform.right, -cameraOffset.y);
        }
    }
    //将物体移动方法和视角转动方法都放到该方法内进行统一判定
    private void touchControl(){
        //因为在触摸屏上有多点触发的可能性,因此我们需要获取到每个触发点的顺序
        for(int i=0;i<Input.touchCount;i++){
            //按照触发点的顺序来获取在屏幕上的对应位置进行功能判定
            Vector3 touchPos= Input.GetTouch(i).position;
            //如果触发点在屏幕左半屏即为移动功能触发,我们执行移动方法即可
            if(touchPos.x < Screen.width / 2){
                getTouchScreenMove();
            }
            //如果触发点在屏幕右半屏即为视角转动功能触发,我们执行视角转动方法即可
            if(touchPos.x > Screen.width / 2 && touchPos.y > Screen.height / 2){
                getCameraControlInput();
            }
        }
    }
}

在脚本进行了优化之后我们触摸屏就可以实现左右半屏单点触发对应的功能。

总结

以上就是我们InputSystem在不同设备上的一些实用技巧分享,另外还有更多详细实用的Unity教程系列在我的**"YF的Unity世界"**频道,欢迎大家一起来学习交流!

相关推荐
終不似少年遊*1 小时前
pyecharts
python·信息可视化·数据分析·学习笔记·pyecharts·使用技巧
异次元的归来10 小时前
Unity DOTS中的share component
unity·游戏引擎
向宇it13 小时前
【从零开始入门unity游戏开发之——C#篇25】C#面向对象动态多态——virtual、override 和 base 关键字、抽象类和抽象方法
java·开发语言·unity·c#·游戏引擎
_oP_i14 小时前
unity webgl部署到iis报错
unity
Go_Accepted14 小时前
Unity全局雾效
unity
向宇it14 小时前
【从零开始入门unity游戏开发之——C#篇24】C#面向对象继承——万物之父(object)、装箱和拆箱、sealed 密封类
java·开发语言·unity·c#·游戏引擎
每日出拳老爷子17 小时前
【图形渲染】【Unity Shader】【Nvidia CG】有用的参考资料链接
unity·游戏引擎·图形渲染
边缘计算社区18 小时前
吉快科技荣膺“金边奖·最佳大模型一体机”,引领AI边缘新时代
人工智能·科技
因_果_律18 小时前
亚马逊云科技 re:Invent 2024重磅发布!Amazon Bedrock Data Automation 预览版震撼登场
大数据·人工智能·科技·亚马逊云科技·re invent
北海651618 小时前
Dots 常用操作
unity