ゲームパッドのボタンを押す (: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())