Web 中的输入
Unity Web 支持的各种输入类型。
阅读时间11 分钟最后更新于 5 天前
Unity Web 支持来自不同 Devices 的各种类型的输入,包括游戏手柄、游戏杆、触摸屏、键盘和运动传感器。
游戏手柄和游戏杆Support持
Web 支持游戏手柄的以下输入:
Web 还支持支持 HTML5 Gamepad API 的浏览器的游戏杆。
某些浏览器仅在用户在应用程序程序获得焦点时与设备交互后,才允许访问输入Devices。此类型的 SECURITY 措施会阻止用户使用连接的 Devices 进行浏览器指纹识别。因此,在调用 input.GetJoystickNames() 检查连接的 Devices 之前,请确保应用程序指示用户按下其游戏手柄/操作杆上的按钮。
映射控制器
旧 Input System 的 Web 游戏控制器 Mapping 与 W3 规范保持一致,其中的按钮 Mapping Layout 布局如下:
按钮 | 描述 |
|---|---|
| 按钮 | 右集群中的底部按钮 = Cross (X) |
| 按钮 | 右集群中的右按钮 = Circle |
| 按钮 | 右集群中的左按钮 = SQUARE |
| 按钮 | 右集群中的顶部按钮 = TRIANGLE |
触控Support
Unity Web 在具有 touch Support 的浏览器和 Devices 中实现 input.touches 和其他相关 API。默认情况下下,移动端Devices会ON触摸屏幕显示软键盘,让用户在 UI 输入字段中进入文本。要禁用此行为,请使用 WebGLInput.mobileKeyboardSupport 属性。
键盘输入和焦点处理
默认情况下下,无论 Web 画布具有焦点,Unity Web 都会处理Page接收的All键盘输入。这允许用户使用基于键盘的应用程序,而无需单击 ON 网络画布。
以下注意事项Apply于如下所述的指定的键盘输入:
键盘输入行为 | 描述 |
|---|---|
| HTML 元素(例如文本字段) | 如果在用于接收键盘输入的Page中引入 HTML 元素(例如文本字段),可能会导致错误。Unity 在Page的REST部分可以接收输入事件之前消耗这些事件。 要使 HTML 元素接收键盘输入,请将 |
| Esc Key | 某些浏览器(如 Safari)代码块无法使用 Esc Key 切换到全屏模式,因为 Esc Key 在 Web Environment 中受到保护。Other浏览器(如 Google Chrome)的行为可能不可预测。当浏览器处于全屏模式时,用户只能使用 Esc Key 退出全屏模式。根据浏览器的类型,单击 Esc Key 可能并不总是触发从浏览器正向到应用程序的事件。 |
| TextMeshPro(也称为 TMP)输入字段中的 |
移动传感器Support
对于Support触控的浏览器和移动端Devices,Unity Web 包括对以下传感器的Support:
- 带有 input.Acceleration 的加速度计
- 使用 Gyroscope.userAcceleration 的 LinearAcceleration
- 具有 Gyroscope.rotationRate 的陀螺仪
- 重力与 Gyroscope.重力
- 使用 Gyroscope.attitude 时的态度
- Input System 包还支持这些传感器。
光标锁定Support
Unity Web 平台支持使用 HTML5 API 的光标锁定。使用光标锁定可将鼠标光标锁定到游戏窗口的中心。锁定光标When,光标在 Unity 中显示为隐藏状态,在鼠标移动When不会Move。这对于第一人称游戏特别有用,在此类游戏中,鼠标光标通常用于ControlPlayer角度的方向。
Element.requestPointerLock激活光标锁定
要锁定光标,请使用 属性。例如,当用户单击鼠标左键时,以下代码将光标切换到锁定状态:
Cursor.lockStatevoid Update(){ if (Input.GetMouseButtonDown(0)) { Cursor.lockState = CursorLockMode.Locked; }}
光标锁定需要通过用户交互激活。有关更多信息,请参阅全屏模式和光标锁定的其他注意事项。
停用光标锁定
按 Esc Key 可解锁光标。
粘性光标锁定
stickyCursorLock使用 可确保状态持久,即使浏览器从 Unity 画布释放光标锁定(通常使用 Esc Key),在这种情况下,光标在画布获得焦点的 Next 时间再次锁定。
stickyCursorLockCursor.lockState因此,如果将 设置为 ,即使 Unity 画布 HTML 元件解锁光标, 也会保持状态。
WebGLInput._stickyCursorLocktrueCursor.lockStateCursorLockMode.Locked如果将 设置为 ,则会发生以下情况:
WebGLInput._stickyCursorLockfalse-
与浏览器的光标锁定状态保持同步。
Cursor.lockState -
如果用户按 Esc Key 取消画布光标锁定,则将更改为
Cursor.lockState。CursorLockMode.None
全屏模式
在游戏中使用全模式式可以执行以下操作:
-
将整个屏幕使用于游戏。
-
隐藏浏览器用户界面 UI 元素,例如地址栏和选项卡。
-
隐藏 Unity Player UI 元素,例如Title栏和工具栏栏。
Unity Web 平台支持使用 HTML5 API 的全屏模式。
Element.requestFullscreen在 Web 中激活全模式式
要启用全屏模式,请使用 属性。例如,当用户按 F Key 时,以下代码将游戏切换到全屏模式:
Screen.fullScreenvoid Update(){ if (Input.GetKeyDown(KeyCode.F)) { Screen.fullScreen = true; }}
全屏模式需要通过用户交互激活。有关更多信息,请参阅全屏模式和光标锁定的其他注意事项。
退出全模式式
要退出全屏模式,请再次按 Esc Key,或将鼠标指针悬停在屏幕顶部以访问地址栏和选项卡。
全模式式和光标锁定的其他注意事项
出于安全考虑,浏览器只允许在用户发起的事件(例如鼠标单击或 Key 按下)之后锁定光标并启用全屏模式。
由于 Unity 不Support单独的事件和渲染循环,因此它会将事件处理推迟到浏览器不再确认 Unity 脚本发出的屏幕或光标锁定请求作为对触发事件的直接响应。
因此,Unity 会在下一个用户发起的事件触发请求,而不是触发光标锁定或全屏请求的事件。
要Enable光标锁定或全屏幕式以获得更好的结果,请使用鼠标/Key按下事件而不是鼠标/Key向上事件来触触发器应。这样就可以确保延迟请求由相应的鼠标/Key up 事件触发(如果不是由用户先前发起的事件触发)。