Fighting Game · Guides & deep dives

V2 Audio Feedback Duplication

The audio feedback duplication profile lives in V2UI:

5sections1 minread
Markdown source
On this page

This runbook covers TODOS.phase-72.72.13.1.10: visual and haptic duplication for audio-only feedback, including screen flash for damage and controller vibration for events.

Runtime Surface#

The audio feedback duplication profile lives in V2UI:

  • C++ header: V2/ue/Source/V2UI/Public/V2AudioFeedbackDuplication.h
  • C++ source: V2/ue/Source/V2UI/Private/V2AudioFeedbackDuplication.cpp
  • automation spec: V2/ue/Source/V2Tests/Private/UI/AudioFeedbackDuplication.spec.cpp
  • contract: V2/ue/Content/V2/UI/Accessibility/AudioFeedbackDuplication_V2_Contract.json
  • focused checker: V2/ue/Tools/check-v2-audio-feedback-duplication.py

FV2AudioFeedbackDuplication::BuildDefaultProfile returns Accessibility.AudioFeedbackDuplication.V2 for the HUD.Accessibility.AudioFeedbackDuplication surface.

Duplication Rules#

Every required audio-only feedback cue resolves to an FV2AudioFeedbackDuplicateCue with visual and haptic metadata. Required cue types are Damage, CombatTiming, SystemEvent, QuestEvent, and EnvironmentalWarning.

The release profile includes:

  • screen flash plus controller vibration for Cue.PlayerDamage;
  • HUD meter pulse plus haptic pulse for Cue.ParryTiming;
  • icon or edge pulses plus controller vibration for system and quest events;
  • warning overlay plus heavy haptic pulse for environmental hazards.

Release Policy#

The profile is valid only when it:

  • duplicates all required audio-only feedback;
  • provides screen flash for damage;
  • provides controller vibration for events;
  • works when audio is muted;
  • has no audio-only state;
  • respects photosensitivity limits.

Verification#

Run these checks after changing audio feedback duplication:

bash
python3 V2/ue/Tools/check-v2-audio-feedback-duplication.py
python3 V2/ue/Tools/check-v2-ui-module.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 V2/tools/validate-v2-docs.py
python3 -m py_compile V2/ue/Tools/check-v2-audio-feedback-duplication.py V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/UI/Accessibility/AudioFeedbackDuplication_V2_Contract.json

Automation test name: V2.UI.Accessibility.AudioFeedbackDuplication.AssetContract.

Horde Gates#

  • audio-feedback-duplication-source
  • audio-feedback-duplication-required-cues
  • audio-feedback-duplication-damage-flash
  • audio-feedback-duplication-event-haptics
  • audio-feedback-duplication-muted-audio
  • audio-feedback-duplication-automation
  • audio-feedback-duplication-ci-wired