track *.wav with git-lfs

Replace AudioExtendSettings.Instance with local AssetDatabase-loaded field to avoid nullref when AudioSystem hasn't yet initialized.

.gitattributes

@@ -0,0 +1 @@
+*.wav filter=lfs diff=lfs merge=lfs -text

AGENTS.md

@@ -6,6 +6,13 @@ Unity 2022.3.62f3, URP, C#. Custom audio & haptic middleware under the namespace
 
 ---
 
+## Agent Guidelines
+
+- **称呼**：在沟通中始终称呼用户为「思谦」或「王思谦」。
+- **存疑必问**：遇到任何不确定、拿不准、信息缺失或模糊的情况，不要自行推测或假设。先收集、整理好所有问题，然后停下来向思谦提问确认。宁可多问，不要猜错。
+
+---
+
 ## Architecture
 
 ```
@@ -170,6 +177,25 @@ SfxSystem manages: throttle (`ThrottleCount`), min interval (`MinInterval`), pri
 - `HapticSystem.Instance.Stop(uint? hapticId = null)` — stops current haptic playback
 - Supports four `HapticType`s: `Preset`, `Emphasis`, `Constant`, `Advance` (`.haptic` file)
 
+#### Device capability & fallback
+
+`HapticController.Play()` (`Lofelt/.../HapticController.cs:350`) uses a three-tier decision chain:
+
+1. **Advanced device** (`DeviceCapabilities.meetsAdvancedRequirements`) → full `.haptic` playback via `LofeltHaptics`
+2. **Gamepad** (`GamepadRumbler.CanPlay()`) → gamepad rumble
+3. **Basic OS support** (`DeviceCapabilities.isVersionSupported`) → **always falls back to a Preset**
+4. None of above → silent no-op
+
+**Advance (`.haptic` file) fallback is Preset-only** — it never degrades to Emphasis or Constant. The fallback Preset is configured via `HapticObject.FallbackPreset` in the data table.
+
+| HapticType | Advanced | Android basic | iOS basic |
+|------------|----------|---------------|-----------|
+| **Advance** | Full `.haptic` | → Preset | → Preset |
+| **Emphasis** | JSON clip | 50ms max-amplitude pulse | → amplitude-mapped Preset |
+| **Constant** | JSON clip with modulation | max-amplitude for `duration` | → hardcoded `HeavyImpact` |
+
+Emphasis and Constant have their own internal fallback chains (template-based JSON clips on advanced, raw motor patterns or Presets on basic), but these are independent direct-invoke paths — they are never used as fallback targets for Advance.
+
 ---
 
 ## Interactive Music System

Assets/Resources/Audios/30-number-1.wav.meta

@@ -7,9 +7,9 @@ AudioImporter:
     serializedVersion: 2
     loadType: 2
     sampleRateSetting: 2
-    sampleRateOverride: 44100
+    sampleRateOverride: 22050
     compressionFormat: 1
-    quality: 0.13
+    quality: 0.5
     conversionMode: 0
     preloadAudioData: 1
   platformSettingOverrides: {}

Assets/Resources/Audios/30-number-2.wav.meta

@@ -7,9 +7,9 @@ AudioImporter:
     serializedVersion: 2
     loadType: 2
     sampleRateSetting: 2
-    sampleRateOverride: 44100
+    sampleRateOverride: 22050
     compressionFormat: 1
-    quality: 0.13
+    quality: 0.5
     conversionMode: 0
     preloadAudioData: 1
   platformSettingOverrides: {}

Assets/Resources/Audios/30-number-3.wav.meta

@@ -7,9 +7,9 @@ AudioImporter:
     serializedVersion: 2
     loadType: 2
     sampleRateSetting: 2
-    sampleRateOverride: 44100
+    sampleRateOverride: 22050
     compressionFormat: 1
-    quality: 0.13
+    quality: 0.5
     conversionMode: 0
     preloadAudioData: 1
   platformSettingOverrides: {}

Assets/Resources/Audios/30-number-4.wav.meta

@@ -7,9 +7,9 @@ AudioImporter:
     serializedVersion: 2
     loadType: 2
     sampleRateSetting: 2
-    sampleRateOverride: 44100
+    sampleRateOverride: 22050
     compressionFormat: 1
-    quality: 0.13
+    quality: 0.5
     conversionMode: 0
     preloadAudioData: 1
   platformSettingOverrides: {}

Assets/Resources/Audios/Master.mixer

@@ -249,8 +249,14 @@ AudioMixerController:
   m_EnableSuspend: 1
   m_UpdateMode: 0
   m_ExposedParameters:
+  - guid: d66e5a701962f484baca61ea5f29bab9
+    name: MusicVolume
   - guid: 9b4461d5598de4602b001fc9d34f76a7
     name: LowpassFreq
+  - guid: f9b2498f18d9c4346b50d00374df58fc
+    name: SFXVolume
+  - guid: 15cd4cd29b1a64dacb39ca2eda4de378
+    name: SFXAccentVolume
   m_AudioMixerGroupViews:
   - guids:
     - 3ef0a681afabf403eae42ddfe3bed37e
@@ -319,6 +325,7 @@ AudioMixerSnapshotController:
     676d0e59581a446dfb975928b4b3a4ea: 22000
     0053647b950eb4d8abf883dc07d6b4ef: 1
     47b8a12e60a1c4cf18d0d0c28f12866d: 440
+    f9b2498f18d9c4346b50d00374df58fc: 0
     c31161cf8dc3a48478fe71156b990b48: 1333
     d171c8cff3d664001b51b62c1b77ab53: 0
   m_TransitionOverrides: {}