58 lines
2.4 KiB
Dart
58 lines
2.4 KiB
Dart
|
/// POST_NOTIFICATIONS 运行时权限门（P3 计划 Task 9）。
|
|||
|
|
///
|
|||
|
|
/// Android 13+（API 33）起，上传前台服务通知需运行时授权；未授权时
|
|||
|
|
/// 传输继续、仅通知不显示——**静默降级，永不阻断入队**（技术方案 §6.3）。
|
|||
|
|
///
|
|||
|
|
/// 实现取舍（有意不引入 permission_handler）：本 App 全部运行时权限需求
|
|||
|
|
/// 仅此一项（camera/image_picker 插件自管权限），为单个权限引入
|
|||
|
|
/// permission_handler 全家桶（AndroidX 传递依赖 + iOS Podfile 宏配置）
|
|||
|
|
/// 不成比例——复用既有原生桥接模式（Task 7 UploadPlugin 同款），自建
|
|||
|
|
/// MethodChannel `photolive/permissions`（MainActivity 内 PermissionPlugin
|
|||
|
|
/// 约 60 行 Kotlin，SDK<33 直接返回 granted）。后续再增权限需求时评估
|
|||
|
|
/// 插件化。
|
|||
|
|
///
|
|||
|
|
/// 进程内单次语义：首次入队动作（连拍/相册选择）时请求一次，之后不再
|
|||
|
|
/// 打扰；拒绝或通道失败（iOS/桌面无此通道）一律静默。
|
|||
|
|
library;
|
|||
|
|
|
|||
|
|
import 'dart:io';
|
|||
|
|
|
|||
|
|
import 'package:flutter/foundation.dart' show kIsWeb;
|
|||
|
|
import 'package:flutter/services.dart';
|
|||
|
|
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
|||
|
|
|
|||
|
|
/// 通知权限门（注入 [channel]/[isAndroid] 供测试）。
|
|||
|
|
class NotificationPermission {
|
|||
|
|
NotificationPermission({
|
|||
|
|
MethodChannel? channel,
|
|||
|
|
bool? isAndroid,
|
|||
|
|
}) : _channel = channel ?? const MethodChannel(kChannelName),
|
|||
|
|
_isAndroid = isAndroid ?? (!kIsWeb && Platform.isAndroid);
|
|||
|
|
|
|||
|
|
/// 平台通道名（与 Kotlin `PermissionPlugin.CHANNEL` 一致）。
|
|||
|
|
static const String kChannelName = 'photolive/permissions';
|
|||
|
|
|
|||
|
|
final MethodChannel _channel;
|
|||
|
|
final bool _isAndroid;
|
|||
|
|
bool _requested = false;
|
|||
|
|
|
|||
|
|
/// 确保已请求一次（首次入队动作调用；幂等）。
|
|||
|
|
///
|
|||
|
|
/// 非 Android 平台直接跳过（iOS 后台传输不依赖通知权限）；通道调用
|
|||
|
|
/// 失败/拒绝静默吞掉——上传链路不因通知权限降级而中断。
|
|||
|
|
Future<void> ensureRequested() async {
|
|||
|
|
if (_requested) return;
|
|||
|
|
_requested = true;
|
|||
|
|
if (!_isAndroid) return;
|
|||
|
|
try {
|
|||
|
|
await _channel.invokeMethod<String>('requestPostNotifications');
|
|||
|
|
} on Object {
|
|||
|
|
// 通道缺失（iOS/桌面）或请求异常：静默降级。
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 生产 Provider（队列/连拍页经 ref.read 一次性调用）。
|
|||
|
|
final notificationPermissionProvider =
|
|||
|
|
Provider<NotificationPermission>((ref) => NotificationPermission());
|