fix(player): 修正飘心Overlay生命周期

lib/pages/player/widgets/player_heart_overlay_scope.dart

@@ -0,0 +1,52 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/foundation.dart';
+import 'package:flutter/widgets.dart';
+
+/// Tracks heart overlays for the lifetime of one player page.
+class PlayerHeartOverlayController {
+  final Map<int, OverlayEntry> _entries = {};
+
+  void track(int id, OverlayEntry entry) {
+    _entries[id] = entry;
+  }
+
+  void untrack(int id) {
+    _entries.remove(id);
+  }
+
+  void dispose() {
+    for (final entry in _entries.entries.toList()) {
+      if (entry.value.mounted) entry.value.remove();
+      entry.value.dispose();
+      if (kDebugMode) {
+        debugPrint(
+          '[player] phase=heart-burst-entry-removed '
+          'id=${entry.key} reason=page-dispose',
+        );
+      }
+    }
+    _entries.clear();
+  }
+}
+
+class PlayerHeartOverlayScope extends InheritedWidget {
+  const PlayerHeartOverlayScope({
+    super.key,
+    required this.controller,
+    required super.child,
+  });
+
+  final PlayerHeartOverlayController controller;
+
+  static PlayerHeartOverlayController? maybeOf(BuildContext context) {
+    return context
+        .dependOnInheritedWidgetOfExactType<PlayerHeartOverlayScope>()
+        ?.controller;
+  }
+
+  @override
+  bool updateShouldNotify(PlayerHeartOverlayScope oldWidget) {
+    return controller != oldWidget.controller;
+  }
+}

lib/pages/player/widgets/player_tap_gesture_region.dart

@@ -6,6 +6,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 
 import 'player_double_tap_hearts.dart';
+import 'player_heart_overlay_scope.dart';
 
 typedef PlayerLongPressStartCallback =
     void Function(LongPressStartDetails details, double width);
@@ -48,18 +49,11 @@ class _PlayerTapGestureRegionState extends State<PlayerTapGestureRegion> {
   int _downSerial = 0;
   int _tapSeq = 0;
   int _nextHeartBurstId = 0;
-  final Map<int, OverlayEntry> _heartOverlayEntries = {};
 
   @override
   void dispose() {
     _tapSeq++;
     _singleTapTimer?.cancel();
-    for (final entry in _heartOverlayEntries.values.toList()) {
-      entry
-        ..remove()
-        ..dispose();
-    }
-    _heartOverlayEntries.clear();
     super.dispose();
   }
 
@@ -161,7 +155,20 @@ class _PlayerTapGestureRegionState extends State<PlayerTapGestureRegion> {
         ? overlayBox.globalToLocal(globalPosition)
         : globalPosition;
     final id = _nextHeartBurstId++;
+    final controller = PlayerHeartOverlayScope.maybeOf(context);
+    var removed = false;
     late final OverlayEntry entry;
+    void removeEntry() {
+      if (removed) return;
+      removed = true;
+      controller?.untrack(id);
+      if (entry.mounted) entry.remove();
+      entry.dispose();
+      if (kDebugMode) {
+        debugPrint('[player] phase=heart-burst-entry-removed id=$id');
+      }
+    }
+
     entry = OverlayEntry(
       builder: (context) => Positioned.fill(
         child: IgnorePointer(
@@ -169,26 +176,15 @@ class _PlayerTapGestureRegionState extends State<PlayerTapGestureRegion> {
             key: ValueKey('heart-overlay-$id'),
             burstId: id,
             origin: origin,
-            onCompleted: () => _removeHeartOverlay(id),
+            onCompleted: removeEntry,
           ),
         ),
       ),
     );
-    _heartOverlayEntries[id] = entry;
+    controller?.track(id, entry);
     overlay.insert(entry);
   }
 
-  void _removeHeartOverlay(int id) {
-    final entry = _heartOverlayEntries.remove(id);
-    if (entry == null) return;
-    entry
-      ..remove()
-      ..dispose();
-    if (kDebugMode) {
-      debugPrint('[player] phase=heart-burst-entry-removed id=$id');
-    }
-  }
-
   void _handleLongPressStart(LongPressStartDetails details, double width) {
     _tapSeq++;
     _cancelPendingSingleTap();