> 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와 함께 휴대형 컨트롤러 사용

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

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

***

## Xbox 컨트롤러를 PTZ에 연결하기

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 컨트롤러는 충전 중이거나 USB로 iOS 컴퓨터에 연결되어 있을 때 사용할 수 없습니다. 컨트롤러 연결에 문제가 발생하면 다음으로 문의하세요 [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 Joystick connected" 메시지가 표시되어야 합니다. 이 메시지가 보이지 않으면 조이스틱이 USB를 통해 컴퓨터에 제대로 연결되어 있는지 확인하세요\*.\*
{% endhint %}

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

{% step %}
**사전 설정 편집에서:**

1. 사전 설정을 편집하고 사용자 지정 버튼 매핑을 만듭니다.
2. 사전 설정에 이름과 선택적 태그를 지정하면 사전 설정을 더 쉽게 관리할 수 있습니다.
3. 클릭 **새 바인드 추가** 키보드 키와 조이스틱 컨트롤 간 바인드를 만듭니다.

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

{% step %}
**사전 설정 편집에서 새 바인드를 만들려면 Scan을 클릭합니다.**

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

<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 Flight Stick

동일한 단계를 따를 수 있습니다, [위에 설명된 대로](#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.