68 lines
2.6 KiB
Dart
68 lines
2.6 KiB
Dart
|
/// 引擎生命周期绑定（P3 计划 Task 6 关注点 1，Task 9 接线）。
|
|||
|
|
///
|
|||
|
|
/// 登录会话账号（SessionStore.account）→ [UploadEngine.start] 的 scope：
|
|||
|
|
/// - 账号在场（App 启动恢复会话 / 登录成功）→ start(accountId)——待传
|
|||
|
|
/// 队列尽快恢复出队（A05）；
|
|||
|
|
/// - 账号离场（登出 / 401 驱逐）→ stop()——**任务行保留在库内**，账号
|
|||
|
|
/// 切换安全由 TaskStore 的 accountId 硬隔离守护保障；
|
|||
|
|
/// - 会话变更通知点：登录页成功、设置页登出、App 壳 401 回调，均调
|
|||
|
|
/// [SessionAccountNotifier.refresh]。
|
|||
|
|
///
|
|||
|
|
/// [uploadEngineScopeProvider] 由 App 壳（PhotoLiveApp.build）watch 保持
|
|||
|
|
/// 常驻——离开登录态即 stop，绝不遗留旧账号的周期出队。
|
|||
|
|
library;
|
|||
|
|
|
|||
|
|
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
|||
|
|
|
|||
|
|
import '../../core/api_client.dart';
|
|||
|
|
import 'providers.dart';
|
|||
|
|
import 'upload_engine.dart';
|
|||
|
|
|
|||
|
|
/// 会话账号 Notifier：读 SessionStore；登录/登出/401 后 refresh()。
|
|||
|
|
class SessionAccountNotifier extends AsyncNotifier<String?> {
|
|||
|
|
@override
|
|||
|
|
Future<String?> build() async {
|
|||
|
|
final session = await ref.watch(sessionStoreProvider).read();
|
|||
|
|
return _normalize(session?.account);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 重读会话（登录成功/登出/401 驱逐后调用）。
|
|||
|
|
Future<void> refresh() async {
|
|||
|
|
final store = ref.read(sessionStoreProvider);
|
|||
|
|
state = const AsyncLoading<String?>();
|
|||
|
|
state = await AsyncValue.guard(() async {
|
|||
|
|
final session = await store.read();
|
|||
|
|
return _normalize(session?.account);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 空串归一为 null（未登录语义；引擎 scope 判空依据）。
|
|||
|
|
static String? _normalize(String? account) =>
|
|||
|
|
(account == null || account.isEmpty) ? null : account;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 会话账号 Provider（引擎 scope 与队列/连拍 UI 的 accountId 来源）。
|
|||
|
|
final sessionAccountProvider =
|
|||
|
|
AsyncNotifierProvider<SessionAccountNotifier, String?>(
|
|||
|
|
SessionAccountNotifier.new,
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
/// 引擎生命周期绑定：账号在场 → start；离场 → stop（任务保留库内）。
|
|||
|
|
///
|
|||
|
|
/// 返回当前 scope 账号（null=引擎停止）；仅被 App 壳 watch 时生效
|
|||
|
|
/// （Provider 惰性求值）。
|
|||
|
|
final uploadEngineScopeProvider = Provider<String?>((ref) {
|
|||
|
|
final account = ref.watch(sessionAccountProvider).value;
|
|||
|
|
final engine = ref.watch(uploadEngineProvider);
|
|||
|
|
if (account != null) {
|
|||
|
|
engine.start(account);
|
|||
|
|
} else {
|
|||
|
|
engine.stop();
|
|||
|
|
}
|
|||
|
|
ref.onDispose(engine.stop);
|
|||
|
|
return account;
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
/// 供文档引用的类型锚点（[UploadEngine] 生命周期语义见 upload_engine.dart）。
|
|||
|
|
typedef EngineLifecycleDoc = UploadEngine;
|