feat: extensive settings for media controls through notification (#28)

* feat: add notification settings customisation options

* feat: add notification settings page and update routing

lib/features/player/core/audiobook_player.dart

@@ -8,6 +8,9 @@ import 'package:just_audio/just_audio.dart';
 import 'package:just_audio_background/just_audio_background.dart';
 import 'package:logging/logging.dart';
 import 'package:shelfsdk/audiobookshelf_api.dart';
+import 'package:vaani/settings/app_settings_provider.dart';
+import 'package:vaani/settings/models/app_settings.dart';
+import 'package:vaani/shared/extensions/model_conversions.dart';
 
 final _logger = Logger('AudiobookPlayer');
 
@@ -81,6 +84,7 @@ class AudiobookPlayer extends AudioPlayer {
     List<Uri>? downloadedUris,
     Uri? artworkUri,
   }) async {
+    final appSettings = loadOrCreateAppSettings();
     // if the book is null, stop the player
     if (book == null) {
       _book = null;
@@ -128,8 +132,10 @@ class AudiobookPlayer extends AudioPlayer {
               // Specify a unique ID for each media item:
               id: book.libraryItemId + track.index.toString(),
               // Metadata to display in the notification:
-              album: book.metadata.title,
-              title: book.metadata.title ?? track.title,
+              title: appSettings.notificationSettings.primaryTitle
+                  .formatNotificationTitle(book),
+              album: appSettings.notificationSettings.secondaryTitle
+                  .formatNotificationTitle(book),
               artUri: artworkUri ??
                   Uri.parse(
                     '$baseUrl/api/items/${book.libraryItemId}/cover?token=$token&width=800',
@@ -198,7 +204,7 @@ class AudiobookPlayer extends AudioPlayer {
 
   @override
   Stream<Duration> get positionStream {
-    // return the positioninbook stream
+    // return the positionInBook stream
     return super.positionStream.map((position) {
       if (_book == null) {
         return Duration.zero;
@@ -267,3 +273,42 @@ Uri _getUri(
   return uri ??
       Uri.parse('${baseUrl.toString()}${track.contentUrl}?token=$token');
 }
+
+extension FormatNotificationTitle on String {
+  String formatNotificationTitle(BookExpanded book) {
+    return replaceAllMapped(
+      RegExp(r'\$(\w+)'),
+      (match) {
+        final type = match.group(1);
+        return NotificationTitleType.values
+                .firstWhere((element) => element.stringValue == type)
+                .extractFrom(book) ??
+            match.group(0) ??
+            '';
+      },
+    );
+  }
+}
+
+extension NotificationTitleUtils on NotificationTitleType {
+  String? extractFrom(BookExpanded book) {
+    var bookMetadataExpanded = book.metadata.asBookMetadataExpanded;
+    switch (this) {
+      case NotificationTitleType.bookTitle:
+        return bookMetadataExpanded.title;
+      case NotificationTitleType.chapterTitle:
+        // TODO: implement chapter title; depends on https://github.com/Dr-Blank/Vaani/issues/2
+        return bookMetadataExpanded.title;
+      case NotificationTitleType.author:
+        return bookMetadataExpanded.authorName;
+      case NotificationTitleType.narrator:
+        return bookMetadataExpanded.narratorName;
+      case NotificationTitleType.series:
+        return bookMetadataExpanded.seriesName;
+      case NotificationTitleType.subtitle:
+        return bookMetadataExpanded.subtitle;
+      case NotificationTitleType.year:
+        return bookMetadataExpanded.publishedYear;
+    }
+  }
+}

lib/features/player/core/init.dart

@@ -0,0 +1,62 @@
+import 'package:audio_service/audio_service.dart';
+import 'package:audio_session/audio_session.dart';
+import 'package:just_audio_background/just_audio_background.dart'
+    show JustAudioBackground, NotificationConfig;
+import 'package:just_audio_media_kit/just_audio_media_kit.dart'
+    show JustAudioMediaKit;
+import 'package:vaani/settings/app_settings_provider.dart';
+import 'package:vaani/settings/models/app_settings.dart';
+
+Future<void> configurePlayer() async {
+  // for playing audio on windows, linux
+  JustAudioMediaKit.ensureInitialized();
+
+  // for configuring how this app will interact with other audio apps
+  final session = await AudioSession.instance;
+  await session.configure(const AudioSessionConfiguration.speech());
+
+  final appSettings = loadOrCreateAppSettings();
+
+  // for playing audio in the background
+  await JustAudioBackground.init(
+    androidNotificationChannelId: 'com.vaani.bg_demo.channel.audio',
+    androidNotificationChannelName: 'Audio playback',
+    androidNotificationOngoing: true,
+    androidStopForegroundOnPause: true,
+    androidNotificationChannelDescription: 'Audio playback in the background',
+    androidNotificationIcon: 'drawable/ic_stat_notification_logo',
+    rewindInterval: appSettings.notificationSettings.rewindInterval,
+    fastForwardInterval: appSettings.notificationSettings.fastForwardInterval,
+    androidShowNotificationBadge: false,
+    notificationConfigBuilder: (state) {
+      final controls = [
+        if (appSettings.notificationSettings.mediaControls
+                .contains(NotificationMediaControl.skipToPreviousChapter) &&
+            state.hasPrevious)
+          MediaControl.skipToPrevious,
+        if (appSettings.notificationSettings.mediaControls
+            .contains(NotificationMediaControl.rewind))
+          MediaControl.rewind,
+        if (state.playing) MediaControl.pause else MediaControl.play,
+        if (appSettings.notificationSettings.mediaControls
+            .contains(NotificationMediaControl.fastForward))
+          MediaControl.fastForward,
+        if (appSettings.notificationSettings.mediaControls
+                .contains(NotificationMediaControl.skipToNextChapter) &&
+            state.hasNext)
+          MediaControl.skipToNext,
+        if (appSettings.notificationSettings.mediaControls
+            .contains(NotificationMediaControl.stop))
+          MediaControl.stop,
+      ];
+      return NotificationConfig(
+        controls: controls,
+        systemActions: const {
+          MediaAction.seek,
+          MediaAction.seekForward,
+          MediaAction.seekBackward,
+        },
+      );
+    },
+  );
+}