Version: 6000.3
语言: 中文
输入
Unity XR 输入

移动键盘

在大多数情况下,Unity 会自动处理 GUI 元素的键盘输入,但也很容易从脚本中按需显示键盘。

GUI 元素

当用户点击可编辑的 GUI 元素时,键盘将自动出现。目前,GUI.文本字段图形用户界面。TextAreaGUI。PasswordField 将显示键盘;有关更多详细信息,请参阅 GUI 类文档。

手动键盘处理

使用 TouchScreenKeyboard.Open() 函数打开键盘。请参阅 TouchScreenKeyboard 脚本参考,了解此函数采用的参数。

键盘布局选项

键盘支持以下选项:-

财产: 功能:
TouchScreenKeyboardType.默认 函件。可以切换到带有数字和标点符号的键盘。
TouchScreenKeyboardType.ASCIICapable 函件。可以切换到带有数字和标点符号的键盘。
触摸屏键盘类型.数字和标点符号 数字和标点符号。可以切换到带字母的键盘。
触摸屏键盘类型.URL 带有斜杠和.com按钮的字母。可以切换到带有数字和标点符号的键盘。
触摸屏键盘类型.数字键盘 只有 0 到 9 之间的数字。
触摸屏键盘类型.PhonePad 用于输入电话号码的键盘。
触摸屏键盘类型.名称PhonePad 函件。可以切换到手机键盘。
触摸屏键盘类型.电子邮件地址 带有 @ 符号的字母。可以切换到带有数字和标点符号的键盘。

文本预览

默认情况下,将创建一个编辑框,并在出现后将其放置在键盘顶部。这用作用户正在键入的文本的预览,因此文本始终对用户可见。但是,您可以通过将 TouchScreenKeyboard.hideInput 设置为 true 来禁用文本预览。请注意,这仅适用于某些键盘类型和输入模式。例如,它不适用于手机键盘和多行文本输入。在这种情况下,编辑框将始终显示。TouchScreenKeyboard.hideInput 是一个全局变量,将影响所有键盘。

可见性和键盘大小

TouchScreenKeyboard 中有三个键盘属性,用于确定键盘可见性状态和屏幕上的大小。

财产: 功能:
可见 如果键盘在屏幕上完全可见并且可用于输入字符,则返回 true
面积 返回键盘的位置和尺寸。
积极 如果键盘已激活,则返回 true。此属性不是静态属性。必须具有键盘实例才能使用此属性。

请注意,TouchScreenKeyboard.area 将返回一个 Rect,其位置和大小设置为 0,直到键盘在屏幕上完全可见。不应在 TouchScreenKeyboard.Open() 之后立即查询此值。键盘事件的顺序如下:

  • TouchScreenKeyboard.Open() 被调用。TouchScreenKeyboard.active 返回 true。TouchScreenKeyboard.visible 返回 false。TouchScreenKeyboard.area 返回 (0, 0, 0, 0)。
  • 键盘滑出屏幕。所有属性都保持不变。
  • 键盘停止滑动。TouchScreenKeyboard.active 返回 true。TouchScreenKeyboard.visible 返回 true。TouchScreenKeyboard.area 返回键盘的实际位置和大小。

安全文本输入

可以将键盘配置为在键入时隐藏符号。当用户需要输入敏感信息(例如密码)时,这非常有用。要在启用安全文本输入的情况下手动打开键盘,请使用以下代码:

TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true);
键入时隐藏文本
键入时隐藏文本

警报键盘

要以黑色半透明背景而不是经典的不透明背景显示键盘,请按如下方式调用 TouchScreenKeyboard.Open():

TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true, true);
警报键盘
警报键盘
输入
Unity XR 输入