目次 - SDL 3.0 API(機能別) - ジョイスティック - SDL_RumbleJoystickTriggers

SDL_RumbleJoystickTriggers

ジョイスティックのトリガーの振動を開始する

ヘッダ

SDL3/SDL_joystick.h

構文

bool SDL_RumbleJoystickTriggers(SDL_Joystick *joystick, Uint16 left_rumble, Uint16 right_rumble, Uint32 duration_ms);

引数

SDL_Joystick *joystick振動させるジョイスティック
Uint16low_frequency_rumble低周波数(左)振動モーターの強度. 0から0xFFFF
Uint16high_frequency_rumble高周波数(右)振動モーターの強度. 0から0xFFFF
Uint32duration_ms振動効果のミリ秒単位の時間

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

この関数の呼び出しのたびに以前の振動は取り消されるため, 強度を0として呼び出すと振動を止めることができる.

これはジョイスティック全体ではなくトリガーを振動させる. 現在はXbox Oneのコントローラのみ対応している. (より一般的に)コントローラ全体を振動させたい場合は, 代わりにSDL_RumbleJoystick()を使うこと.

この関数はSDLイベント処理が行われるか, SDL_UpdateJoysticks()を呼んで振動を更新する必要がある.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_RumbleJoystickTriggers - SDL Wiki