> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputForceFeedbackParams

> GameInputForceFeedbackParams

# GameInputForceFeedbackParams

定義 API 支援的力回饋效果屬性。

## 語法

```cpp theme={null}
struct GameInputForceFeedbackParams
{
    GameInputForceFeedbackEffectKind kind;
    union
    {
        GameInputForceFeedbackConstantParams  constant;
        GameInputForceFeedbackRampParams      ramp;
        GameInputForceFeedbackPeriodicParams  sineWave;
        GameInputForceFeedbackPeriodicParams  squareWave;
        GameInputForceFeedbackPeriodicParams  triangleWave;
        GameInputForceFeedbackPeriodicParams  sawtoothUpWave;
        GameInputForceFeedbackPeriodicParams  sawtoothDownWave;
        GameInputForceFeedbackConditionParams spring;
        GameInputForceFeedbackConditionParams friction;
        GameInputForceFeedbackConditionParams damper;
        GameInputForceFeedbackConditionParams inertia;
    } data;
};
```

### 成員

*kind*<br />
類型：[GameInputForceFeedbackEffectKind](/zh-TW/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind)

定義力回饋效果的種類。

*constant*<br />
類型：[GameInputForceFeedbackConstantParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconstantparams)

固定力回饋效果。在效果持續期間以固定的程度施加力量。

*ramp*<br />
類型：[GameInputForceFeedbackRampParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackrampparams)

斜坡力回饋效果。在效果持續期間逐漸增加或減少所施加的力量。

*sineWave*<br />
類型：[GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams)

正弦波力回饋效果。以正弦波模式施加力量。

*squareWave*<br />
類型：[GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams)

方波力回饋效果。以方波模式施加力量。

*triangleWave*<br />
類型：[GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams)

三角波力回饋效果。以三角波模式施加力量。

*sawtoothUpWave*<br />
類型：[GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams)

上升鋸齒波力回饋效果。以上升鋸齒波模式施加力量。

*sawtoothDownWave*<br />
類型：[GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams)

下降鋸齒波力回饋效果。以下降鋸齒波模式施加力量。

*spring*<br />
類型：[GameInputForceFeedbackConditionParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconditionparams)

彈簧力回饋效果。施加與設定狀態相反的力量。

*friction*<br />
類型：[GameInputForceFeedbackConditionParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconditionparams)

摩擦力回饋效果。施加力量以模擬摩擦力。

*damper*<br />
類型：[GameInputForceFeedbackConditionParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconditionparams)

阻尼力回饋效果。施加力量以模擬阻尼效果。

*inertia*<br />
類型：[GameInputForceFeedbackConditionParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconditionparams)

慣性力回饋效果。施加力量以模擬慣性效果。

## 備註

力回饋效果由其參數定義。這些效果儲存在 `GameInputForceFeedbackParams` 結構中。每種力回饋效果的實際參數略有不同。所有種類效果的參數都會定義效果沿著馬達支援軸的強度，而大多數效果允許使用封套來影響效果隨時間變化的強度。

## 需求

**標頭：** GameInput.h

[GameInput 進階主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)\
[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInputForceFeedbackEffectKind](/zh-TW/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 推出。 |

## 概念文件

* [GameInput 上的力回饋](/zh-TW/build/core-features/common/input/advanced/input-forcefeedback)


## Related topics

- [GameInputForceFeedbackRampParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackrampparams.md)
- [GameInputForceFeedbackConstantParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackconstantparams.md)
- [GameInputForceFeedbackPeriodicParams](/zh-TW/reference/input/gameinput/structs/gameinputforcefeedbackperiodicparams.md)
- [IGameInputForceFeedbackEffect::SetParams](/zh-TW/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setparams.md)
- [IGameInputForceFeedbackEffect::GetParams](/zh-TW/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getparams.md)