feat(home): 首页按内容类型分频道 Feed 并支持分页

lib/pages/home/home_feed_channel.dart

@@ -0,0 +1,14 @@
+// Author: fruit.com.cn
+
+/// 首页顶栏的三个内容频道。
+enum HomeFeedChannel {
+  anime('ANIME'),
+  live('LIVE'),
+  recommend(null);
+
+  const HomeFeedChannel(this.apiType);
+
+  final String? apiType;
+
+  List<String> get apiTypes => apiType == null ? const [] : <String>[apiType!];
+}

lib/pages/home/home_view.dart

@@ -8,7 +8,7 @@ import 'package:flutter/services.dart';
 import 'package:provider/provider.dart';
 
 import '../../core/config/app_config.dart';
-import '../../core/data/models/drama.dart';
+import '../../core/data/services/home_feed_controller.dart';
 import '../../core/data/services/catalog_controller.dart';
 import '../../core/data/services/catalog_retry.dart';
 import '../../core/data/services/category_controller.dart';
@@ -24,8 +24,10 @@ import '../discover/discover_types.dart';
 import '../discover/discover_view.dart';
 import '../create/create_view.dart';
 import '../mine/mine_types.dart';
+import '../player/widgets/home_feed_header.dart';
 import '../player/player_view.dart';
 import '../mine/mine_view.dart';
+import 'home_feed_channel.dart';
 import 'home_binding.dart';
 import 'home_logic.dart';
 
@@ -43,6 +45,8 @@ class _HomePageState extends State<HomePage> with WidgetsBindingObserver {
   static const _defaultSplashSize = 384.0;
 
   bool _resumeRetryInFlight = false;
+  HomeFeedController? _homeFeed;
+  bool _recommendSeeded = false;
 
   @override
   void initState() {
@@ -52,6 +56,7 @@ class _HomePageState extends State<HomePage> with WidgetsBindingObserver {
 
   @override
   void dispose() {
+    _homeFeed?.dispose();
     WidgetsBinding.instance.removeObserver(this);
     super.dispose();
   }
@@ -131,11 +136,19 @@ class _HomePageState extends State<HomePage> with WidgetsBindingObserver {
       );
     }
 
-    return _HomeTabs(
-      key: ValueKey(catalog.dramas.first.id),
-      dramas: catalog.dramas,
-      onRefreshFeed: catalog.refresh,
-    );
+    final homeFeed = _ensureHomeFeed(catalog);
+    if (!_recommendSeeded) {
+      _recommendSeeded = true;
+      homeFeed.seedRecommend(catalog.dramas);
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        if (mounted) unawaited(homeFeed.refreshCurrent());
+      });
+    }
+    return _HomeTabs(key: const Key('home-tabs'), feedController: homeFeed);
+  }
+
+  HomeFeedController _ensureHomeFeed(CatalogController catalog) {
+    return _homeFeed ??= HomeFeedController(catalog.repository);
   }
 
   Widget _startupSplash() {
@@ -199,14 +212,9 @@ class HomeFailureView extends StatelessWidget {
 
 /// 四个根页面共享同一路由并保持各自状态。
 class _HomeTabs extends StatefulWidget {
-  const _HomeTabs({
-    super.key,
-    required this.dramas,
-    required this.onRefreshFeed,
-  });
+  const _HomeTabs({super.key, required this.feedController});
 
-  final List<Drama> dramas;
-  final Future<bool> Function() onRefreshFeed;
+  final HomeFeedController feedController;
 
   @override
   State<_HomeTabs> createState() => _HomeTabsState();
@@ -218,15 +226,21 @@ class _HomeTabsState extends State<_HomeTabs> {
   @override
   void initState() {
     super.initState();
-    logic = HomeBinding().create(widget.dramas);
+    logic = HomeBinding().create(widget.feedController.dramas);
+    widget.feedController.addListener(_onFeedChanged);
   }
 
   @override
   void dispose() {
+    widget.feedController.removeListener(_onFeedChanged);
     logic.dispose();
     super.dispose();
   }
 
+  void _onFeedChanged() {
+    if (mounted) setState(() {});
+  }
+
   @override
   Widget build(BuildContext context) {
     return ListenableBuilder(
@@ -277,16 +291,21 @@ class _HomeTabsState extends State<_HomeTabs> {
   }
 
   Widget _home(BuildContext context) {
+    final dramas = widget.feedController.dramas;
+    if (dramas.isEmpty) return _feedChannelPlaceholder(context);
     return PlayerPage(
       homeMode: true,
       embedded: true,
       active: logic.tab == 0,
-      drama: widget.dramas.first,
+      drama: dramas.first,
       initialIndex: 0,
-      feedDramas: widget.dramas,
+      feedDramas: dramas,
+      feedChannel: widget.feedController.channel,
       onOpenFullPlayer: (drama, episode) =>
           logic.playDrama(context, drama, episodeId: episode.id),
-      onRefreshFeed: widget.onRefreshFeed,
+      onRefreshFeed: widget.feedController.refreshCurrent,
+      onLoadMore: widget.feedController.loadMore,
+      onChannelSelected: _selectFeedChannel,
       onDramaChanged: logic.onDramaChanged,
       onImmersiveChanged: logic.onImmersiveChanged,
       onSearch: () => logic.select(1, search: true),
@@ -295,6 +314,65 @@ class _HomeTabsState extends State<_HomeTabs> {
     );
   }
 
+  Widget _feedChannelPlaceholder(BuildContext context) {
+    final l10n = AppLocalizations.of(context)!;
+    return Stack(
+      fit: StackFit.expand,
+      children: [
+        const ColoredBox(color: Colors.black),
+        SafeArea(
+          bottom: false,
+          child: Column(
+            children: [
+              HomeFeedHeader(
+                l10n: l10n,
+                channel: widget.feedController.channel,
+                onChannelSelected: _selectFeedChannel,
+                onRefresh: () => _refreshPlaceholder(context),
+                onSearch: () => logic.select(1, search: true),
+                onMore: () {},
+              ),
+              Expanded(
+                child: widget.feedController.loadingFirstPage
+                    ? const Center(
+                        child: SizedBox.square(
+                          dimension: 24,
+                          child: CircularProgressIndicator(
+                            key: Key('home-feed-channel-loading'),
+                            strokeWidth: 2.4,
+                            color: Colors.white70,
+                          ),
+                        ),
+                      )
+                    : EmptyState(
+                        icon: Icons.movie_outlined,
+                        title: l10n.noStories,
+                        actionLabel: l10n.retry,
+                        onAction: () =>
+                            unawaited(widget.feedController.refreshCurrent()),
+                      ),
+              ),
+            ],
+          ),
+        ),
+      ],
+    );
+  }
+
+  Future<bool> _refreshPlaceholder(BuildContext context) async {
+    final ok = await widget.feedController.refreshCurrent();
+    if (!ok && context.mounted) {
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(content: Text(AppLocalizations.of(context)!.catalogError)),
+      );
+    }
+    return ok;
+  }
+
+  void _selectFeedChannel(HomeFeedChannel channel) {
+    unawaited(widget.feedController.selectChannel(channel));
+  }
+
   Widget _discover(BuildContext context) {
     return DiscoverPage(
       active: logic.tab == 1,

lib/pages/player/player_logic.dart

@@ -100,6 +100,8 @@ class PlayerLogic extends ChangeNotifier {
   ValueChanged<Drama>? onDramaChanged;
   ValueChanged<bool>? onImmersiveChanged;
   bool _disposed = false;
+  PlayerFactory? _sessionFactory;
+  PlaybackCoordinator? _sessionCoordinator;
 
   /// [start] 是否已经跑过：没跑过时 session/pages 还是 late 未初始化，
   /// dispose 不能直接碰它们（例如页面构建失败或纯逻辑测试）。
@@ -109,6 +111,14 @@ class PlayerLogic extends ChangeNotifier {
 
   bool get chromeHidden => immersive;
 
+  /// 当前 PageView 对应用户正在观看的短剧 id，尚未起播时为 null。
+  String? get currentDramaId {
+    if (!_started || visibleIndices.isEmpty) return null;
+    final index = session.currentIndex;
+    if (index < 0 || index >= queue.length) return null;
+    return queue.entryAt(index).drama.id;
+  }
+
   Episode displayEpisode(Drama drama, Episode fallback) {
     final number = pickedEpisode[drama.id];
     if (number == null) return fallback;
@@ -145,6 +155,8 @@ class PlayerLogic extends ChangeNotifier {
     required PlaybackCoordinator coordinator,
   }) {
     _started = true;
+    _sessionFactory = factory;
+    _sessionCoordinator = coordinator;
     pictureInPicture.setStateListener(onPipChanged);
     queue = feedDramas == null
         ? PlaybackQueue.series(pageDrama)
@@ -153,7 +165,53 @@ class PlayerLogic extends ChangeNotifier {
     pages = PageController(initialPage: initialIndex);
     // 票据解析后要把新地址写回这个列表（PlaybackSession 的 canPlay 读的就是它）
     sessionEpisodes = [for (final entry in queue.entries) entry.episode];
-    session = PlaybackSession(
+    session = _createSession(factory, coordinator);
+    if (!active || visibleIndices.isEmpty) {
+      session.setRouteVisible(false);
+    }
+    unawaited(loadResumePoint());
+    unawaited(selectEpisode(initialIndex));
+  }
+
+  /// 原地替换首页 feed 队列；频道变化时重置到第 1 个，刷新时尽量保留当前剧。
+  void updateFeed(List<Drama> dramas, {String? keepDramaId}) {
+    final currentId = currentDramaId;
+    final nextQueue = PlaybackQueue.home(List<Drama>.unmodifiable(dramas));
+    final nextVisible = List<int>.generate(nextQueue.length, (index) => index);
+    final nextEpisodes = [for (final entry in nextQueue.entries) entry.episode];
+    feedDramas = List<Drama>.unmodifiable(dramas);
+    queue = nextQueue;
+    visibleIndices = nextVisible;
+    if (dramas.isNotEmpty) pageDrama = dramas.first;
+    if (!_started) return;
+    if (nextQueue.length == 0) {
+      session.setRouteVisible(false);
+      notify();
+      return;
+    }
+    final keepIndex = keepDramaId != null && keepDramaId == currentId
+        ? nextQueue.entries.indexWhere((entry) => entry.drama.id == keepDramaId)
+        : -1;
+    if (keepIndex >= 0 && session.active != null) {
+      sessionEpisodes
+        ..clear()
+        ..addAll(nextEpisodes);
+      session.remapCurrentIndex(
+        keepIndex,
+        preloadIndex: nextVisibleIndex(keepIndex),
+      );
+      _jumpToFeedPage(keepIndex);
+      notify();
+      return;
+    }
+    _replaceSession(nextEpisodes, keepIndex >= 0 ? keepIndex : 0);
+  }
+
+  PlaybackSession _createSession(
+    PlayerFactory factory,
+    PlaybackCoordinator coordinator,
+  ) {
+    return PlaybackSession(
       episodes: sessionEpisodes,
       factory: factory,
       // 地址只由后端下发（票据或详情里的免费集签名地址），拿不到地址即视为锁定
@@ -162,11 +220,35 @@ class PlayerLogic extends ChangeNotifier {
       activate: activatePlayer,
       coordinator: coordinator,
     );
-    if (!active || visibleIndices.isEmpty) {
-      session.setRouteVisible(false);
+  }
+
+  void _replaceSession(List<Episode> nextEpisodes, int targetIndex) {
+    final factory = _sessionFactory;
+    final coordinator = _sessionCoordinator;
+    if (factory == null || coordinator == null) return;
+    unawaited(saveCurrentProgress());
+    final previous = session;
+    sessionEpisodes = List<Episode>.of(nextEpisodes);
+    trackedPlayer = null;
+    trackedEpisode = null;
+    trackedDrama = null;
+    session = _createSession(factory, coordinator);
+    session.setRouteVisible(active && visibleIndices.isNotEmpty);
+    unawaited(previous.close());
+    _jumpToFeedPage(targetIndex);
+    unawaited(selectEpisode(targetIndex));
+    notify();
+  }
+
+  void _jumpToFeedPage(int index) {
+    if (!_started) return;
+    if (pages.hasClients) {
+      pages.jumpToPage(index);
+      return;
     }
-    unawaited(loadResumePoint());
-    unawaited(selectEpisode(initialIndex));
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (pages.hasClients) pages.jumpToPage(index);
+    });
   }
 
   /// 服务端续看位置：进播放页时取一次，用于"定位到上次那一集的那一秒"。

lib/pages/player/player_view.dart

@@ -2,6 +2,7 @@
 
 import 'dart:async';
 
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:provider/provider.dart';
@@ -22,6 +23,7 @@ import '../../core/theme/app_theme.dart';
 import '../../core/widgets/auth_gate.dart';
 import '../../core/widgets/download_action.dart';
 import '../../l10n/app_localizations.dart';
+import '../home/home_feed_channel.dart';
 import 'comments_auth.dart';
 import 'player_binding.dart';
 import 'player_logic.dart';
@@ -57,10 +59,13 @@ class PlayerPage extends StatefulWidget {
     this.onSearch,
     this.onMenu,
     this.feedDramas,
+    this.feedChannel,
     this.onDramaChanged,
     this.onImmersiveChanged,
     this.onOpenFullPlayer,
     this.onRefreshFeed,
+    this.onLoadMore,
+    this.onChannelSelected,
     this.wallet,
     this.downloads,
   });
@@ -77,10 +82,13 @@ class PlayerPage extends StatefulWidget {
   final VoidCallback? onSearch;
   final VoidCallback? onMenu;
   final List<Drama>? feedDramas;
+  final HomeFeedChannel? feedChannel;
   final ValueChanged<Drama>? onDramaChanged;
   final ValueChanged<bool>? onImmersiveChanged;
   final Future<void> Function(Drama drama, Episode episode)? onOpenFullPlayer;
   final Future<bool> Function()? onRefreshFeed;
+  final Future<void> Function()? onLoadMore;
+  final ValueChanged<HomeFeedChannel>? onChannelSelected;
   final WalletController? wallet;
   final DownloadController? downloads;
 
@@ -123,6 +131,17 @@ class _PlayerPageState extends State<PlayerPage>
   void didUpdateWidget(covariant PlayerPage oldWidget) {
     super.didUpdateWidget(oldWidget);
     logic.attach(widget, isMounted: () => mounted);
+    if (widget.homeMode &&
+        widget.feedDramas != null &&
+        (!listEquals(oldWidget.feedDramas, widget.feedDramas) ||
+            oldWidget.feedChannel != widget.feedChannel)) {
+      logic.updateFeed(
+        widget.feedDramas!,
+        keepDramaId: oldWidget.feedChannel == widget.feedChannel
+            ? logic.currentDramaId
+            : null,
+      );
+    }
     logic.onPageUpdated(oldWidget);
   }
 
@@ -250,6 +269,10 @@ class _PlayerPageState extends State<PlayerPage>
           final index = indices[position];
           widget.onDramaChanged?.call(logic.queue.entryAt(index).drama);
           unawaited(logic.selectEpisode(index));
+          if (position >= indices.length - 3) {
+            final loadMore = widget.onLoadMore;
+            if (loadMore != null) unawaited(loadMore());
+          }
         },
         itemBuilder: (context, position) =>
             _buildEpisode(context, indices[position], interactions),
@@ -268,6 +291,8 @@ class _PlayerPageState extends State<PlayerPage>
               bottom: false,
               child: HomeFeedHeader(
                 l10n: l10n,
+                channel: widget.feedChannel ?? HomeFeedChannel.recommend,
+                onChannelSelected: widget.onChannelSelected ?? (_) {},
                 onRefresh: () async {
                   final ok = await widget.onRefreshFeed?.call() ?? true;
                   if (context.mounted && !ok) {

lib/pages/player/widgets/home_feed_header.dart

@@ -2,6 +2,7 @@
 
 import 'package:flutter/material.dart';
 
+import '../../home/home_feed_channel.dart';
 import '../../../l10n/app_localizations.dart';
 
 const double _topIconSize = 36;
@@ -16,12 +17,16 @@ class HomeFeedHeader extends StatefulWidget {
   const HomeFeedHeader({
     super.key,
     required this.l10n,
+    required this.channel,
+    required this.onChannelSelected,
     required this.onRefresh,
     required this.onSearch,
     required this.onMore,
   });
 
   final AppLocalizations l10n;
+  final HomeFeedChannel channel;
+  final ValueChanged<HomeFeedChannel> onChannelSelected;
   final Future<bool> Function() onRefresh;
   final VoidCallback onSearch;
   final VoidCallback onMore;
@@ -31,7 +36,6 @@ class HomeFeedHeader extends StatefulWidget {
 }
 
 class _HomeFeedHeaderState extends State<HomeFeedHeader> {
-  _FeedTab _tab = _FeedTab.recommend;
   bool _refreshing = false;
 
   @override
@@ -54,8 +58,12 @@ class _HomeFeedHeaderState extends State<HomeFeedHeader> {
                 scrollDirection: Axis.horizontal,
                 child: Row(
                   children: [
-                    for (var index = 0; index < _FeedTab.values.length; index++)
-                      _tabSlot(_FeedTab.values[index], index),
+                    for (
+                      var index = 0;
+                      index < HomeFeedChannel.values.length;
+                      index++
+                    )
+                      _tabSlot(HomeFeedChannel.values[index], index),
                   ],
                 ),
               ),
@@ -74,15 +82,15 @@ class _HomeFeedHeaderState extends State<HomeFeedHeader> {
     );
   }
 
-  Widget _tabSlot(_FeedTab tab, int index) {
+  Widget _tabSlot(HomeFeedChannel channel, int index) {
     final item = _FeedTabItem(
-      tab: tab,
-      label: tab.label(widget.l10n),
-      selected: _tab == tab,
+      channel: channel,
+      label: _label(channel),
+      selected: widget.channel == channel,
       fontSize: _tabFontSize,
       underlineWidth: _underlineWidth,
       underlineHeight: _underlineHeight,
-      onTap: () => _selectTab(tab),
+      onTap: () => widget.onChannelSelected(channel),
     );
     if (index == 0) return item;
     return Padding(
@@ -91,14 +99,6 @@ class _HomeFeedHeaderState extends State<HomeFeedHeader> {
     );
   }
 
-  void _selectTab(_FeedTab tab) {
-    if (tab.comingSoon) {
-      _showComingSoon();
-      return;
-    }
-    setState(() => _tab = tab);
-  }
-
   Future<void> _refresh() async {
     if (_refreshing) return;
     setState(() => _refreshing = true);
@@ -106,31 +106,10 @@ class _HomeFeedHeaderState extends State<HomeFeedHeader> {
     if (mounted) setState(() => _refreshing = false);
   }
 
-  void _showComingSoon() {
-    ScaffoldMessenger.of(
-      context,
-    ).showSnackBar(SnackBar(content: Text(widget.l10n.comingSoon)));
-  }
-}
-
-/// 顶部频道 tab：漫剧点击提示即将上线。
-enum _FeedTab {
-  anime,
-  real,
-  recommend;
-
-  bool get comingSoon => this == _FeedTab.anime;
-
-  String get keyName => switch (this) {
-    _FeedTab.anime => 'anime',
-    _FeedTab.real => 'real',
-    _FeedTab.recommend => 'recommend',
-  };
-
-  String label(AppLocalizations l10n) => switch (this) {
-    _FeedTab.anime => l10n.feedTabAnime,
-    _FeedTab.real => l10n.feedTabReal,
-    _FeedTab.recommend => l10n.feedTabForYou,
+  String _label(HomeFeedChannel channel) => switch (channel) {
+    HomeFeedChannel.anime => widget.l10n.feedTabAnime,
+    HomeFeedChannel.live => widget.l10n.feedTabReal,
+    HomeFeedChannel.recommend => widget.l10n.feedTabForYou,
   };
 }
 
@@ -223,7 +202,7 @@ class _RefreshButton extends StatelessWidget {
 
 class _FeedTabItem extends StatelessWidget {
   const _FeedTabItem({
-    required this.tab,
+    required this.channel,
     required this.label,
     required this.selected,
     required this.fontSize,
@@ -232,7 +211,7 @@ class _FeedTabItem extends StatelessWidget {
     required this.onTap,
   });
 
-  final _FeedTab tab;
+  final HomeFeedChannel channel;
   final String label;
   final bool selected;
   final double fontSize;
@@ -243,7 +222,7 @@ class _FeedTabItem extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     return GestureDetector(
-      key: Key('home-feed-tab-${tab.keyName}'),
+      key: Key('home-feed-tab-${_keyName(channel)}'),
       behavior: HitTestBehavior.opaque,
       onTap: onTap,
       child: Column(
@@ -272,4 +251,10 @@ class _FeedTabItem extends StatelessWidget {
       ),
     );
   }
+
+  String _keyName(HomeFeedChannel channel) => switch (channel) {
+    HomeFeedChannel.anime => 'anime',
+    HomeFeedChannel.live => 'real',
+    HomeFeedChannel.recommend => 'recommend',
+  };
 }