Album and playlist

fliin login
fliin add collection

// lib/collection_route.dart, next to collection_page.dart.
import 'package:go_router/go_router.dart';

import 'collection_page.dart';

/// Add collectionRoute to the routes of your GoRouter.
final collectionRoute = GoRoute(
  path: '/collections/:id',
  builder: (context, state) => CollectionPage(
    collectionId: state.pathParameters['id']!,
    // Alone in the stack (deep link, go): your app's home.
    onBack: () => context.canPop() ? context.pop() : context.go('/'),
  ),
);

// lib/collection_route.dart, next to collection_page.dart.
import 'package:flutter/material.dart';

import 'collection_page.dart';

/// Opens “Album and playlist”: `Navigator.of(context).push(collectionRoute(collectionId))`.
Route<void> collectionRoute(String collectionId) => MaterialPageRoute<void>(
  builder: (context) => CollectionPage(
    collectionId: collectionId,
    onBack: () => Navigator.of(context).maybePop(),
  ),
);

// lib/collection_page.dart
// Your backend: implement CollectionService (collection_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/collection/collection_data.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_screen.dart';
import 'package:your_app/ui/fliin/screens/player/player_data.dart';
import 'package:flutter/widgets.dart';

import 'player_page.dart';

// The mini player shows the app's player, the one of PlayerPage: a
// track played here plays there, and a pause there shows here.
final collectionNowPlaying = CollectionNowPlayingOf(
  samplePlayer.playback,
  (playback) => switch (playback) {
    PlaybackReady(:final track, :final playing, :final buffering) => CollectionNowPlaying(
      trackId: track.id,
      title: track.title,
      artist: track.artist,
      artwork: track.artwork,
      playing: playing,
      buffering: buffering,
    ),
    _ => null,
  },
);

PlayerTrack _playerTrack(CollectionTrack track) => PlayerTrack(
  id: track.id,
  title: track.title,
  artist: track.artist,
  album: track.album,
  duration: track.duration,
  artwork: track.artwork,
);

// The album or the playlist becomes the player's queue: from the tapped
// track, from its first, or shuffled.
void playCollection(Collection collection, {CollectionTrack? from, bool shuffle = false}) => samplePlayer.playQueue(
  [for (final track in collection.tracks) _playerTrack(track)],
  from: from == null ? null : _playerTrack(from),
  shuffle: shuffle,
);

class CollectionPage extends StatelessWidget {
  const CollectionPage({
    super.key,
    required this.collectionId,
    required this.onBack,
  });

  final String collectionId;
  final VoidCallback onBack;

  @override
  Widget build(BuildContext context) => CollectionScreen.standalone(
    service: SampleCollectionService(),
    id: collectionId,
    nowPlaying: collectionNowPlaying,
    onPlay: (collection, track) => playCollection(collection, from: track),
    onPlayAll: playCollection,
    onShuffle: (collection) => playCollection(collection, shuffle: true),
    onPlayPause: samplePlayer.playPause,
    onNext: samplePlayer.next,
    // The player opens out of the dock, under the finger.
    player: (context, close) => PlayerPage(onBack: close),
    onBack: onBack,
  );
}

// lib/collection_page.dart
// Your backend: implement CollectionService (collection_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/collection/collection_controller.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_data.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_screen.dart';
import 'package:your_app/ui/fliin/screens/player/player_data.dart';
import 'package:flutter/widgets.dart';
import 'package:provider/provider.dart';

import 'player_page.dart';

// The mini player shows the app's player, the one of PlayerPage: a
// track played here plays there, and a pause there shows here.
final collectionNowPlaying = CollectionNowPlayingOf(
  samplePlayer.playback,
  (playback) => switch (playback) {
    PlaybackReady(:final track, :final playing, :final buffering) => CollectionNowPlaying(
      trackId: track.id,
      title: track.title,
      artist: track.artist,
      artwork: track.artwork,
      playing: playing,
      buffering: buffering,
    ),
    _ => null,
  },
);

PlayerTrack _playerTrack(CollectionTrack track) => PlayerTrack(
  id: track.id,
  title: track.title,
  artist: track.artist,
  album: track.album,
  duration: track.duration,
  artwork: track.artwork,
);

// The album or the playlist becomes the player's queue: from the tapped
// track, from its first, or shuffled.
void playCollection(Collection collection, {CollectionTrack? from, bool shuffle = false}) => samplePlayer.playQueue(
  [for (final track in collection.tracks) _playerTrack(track)],
  from: from == null ? null : _playerTrack(from),
  shuffle: shuffle,
);

class CollectionPage extends StatelessWidget {
  const CollectionPage({
    super.key,
    required this.collectionId,
    required this.onBack,
  });

  final String collectionId;
  final VoidCallback onBack;

  @override
  Widget build(BuildContext context) => ChangeNotifierProvider(
    create: (_) => CollectionController(service: SampleCollectionService(), id: collectionId)..load(),
    child: Builder(
      builder: (context) => CollectionScreen(
        controller: context.read<CollectionController>(),
        nowPlaying: collectionNowPlaying,
        onPlay: (collection, track) => playCollection(collection, from: track),
        onPlayAll: playCollection,
        onShuffle: (collection) => playCollection(collection, shuffle: true),
        onPlayPause: samplePlayer.playPause,
        onNext: samplePlayer.next,
        // The player opens out of the dock, under the finger.
        player: (context, close) => PlayerPage(onBack: close),
        onBack: onBack,
      ),
    ),
  );
}

// lib/collection_page.dart
// Your backend: implement CollectionService (collection_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/collection/collection_controller.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_data.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_screen.dart';
import 'package:your_app/ui/fliin/screens/player/player_data.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

import 'player_page.dart';

// The mini player shows the app's player, the one of PlayerPage: a
// track played here plays there, and a pause there shows here.
final collectionNowPlaying = CollectionNowPlayingOf(
  samplePlayer.playback,
  (playback) => switch (playback) {
    PlaybackReady(:final track, :final playing, :final buffering) => CollectionNowPlaying(
      trackId: track.id,
      title: track.title,
      artist: track.artist,
      artwork: track.artwork,
      playing: playing,
      buffering: buffering,
    ),
    _ => null,
  },
);

PlayerTrack _playerTrack(CollectionTrack track) => PlayerTrack(
  id: track.id,
  title: track.title,
  artist: track.artist,
  album: track.album,
  duration: track.duration,
  artwork: track.artwork,
);

// The album or the playlist becomes the player's queue: from the tapped
// track, from its first, or shuffled.
void playCollection(Collection collection, {CollectionTrack? from, bool shuffle = false}) => samplePlayer.playQueue(
  [for (final track in collection.tracks) _playerTrack(track)],
  from: from == null ? null : _playerTrack(from),
  shuffle: shuffle,
);

final collectionControllerProvider = Provider.autoDispose.family<CollectionController, String>((ref, collectionId) {
  final controller = CollectionController(service: SampleCollectionService(), id: collectionId)..load();
  ref.onDispose(controller.dispose);
  return controller;
});

class CollectionPage extends ConsumerWidget {
  const CollectionPage({
    super.key,
    required this.collectionId,
    required this.onBack,
  });

  final String collectionId;
  final VoidCallback onBack;

  @override
  Widget build(BuildContext context, WidgetRef ref) => CollectionScreen(
    controller: ref.watch(collectionControllerProvider(collectionId)),
    nowPlaying: collectionNowPlaying,
    onPlay: (collection, track) => playCollection(collection, from: track),
    onPlayAll: playCollection,
    onShuffle: (collection) => playCollection(collection, shuffle: true),
    onPlayPause: samplePlayer.playPause,
    onNext: samplePlayer.next,
    // The player opens out of the dock, under the finger.
    player: (context, close) => PlayerPage(onBack: close),
    onBack: onBack,
  );
}

// lib/collection_page.dart
// Your backend: implement CollectionService (collection_data.dart) and pass it instead of the sample service.
import 'package:your_app/ui/fliin/screens/collection/collection_controller.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_data.dart';
import 'package:your_app/ui/fliin/screens/collection/collection_screen.dart';
import 'package:your_app/ui/fliin/screens/player/player_data.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_bloc/flutter_bloc.dart';

import 'player_page.dart';

// The mini player shows the app's player, the one of PlayerPage: a
// track played here plays there, and a pause there shows here.
final collectionNowPlaying = CollectionNowPlayingOf(
  samplePlayer.playback,
  (playback) => switch (playback) {
    PlaybackReady(:final track, :final playing, :final buffering) => CollectionNowPlaying(
      trackId: track.id,
      title: track.title,
      artist: track.artist,
      artwork: track.artwork,
      playing: playing,
      buffering: buffering,
    ),
    _ => null,
  },
);

PlayerTrack _playerTrack(CollectionTrack track) => PlayerTrack(
  id: track.id,
  title: track.title,
  artist: track.artist,
  album: track.album,
  duration: track.duration,
  artwork: track.artwork,
);

// The album or the playlist becomes the player's queue: from the tapped
// track, from its first, or shuffled.
void playCollection(Collection collection, {CollectionTrack? from, bool shuffle = false}) => samplePlayer.playQueue(
  [for (final track in collection.tracks) _playerTrack(track)],
  from: from == null ? null : _playerTrack(from),
  shuffle: shuffle,
);

/// The screen's controller as a bloc, for your BlocListener and BlocBuilder:
/// one emission per controller notification. `version` tells them apart
/// when `state` does not change (mode, filters, text…, read them on
/// `controller`). The screen listens to the controller itself.
class CollectionCubit extends Cubit<({CollectionState state, int version})> {
  CollectionCubit(this.controller) : super((state: controller.state, version: 0)) {
    controller.addListener(_changed);
  }

  final CollectionController controller;

  void _changed() => emit((state: controller.state, version: state.version + 1));

  @override
  Future<void> close() {
    controller
      ..removeListener(_changed)
      ..dispose();
    return super.close();
  }
}

class CollectionPage extends StatelessWidget {
  const CollectionPage({
    super.key,
    required this.collectionId,
    required this.onBack,
  });

  final String collectionId;
  final VoidCallback onBack;

  @override
  Widget build(BuildContext context) => BlocProvider(
    create: (_) => CollectionCubit(CollectionController(service: SampleCollectionService(), id: collectionId)..load()),
    child: Builder(
      builder: (context) => CollectionScreen(
        controller: context.read<CollectionCubit>().controller,
        nowPlaying: collectionNowPlaying,
        onPlay: (collection, track) => playCollection(collection, from: track),
        onPlayAll: playCollection,
        onShuffle: (collection) => playCollection(collection, shuffle: true),
        onPlayPause: samplePlayer.playPause,
        onNext: samplePlayer.next,
        // The player opens out of the dock, under the finger.
        player: (context, close) => PlayerPage(onBack: close),
        onBack: onBack,
      ),
    ),
  );
}

CollectionScreen: class extends StatefulWidget
CollectionScreen.new: const new({super.key, required CollectionController controller, ValueListenable<CollectionNowPlaying?>? nowPlaying, void Function(Collection collection, CollectionTrack track)? onPlay, ValueChanged<Collection>? onPlayAll, ValueChanged<Collection>? onShuffle, VoidCallback? onPlayPause, VoidCallback? onNext, VoidCallback? onOpenPlayer, ValueChanged<Collection>? onMore, VoidCallback? onBack, Widget? navigation, Widget Function(BuildContext context, VoidCallback close)? player})
CollectionScreen.standalone: const new({super.key, required CollectionService service, required String id, CollectionState? initial, ValueListenable<CollectionNowPlaying?>? nowPlaying, void Function(Collection collection, CollectionTrack track)? onPlay, ValueChanged<Collection>? onPlayAll, ValueChanged<Collection>? onShuffle, VoidCallback? onPlayPause, VoidCallback? onNext, VoidCallback? onOpenPlayer, ValueChanged<Collection>? onMore, VoidCallback? onBack, Widget? navigation, Widget Function(BuildContext context, VoidCallback close)? player})
CollectionScreen.controller: get CollectionController?
CollectionScreen.service: get CollectionService?
CollectionScreen.id: get String?
CollectionScreen.initial: get CollectionState?
CollectionScreen.nowPlaying: get ValueListenable<CollectionNowPlaying?>?
CollectionScreen.onPlay: get void Function(Collection collection, CollectionTrack track)?
CollectionScreen.onPlayAll: get ValueChanged<Collection>?
CollectionScreen.onShuffle: get ValueChanged<Collection>?
CollectionScreen.onPlayPause: get VoidCallback?
CollectionScreen.onNext: get VoidCallback?
CollectionScreen.onOpenPlayer: get VoidCallback?
CollectionScreen.onMore: get ValueChanged<Collection>?
CollectionScreen.onBack: get VoidCallback?
CollectionScreen.navigation: get Widget?
CollectionScreen.player: get Widget Function(BuildContext context, VoidCallback close)?
CollectionScreen.createState: State<CollectionScreen>()
CollectionState: sealed class permits {CollectionFailed, CollectionLoading, CollectionOffline, CollectionShown}
CollectionState.new: const new()
CollectionLoading: final class extends CollectionState
CollectionLoading.new: const new()
CollectionFailed: final class extends CollectionState
CollectionFailed.new: const new()
CollectionOffline: final class extends CollectionState
CollectionOffline.new: const new()
CollectionShown: final class extends CollectionState
CollectionShown.new: const new(Collection collection)
CollectionShown.collection: get Collection
CollectionController: class extends ChangeNotifier
CollectionController.new: new({required CollectionService service, required String id, CollectionState initial})
CollectionController.service: get CollectionService
CollectionController.id: get String
CollectionController.state: get CollectionState
CollectionController.load: Future<void>()
CollectionController.dispose: void()
CollectionKind: enum {album, playlist}
CollectionKind.album: static final CollectionKind
CollectionKind.playlist: static final CollectionKind
CollectionTrack: final class
CollectionTrack.new: const new({required String id, required String title, required String artist, required String album, required Duration duration, ImageProvider? artwork})
CollectionTrack.id: get String
CollectionTrack.title: get String
CollectionTrack.artist: get String
CollectionTrack.album: get String
CollectionTrack.duration: get Duration
CollectionTrack.artwork: get ImageProvider?
Collection: final class
Collection.new: const new({required String id, required CollectionKind kind, required String title, required String byline, required List<CollectionTrack> tracks, int? year, String? description, ImageProvider? artwork})
Collection.id: get String
Collection.kind: get CollectionKind
Collection.title: get String
Collection.byline: get String
Collection.tracks: get List<CollectionTrack>
Collection.year: get int?
Collection.description: get String?
Collection.artwork: get ImageProvider?
Collection.duration: get Duration
CollectionNoNetwork: final class implements Exception
CollectionNoNetwork.new: const new()
CollectionService: abstract interface class
CollectionService.new: new()
CollectionService.collection: abstract Future<Collection>(String id)
CollectionNowPlaying: final class
CollectionNowPlaying.new: const new({required String trackId, required String title, required String artist, required bool playing, bool buffering, ImageProvider? artwork})
CollectionNowPlaying.trackId: get String
CollectionNowPlaying.title: get String
CollectionNowPlaying.artist: get String
CollectionNowPlaying.playing: get bool
CollectionNowPlaying.buffering: get bool
CollectionNowPlaying.artwork: get ImageProvider?
CollectionNowPlayingOf: final class<T> implements ValueListenable<CollectionNowPlaying?>
CollectionNowPlayingOf.new: const new(ValueListenable<T> source, CollectionNowPlaying? Function(T state) read)
CollectionNowPlayingOf.source: get ValueListenable<T>
CollectionNowPlayingOf.read: get CollectionNowPlaying? Function(T state)
CollectionNowPlayingOf.value: get CollectionNowPlaying?
CollectionNowPlayingOf.addListener: void(VoidCallback listener)
CollectionNowPlayingOf.removeListener: void(VoidCallback listener)
sampleCollectionPhotoUrls: const dynamic
sampleCollectionImage: ImageProvider(String name)
sampleCollectionDrawing: ImageProvider(String name)
sampleAlbums: List<Collection>({ImageProvider Function(String name) image})
samplePlaylists: List<Collection>({ImageProvider Function(String name) image})
sampleAlbum: Collection({ImageProvider Function(String name) image})
samplePlaylist: Collection({ImageProvider Function(String name) image})
SampleCollectionService: final class implements CollectionService
SampleCollectionService.new: new({Duration latency, ImageProvider Function(String name) image})
SampleCollectionService.latency: get Duration
SampleCollectionService.image: get ImageProvider Function(String name)
SampleCollectionService.requests: get List<String>
SampleCollectionService.collection: Future<Collection>(String id)
collectionL10n: const Map<String, Map<String, String>>
CollectionStrings: final class
CollectionStrings.new: const new(String language)
CollectionStrings.of: factory new(BuildContext context)
CollectionStrings.language: get String
CollectionStrings.digits: String(int n)
CollectionStrings.count: String(int n)
CollectionStrings.clock: String(Duration time)
CollectionStrings.spoken: String(Duration time)
CollectionStrings.length: String(Duration time)
CollectionStrings.kind: String(CollectionKind kind)
CollectionStrings.meta: String(CollectionKind kind, int year)
CollectionStrings.back: get String
CollectionStrings.more: get String
CollectionStrings.loading: get String
CollectionStrings.play: get String
CollectionStrings.shuffle: get String
CollectionStrings.nowPlaying: get String
CollectionStrings.paused: get String
CollectionStrings.openPlayer: String(CollectionNowPlaying now)
CollectionStrings.pause: get String
CollectionStrings.next: get String
CollectionStrings.expand: get String
CollectionStrings.buffering: get String
CollectionStrings.tracks: String(int count)
CollectionStrings.total: String(int count, Duration time)
CollectionStrings.emptyTitle: get String
CollectionStrings.emptyMessage: get String
CollectionStrings.errorTitle: get String
CollectionStrings.errorMessage: get String
CollectionStrings.offlineTitle: get String
CollectionStrings.offlineMessage: get String
CollectionStrings.retry: get String