flame/examples/lib/stories/system/overlays_example.dart

import 'package:dashbook/dashbook.dart';
import 'package:flame/components.dart';
import 'package:flame/game.dart';
import 'package:flame/input.dart';
import 'package:flutter/material.dart';

class OverlaysExample extends FlameGame with TapDetector {
  static const String description = '''
    In this example we show how the overlays system can be used.\n\n
    If you tap the canvas the game will start and if you tap it again it will
    pause.
  ''';

  @override
  Future<void> onLoad() async {
    final animation = await loadSpriteAnimation(
      'animations/chopper.png',
      SpriteAnimationData.sequenced(
        amount: 4,
        textureSize: Vector2.all(48),
        stepTime: 0.15,
      ),
    );

    add(
      SpriteAnimationComponent(
        animation: animation,
      )
        ..position.y = size.y / 2
        ..position.x = 100
        ..anchor = Anchor.center
        ..size = Vector2.all(100),
    );

    // 'SecondaryMenu' will be displayed above 'PauseMenu'
    overlays.add('SecondaryMenu', priority: 1);
  }

  @override
  void onTap() {
    if (overlays.isActive('PauseMenu')) {
      overlays.remove('PauseMenu');
      resumeEngine();
    } else {
      overlays.add('PauseMenu');
      pauseEngine();
    }
  }
}

Widget _pauseMenuBuilder(
  BuildContext buildContext,
  OverlaysExample game,
  GestureTapCallback? onTap,
) {
  return Center(
    child: GestureDetector(
      onTap: onTap,
      child: Container(
        width: 100,
        height: 100,
        color: Colors.orange,
        child: const Center(
          child: Text('Paused'),
        ),
      ),
    ),
  );
}

Widget _secondaryMenuBuilder(BuildContext buildContext, OverlaysExample game) {
  return Align(
    alignment: Alignment.bottomRight,
    child: Padding(
      padding: const EdgeInsets.all(8.0),
      child: Container(
        width: 100,
        height: 50,
        alignment: Alignment.center,
        color: Colors.red,
        child: const Row(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Icon(Icons.music_off_rounded),
            Icon(Icons.info),
            Icon(Icons.star),
          ],
        ),
      ),
    ),
  );
}

Widget overlayBuilder(DashbookContext ctx) {
  return GameWidget<OverlaysExample>(
    game: OverlaysExample()..paused = true,
    overlayBuilderMap: {
      'PauseMenu': (context, game) => _pauseMenuBuilder(
            context,
            game,
            () => game.onTap(),
          ),
      'SecondaryMenu': _secondaryMenuBuilder,
    },
    initialActiveOverlays: const ['PauseMenu'],
  );
}