게임패드 옵션 설정 함수
gamepad_set_option 함수는 사용 가능한 게임패드 옵션을 설정하는 데 사용됩니다. 이 함수는 설정할 게임패드 "슬롯"과 설정할 옵션 문자열, 그리고 사용할 값을 입력받습니다. 사용 가능한 옵션 문자열은 프로젝트가 실행되는 플랫폼에 따라 다릅니다.
옵션 설명
| 옵션 이름 | 플랫폼 | 설명 | 값 유형 |
|---|---|---|---|
| "allow_rotation" | tvOS | Siri Remote의 회전 잠금 여부를 설정합니다. 잠금 해제 시(값이 true) 입력이 기기의 방향에 따라 변경됩니다. | Boolean |
| "dpad_absolute" | tvOS | Siri Remote 터치패드가 절대 입력을 수용할지 상대 입력을 수용할지를 설정합니다. 절대 모드(값이 true)에서는 터치패드의 중앙이 (0,0) 위치로 간주됩니다. | Boolean |
함수 문법
gamepad_set_option(device, option_name, value);
인수 설명
| 인수 이름 | 유형 | 설명 |
|---|---|---|
| device | Real | 설정할 게임패드 장치 "슬롯" |
| option_name | String | 설정할 옵션의 이름 (위의 표 참조) |
| value | Real, Boolean, String | 옵션에 설정할 값 (위의 표 참조) |
예제 코드
다음 코드는 모든 게임패드 슬롯을 반복하며 tvOS 플랫폼에서 "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);
}
}
}
활용 예제
- 회전 잠금 해제: 사용자가 게임을 플레이할 때 Siri Remote의 회전 잠금을 해제하여 다양한 입력을 허용합니다.
gml gamepad_set_option(0, "allow_rotation", true);
- 절대 입력 모드 설정: 터치패드의 중앙을 기준으로 입력을 받도록 설정합니다.
gml gamepad_set_option(0, "dpad_absolute", true);
- 상대 입력 모드 설정: 터치패드의 초기 터치 위치를 기준으로 입력을 받도록 설정합니다.
gml gamepad_set_option(0, "dpad_absolute", false);
- 여러 게임패드 설정: 여러 게임패드의 옵션을 동시에 설정하여 일관된 사용자 경험을 제공합니다.
gml for(var i = 0; i < 12; ++i;){ if (gamepad_is_connected(i)){ gamepad_set_option(i, "allow_rotation", true); gamepad_set_option(i, "dpad_absolute", false); } }