Skip to content
Hapbeat devtools
EN

Trigger コンポーネント

This content is not available in your language yet.

Hapbeat SDK は多様な Trigger コンポーネントを用意しており、コードを書かずに触覚を組み込めます。

一覧

Section titled “一覧”
コンポーネント発火タイミング主な用途参考 Showcase Zone
HapbeatUnityEventTriggerUnityEvent から Fire() を呼ぶUI Button / XR Interactable / Animation Event 等Z5 Charge
HapbeatStateBehaviourAnimator state Enter / Exitキャラクターアクション、UI アニメーション、ドア開閉等Z2 Door
HapbeatCollisionTriggerOnCollision / OnTrigger衝突、当たり判定、銃弾命中Z1 Bowling
HapbeatSequenceTriggergrab / hold / release の 3 段階XR Interaction（つかむ・持つ・離す）Z3 Fishing
HapbeatTickEmitter連続値の変化量に応じてスナップ発火Slider / ScrollRect 等のスクロール触覚Z4 Stream Console

HapbeatUnityEventTrigger

Section titled “HapbeatUnityEventTrigger”

UnityEvent（Button.OnClick / XRI Activate / Animation Event 等）の Fire() メソッドを紐付けて発火します。コードなしで任意の UnityEvent から触覚を呼べます。

設定:

  • Event Map: EventMap.asset を参照
  • Event: EventMap 内のエントリをドロップダウンで選択
On Activated:
  [Hapbeat Event Router] → HapbeatUnityEventTrigger.Fire()

HapbeatStateBehaviour

Section titled “HapbeatStateBehaviour”

AnimatorController の state に直接 attach する StateMachineBehaviour 派生。state Enter / Exit の瞬間に Animator runtime から直接呼ばれるため、scene 側 MonoBehaviour で Animator パラメータを poll する方式より遅延も発火条件も明快です。

通常の Trigger と違い、Add Component メニューには出ません。Animator window で対象 state を選択 → Inspector → Add Behaviour → Hapbeat State Behaviour で追加します。

設定:

  • Event Map: EventMap.asset
  • Entry On Enter / Entry On Exit: state 遷移ごとに別エントリを発火可能（片方だけでも OK）
  • Required Previous State: 非空時は「指定 state からの遷移時のみ Enter 発火」（例: Closed → LockedRattle だけ鳴らす、など）
  • Gain Multiplier: entry gain × manifest intensity への追加倍率

実装上の特徴:

  • looping StreamClip を Enter で発火した場合、Exit で 自動的に Stop されるので「state に紐付く擦り音」がクリーンに切れます
  • 参照フィールド (EventMap 等) は AnimatorController asset 上に保存される（ScriptableObject 同士の参照なので scene 依存なし）
  • Showcase Z2 Door: Open / Closed state に各 1 個ずつ attach して door_open / door_close を発火

HapbeatCollisionTrigger

Section titled “HapbeatCollisionTrigger”

Collision / Trigger イベントで発火。速度連動 (Gain Mode: VelocityScaled) が可能。

設定:

  • Tag Filter: 反応するオブジェクトの Tag（空 = 全対象）
  • Layer Mask: レイヤーフィルタ
  • Gain Mode: Fixed（固定）/ VelocityScaled（速度連動）
  • Min Velocity: これ以下の速度では発火しない
  • Cooldown: 連続発火防止（秒）

強い衝撃ほど強い触覚、というマッピングが組めます。

HapbeatSequenceTrigger

Section titled “HapbeatSequenceTrigger”

XR Interaction Toolkit や独自の grab system と組み合わせ、3 段階の Event を 1 コンポーネントで管理します。

設定:

  • On Grab: つかんだ瞬間の Event（例: bowling.grab）
  • On Hold: 持っている間の継続 Event（CLIP 推奨、例: bowling.hold）
  • On Release: 離した瞬間の Event（例: bowling.release）

XR Helpers サンプル (Samples~/XriHelpers/) を Import すれば XRGrabInteractable / XRSocketInteractor との接続が自動でセットアップできます（プロジェクト側で XRI を導入していなくても scaffold 自体は壊れません）。

HapbeatTickEmitter

Section titled “HapbeatTickEmitter”

Slider / ScrollRect などの連続値の変化量に応じて、スナップアルゴリズムでトリガーします。

  • Cooldown 不要（アルゴリズムが連続発火を自制）
  • snap interval で感度を調整

ParameterBinding と組み合わせる

Section titled “ParameterBinding と組み合わせる”

HapbeatParameterBinding を併用すると、Transform / Rigidbody の値を StreamClip の gain / pan に毎フレームマッピングできます。

例: 距離が近いほど触覚を強くする、移動速度が上がるほど振動が強まる。

詳細は Parameter Binding

デバッグ

Section titled “デバッグ”

メニューバー → Hapbeat → Debug → Attach Event Logger to Selected を実行すると、選択中 GameObject の UnityEvent 発火をコンソールにログ出力できます。XRI のイベント発火順序の可視化に有効です。

詳細ログを記録する場合: Hapbeat → Debug → Logs → Start Recording

次のステップ

Section titled “次のステップ”