442 lines
15 KiB
Dart
442 lines
15 KiB
Dart
|
import 'package:flutter/material.dart';
|
|||
|
|
|
|||
|
|
import '../models/device.dart';
|
|||
|
|
import '../services/api_client.dart';
|
|||
|
|
import '../services/device_service.dart';
|
|||
|
|
import '../utils/i10n.dart';
|
|||
|
|
|
|||
|
|
/// 指令参数项。
|
|||
|
|
///
|
|||
|
|
/// [key] **必须与 Web 后台 `src/api/device.ts` 的 `commandTypeOptions`
|
|||
|
|
/// 参数 key 完全一致**，否则后端取不到值，设备端会因缺少参数而忽略该指令。
|
|||
|
|
/// 当前约定：
|
|||
|
|
/// - `passwordUpdate` → `passwd`
|
|||
|
|
/// - `mediaZoneVol` → `vol`
|
|||
|
|
/// - `defaultVol` → `vol` + `maxVol`
|
|||
|
|
class _CommandParam {
|
|||
|
|
const _CommandParam(this.key, this.label, {this.numeric = false});
|
|||
|
|
|
|||
|
|
/// 提交给后端的参数名。
|
|||
|
|
final String key;
|
|||
|
|
|
|||
|
|
/// 输入框标签。
|
|||
|
|
final String label;
|
|||
|
|
|
|||
|
|
/// 是否为 0~100 的整数（音量类参数）。
|
|||
|
|
final bool numeric;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 设备指令项。
|
|||
|
|
class _CommandItem {
|
|||
|
|
const _CommandItem(this.value, this.label, {this.params = const []});
|
|||
|
|
|
|||
|
|
final String value;
|
|||
|
|
final String label;
|
|||
|
|
|
|||
|
|
/// 需要用户填写的参数；为空表示无需输入，直接确认后下发。
|
|||
|
|
final List<_CommandParam> params;
|
|||
|
|
|
|||
|
|
bool get needsInput => params.isNotEmpty;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 设备指令下发弹窗。
|
|||
|
|
///
|
|||
|
|
/// 两种用法：
|
|||
|
|
/// 1. 单设备：传 [device]，指令按 MAC 下发（[DeviceService.sendCommandByMac]）；
|
|||
|
|
/// 2. 门店批量：传 [orgId]（不传 [device]），指令按组织下发
|
|||
|
|
/// （[DeviceService.sendCommandByOrg]），影响该门店下全部设备。
|
|||
|
|
class DeviceCommandSheet extends StatefulWidget {
|
|||
|
|
const DeviceCommandSheet({
|
|||
|
|
super.key,
|
|||
|
|
this.device,
|
|||
|
|
this.orgId,
|
|||
|
|
this.orgName,
|
|||
|
|
required this.deviceService,
|
|||
|
|
}) : assert(device != null || orgId != null,
|
|||
|
|
'device 与 orgId 至少传其一');
|
|||
|
|
|
|||
|
|
/// 单设备模式下的目标设备。
|
|||
|
|
final Device? device;
|
|||
|
|
|
|||
|
|
/// 门店批量模式下的组织 ID。
|
|||
|
|
final String? orgId;
|
|||
|
|
|
|||
|
|
/// 门店批量模式下的组织名称（仅用于展示）。
|
|||
|
|
final String? orgName;
|
|||
|
|
|
|||
|
|
final DeviceService deviceService;
|
|||
|
|
|
|||
|
|
/// 是否为门店批量模式。
|
|||
|
|
bool get isOrgMode => orgId != null && orgId!.isNotEmpty;
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
State<DeviceCommandSheet> createState() => _DeviceCommandSheetState();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class _DeviceCommandSheetState extends State<DeviceCommandSheet> {
|
|||
|
|
final List<TextEditingController> _paramControllers = [];
|
|||
|
|
bool _sending = false;
|
|||
|
|
|
|||
|
|
/// 设备心跳超过该分钟数即视为「可能离线」，下发前给出提示。
|
|||
|
|
static const int _heartbeatStaleMinutes = 3;
|
|||
|
|
|
|||
|
|
List<_CommandItem> _commands(BuildContext context) {
|
|||
|
|
final t = AppLocalizations.of(context);
|
|||
|
|
return [
|
|||
|
|
_CommandItem(DeviceCommand.powerOff, t.deviceCommandLabel(DeviceCommand.powerOff)),
|
|||
|
|
_CommandItem(DeviceCommand.reboot, t.deviceCommandLabel(DeviceCommand.reboot)),
|
|||
|
|
_CommandItem(DeviceCommand.screenshot, t.deviceCommandLabel(DeviceCommand.screenshot)),
|
|||
|
|
_CommandItem(DeviceCommand.themeUpdate, t.deviceCommandLabel(DeviceCommand.themeUpdate)),
|
|||
|
|
_CommandItem(DeviceCommand.versionUpdate, t.deviceCommandLabel(DeviceCommand.versionUpdate)),
|
|||
|
|
_CommandItem(DeviceCommand.marqueeUpdate, t.deviceCommandLabel(DeviceCommand.marqueeUpdate)),
|
|||
|
|
_CommandItem(DeviceCommand.weatherUpdate, t.deviceCommandLabel(DeviceCommand.weatherUpdate)),
|
|||
|
|
_CommandItem(
|
|||
|
|
DeviceCommand.mediaZoneVol,
|
|||
|
|
t.deviceCommandLabel(DeviceCommand.mediaZoneVol),
|
|||
|
|
params: [
|
|||
|
|
_CommandParam('vol', t.deviceCommandInputLabel(DeviceCommand.mediaZoneVol),
|
|||
|
|
numeric: true),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
_CommandItem(
|
|||
|
|
DeviceCommand.defaultVol,
|
|||
|
|
t.deviceCommandLabel(DeviceCommand.defaultVol),
|
|||
|
|
params: [
|
|||
|
|
_CommandParam('vol', t.deviceCommandInputLabel(DeviceCommand.defaultVol),
|
|||
|
|
numeric: true),
|
|||
|
|
_CommandParam('maxVol', t.maxVolume, numeric: true),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
_CommandItem(DeviceCommand.themeClear, t.deviceCommandLabel(DeviceCommand.themeClear)),
|
|||
|
|
_CommandItem(DeviceCommand.cacheClear, t.deviceCommandLabel(DeviceCommand.cacheClear)),
|
|||
|
|
_CommandItem(DeviceCommand.storeExpire, t.deviceCommandLabel(DeviceCommand.storeExpire)),
|
|||
|
|
_CommandItem(DeviceCommand.storeDisable, t.deviceCommandLabel(DeviceCommand.storeDisable)),
|
|||
|
|
_CommandItem(
|
|||
|
|
DeviceCommand.passwordUpdate,
|
|||
|
|
t.deviceCommandLabel(DeviceCommand.passwordUpdate),
|
|||
|
|
params: [
|
|||
|
|
_CommandParam('passwd', t.deviceCommandInputLabel(DeviceCommand.passwordUpdate)),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
_CommandItem(DeviceCommand.worldAd, t.deviceCommandLabel(DeviceCommand.worldAd)),
|
|||
|
|
];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 设备是否「可能离线」：状态为 offline，或心跳时间早于阈值。
|
|||
|
|
///
|
|||
|
|
/// 用于下发前提示，不改变下发行为（仍可强制下发）。
|
|||
|
|
bool _isLikelyOffline(Device device) {
|
|||
|
|
if (device.status == DeviceStatus.offline) return true;
|
|||
|
|
final heartbeat = device.lastSyncTime;
|
|||
|
|
if (heartbeat == null) return true;
|
|||
|
|
return DateTime.now().difference(heartbeat).inMinutes > _heartbeatStaleMinutes;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
Future<void> _send(_CommandItem item) async {
|
|||
|
|
final t = AppLocalizations.of(context);
|
|||
|
|
final data = <String, dynamic>{};
|
|||
|
|
if (item.needsInput) {
|
|||
|
|
for (var i = 0; i < item.params.length; i++) {
|
|||
|
|
final param = item.params[i];
|
|||
|
|
final value = _paramControllers[i].text.trim();
|
|||
|
|
if (value.isEmpty) {
|
|||
|
|
// maxVol 允许留空（后端对该项有默认值），其余参数必填。
|
|||
|
|
if (param.key == 'maxVol') continue;
|
|||
|
|
ScaffoldMessenger.of(context).showSnackBar(
|
|||
|
|
SnackBar(content: Text('${t.pleaseInput}${param.label}')),
|
|||
|
|
);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
if (param.numeric) {
|
|||
|
|
final vol = int.tryParse(value);
|
|||
|
|
if (vol == null || vol < 0 || vol > 100) {
|
|||
|
|
ScaffoldMessenger.of(context).showSnackBar(
|
|||
|
|
SnackBar(content: Text(t.volumeRangeHint)),
|
|||
|
|
);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
// 与 Web 端 `data[key] = item.value.trim()` 保持一致：统一传字符串，
|
|||
|
|
// 避免后端按 String 解析数字时抛类型转换异常。
|
|||
|
|
data[param.key] = value;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
setState(() => _sending = true);
|
|||
|
|
try {
|
|||
|
|
if (widget.isOrgMode) {
|
|||
|
|
await widget.deviceService.sendCommandByOrg(
|
|||
|
|
orgId: widget.orgId!,
|
|||
|
|
command: item.value,
|
|||
|
|
data: data.isNotEmpty ? data : null,
|
|||
|
|
);
|
|||
|
|
} else {
|
|||
|
|
final mac = widget.device!.mac.trim();
|
|||
|
|
if (mac.isEmpty) {
|
|||
|
|
if (!mounted) return;
|
|||
|
|
setState(() => _sending = false);
|
|||
|
|
ScaffoldMessenger.of(context).showSnackBar(
|
|||
|
|
SnackBar(content: Text(t.commandMacMissing)),
|
|||
|
|
);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
await widget.deviceService.sendCommandByMac(
|
|||
|
|
mac: mac,
|
|||
|
|
command: item.value,
|
|||
|
|
data: data.isNotEmpty ? data : null,
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
if (!mounted) return;
|
|||
|
|
Navigator.pop(context);
|
|||
|
|
final target = widget.isOrgMode
|
|||
|
|
? '${t.belongStore}「${widget.orgName ?? widget.orgId}」'
|
|||
|
|
: '${t.deviceDetails}「${widget.device!.macLabel}」';
|
|||
|
|
ScaffoldMessenger.of(context).showSnackBar(
|
|||
|
|
SnackBar(content: Text(t.commandSent(target, item.label))),
|
|||
|
|
);
|
|||
|
|
} catch (e) {
|
|||
|
|
if (!mounted) return;
|
|||
|
|
setState(() => _sending = false);
|
|||
|
|
ScaffoldMessenger.of(context).showSnackBar(
|
|||
|
|
SnackBar(content: Text('${t.commandSendFailed}：${formatApiError(e)}')),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
void dispose() {
|
|||
|
|
for (final c in _paramControllers) {
|
|||
|
|
c.dispose();
|
|||
|
|
}
|
|||
|
|
super.dispose();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
Widget build(BuildContext context) {
|
|||
|
|
final theme = Theme.of(context);
|
|||
|
|
final t = AppLocalizations.of(context);
|
|||
|
|
final commands = _commands(context);
|
|||
|
|
return Padding(
|
|||
|
|
padding: EdgeInsets.only(
|
|||
|
|
bottom: MediaQuery.of(context).viewInsets.bottom,
|
|||
|
|
),
|
|||
|
|
child: SingleChildScrollView(
|
|||
|
|
padding: const EdgeInsets.all(16),
|
|||
|
|
child: Column(
|
|||
|
|
mainAxisSize: MainAxisSize.min,
|
|||
|
|
crossAxisAlignment: CrossAxisAlignment.start,
|
|||
|
|
children: [
|
|||
|
|
Text(
|
|||
|
|
widget.isOrgMode ? t.sendOrgCommandTitle : t.sendCommandTitle,
|
|||
|
|
style: theme.textTheme.titleLarge?.copyWith(
|
|||
|
|
fontWeight: FontWeight.bold,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 4),
|
|||
|
|
if (widget.isOrgMode) ...[
|
|||
|
|
Text(
|
|||
|
|
'${t.belongStore}：${widget.orgName ?? widget.orgId}',
|
|||
|
|
style: theme.textTheme.bodyMedium?.copyWith(
|
|||
|
|
color: theme.colorScheme.onSurfaceVariant,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
Text(
|
|||
|
|
'${t.commandType}：${t.allStores}',
|
|||
|
|
style: theme.textTheme.bodySmall?.copyWith(
|
|||
|
|
color: theme.colorScheme.onSurfaceVariant,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
] else ...[
|
|||
|
|
Text(
|
|||
|
|
'${t.deviceDetails}：${widget.device!.macLabel}',
|
|||
|
|
style: theme.textTheme.bodyMedium?.copyWith(
|
|||
|
|
color: theme.colorScheme.onSurfaceVariant,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
Text(
|
|||
|
|
'${t.macAddress}：${widget.device!.mac}',
|
|||
|
|
style: theme.textTheme.bodySmall?.copyWith(
|
|||
|
|
color: theme.colorScheme.onSurfaceVariant,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
Text(
|
|||
|
|
_buildHeartbeatLine(t),
|
|||
|
|
style: theme.textTheme.bodySmall?.copyWith(
|
|||
|
|
color: widget.device != null && _isLikelyOffline(widget.device!)
|
|||
|
|
? theme.colorScheme.error
|
|||
|
|
: theme.colorScheme.onSurfaceVariant,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
const SizedBox(height: 16),
|
|||
|
|
Text(
|
|||
|
|
t.commandType,
|
|||
|
|
style: theme.textTheme.titleSmall?.copyWith(
|
|||
|
|
fontWeight: FontWeight.bold,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 8),
|
|||
|
|
Wrap(
|
|||
|
|
spacing: 8,
|
|||
|
|
runSpacing: 8,
|
|||
|
|
children: commands.map((item) {
|
|||
|
|
return ActionChip(
|
|||
|
|
label: Text(item.label),
|
|||
|
|
onPressed: _sending ? null : () => _onCommandTap(item),
|
|||
|
|
);
|
|||
|
|
}).toList(),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
String _buildHeartbeatLine(AppLocalizations t) {
|
|||
|
|
final device = widget.device;
|
|||
|
|
if (device == null) return '';
|
|||
|
|
final heartbeat = device.lastSyncTime;
|
|||
|
|
if (heartbeat == null) {
|
|||
|
|
return '${t.lastActiveTime}：${t.deviceSubtitleNotSet}';
|
|||
|
|
}
|
|||
|
|
final minutes = DateTime.now().difference(heartbeat).inMinutes;
|
|||
|
|
return '${t.lastActiveTime}：${_format(heartbeat)}（$minutes${t.minutesAgo}）';
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
String _format(DateTime time) {
|
|||
|
|
String two(int v) => v.toString().padLeft(2, '0');
|
|||
|
|
return '${time.year}-${two(time.month)}-${two(time.day)} '
|
|||
|
|
'${two(time.hour)}:${two(time.minute)}';
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
void _onCommandTap(_CommandItem item) {
|
|||
|
|
if (!item.needsInput) {
|
|||
|
|
_showConfirm(item);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
_showInputDialog(item);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 下发前校验：单设备模式下若设备离线/心跳超时，先给出警告。
|
|||
|
|
Future<bool> _confirmIfOffline() async {
|
|||
|
|
final device = widget.device;
|
|||
|
|
final t = AppLocalizations.of(context);
|
|||
|
|
if (device == null || !_isLikelyOffline(device)) return true;
|
|||
|
|
final ok = await showDialog<bool>(
|
|||
|
|
context: context,
|
|||
|
|
builder: (ctx) => AlertDialog(
|
|||
|
|
title: Text(t.commandConfirmTitle),
|
|||
|
|
content: Text(t.commandOfflineWarning),
|
|||
|
|
actions: [
|
|||
|
|
TextButton(
|
|||
|
|
onPressed: () => Navigator.pop(ctx, false),
|
|||
|
|
child: Text(t.cancel),
|
|||
|
|
),
|
|||
|
|
FilledButton(
|
|||
|
|
onPressed: () => Navigator.pop(ctx, true),
|
|||
|
|
child: Text(t.commandOfflineConfirm),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
) ??
|
|||
|
|
false;
|
|||
|
|
return ok;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
void _showConfirm(_CommandItem item) async {
|
|||
|
|
final t = AppLocalizations.of(context);
|
|||
|
|
final proceed = await _confirmIfOffline();
|
|||
|
|
if (!proceed || !mounted) return;
|
|||
|
|
showDialog<void>(
|
|||
|
|
context: context,
|
|||
|
|
builder: (ctx) => AlertDialog(
|
|||
|
|
title: Text(t.commandConfirmTitle),
|
|||
|
|
content: Text(t.commandConfirmContent(item.label)),
|
|||
|
|
actions: [
|
|||
|
|
TextButton(
|
|||
|
|
onPressed: () => Navigator.pop(ctx),
|
|||
|
|
child: Text(t.cancel),
|
|||
|
|
),
|
|||
|
|
FilledButton(
|
|||
|
|
onPressed: _sending
|
|||
|
|
? null
|
|||
|
|
: () {
|
|||
|
|
Navigator.pop(ctx);
|
|||
|
|
_send(item);
|
|||
|
|
},
|
|||
|
|
child: _sending
|
|||
|
|
? const SizedBox(
|
|||
|
|
height: 18,
|
|||
|
|
width: 18,
|
|||
|
|
child: CircularProgressIndicator(strokeWidth: 2),
|
|||
|
|
)
|
|||
|
|
: Text(t.confirm),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
void _showInputDialog(_CommandItem item) async {
|
|||
|
|
final t = AppLocalizations.of(context);
|
|||
|
|
final proceed = await _confirmIfOffline();
|
|||
|
|
if (!proceed || !mounted) return;
|
|||
|
|
for (final c in _paramControllers) {
|
|||
|
|
c.dispose();
|
|||
|
|
}
|
|||
|
|
_paramControllers
|
|||
|
|
..clear()
|
|||
|
|
..addAll(List.generate(item.params.length, (_) => TextEditingController()));
|
|||
|
|
showDialog<void>(
|
|||
|
|
context: context,
|
|||
|
|
builder: (ctx) => AlertDialog(
|
|||
|
|
title: Text(item.label),
|
|||
|
|
content: SingleChildScrollView(
|
|||
|
|
child: Column(
|
|||
|
|
mainAxisSize: MainAxisSize.min,
|
|||
|
|
children: List.generate(item.params.length, (i) {
|
|||
|
|
final param = item.params[i];
|
|||
|
|
return Padding(
|
|||
|
|
padding: EdgeInsets.only(
|
|||
|
|
bottom: i == item.params.length - 1 ? 0 : 12,
|
|||
|
|
),
|
|||
|
|
child: TextField(
|
|||
|
|
controller: _paramControllers[i],
|
|||
|
|
decoration: InputDecoration(
|
|||
|
|
labelText: param.label,
|
|||
|
|
border: const OutlineInputBorder(),
|
|||
|
|
),
|
|||
|
|
keyboardType:
|
|||
|
|
param.numeric ? TextInputType.number : TextInputType.text,
|
|||
|
|
obscureText: param.key == 'passwd',
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}),
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
actions: [
|
|||
|
|
TextButton(
|
|||
|
|
onPressed: () => Navigator.pop(ctx),
|
|||
|
|
child: Text(t.cancel),
|
|||
|
|
),
|
|||
|
|
FilledButton(
|
|||
|
|
onPressed: _sending
|
|||
|
|
? null
|
|||
|
|
: () {
|
|||
|
|
Navigator.pop(ctx);
|
|||
|
|
_send(item);
|
|||
|
|
},
|
|||
|
|
child: _sending
|
|||
|
|
? const SizedBox(
|
|||
|
|
height: 18,
|
|||
|
|
width: 18,
|
|||
|
|
child: CircularProgressIndicator(strokeWidth: 2),
|
|||
|
|
)
|
|||
|
|
: Text(t.sendCommand),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
}
|