> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/verkada-cameras/ko/configuration/view-and-edit-camera-settings/set-up-sentry-mode-on-a-ptz-camera/use-handheld-controllers-with-the-ptz.md).

# PTZ와 함께 휴대형 컨트롤러 사용하기

Verkada Command 내에서 팬-틸트-줌(PTZ) 카메라를 위한 컨트롤을 사용할 수 있지만, 향상된 경험을 위해 선호하는 핸드헬드 컨트롤러를 사용할 수 있습니다. 모든 PTZ 카메라에 대해 두 가지 옵션을 사용할 수 있습니다:

* 타사 조이스틱
* Microsoft Xbox 컨트롤러

***

## PTZ에 Xbox 컨트롤러 연결

Verkada는 Xbox 컨트롤러를 위해 특별히 설계된 맞춤형 경험을 개발했습니다. 별도의 구성이나 버튼 매핑 없이 Command 사용자는 Xbox 컨트롤러로 PTZ 카메라를 쉽게 제어할 수 있습니다. 컨트롤러가 Xbox 기기로 인식되기만 하면 아래와 같이 미리 구성된 버튼 매핑이 자동으로 컴퓨터와 페어링됩니다.

<div align="left" data-with-frame="true"><img src="/files/b1bccd86d0a87233563fb967b243e03c03485b9a" alt=""></div>

### Xbox 컨트롤러를 macOS에 연결

{% stepper %}
{% step %}
**Bluetooth를 통해 Xbox 컨트롤러를 Mac에 연결합니다.** [**자세히 알아보기**](https://support.apple.com/en-us/111101)
{% endstep %}

{% step %}
**웹 브라우저가 Xbox 컨트롤러 입력을 읽도록 허용:**

a. 다음으로 이동: **시스템 환경설정**.\
b. 선택: **보안 및 개인 정보 보호** > 선택: **개인정보**.\
c. 다음으로 이동: **입력 모니터링** 을 선택합니다.\
d. **저장** 변경 사항.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Xbox 컨트롤러는 충전 중이거나 iOS 컴퓨터에 USB로 연결된 경우 사용할 수 없습니다. 컨트롤러 연결에 어려움이 있으면 다음으로 문의하세요 [Verkada 지원팀](https://www.verkada.com/contact/).
{% endhint %}

### Xbox 컨트롤러를 Windows에 연결

Bluetooth 또는 USB를 통해 Xbox 컨트롤러를 Windows에 연결합니다. [자세히 알아보기](https://www.microsoft.com/en-us/windows/learning-center/how-to-connect-xbox-controller-to-pc)

{% hint style="danger" %}
Bluetooth를 사용하여 Xbox 컨트롤러를 PC에 연결하려면 컴퓨터가 Windows 10 이상에서 실행 중이어야 합니다.
{% endhint %}

***

## 조이스틱을 PTZ에 연결

Vivotek AJ-001 및 Thrustmaster 조이스틱을 사용하여 PTZ 카메라에 다양한 조이스틱을 연결하고 제어할 수 있습니다.

키보드 매핑 소프트웨어를 사용하면 특정 요구 사항과 선호도에 맞게 컨트롤을 사용자 지정할 수 있습니다. 모든 타사 조이스틱에도 동일한 절차를 사용할 수 있습니다.

### 조이스틱을 macOS에 연결

#### Vivotek AJ-001

{% stepper %}
{% step %}
**다음을 다운로드하세요** [**Joystick Mapper**](https://apps.apple.com/us/app/joystick-mapper/id528183797?mt=12) **앱을 iOS App Store에서.**
{% endstep %}

{% step %}
**USB 연결을 통해 AJ-001 조이스틱을 iOS 기기에 연결합니다.**
{% endstep %}

{% step %}
**연결되면 Joystick Mapper 앱을 엽니다.**
{% endstep %}

{% step %}
**사용자 지정 버튼 매핑을 만들려면 새 프리셋 추가를 클릭합니다.**

{% hint style="warning" %}
아래와 같이 화면 하단에 "조이스틱 1개가 연결됨" 메시지가 표시되어야 합니다. 이 메시지가 보이지 않으면 조이스틱이 USB를 통해 컴퓨터에 올바르게 연결되었는지 확인하세요\*.\*
{% endhint %}

<div align="left" data-with-frame="true"><img src="/files/bad9eda3e145c1f6925be93252bed43fd557c827" alt="" width="597"></div>
{% endstep %}

{% step %}
**Edit Preset에서:**

1. 프리셋을 편집하여 사용자 지정 버튼 매핑을 만듭니다.
2. 프리셋을 더 쉽게 관리할 수 있도록 이름과 선택 사항인 태그를 지정합니다.
3. 클릭하세요. **새 바인딩 추가** 키보드 키와 조이스틱 컨트롤 간의 바인딩을 만듭니다.

<div align="left" data-with-frame="true"><img src="/files/a4a5040f2323eeb806e0aadfbf4b2648263319c5" alt="" width="644"></div>
{% endstep %}

{% step %}
**Edit Preset에서 Scan을 클릭하여 새 바인딩을 만듭니다.**

1. 누르면 몇 초 동안 조이스틱 입력(축 또는 특정 버튼)을 사용할 수 있으며, 이는 Joystick Mapper에서 자동으로 감지됩니다.
2. 입력이 감지되면 드롭다운을 클릭하여 해당 입력에 특정 키보드 화살표 키를 연결합니다.
3. (선택 사항) 다음을 사용하여 조이스틱의 모든 버튼과 축에 대한 바인딩을 만듭니다. **스캔** 또는 버튼 및/또는 해당 축을 수동으로 입력합니다.

<div align="left" data-with-frame="true"><img src="/files/cdb6b042d4c89db1855da1eed6486c56132f7e8e" alt="" width="646"></div>

이 예시는 (**권장**) PTZ 카메라에 대한 완성된 매핑을 보여줍니다:

<div align="left" data-with-frame="true"><img src="/files/8f56e174d7eb15ec84fa17a74b26f3901f86744d" alt="" width="641"></div>
{% endstep %}

{% step %}
**매핑이 완료되면 대화 상자를 닫습니다. 변경 사항은 저장되며, 홈 창에서 새로 만든 프리셋에 맞게 업데이트됩니다.**
{% endstep %}

{% step %}
**Joystick Mapper에서 프리셋 상자를 선택하고 Command에서 PTZ 카메라를 열어 조이스틱을 사용합니다.**

<div align="left" data-with-frame="true"><img src="/files/c86abb43a2e861d1a4624d6cd623a5a71039c6fd" alt="" width="596"></div>
{% endstep %}
{% endstepper %}

#### Thrustmaster HOTAS 플라이트 스틱

같은 단계를 따라할 수 있습니다, [위에 설명된 대로](#h_1b94b4fc3d), Thrustmaster 플라이트 스틱에 대한 조이스틱 컨트롤 매핑을 만듭니다. 아래 이미지에 표시된 매핑을 권장합니다. 그러나 다양한 사용자 선호를 충족할 수 있도록 각 배포에 고유한 방식으로 매핑을 구성할 수 있습니다.

<div align="left" data-with-frame="true"><img src="/files/0b5d21d3adae7f9537afb28e4288866ab536e4e2" alt="" width="563"></div>

***

### 조이스틱을 Windows에 연결

#### Vivotek AJ-100

{% stepper %}
{% step %}
**다음을 다운로드하세요** [**JoyToKey**](https://joytokey.net/en/download) **앱을 해당 웹사이트에서.**

<div align="left" data-with-frame="true"><img src="/files/04bcc0e7cb1da9613e7793ba4a2b0515da3d4701" alt="" width="787"></div>
{% endstep %}

{% step %}
**USB 연결을 통해 AJ-001 조이스틱을 Windows 컴퓨터에 연결합니다. USB 연결이 설정되었음을 알리는 메시지가 표시되어야 합니다.**
{% endstep %}

{% step %}
**연결되면 JoyToKey 애플리케이션을 엽니다.**

1. JoyToKey 창(왼쪽 아래)에서 다음을 클릭합니다: **생성** 그리고 나중에 알아볼 수 있는 이름(예: "Vivotek AJ-100")을 프로필에 지정합니다.
2. 클릭하세요. **확인** 프로필을 저장합니다.

<div data-with-frame="true"><figure><img src="/files/3531d13daa6e18a10899472a93092c96ab929ed7" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**프로필 생성이 확인되면 조이스틱의 버튼이나 축을 키보드 키에 매핑할 수 있습니다. 조이스틱 입력을 더블클릭하거나 편집 버튼 할당을 클릭하여 매핑 구성 메뉴를 찾습니다.**

<div align="left" data-with-frame="true"><img src="/files/e8d9995e3e4c3a3b3cbdd3116f9018b8b6b1cf5e" alt=""></div>

버튼 및 축 매핑을 구성하기 위해 다음 창이 별도로 열립니다.
{% endstep %}

{% step %}
**아래에서 노란색으로 강조 표시된 상자를 사용하여 조이스틱 입력에 바인딩할 원하는 키보드 키를 선택합니다(예: 왼쪽 기울기 축을 구성할 때 키보드의 왼쪽 화살표를 클릭하여 컨트롤을 페어링합니다).**
{% endstep %}

{% step %}
**입력이 매핑되면 확인을 클릭합니다.**

<div data-with-frame="true"><figure><img src="/files/8a1cb2a8cb570b2668f122e8a5c9af5ef80cf6a8" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**위 방법을 사용하여 조이스틱의 모든 버튼과 축에 대한 바인딩을 만듭니다.**

이 예시는 (**권장**) PTZ 카메라에 대한 완성된 매핑을 보여줍니다:

<div align="left" data-with-frame="true"><img src="/files/0a5d0feb35246417bf46205ebf6f02478800ea85" alt="" width="521"></div>
{% endstep %}

{% step %}
**매핑이 완료되면 상단에서 옵션 탭을 클릭한 다음 새로 고침을 클릭합니다.**

<div align="left" data-with-frame="true"><img src="/files/de629e82916f042f3d9fc1c27248e81d63cc07fb" alt=""></div>

이렇게 하면 현재 프로필이 저장되고 연결된 조이스틱에 매핑이 적용됩니다. 이제 PTZ 카메라를 조이스틱으로 제어할 수 있습니다!
{% endstep %}
{% endstepper %}

#### Thrustmaster HOTAS 플라이트 스틱

같은 단계를 따라할 수 있습니다, [위에 설명된 대로](#h_ec0751fa3a), Thrustmaster 플라이트 스틱에 대한 조이스틱 컨트롤 매핑을 만듭니다. 아래 이미지에 표시된 매핑을 권장합니다. 그러나 다양한 사용자 선호를 충족할 수 있도록 각 배포에 고유한 매핑을 구성할 수 있습니다.

<div align="left" data-with-frame="true"><img src="/files/895cadcf68447547b3b1068f60acc00348c3017c" alt=""></div>


---

# 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://help.verkada.com/verkada-cameras/ko/configuration/view-and-edit-camera-settings/set-up-sentry-mode-on-a-ptz-camera/use-handheld-controllers-with-the-ptz.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.