> 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) 카메라에 대한 컨트롤을 사용할 수 있지만, 향상된 경험을 위해 선호하는 휴대용 컨트롤러를 사용할 수 있습니다. 모든 PTZ 카메라에는 두 가지 옵션이 제공됩니다:
* 타사 조이스틱
* Microsoft Xbox 컨트롤러
***
## Xbox 컨트롤러를 PTZ에 연결하기
Verkada는 Xbox 컨트롤러를 위해 특별히 제작된 맞춤형 경험을 개발했습니다. 별도의 구성이나 버튼 매핑 없이도 Command 사용자는 Xbox 컨트롤러로 PTZ 카메라를 쉽게 제어할 수 있습니다. 컨트롤러가 Xbox 장치로 인식되는 한, 아래에 표시된 미리 구성된 버튼 매핑과 함께 컴퓨터에 자동으로 페어링됩니다.
### MacOS에 Xbox 컨트롤러 연결하기
{% 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개의 조이스틱이 연결됨" 메시지가 표시되어야 합니다. 이 메시지가 표시되지 않으면 조이스틱이 USB를 통해 컴퓨터에 올바르게 연결되었는지 확인하세요\*.\*
{% endhint %}
{% endstep %}
{% step %}
**사전 설정 편집에서:**
1. 사전 설정을 편집하고 사용자 지정 버튼 매핑을 만드세요.
2. 사전 설정을 쉽게 관리할 수 있도록 사전 설정에 이름과 선택적 태그를 지정하세요.
3. 클릭 **새 바인드 추가** 를 눌러 키보드 키와 조이스틱 컨트롤 간의 바인드를 만드세요.
{% endstep %}
{% step %}
**사전 설정 편집에서 스캔을 클릭하여 새 바인드를 만드세요.**
1. 누른 후 몇 초 안에 조이스틱 입력(축 또는 특정 버튼)을 사용하면 Joystick Mapper가 자동으로 감지합니다.
2. 입력이 감지되면 드롭다운을 클릭하여 해당 입력에 특정 키보드 화살표 키를 연결하세요.
3. (선택 사항) 다음을 사용하여 조이스틱의 모든 버튼과 축에 대한 바인드를 만드세요: **스캔** 또는 버튼 및/또는 해당 축을 수동으로 입력합니다.
이 예시는 (**권장**) PTZ 카메라에 대해 완전히 구성된 매핑을 보여줍니다:
{% endstep %}
{% step %}
**매핑이 완료되면 대화 상자를 닫습니다. 변경 사항은 저장되며 새로 만든 사전 설정에 맞게 홈 창에서 업데이트됩니다.**
{% endstep %}
{% step %}
**Joystick Mapper에서 사전 설정 상자를 선택한 다음 Command에서 PTZ 카메라를 열어 조이스틱을 사용하세요.**
{% endstep %}
{% endstepper %}
#### Thrustmaster HOTAS 비행 스틱
위에 설명된 [동일한 단계를 따를 수 있습니다](#h_1b94b4fc3d), Thrustmaster 비행 스틱의 조이스틱 컨트롤 매핑을 만들기 위해. 아래 이미지에 표시된 매핑을 권장합니다. 그러나 다양한 사용자 선호도를 충족하기 위해 각 배포마다 고유한 매핑을 구성할 수 있습니다.
***
### 조이스틱을 Windows에 연결하기
#### Vivotek AJ-100
{% stepper %}
{% step %}
**다음 앱을 다운로드하세요.** [**JoyToKey**](https://joytokey.net/en/download) **웹사이트에서 앱을 다운로드하세요.**
{% endstep %}
{% step %}
**USB 연결을 통해 AJ-001 조이스틱을 Windows 컴퓨터에 연결하세요. USB 연결이 설정되었다는 메시지가 표시되어야 합니다.**
{% endstep %}
{% step %}
**연결되면 JoyToKey 애플리케이션을 여세요.**
1. JoyToKey 창(왼쪽 아래)에서 **만들기** 를 클릭하고 나중에 알아볼 수 있도록 프로필 이름을 지정하세요(예: "Vivotek AJ-100").
2. 클릭 **확인** 을 눌러 프로필을 저장하세요.
{% endstep %}
{% step %}
**프로필 생성이 확인되면 조이스틱의 버튼이나 축을 키보드 키에 매핑할 수 있습니다. 조이스틱 입력을 두 번 클릭하거나 편집 버튼 할당을 클릭하여 매핑 구성 메뉴를 여세요.**
버튼 및 축 매핑을 구성하기 위해 다음 창이 별도로 열립니다.
{% endstep %}
{% step %}
**아래에서 노란색으로 강조 표시된 상자를 사용하여 조이스틱 입력에 연결할 원하는 키보드 키를 선택하세요(예: 왼쪽 기울기 축을 구성할 때는 키보드의 왼쪽 화살표를 클릭하여 컨트롤을 페어링합니다).**
{% endstep %}
{% step %}
**입력이 매핑되면 확인을 클릭하세요.**
{% endstep %}
{% step %}
**위 방법을 사용하여 조이스틱의 모든 버튼과 축에 대한 바인드를 만드세요.**
이 예시는 (**권장**) PTZ 카메라에 대해 완전히 구성된 매핑을 보여줍니다:
{% endstep %}
{% step %}
**매핑이 완료되면 상단의 옵션 탭을 클릭한 다음 새로 고침을 클릭하세요.**
이렇게 하면 현재 프로필이 저장되고 연결된 조이스틱에 매핑이 적용됩니다. 이제 PTZ 카메라를 조이스틱으로 제어할 준비가 되었습니다!
{% endstep %}
{% endstepper %}
#### Thrustmaster HOTAS 비행 스틱
위에 설명된 [동일한 단계를 따를 수 있습니다](#h_ec0751fa3a), Thrustmaster 비행 스틱의 조이스틱 제어 매핑을 만들기 위해. 아래 이미지에 표시된 매핑을 권장합니다. 그러나 다양한 사용자 선호도를 충족하기 위해 각 배포마다 고유한 매핑을 구성할 수 있습니다.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
