Files
ttstd_family_care/lib/features/album/presentation/album_controller.dart
T
tongtong 4976a26892 feat(security): 加固令牌与会话隔离,完善局域网授权与相册分页
- 令牌改用安全存储持久化,登录/登出按会话版本重建 ProviderScope 并清理账号缓存
- dio 401 刷新改为并发共享单次刷新,避免旧会话覆盖新账号令牌
- Android 17 增加局域网权限申请与网络安全配置,iOS 补充本地网络说明与钥匙串权限
- 相册分页加载并及时释放缩略图/媒体缓存,远程连接销毁时释放信令与 WebRTC
- 升级 AGP 9 / Gradle 9 / compileSdk 37,统一第三方插件 compileSdk,Windows 启用 /utf-8
- 新增 dio 刷新、会话隔离与相册分页单元测试
2026-11-05 11:19:52 +08:00

221 lines
7.0 KiB
Dart
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:ttstd_family_care/features/album/data/photo_providers.dart';
import 'package:ttstd_family_care/features/album/data/photo_repository.dart';
import 'package:ttstd_family_care/features/album/domain/album_models.dart';
/// 相簿加载错误类型。
enum AlbumLoadError { loadFolders, loadFolderAssets }
/// 哨兵值:用于区分 copyWith 中「不修改该字段」与「显式置为 null」。
///
/// 直接用 `field ?? this.field` 会导致 `copyWith(field: null)` 无法清空字段
/// (null 会被 `??` 兜底成旧值)。可空字段([AlbumState.currentAlbum]、
/// [AlbumState.error])必须用本哨兵作为参数默认值,才能支持显式清空。
const Object _noValue = Object();
/// 相簿页状态。
///
/// 只维护「相簿」分段所需数据:
/// - [permission]:相册权限状态(决定是否展示引导/空态)。
/// - [requesting]:是否正在请求权限或加载数据。
/// - [folders]:本机相簿(文件夹)列表,按时间降序。
/// - [currentAlbum]:当前打开查看的相簿;null 表示停留在相簿列表。
/// - [assets]:当前相簿内的媒体(缩略图句柄,时间降序)。
/// - [error]:一次性加载错误,UI 展示后调用 [AlbumController.consumeError] 消费。
/// 错误文案由 UI 依据 [AlbumLoadError] 映射到本地化文案,控制器不持有多语言字符串。
class AlbumState {
const AlbumState({
this.permission = AlbumPermissionStatus.denied,
this.requesting = false,
this.folders = const [],
this.currentAlbum,
this.assets = const [],
this.error,
this.hasMore = false,
this.loadingMore = false,
});
final AlbumPermissionStatus permission;
final bool requesting;
final List<AlbumFolder> folders;
/// 当前打开查看的相簿。
final AlbumFolder? currentAlbum;
/// 当前相簿内的媒体缩略图句柄。
final List<PhotoThumb> assets;
/// 一次性加载错误。
final AlbumLoadError? error;
final bool hasMore;
final bool loadingMore;
/// 复制并覆盖部分字段。
///
/// 可空字段 [currentAlbum] / [error] 使用 [Object] 类型参数 + [_noValue]
/// 哨兵实现:不传(保持默认)表示不修改,显式传 `null` 表示清空为 null,
/// 显式传具体值表示覆盖。其余字段沿用 `??` 语义。
AlbumState copyWith({
bool? hasMore,
bool? loadingMore,
AlbumPermissionStatus? permission,
bool? requesting,
List<AlbumFolder>? folders,
Object? currentAlbum = _noValue,
List<PhotoThumb>? assets,
Object? error = _noValue,
}) => AlbumState(
hasMore: hasMore ?? this.hasMore,
loadingMore: loadingMore ?? this.loadingMore,
permission: permission ?? this.permission,
requesting: requesting ?? this.requesting,
folders: folders ?? this.folders,
currentAlbum: identical(currentAlbum, _noValue)
? this.currentAlbum
: currentAlbum as AlbumFolder?,
assets: assets ?? this.assets,
error: identical(error, _noValue) ? this.error : error as AlbumLoadError?,
);
}
/// 相簿页控制器。
///
/// 页面级控制器,**不使用** keepAlive,随页面销毁自动释放(见 AGENTS.md §4)。
///
/// 职责:
/// - 进入「相簿」分段时申请相册权限(覆盖 Android / iOS 各版本)。
/// - 授权后加载本机相簿列表(按时间降序)。
/// - 打开某个相簿后加载其内媒体(时间降序)。
/// - 返回相簿列表(currentAlbum 置空)。
class AlbumController extends AutoDisposeNotifier<AlbumState> {
int _loadToken = 0;
bool _disposed = false;
int _nextPage = 0;
static const pageSize = 90;
@override
AlbumState build() {
_disposed = false;
ref.watch(photoRepositoryProvider);
ref.onDispose(() {
_disposed = true;
_loadToken++;
});
return const AlbumState();
}
Future<void> requestPermissionAndLoad() async {
if (state.requesting) return;
final token = ++_loadToken;
final repo = ref.read(photoRepositoryProvider);
state = state.copyWith(requesting: true, error: null);
try {
final status = await repo.requestPermission();
if (_disposed || token != _loadToken) return;
final allowed =
status == AlbumPermissionStatus.granted ||
status == AlbumPermissionStatus.limited;
final folders = allowed ? await repo.loadAlbums() : <AlbumFolder>[];
if (_disposed || token != _loadToken) return;
state = AlbumState(permission: status, folders: folders);
} catch (_) {
if (_disposed || token != _loadToken) return;
state = state.copyWith(
requesting: false,
error: AlbumLoadError.loadFolders,
);
}
}
Future<void> openAlbum(AlbumFolder folder) async {
final token = ++_loadToken;
final repo = ref.read(photoRepositoryProvider);
_nextPage = 0;
state = state.copyWith(
requesting: true,
currentAlbum: folder,
assets: const [],
hasMore: true,
loadingMore: false,
error: null,
);
try {
final assets = await repo.loadFolderAssets(
folder.id,
page: 0,
pageSize: pageSize,
);
if (_disposed || token != _loadToken) return;
_nextPage = 1;
state = state.copyWith(
requesting: false,
assets: assets,
hasMore: assets.length == pageSize,
);
} catch (_) {
if (_disposed || token != _loadToken) return;
state = state.copyWith(
requesting: false,
error: AlbumLoadError.loadFolderAssets,
);
}
}
Future<void> loadMore() async {
final folder = state.currentAlbum;
if (folder == null ||
state.requesting ||
state.loadingMore ||
!state.hasMore) {
return;
}
final token = _loadToken;
final repo = ref.read(photoRepositoryProvider);
state = state.copyWith(loadingMore: true, error: null);
try {
final assets = await repo.loadFolderAssets(
folder.id,
page: _nextPage,
pageSize: pageSize,
);
if (_disposed || token != _loadToken) return;
_nextPage++;
final ids = state.assets.map((e) => e.assetId).toSet();
state = state.copyWith(
loadingMore: false,
assets: [...state.assets, ...assets.where((e) => ids.add(e.assetId))],
hasMore: assets.length == pageSize,
);
} catch (_) {
if (_disposed || token != _loadToken) return;
state = state.copyWith(
loadingMore: false,
error: AlbumLoadError.loadFolderAssets,
);
}
}
void backToFolders() {
_loadToken++;
state = state.copyWith(
currentAlbum: null,
assets: const [],
requesting: false,
loadingMore: false,
hasMore: false,
error: null,
);
}
Future<void> openSettings() =>
ref.read(photoRepositoryProvider).openAppSettings();
void consumeError() {
state = state.copyWith(error: null);
}
}
final albumControllerProvider =
NotifierProvider.autoDispose<AlbumController, AlbumState>(
AlbumController.new,
);