gamepad_get_option 함수 설명
gamepad_get_option 함수는 주어진 옵션 값을 가져오는 데 사용됩니다. 이 함수는 확인할 게임패드 "슬롯"과 옵션 문자열을 입력받아 관련된 값을 반환합니다. 사용 가능한 옵션 문자열은 프로젝트가 실행되는 플랫폼에 따라 다릅니다.
옵션 설명
| 옵션 이름 | 플랫폼 | 설명 | 반환 값 |
|---|---|---|---|
| "allow_rotation" | tvOS | Siri Remote가 회전 잠금 상태인지 여부를 반환합니다. 잠금 해제 시, 컨트롤을 회전하면 입력이 변경됩니다. | Boolean |
| "dpad_absolute" | tvOS | Siri Remote 터치패드가 절대 입력을 수용하는지 여부를 반환합니다. 절대 모드에서는 터치패드의 중앙이 (0,0) 위치로 간주됩니다. | Boolean |
함수 구문
gamepad_get_option(device, option_name);
인수 설명
| 인수 이름 | 타입 | 설명 |
|---|---|---|
| device | 정수 | 확인할 게임패드 장치 "슬롯" |
| option_name | 문자열 | 값을 가져올 옵션의 이름 (위의 표 참조) |
반환 값
- Boolean, Real, String 또는 N/A (플랫폼 및 옵션에 따라 다름)
활용 예제
다음은 gamepad_get_option 함수를 활용한 예제입니다.
예제 1: Siri Remote의 회전 허용 설정
for(var i = 0; i < 12; ++i) {
if (gamepad_is_connected(i) && gamepad_get_description(i) == "tvOS Siri Remote") {
if (gamepad_get_option(i, "allow_rotation") == false) {
gamepad_set_option(i, "allow_rotation", true);
}
}
}
이 코드는 모든 게임패드 슬롯을 반복하면서 tvOS 플랫폼에서 "Siri Remote"가 연결되어 있는지 확인합니다. 연결된 경우, 회전 입력을 허용하도록 설정합니다.
예제 2: 터치패드의 절대 입력 모드 확인
for(var i = 0; i < 12; ++i) {
if (gamepad_is_connected(i) && gamepad_get_description(i) == "tvOS Siri Remote") {
var is_absolute = gamepad_get_option(i, "dpad_absolute");
if (is_absolute) {
// 절대 입력 모드일 때의 처리
} else {
// 상대 입력 모드일 때의 처리
}
}
}
이 코드는 연결된 Siri Remote의 터치패드가 절대 입력 모드인지 확인하고, 그에 따라 다른 처리를 수행합니다.
예제 3: 게임패드 옵션을 기반으로 한 사용자 설정
for(var i = 0; i < 12; ++i) {
if (gamepad_is_connected(i)) {
var rotation_allowed = gamepad_get_option(i, "allow_rotation");
if (rotation_allowed) {
// 회전이 허용된 경우의 처리
} else {
// 회전이 허용되지 않은 경우의 처리
}
}
}
이 코드는 각 게임패드 슬롯에서 회전 허용 여부를 확인하고, 그에 따라 다른 처리를 수행합니다.