---
title: ZEPETO角色控制器
slug: world-sdk-guide-ch/lXJO-zepeto
docTags:
createdAt: 2024-09-02T08:34:13.135Z
---
ZEPETO角色控制器提供了诸如移动和相机控制等功能，用于加载到场景中的ZEPETO角色。
要利用角色控制器，必须编写ZEPETO角色创建脚本，然后将角色加载到场景中。
:::hint{type="info"}
- 请参考以下指南。 \[[创建一个Zepeto角色](docId\:x_uqceZxzv-RaMS18k0bt)]
:::
鉴于角色控制器具有与PC和移动输入兼容的预定义角色控制键映射，任何加载的角色都可以在场景中立即操控，无论平台如何。
在PC环境中，可以通过键盘和鼠标控制角色和相机。相反，在移动环境中，可以通过虚拟控制器进行角色和相机操作，如下图所示。您可以灵活修改角色控制器的默认设置。
::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-y0aKHnHVTa5amO5WZ3de2-20240904-102411.png" size="48" width="468" height="823" position="center" caption="移动设备屏幕（竖屏模式）" showCaption="true"}
::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-od7_ixpuD1cQLWp82T6te-20240904-102411.png" size="74" width="1237" height="697" position="center" caption="移动设备屏幕（横屏模式）" showCaption="true"}
:::hint{type="success"}
**👍 以下输入接口支持角色控制：**
**PC**
- 移动：键盘箭头，WASD
- 跳跃：空格键
- 双重跳跃：（左）Shift键
- 缩放：鼠标滚轮
- 旋转：屏幕拖动
**移动设备**
- 移动：（左下角屏幕）虚拟摇杆
- 跳跃：（右下角屏幕）虚拟按钮
- 缩放：（两根手指）屏幕拖动
- 旋转：（一根手指）屏幕拖动
:::
您可以灵活修改CharacterController的默认设置。
通过在层级窗口中选择创建的ZepetoPlayers对象，检查器允许您查看和调整每个参数的应用控制器设置。
ZEPETO相机旨在创建时聚焦于LocalPlayer的上半部分，并在相机/角色移动期间持续跟随。
让我们深入了解每个项目的细节：
## 相机
| **参数名称** | **描述** |
| ---------- | ----------------------------- |
| 预制件 | 这跟踪本地玩家。 |
| 视角偏移 | 相机聚焦的标准位置（基于角色头部） |
| 缩放（最大） | 缩放最大范围 |
| 缩放（最小） | 缩放最小范围 |
| 缩放速度（基础速度） | 缩放进出速度（用于输入值） |
| 缩放速度（阻尼速度） | 缩放进出速度插值值（用于DeltaTime） |
| 旋转（最大角度） | （垂直 + 方向）旋转限制范围 |
| 旋转（最小角度） | （垂直 - 方向）旋转限制范围 |
| 旋转（锁定X轴） | （垂直方向）是否锁定旋转 |
| 旋转速度（基础） | 旋转速度（用于输入值） |
| 旋转速度（阻尼） | 旋转速度插值值（用于DeltaTime） |
| 碰撞层 | 相机碰撞应用的层。
- 设置为玩家层的层不适用。 |
| 使用角色剔除 | 当选中时，当相机与角色碰撞时应用角色剔除。 |
## 角色
| **参数名称** | **描述** |
| -------- | --------------------------------------------------------------------------------- |
| 坡度限制 | 角色可以攀爬的最陡坡度。 |
| 步幅偏移 | 角色可以克服的最高障碍。 |
| 最小移动距离 | 定义角色可以移动的最小间隙。 |
| 阴影 | 角色阴影的视觉表现。 |
| 动画控制器 | 角色的动画控制器。 |
| 行走速度 | 行走输入事件的移动速度。 |
| 奔跑速度 | 奔跑输入事件的移动速度。 |
| 跳跃力量 | 跳跃输入事件的跳跃高度。 |
| 行走/奔跑阈值 | 应用的行走/奔跑参考值（0-1），用于移动输入
- 奔跑阈值：用于切换到行走→奔跑动作的参考值
- 行走阈值：施加行走动作加速度的最大参考值 |
| 双重跳跃 | 如果选中，则允许双重跳跃。
- 如果双重跳跃条件被选中，双重跳跃的默认输入为左Shift。 |
| 移动转向 | 如果选中，则允许移动转向。
- 启用时，角色的瞬时（0.1秒间隔）旋转角度大于90度。 |
| 着陆 | 如果选中，则允许着陆。
- 切换可见的着陆状态，当ZEPETO角色从高度着陆时。
- 如果您希望在跌落后立即移动，请将使用着陆选项设置为关闭。 |
| 着陆翻滚 | 如果选中，则允许着陆翻滚。
- 如果着陆翻滚条件被选中，角色将在垂直速度超过18单位时翻滚。着陆时，如果有水平输入，将触发着陆翻滚动作。 |
某些参数与Unity的角色控制器组件设置对齐。为了进一步澄清，请参考链接的文档。
:::hint{type="info"}
**📘 Unity 角色控制器**
[https://docs.unity3d.com/2020.3/Documentation/ScriptReference/CharacterController.html](https://docs.unity3d.com/2020.3/Documentation/ScriptReference/CharacterController.html)
:::
如果您希望在运行时以编程方式操作角色控制器属性，请查阅API文档。
:::hint{type="info"}
- 请参考以下指南。 \[[ZEPETO.Character.Controller API](https://developer.zepeto.me/docs/character-controller/)]
:::
## 控制
| **参数名称** | **描述** |
| ------------ | --------------------------------------- |
| 事件系统 | 事件系统处理用户输入并将其传达给UI组件。它处理按钮点击、拖动、放置等交互。 |
| 使用默认输入资产 | 使用默认输入资产切换
- 如果未选中，通过键盘进行操作将变得不可能。 |
| 使用默认V-Pad控制器 | V-Pad使用切换
- 取消选中将使V-Pad控制不可访问。 |
| 垂直控制器 | 用于垂直屏幕方向的V-pad控制器预制件。 |
| 水平控制器 | 用于水平屏幕方向的V-pad控制器预制件。 |
## 浮动用户界面 (OnApp)
在应用中玩时，您可以选择是否显示与角色相关的用户界面。
| 参数名称 | 描述 |
| ---------- | -------------------- |
| 迷你资料 | 点击角色时，是否显示迷你资料弹出用户界面 |
| 昵称 (我) | 是否显示我的角色昵称用户界面 |
| 昵称 (其他人) | 是否显示其他角色的昵称用户界面 |
| 气泡聊天 (我) | 是否显示我的角色的气泡聊天用户界面 |
| 气泡聊天 (其他人) | 是否显示其他角色的气泡聊天用户界面 |