Chuyển tới nội dung chính

! Nhấn một lần nút trên tay cầm (:press)

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

Khai báo​

trạng thái, thông báo lỗi = đối tượng tay cầm chơi game:press(phím [, thời gian nhấn ])

Tham số​

  • phím
    Kiểu số nguyên hoặc chuỗi. Xem tham số nút để biết các số và tên được hỗ trợ.
  • thời gian nhấn
    Số hữu hạn không âm, không bắt buộc. Thời gian giữ nút, tính bằng mili giây. Mặc định: 60.

Giá trị trả về​

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

Mô tả​

  • Chỉ nhấn rồi nhả nút đích mà không thay đổi các nút khác đang được giữ.
  • Lời gọi thất bại nếu nút đích đã ở trạng thái được giữ.
  • Trong khi chờ hết thời gian giữ, press sẽ nhường quyền thực thi của luồng Lua hiện tại. Trong thời gian này, các thao tác khác trên cùng tay cầm trả về false, "hardware gamepad is busy"; các đối tượng tay cầm khác vẫn hoạt động độc lập.
  • 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.

Ví dụ​

local pad = assert(gamepad.connect())

assert(pad:press("a"))
assert(pad:press("menu"))
assert(pad:press(32))
assert(pad:disconnect())