Files
ttstd_family_care/lib/features/home/presentation/map_page.dart
T
tongtong 71dd8eb52c feat(theme): 添加全局深色模式支持与主题适配
- 引入 DarkMode 工具类,提供系统栏、颜色、色调的暗色适配能力
- AppColors 调色板改为 CupertinoDynamicColor.withBrightness 自适应
- app.dart 增加 AnnotatedRegion 与 Material Theme 包裹以联动暗色系统栏
- 移除 system_ui_util 中硬编码的浅色图标配置,改由主题驱动
- CardBox、AppDivider、SectionTitle 等公共组件适配深色卡片与分割线
- settings_ui、change_mobile、change_password、login_devices、wechat_binding 等页面全面接入 DarkMode 颜色
- dio_client 新增 allowStale 响应缓存机制,网络异常时回退本地缓存
- token_storage 增加 currentAccountId(JWT 解析)及按用户隔离的设备偏好存取
- ApiException 改为通过私有构造持有真实 AppError 实例,appError getter 返回结构化错误
- 闹钟模块迁移至 FutureProvider.autoDispose.family,消除手动 loading 状态管理
- 闹钟编辑页 CupertinoTimerPicker 替换为 CupertinoDatePicker(24h 格式),标签输入改为 TextEditingController
2026-11-07 02:35:30 +08:00

336 lines
13 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:cupertino_ui/cupertino_ui.dart';
import 'package:flutter_baidu_mapapi_base/flutter_baidu_mapapi_base.dart';
import 'package:flutter_baidu_mapapi_map/flutter_baidu_mapapi_map.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:ttstd_family_care/core/widgets/app_page_scaffold.dart';
import '../../../core/utils/coord_util.dart';
import '../../../l10n/app_localizations.dart';
import '../../device/data/device_providers.dart';
import '../../device/domain/device_models.dart';
import '../../device/presentation/device_switcher.dart';
import '../data/location_controller.dart';
import 'location_map_view.dart';
/// 设备实时位置地图页。
///
/// 基于百度地图展示设备上报的实时位置。定位数据来自
/// `GET /api/v1/client/sn/device-info`(经 [deviceLocationProvider] 解析),
/// 后端返回 GPS(WGS84) 坐标,展示前转换为百度 BD09LL 坐标。
class MapPage extends ConsumerStatefulWidget {
const MapPage({required this.sn, super.key});
final String sn;
@override
ConsumerState<MapPage> createState() => _MapPageState();
}
class _MapPageState extends ConsumerState<MapPage> with WidgetsBindingObserver {
BMFMapController? _mapController;
bool _markerAdded = false;
// 是否正在「定位到我」:点击定位按钮后置 true,拿到本机定位后归 false。
bool _isLocatingSelf = false;
// 平台视图重建代数:app 从后台恢复时自增,强制重建原生地图(见 _recreatePlatformView)。
int _platformViewGeneration = 0;
@override
void initState() {
super.initState();
// 监听 app 生命周期,app 从后台恢复时重建原生地图视图。
WidgetsBinding.instance.addObserver(this);
}
@override
void dispose() {
WidgetsBinding.instance.removeObserver(this);
// 地图控制器由底层平台视图生命周期管理,销毁时主动清空本地引用,
// 避免 teardown 阶段对已释放的原生视图发起调用(降低百度 SDK 原生崩溃风险)。
_mapController = null;
super.dispose();
}
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
// 切换到桌面(paused)再返回时,百度地图原生 Surface 可能残留在其它
// Flutter 页面之上不消失。恢复前台时重建平台视图让其重新挂载到正确层级。
if (state == AppLifecycleState.resumed) {
_recreatePlatformView();
}
}
/// 通过替换 [BMFMapWidget] 的 key 强制重建平台视图,并复位内部状态。
void _recreatePlatformView() {
_mapController = null;
_markerAdded = false;
setState(() => _platformViewGeneration++);
}
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final locationAsync = ref.watch(deviceLocationProvider(widget.sn));
// watch 本机定位 Provider:首次进入自动启动手机定位,页面销毁时自动停止。
ref.watch(locationControllerProvider);
// 监听定位数据(ref.listen 只能在 build 方法内调用):无论地图创建时序如何
// (地图后建/数据后到),只要数据就绪就主动把地图中心与标记同步到设备位置,
// 避免依赖 build 帧时序导致地图停留在默认中心。
ref.listen<AsyncValue<DeviceLocation?>>(
deviceLocationProvider(widget.sn),
(prev, next) {
if (next.hasValue) _syncLocation(next.valueOrNull);
},
);
// 监听本机定位结果:定位成功后把蓝色定位点更新到地图(BMFUserLocation)。
// 若正处于「定位到我」流程,则把地图中心同步到本机位置并复位标记。
ref.listen<LocationState>(
locationControllerProvider,
(prev, next) {
if (next is LocationSuccess) {
_updateUserLocation(next.location);
if (_isLocatingSelf) {
_moveToUserLocation(next.location);
setState(() => _isLocatingSelf = false);
}
} else if (next is LocationFailed) {
debugPrint('[Location] 全屏地图:定位失败 -> ${next.message}');
if (_isLocatingSelf) setState(() => _isLocatingSelf = false);
}
},
);
// 设备坐标(WGS84)转百度坐标,作为地图初始中心;无数据时回退到北京。
final BMFCoordinate center = _computeCenter(locationAsync.valueOrNull);
return AppPageScaffold(
navigationBar: CupertinoNavigationBar(
middle: DeviceContextTitle(l10n.mapTitle),
previousPageTitle: l10n.back,
),
child: SafeArea(
child: Stack(
children: [
BMFMapWidget(
// key 依赖平台视图重建代数:app 从后台恢复时强制重建原生地图,
// 修复地图 Surface 残留在其它页面之上的问题。
key: ValueKey('full_map_$_platformViewGeneration'),
onBMFMapCreated: _onMapCreated,
mapOptions: BMFMapOptions(
center: center,
zoomLevel: 16,
showMapScaleBar: true,
),
),
_buildOverlay(locationAsync, l10n),
_buildLocateButton(l10n),
],
),
),
);
}
/// 地图创建完成回调。
void _onMapCreated(BMFMapController controller) {
_mapController = controller;
// 按官方「显示定位」文档:地图加载完成后再执行图层/覆盖物操作,
// 否则 showUserLocation / addMarker 等在地图未就绪时调用会不生效。
controller.setMapDidLoadCallback(callback: () {
_enableUserLocationLayer();
// 补偿添加设备位置 Marker(地图加载完成后 addMarker 才可靠)。
_syncLocation(ref.read(deviceLocationProvider(widget.sn)).valueOrNull);
});
}
/// 开启定位图层并设置定位点样式(地图加载完成后调用)。
void _enableUserLocationLayer() {
final controller = _mapController;
if (controller == null) return;
// 1. 开启定位图层。
controller.showUserLocation(true);
// 2. 设置定位点样式(使用 SDK 默认图标;不设置无效图片路径,避免图标加载失败)。
final param = BMFUserLocationDisplayParam.userlocationOptions()
..isAccuracyCircleShow = true
..accuracyCircleFillColor = const Color(0x3300B0FF)
..accuracyCircleStrokeColor = const Color(0x6600B0FF)
..locationViewHierarchy =
BMFLocationViewHierarchy.LOCATION_VIEW_HIERARCHY_TOP;
controller.updateLocationViewWithParam(param);
// 3. 若本机定位已就绪,同步蓝色定位点。
final current = ref.read(locationControllerProvider);
if (current is LocationSuccess) _updateUserLocation(current.location);
}
/// 把手机本机定位结果更新到地图定位图层(蓝色定位点)。
void _updateUserLocation(DeviceCurrentLocation location) {
final controller = _mapController;
if (controller == null) return;
// 按百度地图「显示定位」文档构造完整位置对象。
final userLocation = BMFUserLocation(
location: BMFLocation(
coordinate: BMFCoordinate(location.latitude, location.longitude),
altitude: location.altitude ?? 0,
horizontalAccuracy: location.radius ?? 0,
verticalAccuracy: -1.0,
speed: location.speed ?? -1.0,
course: location.course ?? -1.0,
),
);
controller.updateLocationData(userLocation);
}
/// 把地图中心移动到本机定位位置(不带动画也行,这里用动画平滑过渡)。
void _moveToUserLocation(DeviceCurrentLocation location) {
final controller = _mapController;
if (controller == null) return;
controller.setCenterCoordinate(
BMFCoordinate(location.latitude, location.longitude),
true,
);
}
/// 右下角「定位到我」浮动按钮:点击后重新启动本机定位,
/// 定位成功会在 listen 回调中把地图中心移到本机位置。
Widget _buildLocateButton(AppLocalizations l10n) {
final isLocating = _isLocatingSelf;
return Positioned(
right: 6,
bottom: 100,
child: CupertinoButton(
padding: EdgeInsets.zero,
onPressed: isLocating ? null : _onLocateMe,
child: Container(
width: 40,
height: 40,
decoration: BoxDecoration(
color: CupertinoColors.systemBackground.withValues(alpha: 0.92),
shape: BoxShape.circle,
boxShadow: const [
BoxShadow(
color: Color(0x33000000),
blurRadius: 6,
offset: Offset(0, 2),
),
],
),
child: isLocating
? const CupertinoActivityIndicator(radius: 11)
: const Icon(
CupertinoIcons.location_fill,
size: 22,
color: CupertinoColors.activeBlue,
),
),
),
);
}
/// 点击「定位到我」:标记进入定位中,重新启动手机本机定位。
void _onLocateMe() {
// 若已经拿到过本机位置,先立即把中心移过去(定位回调通常很快,提升即时反馈)。
final current = ref.read(locationControllerProvider);
if (current is LocationSuccess) {
_moveToUserLocation(current.location);
}
setState(() => _isLocatingSelf = true);
ref.read(locationControllerProvider.notifier).restart();
}
/// 根据最新定位刷新地图标记与中心。
void _syncLocation(DeviceLocation? location) {
final controller = _mapController;
if (controller == null) return;
final coord = _toWgsCoordinate(location);
if (coord == null) return;
final bd = wgs84ToBd09(coord.lat, coord.lon);
controller.setCenterCoordinate(bd, true);
if (!_markerAdded) {
// Marker 标题展示设备 SN(缺失时兜底为"设备位置")。
final sn = location!.sn;
final title = (sn != null && sn.isNotEmpty) ? sn : '设备位置';
// 使用 iconData 指定图标:基础 BMFMarker(position:, title:) 构造不带 icon,
// 在 Android 端不渲染(SDK 3.1.0 起已废弃),故传入红色定位点 PNG 字节。
_addDeviceMarker(controller, bd, title);
}
}
/// 添加设备位置红点 Marker。
///
/// 图标由 [deviceMarkerIconData] 动态绘制为「带圆角边框的气泡 + 定位针」,
/// 内含设备 SN 文字与边框,不依赖 `titleOptions`(其无边框能力)。
Future<void> _addDeviceMarker(
BMFMapController controller,
BMFCoordinate position,
String title,
) async {
final icon = await deviceMarkerIconData(title);
if (icon == null || _markerAdded) return; // 并发保护,避免重复添加。
final marker = BMFMarker.iconData(
position: position,
iconData: icon,
identifier: 'device_location',
);
await controller.addMarker(marker);
_markerAdded = true;
}
/// 计算初始地图中心。
BMFCoordinate _computeCenter(DeviceLocation? location) {
final coord = _toWgsCoordinate(location);
if (coord != null) return wgs84ToBd09(coord.lat, coord.lon);
// 默认中心:北京
return BMFCoordinate(39.915, 116.404);
}
/// 从 [DeviceLocation] 提取合法的 WGS84 坐标,缺失或非数字时返回 null。
({double lat, double lon})? _toWgsCoordinate(DeviceLocation? location) {
if (location == null) return null;
final latStr = location.latitude;
final lonStr = location.longitude;
if (latStr == null || latStr.isEmpty || lonStr == null || lonStr.isEmpty) {
return null;
}
final lat = double.tryParse(latStr);
final lon = double.tryParse(lonStr);
if (lat == null || lon == null) return null;
return (lat: lat, lon: lon);
}
Widget _buildOverlay(
AsyncValue<DeviceLocation?> locationAsync, AppLocalizations l10n) {
return locationAsync.when(
loading: () => const Center(child: CupertinoActivityIndicator()),
error: (e, _) => Center(
child: Padding(
padding: const EdgeInsets.all(24),
child: Text(
l10n.snapshotLocationFailed,
style: const TextStyle(color: CupertinoColors.systemGrey),
textAlign: TextAlign.center,
),
),
),
data: (location) {
if (_toWgsCoordinate(location) == null) {
return Center(
child: Padding(
padding: const EdgeInsets.all(24),
child: Text(
l10n.noSnapshotLocation,
style: const TextStyle(color: CupertinoColors.systemGrey),
textAlign: TextAlign.center,
),
),
);
}
// 定位数据已就绪且有效:地图中心与标记的同步由 ref.listen + _onMapCreated 负责,
// 这里无需重复调度。
return const SizedBox.shrink();
},
);
}
}