게임패드 버튼 누르기 (:down)
이 메서드는 20260805 이후 버전에서 사용할 수 있습니다
선언
상태, 오류 정보 = 게임패드 객체:down(버튼)
매개변수
- 버튼
정수 또는 문자열.
1~32의 정수, 아래 표의 버튼 이름, 또는"start","menu"를 전달할 수 있습니다. 문자열은 대소문자를 구분하지 않습니다.
| 번호 | 버튼 이름 | 별칭 |
|---|---|---|
| 1 | a | - |
| 2 | b | - |
| 3 | x | - |
| 4 | y | - |
| 5 | left_shoulder | left_bumper、lb、l1 |
| 6 | right_shoulder | right_bumper、rb、r1 |
| 7 | left_trigger | lt、l2 |
| 8 | right_trigger | rt、r2 |
| 9 | left_stick | l3 |
| 10 | right_stick | r3 |
| 11 | l4 | left_paddle |
| 12 | r4 | right_paddle |
| 13 | m1 | - |
| 14 | m2 | - |
| 15 | m3 | - |
| 16 | m4 | - |
반환값
- 상태 불리언. 작업에 성공하면 true를 반환하고, 기기의 연결이 끊겼거나 사용 중이거나 입력 전송에 실패하면 false를 반환합니다.
- 오류 정보 문자열. 작업이 실패했을 때의 오류 정보입니다.
설명
- 숫자
1~32는 숫자 버튼을 나타내며 기기 간에 통일된 게임 버튼 코드가 아닙니다. 일반적으로 위 표의 버튼 이름을 우선 사용해야 합니다. - 숫자
17~32에는 미리 정의된 이름이 없으며 대상 App이 해당 확장 버튼을 지원할 때만 동작합니다. "start"와"menu"는 같은 메뉴 입력의 별칭이며1~32중 특정 숫자에 해당하지 않습니다.select,back,options,home,share및 터치패드 버튼 이름은 현재 지원하지 않습니다.left_trigger와right_trigger는 누르기와 놓기만 지원하고 아날로그 압력 값은 지원하지 않습니다.menu는 시스템 홈 화면 동작을 트리거하지 않습니다.- 잘못된 인수 형식, 알 수 없는 이름, 범위를 벗어난 값은
false, error를 반환하는 대신 Lua 인수 오류를 발생시킵니다.
예제
local pad = assert(gamepad.connect())
assert(pad:down("left_shoulder"))
assert(pad:up("left_shoulder"))
assert(pad:down(13)) -- 숫자 버튼 13
assert(pad:up(13))
assert(pad:disconnect())