このページでは

XrHapticFeedback QML Type

XRコントローラーのハプティックフィードバックを制御します。詳細...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.9
Inherits:

QtObject

Status: Technology preview

このタイプはテクノロジープレビュー段階にあり、変更される可能性があります。

プロパティ

方法

詳細な説明

ハプティックフィードバックとは、通常、何らかのイベントが発生した際に、コントローラーに短い振動を与えることで触覚的な体験を提供するものです。これにより、例えばボタンに触れているような錯覚を生み出すことができます。

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.RisingEdgetrigger がfalse からtrue に変化した時点で、ハプティック効果が開始されます。
XrHapticFeedback.TrailingEdgetrigger が `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.