Files
ttstd_family_care/lib/features/device/domain/device_repository.dart
T
tongtong e06e12fbbc feat(profile): 实现个人资料编辑与策略本地缓存
- 将资料编辑页重构为可交互表单,支持昵称、签名编辑与头像更换
- 新增 DioClient 本地缓存读取与写入方法,支持离线读取策略快照
- 设备策略切换后自动使本地缓存失效,避免数据不一致
- Home Tab 切换时选中态跟随可见页面,滑动过程中实时更新底栏高亮
- 系统设置页引入 loading 遮罩层,防止切换开关时重复操作
- 个人资料页接入 profileController 展示真实用户信息与加载状态
- 适配深色模式,修正 home_tab 中头像与文字颜色硬编码问题
2026-11-09 09:24:51 +08:00

107 lines
4.5 KiB
Dart

import 'dart:io';
import 'package:ttstd_family_care/features/device/domain/device_models.dart';
/// 设备仓储,封装设备信息/定位/应用列表/绑定设备列表的获取。
abstract class DeviceRepository {
/// 当前用户已绑定的设备列表。
Future<List<DeviceBrief>> getMyDevices();
/// 绑定设备(手动输入 SN 或扫码获取 SN)。
///
/// 成功返回 null;失败返回错误提示。
Future<String?> bindDevice(String sn, {String? remark});
/// 解绑设备。
///
/// 成功返回 null;失败返回错误提示。
Future<String?> unbindDevice(String sn);
/// 已绑定设备基本信息(无上报数据时返回 null)。
Future<DeviceSystemInfo?> getDeviceInfo(String sn);
/// 已绑定设备最新定位信息(无上报数据时返回 null)。
Future<DeviceLocation?> getLocation(String sn);
/// 已绑定设备已安装应用列表。
Future<List<DeviceApkInfo>> getApks(String sn);
/// 已绑定设备最近截图列表。
Future<List<ScreenshotVO>> getRecentScreenshots(String sn);
/// 已绑定设备策略信息(功能开关),无记录时为 null。
Future<DevicePolicy?> getPolicy(String sn);
/// 读取当前账号、设备的上一次策略缓存。
Future<DevicePolicy?> getCachedPolicy(String sn);
/// 单独设置某个策略开关(field 为策略字段名,value 为 0/1)。
///
/// 成功返回 null;失败返回错误提示。
Future<String?> togglePolicy(String sn, String field, int value);
/// 向设备下发操作指令(重启/关机/截屏/刷新/定位/拍照等)。
///
/// [op] 为后端操作标识,如 `reboot` / `shutdown` / `screenshot` / `refresh` / `locate` / `take_photo`。
/// [extra] 为可选的附加 query 参数(如远程拍照时的 `camera`:`0` 后置 / `1` 前置)。
/// 成功返回 null;失败返回错误提示。
Future<String?> sendDeviceOp(String sn, String op, {Map<String, dynamic>? extra});
/// 对指定应用执行操作(打开/停止/卸载/清除数据)。
///
/// [op] 为后端操作标识:`launch` / `stop` / `uninstall` / `clear_data`。
/// 成功返回 null;失败返回错误提示。
Future<String?> sendAppOp(String sn, String op, String packageName);
/// 反向拨号:向设备下发拨号指令,由设备主动呼叫 [phone]。
///
/// 成功返回 null;失败返回错误提示。
Future<String?> reverseDial(String sn, String phone);
/// 上传单个壁纸:保存为设备单个壁纸并推送设备。
///
/// 返回记录:成功时 [url] 为保存后的图片 URL、[fileSize] 为文件大小(字节),
/// 失败时 [error] 为错误提示。
Future<({String? url, int? fileSize, String? error})> uploadWallpaperSingle(
String sn, File file);
/// 上传轮换壁纸(最多 7 张):保存为设备轮换壁纸并推送设备。
///
/// 返回记录:成功时 [urls] 为按顺序保存的图片 URL 列表,失败时 [error] 为错误提示。
Future<({List<String>? urls, String? error})> uploadWallpaperRotation(
String sn, List<File> files);
/// 调整壁纸展示顺序(按 [urls] 顺序更新 sort_no)。
///
/// 成功返回 null;失败返回错误提示。
Future<String?> reorderWallpaper(String sn, List<String> urls);
/// 获取设备壁纸配置(家属端),未配置时返回 null。
Future<WallpaperConfig?> getWallpaperConfig(String sn);
/// 发送图片到设备(设备收到推送后弹窗显示图片)。
///
/// [favorite] 是否标记收藏,默认 false。成功返回 null;失败返回错误提示。
Future<String?> sendPicture(String sn, File file, {bool favorite = false});
/// 查询已发送到设备的图片列表(含收藏状态,按发送时间倒序)。
Future<List<DevicePictureInfo>> getPictureList(String sn);
Future<void> deletePicture(String sn, String url);
/// 设置图片收藏状态(按设备 + 图片URL)。
///
/// 成功返回 null;失败返回错误提示。
Future<String?> setPictureFavorite(String sn, String url, bool favorite);
/// 删除单张设备截图(家属端 client 接口)。
///
/// [sn] 设备序列号,[id] 截图ID。成功返回 null;失败返回错误提示。
Future<String?> deleteScreenshot(String sn, int id);
/// 清空设备全部截图(家属端 client 接口)。
///
/// [sn] 设备序列号。成功返回 null;失败返回错误提示。
Future<String?> clearScreenshots(String sn);
}