- 令牌改用安全存储持久化,登录/登出按会话版本重建 ProviderScope 并清理账号缓存 - dio 401 刷新改为并发共享单次刷新,避免旧会话覆盖新账号令牌 - Android 17 增加局域网权限申请与网络安全配置,iOS 补充本地网络说明与钥匙串权限 - 相册分页加载并及时释放缩略图/媒体缓存,远程连接销毁时释放信令与 WebRTC - 升级 AGP 9 / Gradle 9 / compileSdk 37,统一第三方插件 compileSdk,Windows 启用 /utf-8 - 新增 dio 刷新、会话隔离与相册分页单元测试
221 lines
7.0 KiB
Dart
221 lines
7.0 KiB
Dart
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,
|
||
);
|