Merge remote-tracking branch 'origin' into refactor/plunger-behaviors

lib/app/view/app.dart

@@ -9,21 +9,29 @@ import 'package:pinball/select_character/select_character.dart';
 import 'package:pinball/start_game/start_game.dart';
 import 'package:pinball_audio/pinball_audio.dart';
 import 'package:pinball_ui/pinball_ui.dart';
+import 'package:platform_helper/platform_helper.dart';
+import 'package:share_repository/share_repository.dart';
 
 class App extends StatelessWidget {
   const App({
     Key? key,
     required AuthenticationRepository authenticationRepository,
     required LeaderboardRepository leaderboardRepository,
+    required ShareRepository shareRepository,
     required PinballAudioPlayer pinballAudioPlayer,
+    required PlatformHelper platformHelper,
   })  : _authenticationRepository = authenticationRepository,
         _leaderboardRepository = leaderboardRepository,
+        _shareRepository = shareRepository,
         _pinballAudioPlayer = pinballAudioPlayer,
+        _platformHelper = platformHelper,
         super(key: key);
 
   final AuthenticationRepository _authenticationRepository;
   final LeaderboardRepository _leaderboardRepository;
+  final ShareRepository _shareRepository;
   final PinballAudioPlayer _pinballAudioPlayer;
+  final PlatformHelper _platformHelper;
 
   @override
   Widget build(BuildContext context) {
@@ -31,7 +39,9 @@ class App extends StatelessWidget {
       providers: [
         RepositoryProvider.value(value: _authenticationRepository),
         RepositoryProvider.value(value: _leaderboardRepository),
+        RepositoryProvider.value(value: _shareRepository),
         RepositoryProvider.value(value: _pinballAudioPlayer),
+        RepositoryProvider.value(value: _platformHelper),
       ],
       child: MultiBlocProvider(
         providers: [

lib/assets_manager/cubit/assets_manager_cubit.dart

@@ -18,7 +18,7 @@ class AssetsManagerCubit extends Cubit<AssetsManagerState> {
     /// delay here, which is a bit random in duration but enough to let the UI
     /// do its job without adding too much delay for the user, we are letting
     /// the UI paint first, and then we start loading the assets.
-    await Future<void>.delayed(const Duration(milliseconds: 300));
+    await Future<void>.delayed(const Duration(seconds: 1));
     emit(
       state.copyWith(
         loadables: [

lib/assets_manager/views/assets_loading_page.dart

@@ -17,29 +17,32 @@ class AssetsLoadingPage extends StatelessWidget {
   Widget build(BuildContext context) {
     final l10n = context.l10n;
     final headline1 = Theme.of(context).textTheme.headline1;
-    return Center(
+    return Container(
-      child: Column(
+      decoration: const CrtBackground(),
-        mainAxisSize: MainAxisSize.min,
+      child: Center(
-        children: [
+        child: Column(
-          Padding(
+          mainAxisSize: MainAxisSize.min,
-            padding: const EdgeInsets.symmetric(horizontal: 20),
+          children: [
-            child: Assets.images.loadingGame.ioPinball.image(),
+            Padding(
-          ),
+              padding: const EdgeInsets.symmetric(horizontal: 20),
-          const SizedBox(height: 40),
+              child: Assets.images.loadingGame.ioPinball.image(),
-          AnimatedEllipsisText(
-            l10n.loading,
-            style: headline1,
-          ),
-          const SizedBox(height: 40),
-          FractionallySizedBox(
-            widthFactor: 0.8,
-            child: BlocBuilder<AssetsManagerCubit, AssetsManagerState>(
-              builder: (context, state) {
-                return PinballLoadingIndicator(value: state.progress);
-              },
             ),
-          ),
+            const SizedBox(height: 40),
-        ],
+            AnimatedEllipsisText(
+              l10n.loading,
+              style: headline1,
+            ),
+            const SizedBox(height: 40),
+            FractionallySizedBox(
+              widthFactor: 0.8,
+              child: BlocBuilder<AssetsManagerCubit, AssetsManagerState>(
+                builder: (context, state) {
+                  return PinballLoadingIndicator(value: state.progress);
+                },
+              ),
+            ),
+          ],
+        ),
       ),
     );
   }

lib/game/behaviors/ball_theming_behavior.dart

@@ -1,20 +0,0 @@
-import 'package:flame/components.dart';
-import 'package:flame_bloc/flame_bloc.dart';
-import 'package:pinball/select_character/select_character.dart';
-import 'package:pinball_components/pinball_components.dart';
-
-/// Updates the launch [Ball] to reflect character selections.
-class BallThemingBehavior extends Component
-    with
-        FlameBlocListenable<CharacterThemeCubit, CharacterThemeState>,
-        HasGameRef {
-  @override
-  void onNewState(CharacterThemeState state) {
-    gameRef
-        .descendants()
-        .whereType<Ball>()
-        .single
-        .bloc
-        .onThemeChanged(state.characterTheme);
-  }
-}

lib/game/behaviors/behaviors.dart

@@ -1,7 +1,9 @@
 export 'ball_spawning_behavior.dart';
-export 'ball_theming_behavior.dart';
 export 'bonus_ball_spawning_behavior.dart';
 export 'bonus_noise_behavior.dart';
 export 'bumper_noise_behavior.dart';
 export 'camera_focusing_behavior.dart';
+export 'character_selection_behavior.dart';
+export 'cow_bumper_noise_behavior.dart';
+export 'kicker_noise_behavior.dart';
 export 'scoring_behavior.dart';

lib/game/behaviors/character_selection_behavior.dart

@@ -0,0 +1,31 @@
+import 'package:flame/components.dart';
+import 'package:flame_bloc/flame_bloc.dart';
+import 'package:pinball/select_character/select_character.dart';
+import 'package:pinball_components/pinball_components.dart';
+import 'package:pinball_flame/pinball_flame.dart';
+import 'package:platform_helper/platform_helper.dart';
+
+/// Updates the [ArcadeBackground] and launch [Ball] to reflect character
+/// selections.
+class CharacterSelectionBehavior extends Component
+    with
+        FlameBlocListenable<CharacterThemeCubit, CharacterThemeState>,
+        HasGameRef {
+  @override
+  void onNewState(CharacterThemeState state) {
+    if (!readProvider<PlatformHelper>().isMobile) {
+      gameRef
+          .descendants()
+          .whereType<ArcadeBackground>()
+          .single
+          .bloc
+          .onCharacterSelected(state.characterTheme);
+    }
+    gameRef
+        .descendants()
+        .whereType<Ball>()
+        .single
+        .bloc
+        .onCharacterSelected(state.characterTheme);
+  }
+}

lib/game/behaviors/cow_bumper_noise_behavior.dart

@@ -0,0 +1,13 @@
+// ignore_for_file: public_member_api_docs
+
+import 'package:flame_forge2d/flame_forge2d.dart';
+import 'package:pinball_audio/pinball_audio.dart';
+import 'package:pinball_flame/pinball_flame.dart';
+
+class CowBumperNoiseBehavior extends ContactBehavior {
+  @override
+  void beginContact(Object other, Contact contact) {
+    super.beginContact(other, contact);
+    readProvider<PinballAudioPlayer>().play(PinballAudio.cowMoo);
+  }
+}

lib/game/behaviors/kicker_noise_behavior.dart

@@ -0,0 +1,11 @@
+import 'package:flame_forge2d/flame_forge2d.dart';
+import 'package:pinball_audio/pinball_audio.dart';
+import 'package:pinball_flame/pinball_flame.dart';
+
+class KickerNoiseBehavior extends ContactBehavior {
+  @override
+  void beginContact(Object other, Contact contact) {
+    super.beginContact(other, contact);
+    readProvider<PinballAudioPlayer>().play(PinballAudio.kicker);
+  }
+}

lib/game/bloc/game_bloc.dart

@@ -16,6 +16,8 @@ class GameBloc extends Bloc<GameEvent, GameState> {
     on<GameStarted>(_onGameStarted);
   }
 
+  static const _maxScore = 9999999999;
+
   void _onGameStarted(GameStarted _, Emitter emit) {
     emit(state.copyWith(status: GameStatus.playing));
   }
@@ -25,7 +27,10 @@ class GameBloc extends Bloc<GameEvent, GameState> {
   }
 
   void _onRoundLost(RoundLost event, Emitter emit) {
-    final score = state.totalScore + state.roundScore * state.multiplier;
+    final score = math.min(
+      state.totalScore + state.roundScore * state.multiplier,
+      _maxScore,
+    );
     final roundsLeft = math.max(state.rounds - 1, 0);
 
     emit(
@@ -41,9 +46,11 @@ class GameBloc extends Bloc<GameEvent, GameState> {
 
   void _onScored(Scored event, Emitter emit) {
     if (state.status.isPlaying) {
-      emit(
+      final combinedScore = math.min(
-        state.copyWith(roundScore: state.roundScore + event.points),
+        state.totalScore + state.roundScore + event.points,
+        _maxScore,
       );
+      emit(state.copyWith(roundScore: combinedScore - state.totalScore));
     }
   }
 

lib/game/components/android_acres/android_acres.dart

@@ -48,6 +48,7 @@ class AndroidAcres extends Component {
                   children: [
                     ScoringContactBehavior(points: Points.twentyThousand),
                     BumperNoiseBehavior(),
+                    CowBumperNoiseBehavior(),
                   ],
                 )..initialPosition = Vector2(-20.7, -13),
                 AndroidSpaceshipBonusBehavior(),

lib/game/components/backbox/backbox.dart

@@ -6,10 +6,13 @@ import 'package:leaderboard_repository/leaderboard_repository.dart';
 import 'package:pinball/game/components/backbox/bloc/backbox_bloc.dart';
 import 'package:pinball/game/components/backbox/displays/displays.dart';
 import 'package:pinball/game/game.dart';
+import 'package:pinball/l10n/l10n.dart';
 import 'package:pinball_components/pinball_components.dart';
 import 'package:pinball_flame/pinball_flame.dart';
 import 'package:pinball_theme/pinball_theme.dart' hide Assets;
+import 'package:pinball_ui/pinball_ui.dart';
 import 'package:platform_helper/platform_helper.dart';
+import 'package:share_repository/share_repository.dart';
 
 /// {@template backbox}
 /// The [Backbox] of the pinball machine.
@@ -18,24 +21,25 @@ class Backbox extends PositionComponent with ZIndex, HasGameRef {
   /// {@macro backbox}
   Backbox({
     required LeaderboardRepository leaderboardRepository,
+    required ShareRepository shareRepository,
     required List<LeaderboardEntryData>? entries,
   })  : _bloc = BackboxBloc(
           leaderboardRepository: leaderboardRepository,
           initialEntries: entries,
         ),
-        _platformHelper = PlatformHelper();
+        _shareRepository = shareRepository;
 
   /// {@macro backbox}
   @visibleForTesting
   Backbox.test({
     required BackboxBloc bloc,
-    required PlatformHelper platformHelper,
+    required ShareRepository shareRepository,
   })  : _bloc = bloc,
-        _platformHelper = platformHelper;
+        _shareRepository = shareRepository;
 
+  final ShareRepository _shareRepository;
   late final Component _display;
   final BackboxBloc _bloc;
-  final PlatformHelper _platformHelper;
   late StreamSubscription<BackboxState> _subscription;
 
   @override
@@ -68,7 +72,7 @@ class Backbox extends PositionComponent with ZIndex, HasGameRef {
     } else if (state is LeaderboardFailureState) {
       _display.add(LeaderboardFailureDisplay());
     } else if (state is InitialsFormState) {
-      if (_platformHelper.isMobile) {
+      if (readProvider<PlatformHelper>().isMobile) {
         gameRef.overlays.add(PinballGame.mobileControlsOverlay);
       }
       _display.add(
@@ -87,6 +91,8 @@ class Backbox extends PositionComponent with ZIndex, HasGameRef {
         ),
       );
     } else if (state is InitialsSuccessState) {
+      gameRef.overlays.remove(PinballGame.mobileControlsOverlay);
+
       _display.add(
         GameOverInfoDisplay(
           onShare: () {
@@ -94,6 +100,20 @@ class Backbox extends PositionComponent with ZIndex, HasGameRef {
           },
         ),
       );
+    } else if (state is ShareState) {
+      _display.add(
+        ShareDisplay(
+          onShare: (platform) {
+            final message = readProvider<AppLocalizations>()
+                .iGotScoreAtPinball(state.score.formatScore());
+            final url = _shareRepository.shareText(
+              value: message,
+              platform: platform,
+            );
+            openLink(url);
+          },
+        ),
+      );
     } else if (state is InitialsFailureState) {
       _display.add(
         InitialsSubmissionFailureDisplay(

lib/game/components/backbox/bloc/backbox_bloc.dart

@@ -75,9 +75,7 @@ class BackboxBloc extends Bloc<BackboxEvent, BackboxState> {
     Emitter<BackboxState> emit,
   ) async {
     emit(
-      ShareState(
+      ShareState(score: event.score),
-        score: event.score,
-      ),
     );
   }
 

lib/game/components/backbox/displays/displays.dart

@@ -5,3 +5,4 @@ export 'initials_submission_success_display.dart';
 export 'leaderboard_display.dart';
 export 'leaderboard_failure_display.dart';
 export 'loading_display.dart';
+export 'share_display.dart';

lib/game/components/backbox/displays/game_over_info_display.dart

@@ -212,7 +212,7 @@ class GoogleIOLinkComponent extends TextComponent with HasGameRef, Tappable {
         );
 
   @override
-  bool onTapDown(TapDownInfo info) {
+  bool onTapUp(TapUpInfo info) {
     openLink(ShareRepository.googleIOEvent);
     return true;
   }

lib/game/components/backbox/displays/leaderboard_display.dart

@@ -1,4 +1,6 @@
+// cSpell:ignore sublist
 import 'package:flame/components.dart';
+import 'package:flame/effects.dart';
 import 'package:flutter/material.dart';
 import 'package:leaderboard_repository/leaderboard_repository.dart';
 import 'package:pinball/l10n/l10n.dart';
@@ -23,6 +25,23 @@ final _bodyTextPaint = TextPaint(
   ),
 );
 
+double _calcY(int i) => (i * 3.2) + 3.2;
+
+const _columns = [-14.0, 0.0, 14.0];
+
+String _rank(int number) {
+  switch (number) {
+    case 1:
+      return '${number}st';
+    case 2:
+      return '${number}nd';
+    case 3:
+      return '${number}rd';
+    default:
+      return '${number}th';
+  }
+}
+
 /// {@template leaderboard_display}
 /// Component that builds the leaderboard list of the Backbox.
 /// {@endtemplate}
@@ -33,21 +52,47 @@ class LeaderboardDisplay extends PositionComponent with HasGameRef {
 
   final List<LeaderboardEntryData> _entries;
 
-  double _calcY(int i) => (i * 3.2) + 3.2;
+  _MovePageArrow _findArrow({required bool active}) {
+    return descendants()
+        .whereType<_MovePageArrow>()
+        .firstWhere((arrow) => arrow.active == active);
+  }
 
-  static const _columns = [-15.0, 0.0, 15.0];
+  void _changePage(List<LeaderboardEntryData> ranking, int offset) {
+    final current = descendants().whereType<_RankingPage>().single;
+    final activeArrow = _findArrow(active: true);
+    final inactiveArrow = _findArrow(active: false);
 
-  String _rank(int number) {
+    activeArrow.active = false;
-    switch (number) {
+
-      case 1:
+    current.add(
-        return '${number}st';
+      ScaleEffect.to(
-      case 2:
+        Vector2(0, 1),
-        return '${number}nd';
+        EffectController(
-      case 3:
+          duration: 0.5,
-        return '${number}rd';
+          curve: Curves.easeIn,
-      default:
+        ),
-        return '${number}th';
+      )..onFinishCallback = () {
-    }
+          current.removeFromParent();
+          inactiveArrow.active = true;
+          firstChild<PositionComponent>()?.add(
+            _RankingPage(
+              ranking: ranking,
+              offset: offset,
+            )
+              ..scale = Vector2(0, 1)
+              ..add(
+                ScaleEffect.to(
+                  Vector2(1, 1),
+                  EffectController(
+                    duration: 0.5,
+                    curve: Curves.easeIn,
+                  ),
+                ),
+              ),
+          );
+        },
+    );
   }
 
   @override
@@ -60,6 +105,20 @@ class LeaderboardDisplay extends PositionComponent with HasGameRef {
       PositionComponent(
         position: Vector2(0, 4),
         children: [
+          _MovePageArrow(
+            position: Vector2(20, 9),
+            onTap: () {
+              _changePage(_entries.sublist(5), 5);
+            },
+          ),
+          _MovePageArrow(
+            position: Vector2(-20, 9),
+            direction: ArrowIconDirection.left,
+            active: false,
+            onTap: () {
+              _changePage(_entries.take(5).toList(), 0);
+            },
+          ),
           PositionComponent(
             children: [
               TextComponent(
@@ -82,39 +141,106 @@ class LeaderboardDisplay extends PositionComponent with HasGameRef {
               ),
             ],
           ),
-          for (var i = 0; i < ranking.length; i++)
+          _RankingPage(
-            PositionComponent(
+            ranking: ranking,
-              children: [
+            offset: 0,
-                TextComponent(
+          ),
-                  text: _rank(i + 1),
-                  textRenderer: _bodyTextPaint,
-                  position: Vector2(_columns[0], _calcY(i)),
-                  anchor: Anchor.center,
-                ),
-                TextComponent(
-                  text: ranking[i].score.formatScore(),
-                  textRenderer: _bodyTextPaint,
-                  position: Vector2(_columns[1], _calcY(i)),
-                  anchor: Anchor.center,
-                ),
-                SpriteComponent.fromImage(
-                  gameRef.images.fromCache(
-                    ranking[i].character.toTheme.leaderboardIcon.keyName,
-                  ),
-                  anchor: Anchor.center,
-                  size: Vector2(1.8, 1.8),
-                  position: Vector2(_columns[2] - 2.5, _calcY(i) + .25),
-                ),
-                TextComponent(
-                  text: ranking[i].playerInitials,
-                  textRenderer: _bodyTextPaint,
-                  position: Vector2(_columns[2] + 1, _calcY(i)),
-                  anchor: Anchor.center,
-                ),
-              ],
-            ),
         ],
       ),
     );
   }
 }
+
+class _RankingPage extends PositionComponent with HasGameRef {
+  _RankingPage({
+    required this.ranking,
+    required this.offset,
+  }) : super(children: []);
+
+  final List<LeaderboardEntryData> ranking;
+  final int offset;
+
+  @override
+  Future<void> onLoad() async {
+    await addAll([
+      for (var i = 0; i < ranking.length; i++)
+        PositionComponent(
+          children: [
+            TextComponent(
+              text: _rank(i + 1 + offset),
+              textRenderer: _bodyTextPaint,
+              position: Vector2(_columns[0], _calcY(i)),
+              anchor: Anchor.center,
+            ),
+            TextComponent(
+              text: ranking[i].score.formatScore(),
+              textRenderer: _bodyTextPaint,
+              position: Vector2(_columns[1], _calcY(i)),
+              anchor: Anchor.center,
+            ),
+            SpriteComponent.fromImage(
+              gameRef.images.fromCache(
+                ranking[i].character.toTheme.leaderboardIcon.keyName,
+              ),
+              anchor: Anchor.center,
+              size: Vector2(1.8, 1.8),
+              position: Vector2(_columns[2] - 3, _calcY(i) + .25),
+            ),
+            TextComponent(
+              text: ranking[i].playerInitials,
+              textRenderer: _bodyTextPaint,
+              position: Vector2(_columns[2] + 1, _calcY(i)),
+              anchor: Anchor.center,
+            ),
+          ],
+        ),
+    ]);
+  }
+}
+
+class _MovePageArrow extends PositionComponent {
+  _MovePageArrow({
+    required Vector2 position,
+    required this.onTap,
+    this.direction = ArrowIconDirection.right,
+    bool active = true,
+  }) : super(
+          position: position,
+          children: [
+            if (active)
+              ArrowIcon(
+                position: Vector2.zero(),
+                direction: direction,
+                onTap: onTap,
+              ),
+            SequenceEffect(
+              [
+                ScaleEffect.to(
+                  Vector2.all(1.2),
+                  EffectController(duration: 1),
+                ),
+                ScaleEffect.to(Vector2.all(1), EffectController(duration: 1)),
+              ],
+              infinite: true,
+            ),
+          ],
+        );
+
+  final ArrowIconDirection direction;
+  final VoidCallback onTap;
+
+  bool get active => children.whereType<ArrowIcon>().isNotEmpty;
+  set active(bool value) {
+    if (value) {
+      add(
+        ArrowIcon(
+          position: Vector2.zero(),
+          direction: direction,
+          onTap: onTap,
+        ),
+      );
+    } else {
+      firstChild<ArrowIcon>()?.removeFromParent();
+    }
+  }
+}

lib/game/components/backbox/displays/share_display.dart

@@ -0,0 +1,189 @@
+import 'dart:async';
+
+import 'package:flame/components.dart';
+import 'package:flame/input.dart';
+import 'package:flutter/material.dart';
+import 'package:pinball/l10n/l10n.dart';
+import 'package:pinball_components/pinball_components.dart';
+import 'package:pinball_flame/pinball_flame.dart';
+import 'package:pinball_ui/pinball_ui.dart';
+import 'package:share_repository/share_repository.dart';
+
+/// Signature for the callback called when the user tries to share their score
+/// on the [ShareDisplay].
+typedef OnSocialShareTap = void Function(SharePlatform);
+
+final _descriptionTextPaint = TextPaint(
+  style: const TextStyle(
+    fontSize: 1.6,
+    color: PinballColors.white,
+    fontFamily: PinballFonts.pixeloidSans,
+  ),
+);
+
+/// {@template share_display}
+/// Display that allows users to share their score to social networks.
+/// {@endtemplate}
+class ShareDisplay extends Component with HasGameRef {
+  /// {@macro share_display}
+  ShareDisplay({
+    OnSocialShareTap? onShare,
+  }) : super(
+          children: [
+            _ShareInstructionsComponent(
+              onShare: onShare,
+            ),
+          ],
+        );
+}
+
+class _ShareInstructionsComponent extends PositionComponent with HasGameRef {
+  _ShareInstructionsComponent({
+    OnSocialShareTap? onShare,
+  }) : super(
+          anchor: Anchor.center,
+          position: Vector2(0, -25),
+          children: [
+            _DescriptionComponent(),
+            _SocialNetworksComponent(
+              onShare: onShare,
+            ),
+          ],
+        );
+}
+
+class _DescriptionComponent extends PositionComponent with HasGameRef {
+  _DescriptionComponent()
+      : super(
+          anchor: Anchor.center,
+          position: Vector2.zero(),
+          children: [
+            _LetEveryoneTextComponent(),
+            _SharingYourScoreTextComponent(),
+            _SocialMediaTextComponent(),
+          ],
+        );
+}
+
+class _LetEveryoneTextComponent extends TextComponent with HasGameRef {
+  _LetEveryoneTextComponent()
+      : super(
+          anchor: Anchor.center,
+          position: Vector2.zero(),
+          textRenderer: _descriptionTextPaint,
+        );
+
+  @override
+  Future<void> onLoad() async {
+    await super.onLoad();
+    text = readProvider<AppLocalizations>().letEveryone;
+  }
+}
+
+class _SharingYourScoreTextComponent extends TextComponent with HasGameRef {
+  _SharingYourScoreTextComponent()
+      : super(
+          anchor: Anchor.center,
+          position: Vector2(0, 2.5),
+          textRenderer: _descriptionTextPaint,
+        );
+
+  @override
+  Future<void> onLoad() async {
+    await super.onLoad();
+    text = readProvider<AppLocalizations>().bySharingYourScore;
+  }
+}
+
+class _SocialMediaTextComponent extends TextComponent with HasGameRef {
+  _SocialMediaTextComponent()
+      : super(
+          anchor: Anchor.center,
+          position: Vector2(0, 5),
+          textRenderer: _descriptionTextPaint,
+        );
+
+  @override
+  Future<void> onLoad() async {
+    await super.onLoad();
+    text = readProvider<AppLocalizations>().socialMediaAccount;
+  }
+}
+
+class _SocialNetworksComponent extends PositionComponent with HasGameRef {
+  _SocialNetworksComponent({
+    OnSocialShareTap? onShare,
+  }) : super(
+          anchor: Anchor.center,
+          position: Vector2(0, 12),
+          children: [
+            FacebookButtonComponent(onTap: onShare),
+            TwitterButtonComponent(onTap: onShare),
+          ],
+        );
+}
+
+/// {@template facebook_button_component}
+/// Button for sharing on Facebook.
+/// {@endtemplate}
+class FacebookButtonComponent extends SpriteComponent
+    with HasGameRef, Tappable {
+  /// {@macro facebook_button_component}
+  FacebookButtonComponent({
+    OnSocialShareTap? onTap,
+  })  : _onTap = onTap,
+        super(
+          anchor: Anchor.center,
+          position: Vector2(-5, 0),
+        );
+
+  final OnSocialShareTap? _onTap;
+
+  @override
+  bool onTapUp(TapUpInfo info) {
+    _onTap?.call(SharePlatform.facebook);
+    return true;
+  }
+
+  @override
+  Future<void> onLoad() async {
+    await super.onLoad();
+    final sprite = Sprite(
+      gameRef.images.fromCache(Assets.images.backbox.button.facebook.keyName),
+    );
+    this.sprite = sprite;
+    size = sprite.originalSize / 25;
+  }
+}
+
+/// {@template twitter_button_component}
+/// Button for sharing on Twitter.
+/// {@endtemplate}
+class TwitterButtonComponent extends SpriteComponent with HasGameRef, Tappable {
+  /// {@macro twitter_button_component}
+  TwitterButtonComponent({
+    OnSocialShareTap? onTap,
+  })  : _onTap = onTap,
+        super(
+          anchor: Anchor.center,
+          position: Vector2(5, 0),
+        );
+
+  final OnSocialShareTap? _onTap;
+
+  @override
+  bool onTapUp(TapUpInfo info) {
+    _onTap?.call(SharePlatform.twitter);
+    return true;
+  }
+
+  @override
+  Future<void> onLoad() async {
+    await super.onLoad();
+    final sprite = Sprite(
+      gameRef.images.fromCache(Assets.images.backbox.button.twitter.keyName),
+    );
+    this.sprite = sprite;
+    size = sprite.originalSize / 25;
+  }
+}

lib/game/components/bottom_group.dart

@@ -52,6 +52,7 @@ class _BottomGroupSide extends Component {
       children: [
         ScoringContactBehavior(points: Points.fiveThousand)
           ..applyTo(['bouncy_edge']),
+        KickerNoiseBehavior()..applyTo(['bouncy_edge']),
       ],
     )..initialPosition = Vector2(
         (22.44 * direction) + centerXAdjustment,

lib/game/components/components.dart

@@ -5,7 +5,7 @@ export 'dino_desert/dino_desert.dart';
 export 'drain/drain.dart';
 export 'flutter_forest/flutter_forest.dart';
 export 'game_bloc_status_listener.dart';
-export 'google_word/google_word.dart';
+export 'google_gallery/google_gallery.dart';
 export 'launcher.dart';
 export 'multiballs/multiballs.dart';
 export 'multipliers/multipliers.dart';

lib/game/components/google_gallery/behaviors/google_word_bonus_behavior.dart

@@ -0,0 +1,26 @@
+import 'package:flame/components.dart';
+import 'package:flame_bloc/flame_bloc.dart';
+import 'package:pinball/game/behaviors/behaviors.dart';
+import 'package:pinball/game/game.dart';
+import 'package:pinball_components/pinball_components.dart';
+import 'package:pinball_flame/pinball_flame.dart';
+
+/// Adds a [GameBonus.googleWord] when all [GoogleLetter]s are activated.
+class GoogleWordBonusBehavior extends Component {
+  @override
+  Future<void> onLoad() async {
+    await super.onLoad();
+    await add(
+      FlameBlocListener<GoogleWordCubit, GoogleWordState>(
+        listenWhen: (_, state) => state.letterSpriteStates.values
+            .every((element) => element == GoogleLetterSpriteState.lit),
+        onNewState: (state) {
+          readBloc<GameBloc, GameState>()
+              .add(const BonusActivated(GameBonus.googleWord));
+          readBloc<GoogleWordCubit, GoogleWordState>().onBonusAwarded();
+          add(BonusBallSpawningBehavior());
+        },
+      ),
+    );
+  }
+}

lib/game/components/google_gallery/google_gallery.dart

@@ -0,0 +1,47 @@
+import 'package:flame/components.dart';
+import 'package:flame_bloc/flame_bloc.dart';
+import 'package:flutter/material.dart';
+import 'package:pinball/game/behaviors/behaviors.dart';
+import 'package:pinball/game/components/google_gallery/behaviors/behaviors.dart';
+import 'package:pinball_components/pinball_components.dart';
+import 'package:pinball_flame/pinball_flame.dart';
+
+/// {@template google_gallery}
+/// Middle section of the board containing the [GoogleWord] and the
+/// [GoogleRollover]s.
+/// {@endtemplate}
+class GoogleGallery extends Component with ZIndex {
+  /// {@macro google_gallery}
+  GoogleGallery()
+      : super(
+          children: [
+            FlameBlocProvider<GoogleWordCubit, GoogleWordState>(
+              create: GoogleWordCubit.new,
+              children: [
+                GoogleRollover(
+                  side: BoardSide.right,
+                  children: [
+                    ScoringContactBehavior(points: Points.fiveThousand),
+                  ],
+                ),
+                GoogleRollover(
+                  side: BoardSide.left,
+                  children: [
+                    ScoringContactBehavior(points: Points.fiveThousand),
+                  ],
+                ),
+                GoogleWord(position: Vector2(-4.45, 1.8)),
+                GoogleWordBonusBehavior(),
+              ],
+            ),
+          ],
+        ) {
+    zIndex = ZIndexes.decal;
+  }
+
+  /// Creates a [GoogleGallery] without any children.
+  ///
+  /// This can be used for testing [GoogleGallery]'s behaviors in isolation.
+  @visibleForTesting
+  GoogleGallery.test();
+}

lib/game/components/google_word/behaviors/google_word_bonus_behavior.dart

@@ -1,29 +0,0 @@
-import 'package:flame/components.dart';
-import 'package:flame_bloc/flame_bloc.dart';
-import 'package:pinball/game/game.dart';
-import 'package:pinball_components/pinball_components.dart';
-import 'package:pinball_flame/pinball_flame.dart';
-
-/// Adds a [GameBonus.googleWord] when all [GoogleLetter]s are activated.
-class GoogleWordBonusBehavior extends Component
-    with ParentIsA<GoogleWord>, FlameBlocReader<GameBloc, GameState> {
-  @override
-  void onMount() {
-    super.onMount();
-
-    final googleLetters = parent.children.whereType<GoogleLetter>();
-    for (final letter in googleLetters) {
-      letter.bloc.stream.listen((_) {
-        final achievedBonus = googleLetters
-            .every((letter) => letter.bloc.state == GoogleLetterState.lit);
-
-        if (achievedBonus) {
-          bloc.add(const BonusActivated(GameBonus.googleWord));
-          for (final letter in googleLetters) {
-            letter.bloc.onReset();
-          }
-        }
-      });
-    }
-  }
-}

lib/game/components/google_word/google_word.dart

@@ -1,52 +0,0 @@
-import 'package:flame/components.dart';
-import 'package:flutter/material.dart';
-import 'package:pinball/game/behaviors/scoring_behavior.dart';
-import 'package:pinball/game/components/google_word/behaviors/behaviors.dart';
-import 'package:pinball_components/pinball_components.dart';
-import 'package:pinball_flame/pinball_flame.dart';
-
-/// {@template google_word}
-/// Loads all [GoogleLetter]s to compose a [GoogleWord].
-/// {@endtemplate}
-class GoogleWord extends Component with ZIndex {
-  /// {@macro google_word}
-  GoogleWord({
-    required Vector2 position,
-  }) : super(
-          children: [
-            GoogleLetter(
-              0,
-              children: [ScoringContactBehavior(points: Points.fiveThousand)],
-            )..initialPosition = position + Vector2(-13.1, 1.72),
-            GoogleLetter(
-              1,
-              children: [ScoringContactBehavior(points: Points.fiveThousand)],
-            )..initialPosition = position + Vector2(-8.33, -0.75),
-            GoogleLetter(
-              2,
-              children: [ScoringContactBehavior(points: Points.fiveThousand)],
-            )..initialPosition = position + Vector2(-2.88, -1.85),
-            GoogleLetter(
-              3,
-              children: [ScoringContactBehavior(points: Points.fiveThousand)],
-            )..initialPosition = position + Vector2(2.88, -1.85),
-            GoogleLetter(
-              4,
-              children: [ScoringContactBehavior(points: Points.fiveThousand)],
-            )..initialPosition = position + Vector2(8.33, -0.75),
-            GoogleLetter(
-              5,
-              children: [ScoringContactBehavior(points: Points.fiveThousand)],
-            )..initialPosition = position + Vector2(13.1, 1.72),
-            GoogleWordBonusBehavior(),
-          ],
-        ) {
-    zIndex = ZIndexes.decal;
-  }
-
-  /// Creates a [GoogleWord] without any children.
-  ///
-  /// This can be used for testing [GoogleWord]'s behaviors in isolation.
-  @visibleForTesting
-  GoogleWord.test();
-}

lib/game/components/multiballs/behaviors/multiballs_behavior.dart

@@ -11,7 +11,8 @@ class MultiballsBehavior extends Component
   bool listenWhen(GameState? previousState, GameState newState) {
     final hasChanged = previousState?.bonusHistory != newState.bonusHistory;
     final lastBonusIsMultiball = newState.bonusHistory.isNotEmpty &&
-        newState.bonusHistory.last == GameBonus.dashNest;
+        (newState.bonusHistory.last == GameBonus.dashNest ||
+            newState.bonusHistory.last == GameBonus.googleWord);
 
     return hasChanged && lastBonusIsMultiball;
   }

lib/game/game_assets.dart

@@ -12,7 +12,7 @@ extension PinballGameAssetsX on PinballGame {
     const androidTheme = AndroidTheme();
     const dinoTheme = DinoTheme();
 
-    return [
+    final gameAssets = [
       images.load(components.Assets.images.boardBackground.keyName),
       images.load(components.Assets.images.ball.flameEffect.keyName),
       images.load(components.Assets.images.signpost.inactive.keyName),
@@ -101,6 +101,8 @@ extension PinballGameAssetsX on PinballGame {
       images.load(components.Assets.images.sparky.bumper.c.dimmed.keyName),
       images.load(components.Assets.images.backbox.marquee.keyName),
       images.load(components.Assets.images.backbox.displayDivider.keyName),
+      images.load(components.Assets.images.backbox.button.facebook.keyName),
+      images.load(components.Assets.images.backbox.button.twitter.keyName),
       images.load(
         components.Assets.images.backbox.displayTitleDecoration.keyName,
       ),
@@ -116,6 +118,10 @@ extension PinballGameAssetsX on PinballGame {
       images.load(components.Assets.images.googleWord.letter5.dimmed.keyName),
       images.load(components.Assets.images.googleWord.letter6.lit.keyName),
       images.load(components.Assets.images.googleWord.letter6.dimmed.keyName),
+      images.load(components.Assets.images.googleRollover.left.decal.keyName),
+      images.load(components.Assets.images.googleRollover.left.pin.keyName),
+      images.load(components.Assets.images.googleRollover.right.decal.keyName),
+      images.load(components.Assets.images.googleRollover.right.pin.keyName),
       images.load(components.Assets.images.multiball.lit.keyName),
       images.load(components.Assets.images.multiball.dimmed.keyName),
       images.load(components.Assets.images.multiplier.x2.lit.keyName),
@@ -139,14 +145,24 @@ extension PinballGameAssetsX on PinballGame {
       images.load(components.Assets.images.skillShot.pin.keyName),
       images.load(components.Assets.images.skillShot.lit.keyName),
       images.load(components.Assets.images.skillShot.dimmed.keyName),
-      images.load(dashTheme.leaderboardIcon.keyName),
+      images.load(components.Assets.images.displayArrows.arrowLeft.keyName),
-      images.load(sparkyTheme.leaderboardIcon.keyName),
+      images.load(components.Assets.images.displayArrows.arrowRight.keyName),
       images.load(androidTheme.leaderboardIcon.keyName),
-      images.load(dinoTheme.leaderboardIcon.keyName),
       images.load(androidTheme.ball.keyName),
+      images.load(dashTheme.leaderboardIcon.keyName),
       images.load(dashTheme.ball.keyName),
+      images.load(dinoTheme.leaderboardIcon.keyName),
       images.load(dinoTheme.ball.keyName),
+      images.load(sparkyTheme.leaderboardIcon.keyName),
       images.load(sparkyTheme.ball.keyName),
     ];
+
+    return (platformHelper.isMobile) ? gameAssets : gameAssets
+      ..addAll([
+        images.load(androidTheme.background.keyName),
+        images.load(dashTheme.background.keyName),
+        images.load(dinoTheme.background.keyName),
+        images.load(sparkyTheme.background.keyName),
+      ]);
   }
 }

lib/game/pinball_game.dart

@@ -14,15 +14,19 @@ import 'package:pinball/select_character/select_character.dart';
 import 'package:pinball_audio/pinball_audio.dart';
 import 'package:pinball_components/pinball_components.dart';
 import 'package:pinball_flame/pinball_flame.dart';
+import 'package:platform_helper/platform_helper.dart';
+import 'package:share_repository/share_repository.dart';
 
 class PinballGame extends PinballForge2DGame
     with HasKeyboardHandlerComponents, MultiTouchTapDetector, HasTappables {
   PinballGame({
     required CharacterThemeCubit characterThemeBloc,
     required this.leaderboardRepository,
+    required this.shareRepository,
     required GameBloc gameBloc,
     required AppLocalizations l10n,
     required PinballAudioPlayer audioPlayer,
+    required this.platformHelper,
   })  : focusNode = FocusNode(),
         _gameBloc = gameBloc,
         _audioPlayer = audioPlayer,
@@ -51,8 +55,12 @@ class PinballGame extends PinballForge2DGame
 
   final LeaderboardRepository leaderboardRepository;
 
+  final ShareRepository shareRepository;
+
   final AppLocalizations _l10n;
 
+  final PlatformHelper platformHelper;
+
   final GameBloc _gameBloc;
 
   List<LeaderboardEntryData>? _entries;
@@ -84,13 +92,15 @@ class PinballGame extends PinballForge2DGame
             providers: [
               FlameProvider<PinballAudioPlayer>.value(_audioPlayer),
               FlameProvider<LeaderboardRepository>.value(leaderboardRepository),
+              FlameProvider<ShareRepository>.value(shareRepository),
               FlameProvider<AppLocalizations>.value(_l10n),
+              FlameProvider<PlatformHelper>.value(platformHelper),
             ],
             children: [
               BonusNoiseBehavior(),
               GameBlocStatusListener(),
               BallSpawningBehavior(),
-              BallThemingBehavior(),
+              CharacterSelectionBehavior(),
               CameraFocusingBehavior(),
               CanvasComponent(
                 onSpritePainted: (paint) {
@@ -101,13 +111,15 @@ class PinballGame extends PinballForge2DGame
                 children: [
                   ZCanvasComponent(
                     children: [
+                      if (!platformHelper.isMobile) ArcadeBackground(),
                       BoardBackgroundSpriteComponent(),
                       Boundaries(),
                       Backbox(
                         leaderboardRepository: leaderboardRepository,
+                        shareRepository: shareRepository,
                         entries: _entries,
                       ),
-                      GoogleWord(position: Vector2(-4.45, 1.8)),
+                      GoogleGallery(),
                       Multipliers(),
                       Multiballs(),
                       SkillShot(
@@ -193,14 +205,18 @@ class DebugPinballGame extends PinballGame with FPSCounter, PanDetector {
   DebugPinballGame({
     required CharacterThemeCubit characterThemeBloc,
     required LeaderboardRepository leaderboardRepository,
+    required ShareRepository shareRepository,
     required AppLocalizations l10n,
     required PinballAudioPlayer audioPlayer,
+    required PlatformHelper platformHelper,
     required GameBloc gameBloc,
   }) : super(
           characterThemeBloc: characterThemeBloc,
           audioPlayer: audioPlayer,
           leaderboardRepository: leaderboardRepository,
+          shareRepository: shareRepository,
           l10n: l10n,
+          platformHelper: platformHelper,
           gameBloc: gameBloc,
         );
 

lib/game/view/pinball_game_page.dart

@@ -5,13 +5,14 @@ import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:leaderboard_repository/leaderboard_repository.dart';
 import 'package:pinball/assets_manager/assets_manager.dart';
 import 'package:pinball/game/game.dart';
-import 'package:pinball/gen/gen.dart';
 import 'package:pinball/l10n/l10n.dart';
 import 'package:pinball/more_information/more_information.dart';
 import 'package:pinball/select_character/select_character.dart';
 import 'package:pinball/start_game/start_game.dart';
 import 'package:pinball_audio/pinball_audio.dart';
 import 'package:pinball_ui/pinball_ui.dart';
+import 'package:platform_helper/platform_helper.dart';
+import 'package:share_repository/share_repository.dart';
 
 class PinballGamePage extends StatelessWidget {
   const PinballGamePage({
@@ -26,31 +27,34 @@ class PinballGamePage extends StatelessWidget {
     final characterThemeBloc = context.read<CharacterThemeCubit>();
     final audioPlayer = context.read<PinballAudioPlayer>();
     final leaderboardRepository = context.read<LeaderboardRepository>();
+    final shareRepository = context.read<ShareRepository>();
+    final platformHelper = context.read<PlatformHelper>();
     final gameBloc = context.read<GameBloc>();
     final game = isDebugMode
         ? DebugPinballGame(
             characterThemeBloc: characterThemeBloc,
             audioPlayer: audioPlayer,
             leaderboardRepository: leaderboardRepository,
+            shareRepository: shareRepository,
             l10n: context.l10n,
+            platformHelper: platformHelper,
             gameBloc: gameBloc,
           )
         : PinballGame(
             characterThemeBloc: characterThemeBloc,
             audioPlayer: audioPlayer,
             leaderboardRepository: leaderboardRepository,
+            shareRepository: shareRepository,
             l10n: context.l10n,
+            platformHelper: platformHelper,
             gameBloc: gameBloc,
           );
 
-    return Container(
+    return Scaffold(
-      decoration: const CrtBackground(),
+      backgroundColor: PinballColors.black,
-      child: Scaffold(
+      body: BlocProvider(
-        backgroundColor: PinballColors.transparent,
+        create: (_) => AssetsManagerCubit(game, audioPlayer)..load(),
-        body: BlocProvider(
+        child: PinballGameView(game),
-          create: (_) => AssetsManagerCubit(game, audioPlayer)..load(),
-          child: PinballGameView(game),
-        ),
       ),
     );
   }
@@ -166,7 +170,7 @@ class _PositionedInfoIcon extends StatelessWidget {
             visible: state.status.isGameOver,
             child: IconButton(
               iconSize: 50,
-              icon: Assets.images.linkBox.infoIcon.image(),
+              icon: const Icon(Icons.info, color: PinballColors.white),
               onPressed: () => showMoreInformationDialog(context),
             ),
           );

lib/gen/assets.gen.dart

@@ -14,7 +14,6 @@ class $AssetsImagesGen {
       const $AssetsImagesBonusAnimationGen();
   $AssetsImagesComponentsGen get components =>
       const $AssetsImagesComponentsGen();
-  $AssetsImagesLinkBoxGen get linkBox => const $AssetsImagesLinkBoxGen();
   $AssetsImagesLoadingGameGen get loadingGame =>
       const $AssetsImagesLoadingGameGen();
   $AssetsImagesScoreGen get score => const $AssetsImagesScoreGen();
@@ -56,14 +55,6 @@ class $AssetsImagesComponentsGen {
       const AssetGenImage('assets/images/components/space.png');
 }
 
-class $AssetsImagesLinkBoxGen {
-  const $AssetsImagesLinkBoxGen();
-
-  /// File path: assets/images/link_box/info_icon.png
-  AssetGenImage get infoIcon =>
-      const AssetGenImage('assets/images/link_box/info_icon.png');
-}
-
 class $AssetsImagesLoadingGameGen {
   const $AssetsImagesLoadingGameGen();
 

lib/how_to_play/widgets/how_to_play_dialog.dart

@@ -50,14 +50,11 @@ extension on Control {
 }
 
 class HowToPlayDialog extends StatefulWidget {
-  HowToPlayDialog({
+  const HowToPlayDialog({
     Key? key,
     required this.onDismissCallback,
-    @visibleForTesting PlatformHelper? platformHelper,
+  }) : super(key: key);
-  })  : platformHelper = platformHelper ?? PlatformHelper(),
-        super(key: key);
 
-  final PlatformHelper platformHelper;
   final VoidCallback onDismissCallback;
 
   @override
@@ -85,7 +82,7 @@ class _HowToPlayDialogState extends State<HowToPlayDialog> {
 
   @override
   Widget build(BuildContext context) {
-    final isMobile = widget.platformHelper.isMobile;
+    final isMobile = context.read<PlatformHelper>().isMobile;
     final l10n = context.l10n;
 
     return WillPopScope(

lib/l10n/arb/app_en.arb

@@ -189,7 +189,7 @@
     "description": "Text shown on the mobile controls enter button"
   },
   "initialsErrorTitle": "Uh-oh... well, that didn’t work",
-  "@enter": {
+  "@initialsErrorTitle": {
     "description": "Title shown when the initials submission fails"
   },
   "initialsErrorMessage": "Please try a different combination of letters",
@@ -200,4 +200,26 @@
   "@leaderboardErrorMessage": {
     "description": "Text shown when the leaderboard had an error while loading"
   }
+  ,
+  "letEveryone": "Let everyone know about I/O Pinball",
+  "@letEveryone": {
+    "description": "Text displayed on share screen for description"
+  },
+  "bySharingYourScore": "by sharing your score to your preferred",
+  "@bySharingYourScore": {
+    "description": "Text displayed on share screen for description"
+  },
+  "socialMediaAccount": "social media account!",
+  "@socialMediaAccount": {
+    "description": "Text displayed on share screen for description"
+  },
+  "iGotScoreAtPinball": "I got {score} at the #IOPinball machine, can you beat my score? See you at #GoogleIO!",
+  "@iGotScoreAtPinball": {
+    "description": "Text to share score on Social Network",
+    "placeholders": {
+      "score": {
+          "type": "String"
+      }
+    }
+  }
 }

lib/main.dart

@@ -6,12 +6,17 @@ import 'package:leaderboard_repository/leaderboard_repository.dart';
 import 'package:pinball/app/app.dart';
 import 'package:pinball/bootstrap.dart';
 import 'package:pinball_audio/pinball_audio.dart';
+import 'package:platform_helper/platform_helper.dart';
+import 'package:share_repository/share_repository.dart';
 
 void main() {
   bootstrap((firestore, firebaseAuth) async {
     final leaderboardRepository = LeaderboardRepository(firestore);
+    const shareRepository =
+        ShareRepository(appUrl: ShareRepository.pinballGameUrl);
     final authenticationRepository = AuthenticationRepository(firebaseAuth);
     final pinballAudioPlayer = PinballAudioPlayer();
+    final platformHelper = PlatformHelper();
     unawaited(
       Firebase.initializeApp().then(
         (_) => authenticationRepository.authenticateAnonymously(),
@@ -20,7 +25,9 @@ void main() {
     return App(
       authenticationRepository: authenticationRepository,
       leaderboardRepository: leaderboardRepository,
+      shareRepository: shareRepository,
       pinballAudioPlayer: pinballAudioPlayer,
+      platformHelper: platformHelper,
     );
   });
 }

lib/more_information/more_information_dialog.dart

@@ -204,7 +204,7 @@ class _MadeWithFlutterAndFirebase extends StatelessWidget {
 abstract class _MoreInformationUrl {
   static const flutterWebsite = 'https://flutter.dev';
   static const firebaseWebsite = 'https://firebase.google.com';
-  static const openSourceCode = 'https://github.com/VGVentures/pinball';
+  static const openSourceCode = 'https://github.com/flutter/pinball';
   static const googleIOEvent = 'https://events.google.com/io/';
   static const flutterGamesWebsite = 'http://flutter.dev/games';
   static const howItsMadeArticle =

packages/pinball_audio/lib/gen/assets.gen.dart

@@ -17,11 +17,14 @@ class $AssetsSfxGen {
   String get android => 'assets/sfx/android.mp3';
   String get bumperA => 'assets/sfx/bumper_a.mp3';
   String get bumperB => 'assets/sfx/bumper_b.mp3';
+  String get cowMoo => 'assets/sfx/cow_moo.mp3';
   String get dash => 'assets/sfx/dash.mp3';
   String get dino => 'assets/sfx/dino.mp3';
   String get gameOverVoiceOver => 'assets/sfx/game_over_voice_over.mp3';
   String get google => 'assets/sfx/google.mp3';
   String get ioPinballVoiceOver => 'assets/sfx/io_pinball_voice_over.mp3';
+  String get kickerA => 'assets/sfx/kicker_a.mp3';
+  String get kickerB => 'assets/sfx/kicker_b.mp3';
   String get launcher => 'assets/sfx/launcher.mp3';
   String get sparky => 'assets/sfx/sparky.mp3';
 }

packages/pinball_audio/lib/src/pinball_audio.dart

@@ -1,32 +1,39 @@
 import 'dart:math';
 
 import 'package:audioplayers/audioplayers.dart';
+import 'package:clock/clock.dart';
 import 'package:flame_audio/audio_pool.dart';
 import 'package:flame_audio/flame_audio.dart';
 import 'package:flutter/material.dart';
 import 'package:pinball_audio/gen/assets.gen.dart';
 
-/// Sounds available for play
+/// Sounds available to play.
 enum PinballAudio {
-  /// Google
+  /// Google.
   google,
 
-  /// Bumper
+  /// Bumper.
   bumper,
 
-  /// Background music
+  /// Cow moo.
+  cowMoo,
+
+  /// Background music.
   backgroundMusic,
 
-  /// IO Pinball voice over
+  /// IO Pinball voice over.
   ioPinballVoiceOver,
 
-  /// Game over
+  /// Game over.
   gameOverVoiceOver,
 
-  /// Launcher
+  /// Launcher.
   launcher,
 
-  /// Sparky
+  /// Kicker.
+  kicker,
+
+  /// Sparky.
   sparky,
 
   /// Android
@@ -52,7 +59,7 @@ typedef CreateAudioPool = Future<AudioPool> Function(
 typedef PlaySingleAudio = Future<void> Function(String);
 
 /// Defines the contract for looping a single audio.
-typedef LoopSingleAudio = Future<void> Function(String);
+typedef LoopSingleAudio = Future<void> Function(String, {double volume});
 
 /// Defines the contract for pre fetching an audio.
 typedef PreCacheSingleAudio = Future<void> Function(String);
@@ -94,59 +101,120 @@ class _LoopAudio extends _Audio {
     required this.preCacheSingleAudio,
     required this.loopSingleAudio,
     required this.path,
+    this.volume,
   });
 
   final PreCacheSingleAudio preCacheSingleAudio;
   final LoopSingleAudio loopSingleAudio;
   final String path;
+  final double? volume;
 
   @override
   Future<void> load() => preCacheSingleAudio(prefixFile(path));
 
   @override
   void play() {
-    loopSingleAudio(prefixFile(path));
+    loopSingleAudio(prefixFile(path), volume: volume ?? 1);
+  }
+}
+
+class _SingleLoopAudio extends _LoopAudio {
+  _SingleLoopAudio({
+    required PreCacheSingleAudio preCacheSingleAudio,
+    required LoopSingleAudio loopSingleAudio,
+    required String path,
+    double? volume,
+  }) : super(
+          preCacheSingleAudio: preCacheSingleAudio,
+          loopSingleAudio: loopSingleAudio,
+          path: path,
+          volume: volume,
+        );
+
+  bool _playing = false;
+
+  @override
+  void play() {
+    if (!_playing) {
+      super.play();
+      _playing = true;
+    }
   }
 }
 
-class _BumperAudio extends _Audio {
+class _RandomABAudio extends _Audio {
-  _BumperAudio({
+  _RandomABAudio({
     required this.createAudioPool,
     required this.seed,
+    required this.audioAssetA,
+    required this.audioAssetB,
+    this.volume,
   });
 
   final CreateAudioPool createAudioPool;
   final Random seed;
+  final String audioAssetA;
+  final String audioAssetB;
+  final double? volume;
 
-  late AudioPool bumperA;
+  late AudioPool audioA;
-  late AudioPool bumperB;
+  late AudioPool audioB;
 
   @override
   Future<void> load() async {
     await Future.wait(
       [
         createAudioPool(
-          prefixFile(Assets.sfx.bumperA),
+          prefixFile(audioAssetA),
           maxPlayers: 4,
           prefix: '',
-        ).then((pool) => bumperA = pool),
+        ).then((pool) => audioA = pool),
         createAudioPool(
-          prefixFile(Assets.sfx.bumperB),
+          prefixFile(audioAssetB),
           maxPlayers: 4,
           prefix: '',
-        ).then((pool) => bumperB = pool),
+        ).then((pool) => audioB = pool),
       ],
     );
   }
 
   @override
   void play() {
-    (seed.nextBool() ? bumperA : bumperB).start(volume: 0.6);
+    (seed.nextBool() ? audioA : audioB).start(volume: volume ?? 1);
+  }
+}
+
+class _ThrottledAudio extends _Audio {
+  _ThrottledAudio({
+    required this.preCacheSingleAudio,
+    required this.playSingleAudio,
+    required this.path,
+    required this.duration,
+  });
+
+  final PreCacheSingleAudio preCacheSingleAudio;
+  final PlaySingleAudio playSingleAudio;
+  final String path;
+  final Duration duration;
+
+  DateTime? _lastPlayed;
+
+  @override
+  Future<void> load() => preCacheSingleAudio(prefixFile(path));
+
+  @override
+  void play() {
+    final now = clock.now();
+    if (_lastPlayed == null ||
+        (_lastPlayed != null && now.difference(_lastPlayed!) > duration)) {
+      _lastPlayed = now;
+      playSingleAudio(prefixFile(path));
+    }
   }
 }
 
 /// {@template pinball_audio_player}
-/// Sound manager for the pinball game
+/// Sound manager for the pinball game.
 /// {@endtemplate}
 class PinballAudioPlayer {
   /// {@macro pinball_audio_player}
@@ -208,14 +276,31 @@ class PinballAudioPlayer {
         playSingleAudio: _playSingleAudio,
         path: Assets.sfx.gameOverVoiceOver,
       ),
-      PinballAudio.bumper: _BumperAudio(
+      PinballAudio.bumper: _RandomABAudio(
+        createAudioPool: _createAudioPool,
+        seed: _seed,
+        audioAssetA: Assets.sfx.bumperA,
+        audioAssetB: Assets.sfx.bumperB,
+        volume: 0.6,
+      ),
+      PinballAudio.kicker: _RandomABAudio(
         createAudioPool: _createAudioPool,
         seed: _seed,
+        audioAssetA: Assets.sfx.kickerA,
+        audioAssetB: Assets.sfx.kickerB,
+        volume: 0.6,
+      ),
+      PinballAudio.cowMoo: _ThrottledAudio(
+        preCacheSingleAudio: _preCacheSingleAudio,
+        playSingleAudio: _playSingleAudio,
+        path: Assets.sfx.cowMoo,
+        duration: const Duration(seconds: 2),
       ),
-      PinballAudio.backgroundMusic: _LoopAudio(
+      PinballAudio.backgroundMusic: _SingleLoopAudio(
         preCacheSingleAudio: _preCacheSingleAudio,
         loopSingleAudio: _loopSingleAudio,
         path: Assets.music.background,
+        volume: .6,
       ),
     };
   }
@@ -232,19 +317,19 @@ class PinballAudioPlayer {
 
   final Random _seed;
 
-  /// Registered audios on the Player
+  /// Registered audios on the Player.
   @visibleForTesting
   // ignore: library_private_types_in_public_api
   late final Map<PinballAudio, _Audio> audios;
 
-  /// Loads the sounds effects into the memory
+  /// Loads the sounds effects into the memory.
   List<Future<void>> load() {
     _configureAudioCache(FlameAudio.audioCache);
 
     return audios.values.map((a) => a.load()).toList();
   }
 
-  /// Plays the received audio
+  /// Plays the received audio.
   void play(PinballAudio audio) {
     assert(
       audios.containsKey(audio),

packages/pinball_audio/pubspec.yaml

@@ -8,6 +8,7 @@ environment:
 
 dependencies:
   audioplayers: ^0.20.1
+  clock: ^1.1.0
   flame_audio: ^1.0.1
   flutter:
     sdk: flutter

packages/pinball_audio/test/src/pinball_audio_test.dart

@@ -2,6 +2,7 @@
 import 'dart:math';
 
 import 'package:audioplayers/audioplayers.dart';
+import 'package:clock/clock.dart';
 import 'package:flame_audio/audio_pool.dart';
 import 'package:flame_audio/flame_audio.dart';
 import 'package:flutter_test/flutter_test.dart';
@@ -32,7 +33,7 @@ class _MockPlaySingleAudio extends Mock {
 }
 
 class _MockLoopSingleAudio extends Mock {
-  Future<void> onCall(String url);
+  Future<void> onCall(String url, {double volume});
 }
 
 abstract class _PreCacheSingleAudio {
@@ -43,6 +44,8 @@ class _MockPreCacheSingleAudio extends Mock implements _PreCacheSingleAudio {}
 
 class _MockRandom extends Mock implements Random {}
 
+class _MockClock extends Mock implements Clock {}
+
 void main() {
   group('PinballAudio', () {
     late _MockCreateAudioPool createAudioPool;
@@ -74,7 +77,8 @@ void main() {
       when(() => playSingleAudio.onCall(any())).thenAnswer((_) async {});
 
       loopSingleAudio = _MockLoopSingleAudio();
-      when(() => loopSingleAudio.onCall(any())).thenAnswer((_) async {});
+      when(() => loopSingleAudio.onCall(any(), volume: any(named: 'volume')))
+          .thenAnswer((_) async {});
 
       preCacheSingleAudio = _MockPreCacheSingleAudio();
       when(() => preCacheSingleAudio.onCall(any())).thenAnswer((_) async {});
@@ -116,6 +120,26 @@ void main() {
         ).called(1);
       });
 
+      test('creates the kicker pools', () async {
+        await Future.wait(audioPlayer.load());
+
+        verify(
+          () => createAudioPool.onCall(
+            'packages/pinball_audio/${Assets.sfx.kickerA}',
+            maxPlayers: 4,
+            prefix: '',
+          ),
+        ).called(1);
+
+        verify(
+          () => createAudioPool.onCall(
+            'packages/pinball_audio/${Assets.sfx.kickerB}',
+            maxPlayers: 4,
+            prefix: '',
+          ),
+        ).called(1);
+      });
+
       test('configures the audio cache instance', () async {
         await Future.wait(audioPlayer.load());
 
@@ -171,6 +195,10 @@ void main() {
           () => preCacheSingleAudio
               .onCall('packages/pinball_audio/assets/sfx/launcher.mp3'),
         ).called(1);
+        verify(
+          () => preCacheSingleAudio
+              .onCall('packages/pinball_audio/assets/sfx/cow_moo.mp3'),
+        ).called(1);
         verify(
           () => preCacheSingleAudio
               .onCall('packages/pinball_audio/assets/music/background.mp3'),
@@ -227,6 +255,91 @@ void main() {
       });
     });
 
+    group('kicker', () {
+      late AudioPool kickerAPool;
+      late AudioPool kickerBPool;
+
+      setUp(() {
+        kickerAPool = _MockAudioPool();
+        when(() => kickerAPool.start(volume: any(named: 'volume')))
+            .thenAnswer((_) async => () {});
+        when(
+          () => createAudioPool.onCall(
+            'packages/pinball_audio/${Assets.sfx.kickerA}',
+            maxPlayers: any(named: 'maxPlayers'),
+            prefix: any(named: 'prefix'),
+          ),
+        ).thenAnswer((_) async => kickerAPool);
+
+        kickerBPool = _MockAudioPool();
+        when(() => kickerBPool.start(volume: any(named: 'volume')))
+            .thenAnswer((_) async => () {});
+        when(
+          () => createAudioPool.onCall(
+            'packages/pinball_audio/${Assets.sfx.kickerB}',
+            maxPlayers: any(named: 'maxPlayers'),
+            prefix: any(named: 'prefix'),
+          ),
+        ).thenAnswer((_) async => kickerBPool);
+      });
+
+      group('when seed is true', () {
+        test('plays the kicker A sound pool', () async {
+          when(seed.nextBool).thenReturn(true);
+          await Future.wait(audioPlayer.load());
+          audioPlayer.play(PinballAudio.kicker);
+
+          verify(() => kickerAPool.start(volume: 0.6)).called(1);
+        });
+      });
+
+      group('when seed is false', () {
+        test('plays the kicker B sound pool', () async {
+          when(seed.nextBool).thenReturn(false);
+          await Future.wait(audioPlayer.load());
+          audioPlayer.play(PinballAudio.kicker);
+
+          verify(() => kickerBPool.start(volume: 0.6)).called(1);
+        });
+      });
+    });
+
+    group('cow moo', () {
+      test('plays the correct file', () async {
+        await Future.wait(audioPlayer.load());
+        audioPlayer.play(PinballAudio.cowMoo);
+
+        verify(
+          () => playSingleAudio
+              .onCall('packages/pinball_audio/${Assets.sfx.cowMoo}'),
+        ).called(1);
+      });
+
+      test('only plays the sound again after 2 seconds', () async {
+        final clock = _MockClock();
+        await withClock(clock, () async {
+          when(clock.now).thenReturn(DateTime(2022));
+          await Future.wait(audioPlayer.load());
+          audioPlayer
+            ..play(PinballAudio.cowMoo)
+            ..play(PinballAudio.cowMoo);
+
+          verify(
+            () => playSingleAudio
+                .onCall('packages/pinball_audio/${Assets.sfx.cowMoo}'),
+          ).called(1);
+
+          when(clock.now).thenReturn(DateTime(2022, 1, 1, 1, 2));
+          audioPlayer.play(PinballAudio.cowMoo);
+
+          verify(
+            () => playSingleAudio
+                .onCall('packages/pinball_audio/${Assets.sfx.cowMoo}'),
+          ).called(1);
+        });
+      });
+    });
+
     group('google', () {
       test('plays the correct file', () async {
         await Future.wait(audioPlayer.load());
@@ -331,8 +444,24 @@ void main() {
         audioPlayer.play(PinballAudio.backgroundMusic);
 
         verify(
-          () => loopSingleAudio
+          () => loopSingleAudio.onCall(
-              .onCall('packages/pinball_audio/${Assets.music.background}'),
+            'packages/pinball_audio/${Assets.music.background}',
+            volume: .6,
+          ),
+        ).called(1);
+      });
+
+      test('plays only once', () async {
+        await Future.wait(audioPlayer.load());
+        audioPlayer
+          ..play(PinballAudio.backgroundMusic)
+          ..play(PinballAudio.backgroundMusic);
+
+        verify(
+          () => loopSingleAudio.onCall(
+            'packages/pinball_audio/${Assets.music.background}',
+            volume: .6,
+          ),
         ).called(1);
       });
     });