XrHapticFeedback QML Type
XRコントローラーのハプティックフィードバックを制御します。詳細...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.9 |
| Inherits: | |
| Status: | Technology preview |
このタイプはテクノロジープレビュー段階にあり、変更される可能性があります。
プロパティ
- condition : enumeration
- controller : enumeration
- hapticEffect : XrHapticEffect
- trigger : bool
方法
詳細な説明
ハプティックフィードバックとは、通常、何らかのイベントが発生した際に、コントローラーに短い振動を与えることで触覚的な体験を提供するものです。これにより、例えばボタンに触れているような錯覚を生み出すことができます。
XrHapticFeedback を使用するには、2つの方法があります:
以下のコードは、someObject.hit プロパティの値がfalse からtrue に変化した際に、右側のコントローラーを振動させます:
XrHapticFeedback {
controller: XrHapticFeedback.RightController
condition: XrHapticFeedback.RisingEdge
trigger: someObject.hit
hapticEffect: XrSimpleHapticEffect {
amplitude: 0.5
duration: 300
frequency: 3000
}
}プロパティのドキュメント
condition : enumeration [default: XrHapticFeedback.RisingEdge]
このハプティックフィードバックをトリガーするための条件。
このプロパティは、trigger プロパティがどのように解釈されるかを指定します。
以下のいずれかになります:
| 定数 | 説明 |
|---|---|
XrHapticFeedback.RisingEdge | trigger がfalse からtrue に変化した時点で、ハプティック効果が開始されます。 |
XrHapticFeedback.TrailingEdge | trigger が `true ` から `false` に変化したときに、ハプティック効果が開始されます。 |
controller : enumeration
このハプティックフィードバックが適用されるコントローラー。
以下のいずれかになります:
| 定数 | 値 |
|---|---|
XrHapticFeedback.LeftController | |
XrHapticFeedback.RightController | |
XrHapticFeedback.UnknownController |
hapticEffect : XrHapticEffect
このプロパティは、ハプティックフィードバックがトリガーされた際にコントローラーに適用される効果を表します。
trigger : bool
ハプティックフィードバックのトリガー
このプロパティは、ハプティック効果がどのような操作に反応するかを定義します。condition プロパティは、トリガーがどのように解釈されるかを決定します。
「 start 」および「condition 」も参照してください 。
メソッドのドキュメント
void start()
ハプティックフィードバック効果を開始します。
void stop()
ハプティックフィードバック効果を停止します。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.