文档

Unity 引擎

Unity 引擎

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
注意
由于 Web 遵循 W3 规范,因此与Other平台可能不一致,如果您同时Target向多个个平台(例如 Windows 和 Web),则需要不同的方法。如需了解更多信息,请参阅有关重新映射的 W3 文档。

触控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 元素接收键盘输入,请将
WebGLInput.captureAllKeyboardInput
设置为
false
。这样,仅当 Web 画布获得焦点时,应用程序才会接收输入。
Esc Key某些浏览器(如 Safari)代码块无法使用 Esc Key 切换到全屏模式,因为 Esc Key 在 Web Environment 中受到保护。Other浏览器(如 Google Chrome)的行为可能不可预测。当浏览器处于全屏模式时,用户只能使用 Esc Key 退出全屏模式。根据浏览器的类型,单击 Esc Key 可能并不总是触发从浏览器正向到应用程序的事件。
HideMobileInput
TextMeshPro(也称为 TMP)输入字段中的
HideMobileInput
选项 ON Web 平台没有特效。此选项特效,因为您需要文本输入字段才能在浏览器触发器键盘。Web 平台实例化一个文本输入字段,以便在 Unity Player期望条目文本Whenen发虚拟键盘。文本输入字段与Other平台一样显示在虚拟键盘上方。由于虚拟键盘依赖ON移动端文本输入字段,因此无法ON Web 平台上显示为隐藏状态。

移动传感器Support

对于Support触控的浏览器和移动端Devices,Unity Web 包括对以下传感器的Support:
重要
浏览器仅在安全上下文中允许传感器输入,这意味着必须通过 HTTPS 提供 Page。
http://localhost
是单一异常,您可以在 Development 期间使用。

光标锁定Support

Unity Web 平台支持使用 HTML5 API
Element.requestPointerLock
的光标锁定。使用光标锁定可将鼠标光标锁定到游戏窗口的中心。锁定光标When,光标在 Unity 中显示为隐藏状态,在鼠标移动When不会Move。这对于第一人称游戏特别有用,在此类游戏中,鼠标光标通常用于ControlPlayer角度的方向。
注意
由于浏览器对光标锁定的支持不同,请参阅 Mozilla 文档 ON 元件:requestPointerLock() 方法。

激活光标锁定

要锁定光标,请使用
Cursor.lockState
属性。例如,当用户单击鼠标左键时,以下代码将光标切换到锁定状态:
void Update(){ if (Input.GetMouseButtonDown(0)) { Cursor.lockState = CursorLockMode.Locked; }}
光标锁定需要通过用户交互激活。有关更多信息,请参阅全屏模式和光标锁定的其他注意事项。

停用光标锁定

按 Esc Key 可解锁光标。

粘性光标锁定

stickyCursorLock
属性通常用于第一人称游戏,因为无论浏览器行为如何,保持光标锁定模式都很有用。
使用
stickyCursorLock
可确保
Cursor.lockState
状态持久,即使浏览器从 Unity 画布释放光标锁定(通常使用 Esc Key),在这种情况下,光标在画布获得焦点的 Next 时间再次锁定。
因此,如果将
WebGLInput._stickyCursorLock
设置为
true
,即使 Unity 画布 HTML 元件解锁光标,
Cursor.lockState
也会保持
CursorLockMode.Locked
状态。
如果将
WebGLInput._stickyCursorLock
设置为
false
,则会发生以下情况:
  • Cursor.lockState
    与浏览器的光标锁定状态保持同步。
  • 如果用户按 Esc Key 取消画布光标锁定,则
    Cursor.lockState
    将更改为
    CursorLockMode.None
    。
注意
在 Web 中,
stickyCursorLock
默认情况下设置为
true
。

全屏模式

在游戏中使用全模式式可以执行以下操作:
  • 将整个屏幕使用于游戏。
  • 隐藏浏览器用户界面 UI 元素,例如地址栏和选项卡。
  • 隐藏 Unity Player UI 元素,例如Title栏和工具栏栏。
Unity Web 平台支持使用 HTML5 API
Element.requestFullscreen
的全屏模式。
注意
由于浏览器对全屏模式的支持不同,请参阅 Mozilla ON 元件:requestFullscreen() 方法的文档。

在 Web 中激活全模式式

要启用全屏模式,请使用
Screen.fullScreen
属性。例如,当用户按 F Key 时,以下代码将游戏切换到全屏模式:
void Update(){ if (Input.GetKeyDown(KeyCode.F)) { Screen.fullScreen = true; }}
注意
默认情况下,
Screen.fullScreen
属性设置为
false
。
全屏模式需要通过用户交互激活。有关更多信息,请参阅全屏模式和光标锁定的其他注意事项。

退出全模式式

要退出全屏模式,请再次按 Esc Key,或将鼠标指针悬停在屏幕顶部以访问地址栏和选项卡。

全模式式和光标锁定的其他注意事项

出于安全考虑,浏览器只允许在用户发起的事件(例如鼠标单击或 Key 按下)之后锁定光标并启用全屏模式。
由于 Unity 不Support单独的事件和渲染循环,因此它会将事件处理推迟到浏览器不再确认 Unity 脚本发出的屏幕或光标锁定请求作为对触发事件的直接响应。
因此,Unity 会在下一个用户发起的事件触发请求,而不是触发光标锁定或全屏请求的事件。
要Enable光标锁定或全屏幕式以获得更好的结果,请使用鼠标/Key按下事件而不是鼠标/Key向上事件来触触发器应。这样就可以确保延迟请求由相应的鼠标/Key up 事件触发(如果不是由用户先前发起的事件触发)。
您还可以使用 Unity 的 UI.按钮组件通过创建覆盖
OnPointerDown
方法的
Button
子类来实现所需的行为。
注意
某些浏览器可能会在进入全模式式或锁定光标之前显示通知message或提示用户授予权限。

其他资源