---
title: 移动键盘
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/input/mobile-keyboard
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/input/mobile-keyboard.md
last_updated: 2026-10-30
generated_at: 2026-11-18T12:02:46.758Z
locale: zh-cn
---

# 移动键盘

> 自动为 GUI 元素打开 ON 屏幕键盘，或通过脚本手动打开。

在大多数情况下，Unity 将自动手柄 GUI 元素的键盘输入，但也很容易通过脚本ON需显示键盘。

## GUI 元素##gui-elements

当用户点击 ON 可编辑的 GUI 元素时，键盘将自动出现。目前，[GUI.TextField](/engine/6000.0/script-reference/unityengine/gui/textfield.md)、[GUI.TextArea](/engine/6000.0/script-reference/unityengine/gui/textarea.md) 和 [GUI.PasswordField](/engine/6000.0/script-reference/unityengine/gui/passwordfield.md) 将显示键盘；有关更多细节，请参阅 [GUI 类](/engine/6000.0/script-reference/unityengine/gui.md)文档。

## 用户手册键盘处理##manual-keyboard-handling

> **Note:**
>
> 原生 iPhone、Android 和 Windows 应用商店应用程序仅支持 ON `TouchScreenKeyboard` API。尝试ON不受支持的平台上访问Properties性会抛出异常。如果您的目标是多个平台，请确保您的代码在尝试使用之前检查`TouchScreenKeyboard.isSupported`。

使用 **[TouchScreenKeyboard.Open()](/engine/6000.0/script-reference/unityengine/touchscreenkeyboard/open.md)** 函数打开键盘。请参阅 [TouchScreenKeyboard](/engine/6000.0/script-reference/unityengine/touchscreenkeyboard.md) 脚本参考以了解此函数接受的参数。

## 键盘Layout选项##keyboard-layout-options

键盘支持以下选项：

| *属性*                                                                                                                                              | *函数*                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| **[TouchScreenKeyboardType.Default](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/default.md)**                             | 字母。可以切换到带有数字和标点符号的键盘。               |
| **[TouchScreenKeyboardType.ASCIICapable](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/asciicapable.md)**                   | 字母。可以切换到带有数字和标点符号的键盘。               |
| **[TouchScreenKeyboardType.NumbersAndPunctuation](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/numbersandpunctuation.md)** | 数字和标点符号。可以切换到带有字母的键盘。               |
| **[TouchScreenKeyboardType.URL](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/url.md)**                                     | 带有斜杠和 .COM 按钮的字母。可以切换到带有数字和标点符号的键盘。 |
| **[TouchScreenKeyboardType.NumberPad](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/numberpad.md)**                         | 仅限 0 到 9 之间的数字。                     |
| **[TouchScreenKeyboardType.PhonePad](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/phonepad.md)**                           | 用于进入Phone号码的键盘。                     |
| **[TouchScreenKeyboardType.NamePhonePad](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/namephonepad.md)**                   | 字母。可以切换到Phone键盘。                    |
| **[TouchScreenKeyboardType.EmailAddress](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/emailaddress.md)**                   | 带有 @ 符号的字母。可以切换到带有数字和标点符号的键盘。       |

## 文本预览##text-preview

默认情况下下，将显示一个编辑Box将其放置ON键盘顶部。它用作用户正在输入的文本的预览，因此文本对用户始终可见。但是，您可以通过将 **TouchScreenKeyboard.hideInput** 设置为 true 来禁用文本预览。请注意，这仅适用于某些键盘类型和输入模式。例如，它不适用于 Phone 键盘和多线文本输入。在这种情况下，将始终显示编辑 Box。**TouchScreenKeyboard.hideInput** 是全局变量，将影响 All 键盘。

## 可见性和键盘大小##visibility-and-keyboard-size

[TouchScreenKeyboard](/engine/6000.0/script-reference/unityengine/touchscreenkeyboard.md) 中有三个键盘 Properties 用于确定屏幕上的键盘可见性状态和大小。

| *属性*       | *函数*                                                 |
| ---------- | ---------------------------------------------------- |
| **可见**     | 如果键盘在屏幕上完全可见并可用于进入角色，则返回 **true**。                   |
| **面积**     | 返回键盘的位置和尺寸。                                          |
| **active** | 如果键盘已激活，则返回 **true**。属性性不是Static属性。必须有一个键盘实例才能使用属性性。 |

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

* 调用 **TouchScreenKeyboard.Open()**。**TouchScreenKeyboard.active** 返回 true。**TouchScreenKeyboard.visible** 返回 false。**TouchScreenKeyboard.area** 返回 (0, 0, 0, 0)。
* 键盘滑出屏幕。All Properties 保持不变。
* 键盘停止滑动。**TouchScreenKeyboard.active** 返回 true。**TouchScreenKeyboard.visible** 返回 true。**TouchScreenKeyboard.area** 返回键盘的实际位置和大小。

## 安全文本输入##secure-text-input

可以将键盘配置为在键When隐藏符号。When需要Users进入敏感信息（例如密码）时，这非常有用。要在已启用安全文本输入的情况下手动Open键盘，请使用以下代码：

```lang-cs
TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true);
```


**Hiding text while typing:**
![](/api/media?file=/engine/6000.0/media/images/KeyboardSecure.png)

## 警报键盘##alert-keyboard

要显示具有黑色半透明背景而不是经典 Opaque 的键盘，请调用 **TouchScreenKeyboard.Open()**，如下所示：

```lang-cs
TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true, true);
```


**Alert keyboard:**
![](/api/media?file=/engine/6000.0/media/images/KeyboardAlert.png)
