Nhấn giữ nút trên tay cầm (:down)

Phương thức này chỉ khả dụng trên các phiên bản sau 20260805

Khai báo

success, err = pad:down(button)

Tham số

• button Kiểu số nguyên hoặc chuỗi. Có thể truyền số nguyên từ 1 đến 32, một trong các tên bên dưới, hoặc "start", "menu"; việc so khớp chuỗi không phân biệt chữ hoa chữ thường.

Số	Tên nút	Bí danh
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	-

Giá trị trả về

• success Kiểu boolean. Trả về true nếu thao tác thành công; trả về false nếu thiết bị đã ngắt kết nối, đang bận hoặc gửi đầu vào thất bại.
• err Kiểu chuỗi. Thông báo lỗi khi thao tác thất bại.

Mô tả

• Các giá trị số từ 1 đến 32 biểu thị nút số, không phải mã nút được chuẩn hóa giữa các thiết bị. Nên ưu tiên dùng tên trong bảng khi có thể.
• Các nút số từ 17 đến 32 không có tên định sẵn và chỉ có tác dụng khi ứng dụng đích hỗ trợ nút mở rộng tương ứng.
• "start" và "menu" là bí danh của cùng một đầu vào trình đơn, không tương ứng với nút số nào từ 1 đến 32.
• Hiện chưa hỗ trợ các tên select, back, options, home, share và nút bàn di chuột.
• left_trigger và right_trigger chỉ hỗ trợ trạng thái nhấn hoặc nhả, không hỗ trợ giá trị áp lực analog. menu không kích hoạt thao tác về Màn hình chính của hệ thống.
• Kiểu đối số không hợp lệ, tên không xác định và giá trị vượt phạm vi sẽ phát sinh lỗi đối số Lua thay vì trả về false, error.

Ví dụ

local pad = assert(gamepad.connect())

assert(pad:down("left_shoulder"))
assert(pad:up("left_shoulder"))
assert(pad:down(13))  -- nút số 13
assert(pad:up(13))
assert(pad:disconnect())