> For the complete documentation index, see [llms.txt](https://docs.uvify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uvify.com/01-login.md).

# 1. 로그인과 문자 입력

KGroundControl을 실행하면 인증이 필요한 환경에서 로그인 화면이 표시됩니다. **ID**와 **비밀번호**를 입력한 뒤 **로그인**을 누릅니다. 로그인 화면이 닫히고 비행 화면이 나타나면 다음 장으로 이동합니다.

## 1.1 화면에 보이는 항목 <a href="#section-11" id="section-11"></a>

![로그인 화면. 제품 이름, 인증 안내, ID, 비밀번호, 로그인 버튼](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-0062cbd03077590ffcdea025abe97e3857d41ab3%2Flogin.png?alt=media)

*그림 1-1. 입력 전 로그인 화면. 이 매뉴얼의 화면과 수치는 설명용 예시입니다.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목              | 설명                                          |
| :---: | ------------------ | ------------------------------------------- |
| **1** | **KGroundControl** | 프로그램 이름입니다.                                 |
| **2** | **인증 안내**          | 로그인이 필요하다는 안내입니다.                           |
| **3** | **ID 입력란**         | 발급받은 ID를 입력합니다. Enter를 누르면 비밀번호로 이동합니다.     |
| **4** | **비밀번호 입력란**       | 비밀번호를 입력합니다. 입력 문자는 가려지며 Enter로 로그인을 요청합니다. |
| **5** | **로그인**            | 입력한 인증 정보로 로그인을 요청합니다.                      |

ID 입력란에서 **Enter**를 누르면 비밀번호 입력란으로 이동합니다. 비밀번호 입력란에서 **Enter**를 누르면 로그인을 요청합니다. **Esc**는 비밀번호 입력을 지웁니다.

## 1.2 로그인에 실패했을 때 <a href="#section-12" id="section-12"></a>

![로그인 실패 안내가 표시된 화면](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-7f719b2813510bb96e92d91afd560d1e0a621302%2Flogin-failed.png?alt=media)

*그림 1-2. 「로그인에 실패했습니다. ID 또는 비밀번호를 확인하세요.」 안내.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목              | 설명                                          |
| :---: | ------------------ | ------------------------------------------- |
| **1** | **KGroundControl** | 프로그램 이름입니다.                                 |
| **2** | **인증 안내**          | 로그인이 필요하다는 안내입니다.                           |
| **3** | **ID 입력란**         | 발급받은 ID를 입력합니다. Enter를 누르면 비밀번호로 이동합니다.     |
| **4** | **비밀번호 입력란**       | 비밀번호를 입력합니다. 입력 문자는 가려지며 Enter로 로그인을 요청합니다. |
| **5** | **로그인 실패 안내**      | 로그인에 실패했습니다. ID 또는 비밀번호를 확인하세요.             |
| **6** | **로그인**            | 입력한 인증 정보로 로그인을 요청합니다.                      |

인증에 실패하면 비밀번호가 지워지고 비밀번호 입력란이 다시 선택됩니다. ID가 맞는지 확인한 뒤 비밀번호를 다시 입력합니다. 화면에 표시된 실패 안내만으로 ID와 비밀번호 중 어느 항목이 틀렸는지는 구분할 수 없습니다.

## 1.3 로그인이 잠겼을 때 <a href="#section-13" id="section-13"></a>

![입력란과 로그인 버튼이 비활성화된 잠금 화면](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-0a0ad982c22b526b98a7662783e0cbd336e90118%2Flogin-locked.png?alt=media)

*그림 1-3. 일시 잠금 안내. 30초는 화면 설명용 예시이며 실제 남은 시간을 확인합니다.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목              | 설명                                |
| :---: | ------------------ | --------------------------------- |
| **1** | **KGroundControl** | 프로그램 이름입니다.                       |
| **2** | **인증 안내**          | 로그인이 필요하다는 안내입니다.                 |
| **3** | **ID 입력란**         | 일시 잠금 중에는 입력할 수 없습니다.             |
| **4** | **비밀번호 입력란**       | 일시 잠금 중에는 입력할 수 없습니다.             |
| **5** | **잠금과 남은 시간**      | 로그인이 일시적으로 잠겼습니다. 30초 후 다시 시도하세요. |
| **6** | **로그인**            | 이 상태에서는 로그인 버튼을 사용할 수 없습니다.       |

일시 잠금 중에는 ID·비밀번호 입력란과 로그인 버튼을 사용할 수 없습니다. 화면에 표시되는 남은 시간이 지난 뒤 다시 입력합니다. 잠금이 해제되면 ID 입력란이 선택됩니다.

## 1.4 인증 설정 안내만 보일 때 <a href="#section-14" id="section-14"></a>

![인증 정보가 구성되지 않은 경우 표시되는 안내 화면](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-fc02a25169aa5c6719ebeae36748689357848648%2Flogin-unconfigured.png?alt=media)

*그림 1-4. 인증 정보가 준비되지 않은 환경의 안내.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목              | 설명                                             |
| :---: | ------------------ | ---------------------------------------------- |
| **1** | **KGroundControl** | 프로그램 이름입니다.                                    |
| **2** | **인증 안내**          | 로그인이 필요하다는 안내입니다.                              |
| **3** | **인증 설정 안내**       | 인증 계정 파일이 포함되지 않았습니다. 인증 정보를 포함하여 앱을 다시 빌드하세요. |
| **4** | **로그인**            | 이 상태에서는 로그인 버튼을 사용할 수 없습니다.                    |

ID·비밀번호 입력란이 보이지 않고 인증 정보에 관한 안내만 표시되면, 화면에서 계정을 새로 만드는 방식으로 해결할 수 없습니다. 이 단말을 관리하는 담당자에게 안내 내용을 전달합니다.

## 1.5 화면 키보드 <a href="#section-15" id="section-15"></a>

[문자 키](#151-문자-키) · [Shift](#152-shift) · [123](#153-123) · [ABC](#154-abc) · [스페이스](#155-스페이스) · [지우기](#156-지우기) · [초기화](#157-초기화) · [입력](#158-입력) · [키보드 숨기기 / 키보드 표시](#159-키보드-숨기기-키보드-표시)

입력란을 선택하면 화면 키보드가 표시될 수 있습니다. Android 환경에서는 운영체제 키보드를 사용하므로 아래 그림과 모양이 다를 수 있습니다.

![영문 화면 키보드. Shift, 123, 스페이스, 지우기, 초기화, 입력](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-32077318886f95899f01f405a2f78adee88ac27c%2Fkeyboard.png?alt=media)

*그림 1-5. 영문 입력 키보드.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목     | 설명                                                                         |
| :---: | --------- | -------------------------------------------------------------------------- |
| **1** | **문자 키**  | 누른 문자를 현재 입력 위치에 넣습니다. 선택한 문자열이 있으면 바꿉니다.                                  |
| **2** | **Shift** | 누를 때마다 꺼짐 → 다음 한 글자 대문자 → Caps 고정 → 꺼짐으로 바뀝니다. 다음 한 글자 모드에서 문자를 입력하면 꺼집니다. |
| **3** | **123**   | 숫자와 기호 키보드로 바꿉니다.                                                          |
| **4** | **스페이스**  | 공백을 입력합니다.                                                                 |
| **5** | **지우기**   | 선택한 부분이나 커서 앞의 문자를 지웁니다.                                                   |
| **6** | **초기화**   | 현재 입력란의 내용을 모두 지웁니다. 앱이나 기체 설정을 초기화하는 버튼이 아닙니다.                            |
| **7** | **입력**    | 현재 입력란에 Enter를 전달합니다. ID에서는 비밀번호로 이동하고, 비밀번호에서는 로그인을 요청합니다.                |

**문자 키**

현재 선택한 입력란에 해당 문자를 입력합니다. 선택된 문자열이 있으면 그 부분을 바꿉니다.

**Shift**

누를 때마다 꺼짐 → 다음 한 글자 대문자 → Caps 고정 → 꺼짐으로 바뀝니다. 다음 한 글자 모드에서 문자를 입력하면 꺼집니다.

**123**

숫자와 기호 키보드로 바꿉니다.

**ABC**

숫자·기호 키보드에서 영문 키보드로 돌아옵니다.

**스페이스**

공백을 입력합니다.

**지우기**

선택한 부분이나 커서 앞의 문자를 지웁니다.

**초기화**

현재 입력란의 내용을 모두 지웁니다. 앱이나 기체 설정을 초기화하는 버튼이 아닙니다.

**입력**

현재 입력란에 Enter를 전달합니다. ID에서는 비밀번호로 이동하고, 비밀번호에서는 로그인을 요청합니다.

**키보드 숨기기 / 키보드 표시**

키보드 위쪽 손잡이로 키보드를 접거나 다시 펼칩니다. 입력한 내용은 그대로 유지됩니다.

![숫자와 기호로 전환한 화면 키보드](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-a544df0500e54101195e93effeac0768a15f8e30%2Fkeyboard-symbols.png?alt=media)

*그림 1-6. **123**을 눌렀을 때의 숫자·기호 키보드.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목       | 설명                                                                         |
| :---: | ----------- | -------------------------------------------------------------------------- |
| **1** | **숫자·기호 키** | 누른 문자를 현재 입력 위치에 넣습니다. 선택한 문자열이 있으면 바꿉니다.                                  |
| **2** | **Shift**   | 누를 때마다 꺼짐 → 다음 한 글자 대문자 → Caps 고정 → 꺼짐으로 바뀝니다. 다음 한 글자 모드에서 문자를 입력하면 꺼집니다. |
| **3** | **ABC**     | 숫자·기호 키보드에서 영문 키보드로 돌아옵니다.                                                 |
| **4** | **스페이스**    | 공백을 입력합니다.                                                                 |
| **5** | **지우기**     | 선택한 부분이나 커서 앞의 문자를 지웁니다.                                                   |
| **6** | **초기화**     | 현재 입력란의 내용을 모두 지웁니다. 앱이나 기체 설정을 초기화하는 버튼이 아닙니다.                            |
| **7** | **입력**      | 현재 입력란에 Enter를 전달합니다. ID에서는 비밀번호로 이동하고, 비밀번호에서는 로그인을 요청합니다.                |

숫자만 입력하는 설정 항목에서는 다음과 같은 숫자 키패드가 표시됩니다. 입력 가능한 부호와 소수점은 해당 입력란의 규칙에 따릅니다.

![숫자 입력란에 사용하는 숫자 키패드](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-b710e5f727cfe4621da14a3e79f1ae95633734e1%2Fkeyboard-numbers.png?alt=media)

*그림 1-7. 숫자 입력용 키패드.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목       | 설명                                                          |
| :---: | ----------- | ----------------------------------------------------------- |
| **1** | **숫자·기호 키** | 누른 문자를 현재 입력 위치에 넣습니다. 선택한 문자열이 있으면 바꿉니다.                   |
| **2** | **음수 부호**   | 음수 부호를 입력합니다.                                               |
| **3** | **0**       | 숫자 0을 입력합니다.                                                |
| **4** | **.**       | 소수점을 입력합니다. 입력란이 소수를 허용할 때 사용합니다.                           |
| **5** | **지우기**     | 선택한 부분이나 커서 앞의 문자를 지웁니다.                                    |
| **6** | **초기화**     | 현재 입력란의 내용을 모두 지웁니다. 앱이나 기체 설정을 초기화하는 버튼이 아닙니다.             |
| **7** | **입력**      | 현재 입력란에 Enter를 전달합니다. ID에서는 비밀번호로 이동하고, 비밀번호에서는 로그인을 요청합니다. |

다음: [2. 비행 화면의 구성](/02-flight-screen.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.uvify.com/01-login.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
