feat: Add custom long tap delay

packages/flame/lib/src/events/component_mixins/tap_callbacks.dart

@@ -16,13 +16,18 @@ mixin TapCallbacks on Component {
   void onTapUp(TapUpEvent event) {}
   void onTapCancel(TapCancelEvent event) {}
 
+  /// The delay (in milliseconds) after which a tap is considered a long tap.
+  int get longTapDelay => 300;
+
   @override
   @mustCallSuper
   void onMount() {
     super.onMount();
     final game = findRootGame()!;
     if (game.findByKey(const MultiTapDispatcherKey()) == null) {
-      final dispatcher = MultiTapDispatcher();
+      final dispatcher = MultiTapDispatcher(
+          longTapDelay: longTapDelay,
+      );
       game.registerKey(const MultiTapDispatcherKey(), dispatcher);
       game.add(dispatcher);
     }

packages/flame/lib/src/events/flame_game_mixins/multi_tap_dispatcher.dart

@@ -23,9 +23,16 @@ class MultiTapDispatcherKey implements ComponentKey {
 
 @internal
 class MultiTapDispatcher extends Component implements MultiTapListener {
+  MultiTapDispatcher({
+    int longTapDelay = 300,
+  }) : _longTapDelay = longTapDelay;
+
   /// The record of all components currently being touched.
   final Set<TaggedComponent<TapCallbacks>> _record = {};
 
+  /// The delay (in milliseconds) after which a tap is considered a long tap.
+  final int _longTapDelay;
+
   FlameGame get game => parent! as FlameGame;
 
   /// Called when the user touches the device screen within the game canvas,
@@ -50,7 +57,7 @@ class MultiTapDispatcher extends Component implements MultiTapListener {
   }
 
   /// Called after the user has been touching the screen for [longTapDelay]
-  /// seconds without the tap being cancelled.
+  /// milliseconds without the tap being cancelled.
   ///
   /// This event will be delivered to all the components that previously
   /// received the `onTapDown` event, and who remain at the point where the user
@@ -118,9 +125,9 @@ class MultiTapDispatcher extends Component implements MultiTapListener {
 
   //#region MultiTapListener API
 
-  /// The delay (in seconds) after which a tap is considered a long tap.
+  /// The delay (in milliseconds) after which a tap is considered a long tap.
   @override
-  double get longTapDelay => 0.300;
+  int get longTapDelay => _longTapDelay;
 
   @override
   void handleTap(int pointerId) {}
@@ -157,7 +164,7 @@ class MultiTapDispatcher extends Component implements MultiTapListener {
       MultiTapGestureRecognizer.new,
       (MultiTapGestureRecognizer instance) {
         instance.longTapDelay = Duration(
-          milliseconds: (longTapDelay * 1000).toInt(),
+          milliseconds: longTapDelay,
         );
         instance.onTap = handleTap;
         instance.onTapDown = handleTapDown;

packages/flame/lib/src/events/game_mixins/multi_touch_tap_detector.dart

@@ -22,7 +22,7 @@ mixin MultiTouchTapDetector on Game implements MultiTapListener {
 
   //#region MultiTapListener API
   @override
-  double get longTapDelay => 0.300;
+  int get longTapDelay => 300;
 
   @override
   void handleTap(int pointerId) => onTap(pointerId);

packages/flame/lib/src/events/interfaces/multi_tap_listener.dart

@@ -10,7 +10,7 @@ import 'package:flutter/gestures.dart';
 ///  - [MultiTouchTapDetector] for a custom `Game`
 abstract class MultiTapListener {
   /// The amount of time before the "long tap down" event is triggered.
-  double get longTapDelay;
+  int get longTapDelay;
 
   /// A tap has occurred.
   void handleTap(int pointerId);

packages/flame/lib/src/game/game_widget/gesture_detector_builder.dart

@@ -157,7 +157,7 @@ class GestureDetectorBuilder {
         (MultiTapGestureRecognizer instance) {
           final g = game as MultiTapListener;
           instance.longTapDelay = Duration(
-            milliseconds: (g.longTapDelay * 1000).toInt(),
+            milliseconds: g.longTapDelay,
           );
           instance.onTap = g.handleTap;
           instance.onTapDown = g.handleTapDown;

packages/flame/test/events/component_mixins/tap_callbacks_test.dart

@@ -134,6 +134,20 @@ void main() {
       },
     );
 
+    testWidgets(
+      'TapCallbacks default long tap delay is 300ms',
+          (tester) async {
+        expect(_TapCallbacksComponent().longTapDelay, 300);
+      },
+    );
+
+    testWidgets(
+      'Custom TapCallbacks can override default long tap delay',
+          (tester) async {
+        expect(_CustomDelayTapCallbacksComponent().longTapDelay, 500);
+      },
+    );
+
     testWidgets(
       'tap outside of component is not registered as handled',
       (tester) async {
@@ -511,4 +525,10 @@ mixin _TapCounter on TapCallbacks {
 class _TapCallbacksComponent extends PositionComponent
     with TapCallbacks, _TapCounter {}
 
+class _CustomDelayTapCallbacksComponent extends PositionComponent
+    with TapCallbacks, _TapCounter {
+  @override
+  int get longTapDelay => 500;
+}
+
 class _TapCallbacksGame extends FlameGame with TapCallbacks, _TapCounter {}

packages/flame/test/events/game_mixins/multi_touch_tap_detector_test.dart

@@ -84,6 +84,23 @@ void main() {
         expect(game.nOnTapCancel, 2);
       },
     );
+
+    test(
+      'default longTapDelay is 300ms',
+      () {
+        final detector = _GameWithMultiTouchTapDetector();
+        expect(detector.longTapDelay, 300);
+      },
+    );
+
+    test(
+      'longTapDelay can be customized',
+      () {
+        final detector = _GameWithMultiTouchTapDetector();
+        detector.longTapDelayValue = 500;
+        expect(detector.longTapDelay, 500);
+      },
+    );
   });
 }
 
@@ -97,6 +114,11 @@ class _GameWithMultiTouchTapDetector extends Game with MultiTouchTapDetector {
   int nOnTap = 0;
   int nOnTapCancel = 0;
 
+  int? longTapDelayValue;
+
+  @override
+  int get longTapDelay => longTapDelayValue ?? super.longTapDelay;
+
   @override
   void render(Canvas canvas) => rendered = true;