次の方法で共有


SetRumbleState

デバイス上の 4 つの振動モーターに必要な強度を設定します。

構文

void SetRumbleState(  
         const GameInputRumbleParams* params  
)  

パラメーター

params _In_opt_
型: GameInputRumbleParams*

それぞれの振動モーターに必要な強度を含む構造体。 振動モーターの強度の範囲は 0.0 から 1.0 までです。

戻り値

型: void

解説

SetRumbleState メソッドは、デバイス上の 4 つの振動モーターに必要な強度を設定します。 他のフィードバックの種類と同様に、これはいつでもアプリケーションで呼び出すことができますが、アプリケーションにフォーカスがある間のみデバイスに適用されます。

できるだけシンプルにするために、アプリケーションではデバイスでサポートされる振動モーターを確認する必要はなく、4 つのモーターすべての強度を指定できます。 デバイスに 4 つのモーターのいずれかがない場合、GameInput 実装は他のモーターに強度を追加して、依然としてユーザーがフィードバック量を感じるようにすることで適応しようとします。 たとえば、高周波振動モーターに少量の他の振動強度を追加することで、2 モーター ゲームパッド上でトリガーの振動値がエミュレートされます。

切断されていたデバイス、または振動モーターがないデバイスでは、SetRumbleState メソッドを呼び出しても何も起こりません。 モーター強度値の範囲は [0.0, 1.0] です。 この範囲外で指定された値は最も近い有効値にクランプされます。

要件

ヘッダー: GameInput.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

GameInput の概要
GameInputRumbleParams
IGameInputDevice