186 lines
6.8 KiB
Markdown
186 lines
6.8 KiB
Markdown
---
|
||
title: StudyCase1
|
||
date: 2025-11-26 15:35
|
||
tags: [studycase, unity]
|
||
pinned: true
|
||
head:
|
||
- - meta
|
||
- name: description
|
||
content: vitepress-theme-bluearchive StudyCase1
|
||
- - meta
|
||
- name: keywords
|
||
content: vitepress theme bluearchive StudyCase1
|
||
---
|
||
|
||
# 角色控制器
|
||
- [世界构筑的起始篇章-编辑器](#1世界构筑的起始篇章-编辑器)
|
||
- [光芒汇聚之所-章节目标](#2光芒汇聚之所-章节目标)
|
||
- [光流影卷-演示视频](#3光流影卷-演示视频)
|
||
- [初始祭坛-前置准备](#4初始祭坛-前置准备)
|
||
- [勇者行迹录-章节任务](#5勇者行迹录-章节任务)
|
||
- [异闻录-FAQ](#6异闻录-faq)
|
||
|
||
## 1.世界构筑的起始篇章-编辑器
|
||
- **Unity 2022.3.62f2**：
|
||
- **Visual Studio 2022**
|
||
|
||
## 2.光芒汇聚之所-章节目标
|
||
- **鼠标控制视角旋转**
|
||
- **WASD控制模型移动**
|
||
- **空格控制跳跃**
|
||
|
||
## 3.光流影卷-演示视频
|
||
<video id="vdMain" controls muted poster="/video/studycase1/演示视频.png" playsinline>
|
||
<source id="vSource" src="/video/studycase1/演示视频.mp4" type="video/mp4" />
|
||
</video>
|
||
|
||
## 4.初始祭坛-前置准备
|
||
### 新建项目
|
||
- 创建URP项目
|
||
|
||
<img src="/image/studycase1/创建URP项目.png" data-fancybox="gallery"/>
|
||
|
||
- 移除Readme
|
||
|
||
<img src="/image/studycase1/移除Readme.png" data-fancybox="gallery"/>
|
||
|
||
- 新建场景或者修改初始场景为StudyCase1
|
||
|
||
<img src="/image/studycase1/创建StudyCase1场景.png" data-fancybox="gallery"/>
|
||
|
||
### 安装 Input System 与 Cinemachine
|
||
- 打开 Package Manager
|
||
|
||
<img src="/image/studycase1/打开PackageManager.png" data-fancybox="gallery"/>
|
||
|
||
- 切换到 Unity Registry
|
||
|
||
<img src="/image/studycase1/切换到UnityRegistry.png" data-fancybox="gallery"/>
|
||
|
||
- 安装 `Input System` 与 `Cinemachine`
|
||
|
||
<img src="/image/studycase1/安装俩个包.png" data-fancybox="gallery"/>
|
||
|
||
- 导入示例
|
||
|
||
<img src="/image/studycase1/导入示例.png" data-fancybox="gallery"/>
|
||
|
||
- 创建初始场景(StudyCase1)
|
||
|
||
<img src="/image/studycase1/创建初始场景.png" data-fancybox="gallery"/>
|
||
|
||
- 从示例项目导入模型到场景
|
||
|
||
<img src="/image/studycase1/从示例项目导入模型到场景.png" data-fancybox="gallery"/>
|
||
|
||
> 提示：安装 Input System 后，Unity 会提示重启并切换至新输入系统，务必确认。
|
||
|
||
## 5.勇者行迹录-章节任务
|
||
### 添加虚拟相机根节点
|
||
- 为相机添加 `CinemachineBrain`作为根节点以便统一控制
|
||
|
||
<img src="/image/studycase1/添加虚拟相机根节点.png" data-fancybox="gallery"/>
|
||
|
||
### 创建玩家节点
|
||
- 创建 `Player` 空节点，创建`Forward`和`Model`空节点并作为`Player`子节点以及虚拟相机
|
||
- 注意`Forward`和`Model`的尽量不要有偏移
|
||
|
||
<img src="/image/studycase1/创建玩家层级.png" data-fancybox="gallery"/>
|
||
|
||
- 创建胶囊体和正方体作为`Model`的子物体，可以去掉碰撞器，尽量不要有偏移
|
||
|
||
<img src="/image/studycase1/玩家节点.png" data-fancybox="gallery"/>
|
||
|
||
### 配置虚拟相机
|
||
- 将虚拟相机 `Follow`、`LookAt` 指向玩家模型，调整 Body/ Aim，使镜头保持第三人称视角
|
||
|
||
<img src="/image/studycase1/配置虚拟相机.png" data-fancybox="gallery"/>
|
||
|
||
### 创建 InputActions
|
||
- 创建`Resources`文件夹，右键 `Create > Input Actions`,，命名为 `PlayerInputActions`
|
||
|
||
<img src="/image/studycase1/创建InputActions.png" data-fancybox="gallery"/>
|
||
|
||
- 创建 `Player` Action Map，添加 `Move`（Vector2）与 `Jump`（Button）
|
||
|
||
<img src="/image/studycase1/创建playerinputactions.png" data-fancybox="gallery"/>
|
||
|
||
- Move 绑定 `WASD` ；Jump 绑定 `space`
|
||
|
||
<img src="/image/studycase1/创建4向绑定.png" data-fancybox="gallery"/>
|
||
<img src="/image/studycase1/绑定wasd.png" data-fancybox="gallery"/>
|
||
|
||
### 编写脚本`ThirdCharacterController.cs`
|
||
- 在 `Assets\Scripts\StudyCase1` 下创建脚本 `ThirdCharacterController`
|
||
```csharp
|
||
using UnityEngine;
|
||
using UnityEngine.InputSystem;
|
||
|
||
namespace StudyCase1
|
||
{
|
||
public class ThirdCharacterController : MonoBehaviour
|
||
{
|
||
public CharacterController characterController;
|
||
public Transform forward;
|
||
public Transform model;
|
||
public Cinemachine.CinemachineVirtualCamera vCam;
|
||
public float moveSpeed = 5f;
|
||
public float jumpSpeed = 2f;
|
||
public float turnSpeed = 10f;
|
||
public float gravity = 10f;
|
||
Vector3 moveDir;
|
||
Vector2 moveInput;
|
||
private void Update()
|
||
{
|
||
moveDir = new Vector3(moveInput.x, moveDir.y, moveInput.y);
|
||
forward.eulerAngles = new Vector3(0, vCam.transform.eulerAngles.y, 0);
|
||
moveDir = forward.TransformDirection(moveDir);
|
||
if (moveInput != Vector2.zero)
|
||
{
|
||
Quaternion target = Quaternion.LookRotation(new Vector3(moveDir.x, 0, moveDir.z));
|
||
model.rotation = Quaternion.Slerp(model.rotation, target, turnSpeed * Time.deltaTime);
|
||
}
|
||
if (!characterController.isGrounded)
|
||
moveDir.y -= gravity * Time.deltaTime;
|
||
characterController.Move(moveDir * moveSpeed * Time.deltaTime);
|
||
}
|
||
public void OnMove(InputAction.CallbackContext context)
|
||
{
|
||
if (characterController.isGrounded)
|
||
moveInput = context.ReadValue<Vector2>();
|
||
else moveInput = Vector2.zero;
|
||
}
|
||
public void OnJump(InputAction.CallbackContext context)
|
||
{
|
||
if (context.performed && characterController.isGrounded)
|
||
{
|
||
moveDir.y = jumpSpeed;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 代码讲解
|
||
- **namespace StudyCase1**:因为可能出现同名文件
|
||
- **forward**：作为“参照物”同步虚拟相机的 Y 轴旋转，用来转换输入的坐标轴。
|
||
- **moveDir**：在本地坐标系下计算移动向量，并通过 `CharacterController.Move` 驱动。
|
||
- **OnMove/OnJump**：直接使用 Input System 回调，确保只有在贴地时才写入输入，避免空中漂移。
|
||
- **旋转插值**：`Quaternion.Slerp` 让角色转身更加顺滑，可根据手感微调 `turnSpeed`。
|
||
|
||
### Player节点设置
|
||
- 挂载`ThirdCharacterController`
|
||
|
||
<img src="/image/studycase1/挂载ThirdCharacterController.png" data-fancybox="gallery"/>
|
||
|
||
- 添加组件`PlayerInput`
|
||
|
||
<img src="/image/studycase1/添加组件PlayerInput.png" data-fancybox="gallery"/>
|
||
|
||
## 6.异闻录-FAQ
|
||
- **角色不动**：确认 `CharacterController` 已赋值且 `Move` Action Map 激活。
|
||
- **镜头不同步**：检查 `forward` 对象是否正确引用虚拟相机的朝向，检查模型和`player`是否偏移过大。
|
||
- **跳跃失效**：确认 `Jump` 绑定的动作类型为 `Button`，确认角色是否在地上。
|
||
- **移动时会旋转镜头**：确认虚拟相机是在 `Player` 节点下，不是在 `Model` 节点下。
|
||
|
||
完成以上步骤，即可得到一个可拓展的第三人称基础模板。[项目地址](http://home.gtuantuan.online:8300/TuanTuan/StudyCase) |