---
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/ko-kr/engine/6000.0/manual/input/mobile-keyboard
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/input/mobile-keyboard.md
last_updated: 2026-10-30
generated_at: 2026-11-19T19:53:32.431Z
locale: ko-kr
---

# 모바일 키보드

> GUI 요소에 대해 자동으로 또는 스크립트를 통해 수동으로 온스크린 키보드를 엽니다.

대부분의 경우 Unity GUI 요소에 대한 키보드 입력을 자동으로 처리하지만, 필요한 경우 스크립트에서 키보드를 쉽게 표시할 수 있습니다.

## GUI 요소##gui-elements

사용자가 편집 가능한 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:**
>
> `TouchScreenKeyboard` API는 네이티브 iPhone, Android 및 Windows 스토어 앱에서만 지원됩니다. 지원되지 않는 플랫폼에서 해당 프로퍼티에 액세스하려고 하면 예외가 발생합니다. 여러 플랫폼을 대상으로 하는 경우 코드를 사용하기 전에 코드가 `TouchScreenKeyboard.isSupported`를 확인해야 합니다.

키보드를 열려면 **[TouchScreenKeyboard.Open()](/engine/6000.0/script-reference/unityengine/touchscreenkeyboard/open.md)** 함수를 사용합니다. 이 함수의 파라미터는 [TouchScreenKeyboard](/engine/6000.0/script-reference/unityengine/touchscreenkeyboard.md) 스크립팅 레퍼런스를 참조하십시오.

## 키보드 레이아웃 옵션##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)**                           | 전화번호를 입력하는 데 사용되는 키보드입니다.                     |
| **[TouchScreenKeyboardType.NamePhonePad](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/namephonepad.md)**                   | 문자。 휴대폰 키보드로 전환할 수 있습니다.                      |
| **[TouchScreenKeyboardType.EmailAddress](/engine/6000.0/script-reference/unityengine/touchscreenkeyboardtype/emailaddress.md)**                   | @ 기호가 있는 문자. 숫자 및 기호 키보드로 전환할 수 있습니다.         |

## 텍스트 미리보기##text-preview

기본적으로 수정 상자가 생성되고 키보드가 나타나면 키보드 위에 배치됩니다. 이는 사용자가 입력하는 텍스트의 미리보기로 작동하므로 텍스트가 항상 사용자에게 표시됩니다. 그러나 **TouchScreenKeyboard.hideInput**을 true로 설정하여 텍스트 미리보기를 비활성화할 수 있습니다. 이는 특정 키보드 타입과 입력 모드에서만 작동합니다. 예를 들어 휴대폰 키패드와 다중 행 텍스트 입력에는 작동하지 않습니다. 이러한 경우에는 항상 수정 상자가 표시됩니다. **TouchScreenKeyboard.hideInput**은 전역 변수이며 모든 키보드에 영향을 줍니다.

## 가시성 및 키보드 크기##visibility-and-keyboard-size

[TouchScreenKeyboard](/engine/6000.0/script-reference/unityengine/touchscreenkeyboard.md)에는 화면의 키보드 가시성 상태와 크기를 결정하는 세 가지 키보드 프로퍼티가 있습니다.

| 프로퍼티        | \_함수\*\*                                                                            |
| ----------- | ----------------------------------------------------------------------------------- |
| **visible** | 키보드가 화면에 완전히 보이고 문자를 입력하는 데 사용할 수 있는 경우 **true를** 반환합니다.                            |
| **area**    | 키보드의 포지션과 크기를 반환합니다.                                                                |
| **active**  | 키보드가 활성화되면 **true를** 반환합니다. 이 프로퍼티는 정적 프로퍼티가 아닙니다. 이 프로퍼티를 사용하려면 키보드 인스턴스가 있어야 합니다. |

**TouchScreenKeyboard.area**는 키보드가 화면에 완전히 보일 때까지 포지션과 크기가 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**는 키보드의 실제 위치와 크기를 반환합니다.

## 보안 텍스트 입력##secure-text-input

키보드를 설정하여 입력 시 기호를 숨길 수 있습니다. 이는 사용자가 중요한 정보를 입력해야 하는 경우에 유용합니다(예: 비밀번호). 안전한 텍스트 입력이 활성화된 상태에서 키보드를 수동으로 열려면 다음 코드를 사용하십시오.

```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

클래식 불투명 대신 검은색 반투명 배경으로 키보드를 표시하려면 다음과 같이 \*\*TouchScreenKeyboard.Open()\*\*을 호출하십시오.

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


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