# 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 %}
**프리셋 편집에서 스캔을 클릭하여 새 바인드를 생성합니다.**

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

동일한 절차를 따를 수 있습니다, [위에 설명된 대로](#h_ec0751fa3a), Thrustmaster 비행 스틱용 조이스틱 제어 매핑을 만들기 위해. 아래 이미지에 표시된 매핑을 권장합니다. 그러나 다양한 사용자 선호도를 충족할 수 있도록 배포별로 고유한 매핑을 구성할 수 있습니다.

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


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.