USB 摄像头+远程遥控+中英的适配+topic的集成和状态的使用到相应页面

This commit is contained in:
2026-10-20 17:03:37 +08:00
parent 178cd2533c
commit 582242e9aa
144 changed files with 15759 additions and 406 deletions

View File

@@ -6,6 +6,8 @@ import 'package:crypto/crypto.dart';
import 'package:flutter/foundation.dart';
import 'package:xml/xml.dart';
import 'rtsp_playback_tuning.dart';
/// 轻量 ONVIF SOAP 客户端。默认账号 admin、密码为空(构造函数可覆盖)。
/// 提供 GetDeviceInformation / GetCapabilities(Media XAddr) / GetProfiles / GetStreamUri。
/// 认证采用 WS-Security UsernameToken + PasswordDigest。
@@ -170,27 +172,17 @@ class OnvifClient {
return _firstText(doc, 'XAddr');
}
/// 获取第一个视频 Profile 的 token。
Future<String> getFirstProfileToken(String mediaXAddr) async {
final body = _envelope(
serviceNs: 'http://www.onvif.org/ver10/media/wsdl',
actionTail: 'GetProfiles',
bodyInner:
'<trt:GetProfiles xmlns:trt="http://www.onvif.org/ver10/media/wsdl"/>',
);
final resp = await _post(mediaXAddr, body);
final doc = XmlDocument.parse(resp);
// Profiles 元素的 token 属性即 ProfileToken
for (final p in doc.findAllElements('Profiles')) {
final token = p.getAttribute('token');
if (token != null && token.isNotEmpty) return token;
}
throw OnvifException('未获取到视频 Profile');
}
/// 选择“分辨率最小”的视频 Profile(即子码流)以降低延迟与码率;
/// 摄像头只报一个 Profile 或无分辨率信息时退回第一个。
Future<String> getLowLatencyProfileToken(String mediaXAddr) async {
/// 按 [select] 挑一个视频 Profile,返回 `(token, 声明码率kbps)`。
///
/// 码率一并带出来是给【链路探针】当分母用的:声明码率是“应该收到多少”,
/// 实测进给率是“实际到了多少”,两者一比就能把“图传不够”和“内容坏了”分开。
/// 设备不报 Bitrate(杂牌机常见)时给 null,探针退成只看比例。
///
/// 只报一个 Profile、或压根没报分辨率时,退回第一个(因“选不出”而放弃拉流)。
Future<(String, int?)> getProfileToken(
String mediaXAddr,
RtspProfileSelect select,
) async {
final body = _envelope(
serviceNs: 'http://www.onvif.org/ver10/media/wsdl',
actionTail: 'GetProfiles',
@@ -200,28 +192,54 @@ class OnvifClient {
final resp = await _post(mediaXAddr, body);
final doc = XmlDocument.parse(resp);
String? firstToken;
int? firstKbps;
String? bestToken;
int? bestKbps;
int bestArea = -1;
final listed = <String>[];
for (final p in doc.findAllElements('Profiles')) {
final token = p.getAttribute('token');
if (token == null || token.isEmpty) continue;
firstToken ??= token;
final w = _firstIntIn(p, 'Width');
final h = _firstIntIn(p, 'Height');
if (w != null && h != null && w > 0 && h > 0) {
final area = w * h;
if (bestArea < 0 || area < bestArea) {
bestArea = area;
bestToken = token;
}
final bitrateKbps = _firstIntIn(p, 'Bitrate');
if (firstToken == token) firstKbps = bitrateKbps;
listed.add(
'$token ${w ?? '?'}x${h ?? '?'}'
'${bitrateKbps != null ? ' ${bitrateKbps}kbps' : ''}',
);
if (w == null || h == null || w <= 0 || h <= 0) continue;
if (select == RtspProfileSelect.first) continue;
final area = w * h;
final better = select == RtspProfileSelect.smallest
? (bestArea < 0 || area < bestArea)
: (bestArea < 0 || area > bestArea);
if (better) {
bestArea = area;
bestToken = token;
bestKbps = bitrateKbps;
}
}
if (bestToken != null) {
debugPrint('🎚 [子码流] 选用最小分辨率 Profile(面积≈$bestArea)token=$bestToken');
return bestToken;
if (listed.isNotEmpty) {
debugPrint('🎚 [码流] ${select.label};候选:${listed.join(' | ')}');
}
if (firstToken != null) return firstToken;
throw OnvifException('未获取到视频 Profile');
if (firstToken == null) throw OnvifException('未获取到视频 Profile');
// 选不出合适的那一路(设备只报一个 / 没报分辨率 / 选了“设备首个”)→ 退回第一个。
final String picked;
final int? kbps;
if (select == RtspProfileSelect.first || bestToken == null) {
picked = firstToken;
kbps = firstKbps;
} else {
picked = bestToken;
kbps = bestKbps;
}
debugPrint(
'🎚 [码流] 最终使用 token=$picked(面积≈$bestArea'
'${kbps != null ? ', 声明 ${kbps}kbps' : ', 设备未报码率'})',
);
return (picked, kbps);
}
/// 在 [parent] 及其后代中找第一个可解析为 int 的 [name] 元素值。
@@ -252,11 +270,16 @@ class OnvifClient {
return _injectCredentials(uri);
}
/// 一步到位:由 device xAddr 得到带凭证的 RTSP 地址。
Future<String> resolveRtsp(String deviceXAddr) async {
/// 一步到位:由 device xAddr 得到带凭证的 RTSP 地址与声明码率。
/// [profileSelect] 由调参面板控制:取子码流还是主码流。
Future<(String, int?)> resolveRtsp(
String deviceXAddr, {
RtspProfileSelect profileSelect = RtspProfileSelect.smallest,
}) async {
final mediaXAddr = await getMediaXAddr(deviceXAddr);
final token = await getLowLatencyProfileToken(mediaXAddr);
return getStreamUri(mediaXAddr, token);
final (token, bitrateKbps) = await getProfileToken(mediaXAddr, profileSelect);
final uri = await getStreamUri(mediaXAddr, token);
return (uri, bitrateKbps);
}
/// rtsp://ip/path -> rtsp://admin:pass@ip/path。

View File

@@ -0,0 +1,157 @@
/// 链路进给探针:**判断"图传那一段送过来的数据到底缺不缺"**。
///
/// 原理(不需要改原生,也不依赖 TrafficStats):
/// 直播流的 `buffered.last.end` 走在**媒体时间轴**上,它每推进 1ms,就等于
/// "收到了覆盖 1ms 媒体时长的数据"。用它除以墙钟间隔就是【进给率】:
/// feed = Δbuf / Δt → 数据到得齐不齐(丢帧、断供都会体现在这里)
/// play = Δpos / Δt → 渲染推得推不动(解码/性能问题会体现在这里,测不到则不判定)
/// 25fps 下每丢 1 帧 feed 少约 4%,所以 feed 可以直接当"码流完整度"读。
///
/// 为什么不用"积压绝对值"下结论(项目里的历史误报教训):RTP 时间戳与 ExoPlayer
/// 播放时钟存在系统性偏差,画面完全正常时积压也能涨到 4000~6000ms。
/// 这里 lagMs 只用作**粗分的第三种情况**(货到了没播 vs 根本没到货),阈值放得很宽,
/// 读数不可信时直接置 null(宁可少判一档,也不要用假数下结论)。
///
/// ⚠️ play 的输入必须是**原生未钳位的 position**(`await controller.position`):
/// video_player 的 `_updatePosition()` 会把位置钳到 `value.duration`,而 RTSP 直播的
/// duration 恒为 0 → `value.position` 永远是 0,于是 play 恒为 0%(假"渲染停滞"),
/// 且 lag = bufEnd - 0 会变成"自开播起的总时长"一路虚高。两者是同一个 bug 的两张脸。
///
/// 结论边界要说清楚:探针能证明"有没有缺数据",但缺数据的原因(空口误码 / 图传带宽 /
/// 网线接触)它分不出来;"进给完整但仍然花屏"则明确指向**内容本身坏了**,
/// 也就是摄像头编码或空口误码已经被拼进码流,这时 TCP 开关是救不了的。
enum LinkVerdict {
unknown(
'采样中',
'刚开始或读数不可信,等几秒再下结论。',
),
healthy(
'进给完整',
'数据基本按实时到齐。若画面仍花,病不在"传得不够",而在收到的码流本身有错'
'(空口误码已拼进流 / 编码)或解码层——切软解对比,或在摄像头端查 GOP。',
),
lightLoss(
'轻度丢帧',
'有丢帧但量不大:先切 TCP 看能否靠重传补回(补得回=链路在丢包但带宽够);'
'补不回就降码流。',
),
starved(
'断供',
'进给明显低于实时:链路吞吐不足或严重丢包,指向图传空口段。'
'APP 侧只能降码流(子码流 / 摄像头端调低码率、缩短 GOP),TCP 只会更卡。',
),
decoderStalled(
'渲染停滞',
'缓冲里还有货但播不动:解码/渲染跟不上,不是链路问题。'
'切软解或降码流对比。(仅在 position 读数可信时才会给出这一档)',
),
backlogGrowing(
'积压增长',
'缓冲末尾推进快于墙钟,积压持续变大(端到端延迟会一路上涨):媒体时间轴/推流偏差,'
'或播放侧跟不上。RTSP 是不可 seek 的直播源,ExoPlayer 不会丢旧数据追实时边缘,'
'所以唯一的止血办法是把 maxBufferMs 压小(Loader 到 max 就不许再囤)。',
);
const LinkVerdict(this.label, this.advice);
final String label;
final String advice;
}
/// 一次探针读数。
class RtspLinkSnapshot {
const RtspLinkSnapshot({
required this.windowMs,
required this.feed,
required this.play,
required this.lagMs,
required this.verdict,
this.declaredKbps,
});
final int windowMs;
/// 数据进给率(1.0 = 完全按实时到达)。
final double feed;
/// 渲染推进率(1.0 = 画面按实时在走)。null = 本流/本机型拿不到可信的 position,
/// 这一档直接不参与判定(绝不能再拿它当 0% 看)。
final double? play;
/// 缓冲末尾与播放位置之差(仅作粗分依据,不当延迟结论用)。null = 不可信。
final int? lagMs;
final LinkVerdict verdict;
/// ONVIF Profile 声明的码率(kbps),设备没报则为 null。
final int? declaredKbps;
/// 估算丢帧率(%):feed 低于 1 的部分。
int get estLossPct => ((1 - feed) * 100).clamp(0, 100).round();
/// 按"每 ms 媒体时长对应等量字节"估算的实际接收速率(kbps)。
/// 仅在有声明码率时给出,属于估算而非计量。
int? get estReceivedKbps =>
declaredKbps == null ? null : (declaredKbps! * feed).round();
/// 一行数字摘要(显示在链路条上方)。
String get detail {
final double? p = play;
final int? lag = lagMs;
final String base =
'进给 ${(feed * 100).toStringAsFixed(0)}%'
' · 渲染 ${p == null ? '—' : '${(p * 100).toStringAsFixed(0)}%'}'
' · 积压 ${lag == null ? '—' : '${lag}ms'}';
final int? kbps = estReceivedKbps;
if (kbps == null) return base;
return '$base · 实收≈${(kbps / 1000).toStringAsFixed(2)}M'
'/声明${(declaredKbps! / 1000).toStringAsFixed(2)}M';
}
}
/// 用两个相邻采样的增量算出探针读数。窗口不足或读数可疑时返回 null(不判定)。
///
/// [dPosMs] / [lagMs] 传 null 表示调用方确认这两个读数不可信(比如 position 拿不到),
/// 此时仅依 feed 判定,不再给出 `渲染停滞`。
RtspLinkSnapshot? evaluateLinkSnapshot({
required int dtMs,
int? dPosMs,
required int dBufMs,
int? lagMs,
int? declaredKbps,
}) {
// 第一个窗口没有增量;窗口太短的话时间戳抖动会盖过信号。
if (dtMs < 1500) return null;
// 缓冲末尾回退:重拉流/时间戳重置,这一轮作废。
if (dBufMs < -50) return null;
final double feed = (dBufMs / dtMs).clamp(0.0, 3.0);
final double? play = dPosMs == null ? null : (dPosMs / dtMs).clamp(0.0, 3.0);
final int? lag = lagMs;
// 关键分叉:feed 掉下来了,到底是"没到货"还是"货压着没播"?
// 手里还有明显积压却播不动 → 判解码/渲染;积压快见底 → 判链路断供。
// 没有可信的 position / lag 读数时,这一分叉直接不走(宁可少判一档)。
final bool renderStalled = play != null && play < 0.60;
final bool nearlyEmpty = lag != null && lag < 400;
final LinkVerdict verdict;
if (renderStalled && lag != null && !nearlyEmpty) {
verdict = LinkVerdict.decoderStalled;
} else if (feed > 1.08) {
verdict = LinkVerdict.backlogGrowing;
} else if (feed < 0.85) {
verdict = LinkVerdict.starved;
} else if (feed < 0.97) {
verdict = LinkVerdict.lightLoss;
} else {
verdict = LinkVerdict.healthy;
}
return RtspLinkSnapshot(
windowMs: dtMs,
feed: feed,
play: play,
lagMs: lagMs,
verdict: verdict,
declaredKbps: declaredKbps,
);
}

View File

@@ -0,0 +1,338 @@
import 'dart:convert';
import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';
import 'package:shared_preferences/shared_preferences.dart';
/// 解码方式(对应原生 PlaybackTuning.decoderMode)。
///
/// Media3 不传 RenderersFactory 时 = `DefaultRenderersFactory` + `MediaCodecSelector.DEFAULT`,
/// 即**硬件优先**,而且硬解初始化失败**不会**自动回退软解(直接报错)。
enum RtspDecoderMode {
hardwarePreferred(0, '硬解', 'Media3 默认:硬件解码器优先'),
softwareOnly(1, '软解', '只用软件解码:排除硬解差异,功耗高、高分辨率可能跟不上'),
hardwareWithFallback(2, '硬解+回退', '硬件优先,初始化失败时回退软解(缺对应硬解的机型有用)');
const RtspDecoderMode(this.nativeValue, this.label, this.desc);
final int nativeValue;
final String label;
final String desc;
static RtspDecoderMode fromName(String? name) {
return RtspDecoderMode.values.firstWhere(
(m) => m.name == name,
orElse: () => hardwarePreferred,
);
}
/// 从原生回显的 int 还原(回显里没有 name,只有 nativeValue)。
static RtspDecoderMode fromNative(int? value) {
return RtspDecoderMode.values.firstWhere(
(m) => m.nativeValue == value,
orElse: () => hardwarePreferred,
);
}
}
/// 取哪个 ONVIF Profile —— 这是 App 侧唯一能"调码率"的抓手。
///
/// App 不改摄像头编码配置(那要 SetVideoEncoderConfiguration,会写设备),
/// 而是换一条已配好的流:子码流低分辨率低码率、主码流反之。
enum RtspProfileSelect {
smallest('子码流', '分辨率最小的 Profile(默认,省带宽)'),
largest('主码流', '分辨率最大的 Profile(验证是不是码率超出图传吞吐)'),
first('设备首个', 'GetProfiles 返回的第一个(很多机型=主码流)');
const RtspProfileSelect(this.label, this.desc);
final String label;
final String desc;
static RtspProfileSelect fromName(String? name) {
return RtspProfileSelect.values.firstWhere(
(p) => p.name == name,
orElse: () => smallest,
);
}
}
/// 直播播放调参(与本地覆盖包 packages/video_player_android 的 PlaybackTuning.java 对应)。
///
/// 用途:把「治花屏」和「治延迟」两个互相冲突的策略做成**运行时可改的选项**,
/// 现场 A/B 不需要重新编译。改动只对**下一次拉流**生效(ExoPlayer 创建时读取)。
///
/// 两个策略的取舍(源码依据见各字段注释):
/// - **花屏** ← 空口/图传丢包。UDP 不重传,坏帧直接解出马赛克;TCP 会重传把画面补全,
/// 代价是弱链路下卡顿、延迟上升。
/// - **延迟** ← ExoPlayer 稳态积压。Media3 `DefaultLoadControl` 的 Loader 在
/// `minBufferMs..maxBufferMs` 之间锯齿,平均积压约为 `(min+max)/2`;
/// `bufferForPlaybackMs=0` 只决定「起播不等缓冲」,不压稳态延迟。
class RtspPlaybackTuning {
const RtspPlaybackTuning({
this.forceRtpTcp = false,
this.minBufferMs = 500,
this.maxBufferMs = 3000,
this.bufferForPlaybackMs = 0,
this.bufferForPlaybackAfterRebufferMs = 0,
this.rtspTimeoutMs = 0,
this.targetBufferBytes = 0,
this.decoderMode = RtspDecoderMode.hardwarePreferred,
this.profileSelect = RtspProfileSelect.smallest,
});
/// RTSP 的 RTP 传输方式。
/// false = UDP(Media3 默认,延迟低,丢包即花屏);true = TCP interleaved(抗丢包,代价是卡)。
final bool forceRtpTcp;
/// Loader 重新恢复加载的水位(毫秒)。
/// 注意:Media3 内部有 `minBufferUs = max(minBufferUs, 500_000)` 的硬下限,
/// 填小于 500 的值**不会有任何效果**,UI 上要把这一点告诉用户。
final int minBufferMs;
/// Loader 停止加载的水位(毫秒)= 稳态积压上限,延迟最直接的可调项。
final int maxBufferMs;
/// 起播/暂停恢复所需缓冲(毫秒)。直播保持 0,首帧到达即渲染。
final int bufferForPlaybackMs;
/// rebuffer 后恢复播放所需缓冲(毫秒)。直播保持 0,避免每次卡完再攒一段。
final int bufferForPlaybackAfterRebufferMs;
/// RtspMediaSource 超时(毫秒)。0 = 用 Media3 默认值。
/// 它同时影响「UDP 长时间无数据后改用 TCP 重试」与「多久无数据判为流结束」,
/// 设太小会在弱链路上误判断流。
final int rtspTimeoutMs;
/// 字节上限 `targetBufferBytes`。0 = 不覆盖,用 Media3 默认(视频约 2MB)。
/// 加载器是「时间水位到了**或**字节数到了」就停:子码流下 2MB 等于十几秒、轮不到它;
/// 换主码流/高码率后 2MB 可能不到 1 秒就撞上 → 表现为频繁 rebuffer,需调大。
/// 注:这就是当年 media_kit 那个 32MB bufferSize 在 ExoPlayer 里的对应项。
final int targetBufferBytes;
/// 解码方式(硬解/软解/硬解失败回退软解)。
final RtspDecoderMode decoderMode;
/// 取主码流还是子码流(在 ONVIF 取流那一步生效,猜 URL 兜底路径不受它控制)。
final RtspProfileSelect profileSelect;
static const RtspPlaybackTuning defaults = RtspPlaybackTuning();
// ===== 预设档位(现场试验直接点,不用逐个填数字)=====
/// 均衡:TCP 补画面 + 中等水位。图传链路上推荐先从这里开始试。
static const RtspPlaybackTuning balanced = RtspPlaybackTuning(
forceRtpTcp: true,
maxBufferMs: 1500,
);
/// 抗花屏优先:TCP + 原水位。画面完整性优先,能接受卡顿。
static const RtspPlaybackTuning antiArtifact = RtspPlaybackTuning(
forceRtpTcp: true,
maxBufferMs: 3000,
);
/// 低延迟优先:UDP + 紧水位。链路质量好、要最跟手时用。
static const RtspPlaybackTuning lowLatency = RtspPlaybackTuning(
forceRtpTcp: false,
maxBufferMs: 1000,
);
/// 稳态积压估算(毫秒):Loader 锯齿的中点。
int get estimatedBacklogMs => (minBufferMs + maxBufferMs) ~/ 2;
/// 当前是否处于「Media3 原生默认行为」——用于 UI 标记未改动。
bool get isDefault =>
forceRtpTcp == defaults.forceRtpTcp &&
minBufferMs == defaults.minBufferMs &&
maxBufferMs == defaults.maxBufferMs &&
bufferForPlaybackMs == defaults.bufferForPlaybackMs &&
bufferForPlaybackAfterRebufferMs == defaults.bufferForPlaybackAfterRebufferMs &&
rtspTimeoutMs == defaults.rtspTimeoutMs &&
targetBufferBytes == defaults.targetBufferBytes &&
decoderMode == defaults.decoderMode &&
profileSelect == defaults.profileSelect;
/// 给页面显示的一行摘要(含策略含义,省得对着数字猜)。
///
/// targetBufferBytes 是字节上限,它和 maxBufferMs 哪个先到就按哪个停,
/// 所以**它一旦被改大,延迟上限会跟着抬高**——这个字段以前不在摘要里,
/// 导致“今天怎么变慢了”完全看不出来,现在只要不是默认值就显式标出来。
String get summary {
final String bytesPart = targetBufferBytes == defaults.targetBufferBytes
? ''
: ' · 字节上限${targetBufferBytes ~/ 1024}KB';
return '${forceRtpTcp ? 'TCP' : 'UDP'} · '
'水位 $minBufferMs~${maxBufferMs}ms(≈$estimatedBacklogMs) · '
'${profileSelect.label} · ${decoderMode.label}$bytesPart';
}
RtspPlaybackTuning copyWith({
bool? forceRtpTcp,
int? minBufferMs,
int? maxBufferMs,
int? bufferForPlaybackMs,
int? bufferForPlaybackAfterRebufferMs,
int? rtspTimeoutMs,
int? targetBufferBytes,
RtspDecoderMode? decoderMode,
RtspProfileSelect? profileSelect,
}) {
return RtspPlaybackTuning(
forceRtpTcp: forceRtpTcp ?? this.forceRtpTcp,
minBufferMs: minBufferMs ?? this.minBufferMs,
maxBufferMs: maxBufferMs ?? this.maxBufferMs,
bufferForPlaybackMs: bufferForPlaybackMs ?? this.bufferForPlaybackMs,
bufferForPlaybackAfterRebufferMs:
bufferForPlaybackAfterRebufferMs ?? this.bufferForPlaybackAfterRebufferMs,
rtspTimeoutMs: rtspTimeoutMs ?? this.rtspTimeoutMs,
targetBufferBytes: targetBufferBytes ?? this.targetBufferBytes,
decoderMode: decoderMode ?? this.decoderMode,
profileSelect: profileSelect ?? this.profileSelect,
);
}
/// 下发给原生侧的参数。`max < min` 这类非法组合在这里先夹住:
/// Media3 构造函数对 maxBufferMs >= minBufferMs 有断言,越界会直接抛异常表现为首帧黑屏。
/// 注意:profileSelect 不出现在这里——它作用于 ONVIF 取流(Dart 侧),不是 ExoPlayer 参数。
Map<String, Object> toChannelArgs() {
final int min = minBufferMs < 500 ? 500 : minBufferMs; // Media3 硬下限
final int max = maxBufferMs < min ? min : maxBufferMs;
return <String, Object>{
'forceRtpTcp': forceRtpTcp,
'minBufferMs': min,
'maxBufferMs': max,
'bufferForPlaybackMs': bufferForPlaybackMs,
'bufferForPlaybackAfterRebufferMs': bufferForPlaybackAfterRebufferMs,
'rtspTimeoutMs': rtspTimeoutMs,
'targetBufferBytes': targetBufferBytes < 0 ? 0 : targetBufferBytes,
'decoderMode': decoderMode.nativeValue,
};
}
/// 持久化用:枚举存 name(存 index 会因枚举重排而错位)。
Map<String, Object> toJson() => <String, Object>{
...toChannelArgs(),
'profileSelect': profileSelect.name,
'decoderModeName': decoderMode.name,
};
factory RtspPlaybackTuning.fromMap(Map<String, Object?> m) {
return RtspPlaybackTuning(
forceRtpTcp: (m['forceRtpTcp'] as bool?) ?? defaults.forceRtpTcp,
minBufferMs: (m['minBufferMs'] as num?)?.toInt() ?? defaults.minBufferMs,
maxBufferMs: (m['maxBufferMs'] as num?)?.toInt() ?? defaults.maxBufferMs,
bufferForPlaybackMs:
(m['bufferForPlaybackMs'] as num?)?.toInt() ?? defaults.bufferForPlaybackMs,
bufferForPlaybackAfterRebufferMs:
(m['bufferForPlaybackAfterRebufferMs'] as num?)?.toInt() ??
defaults.bufferForPlaybackAfterRebufferMs,
rtspTimeoutMs: (m['rtspTimeoutMs'] as num?)?.toInt() ?? defaults.rtspTimeoutMs,
targetBufferBytes: (m['targetBufferBytes'] as num?)?.toInt() ?? defaults.targetBufferBytes,
// 缓存里存 name,原生回显里只有 int:两种来源都要能解。
decoderMode: m['decoderModeName'] != null
? RtspDecoderMode.fromName(m['decoderModeName'] as String?)
: RtspDecoderMode.fromNative((m['decoderMode'] as num?)?.toInt()),
profileSelect: RtspProfileSelect.fromName(m['profileSelect'] as String?),
);
}
// ===== 下发到原生插件 =====
static const MethodChannel _channel =
MethodChannel('plugins.flutter.dev/video_player_android/tuning');
/// 把当前配置下发给插件。**必须在 `VideoPlayerController.initialize()` 之前调用**,
/// 因为 LoadControl / RtspMediaSource.Factory 都是在创建播放器那一刻读值的。
Future<void> apply() async {
try {
final Map<Object?, Object?>? echoed =
await _channel.invokeMethod<Map<Object?, Object?>>('set', toChannelArgs());
debugPrint(
'🛠 [调参] 已下发 $summary → 原生回显 ${echoed?['maxBufferMs']}ms 水位 / '
'TCP=${echoed?['forceRtpTcp']}',
);
} on PlatformException catch (e) {
debugPrint('🛠 [调参] 下发失败:${e.code} ${e.message}');
} on MissingPluginException {
// 非 Android 平台或未使用本地覆盖包(例如误装了 pub.dev 的 video_player_android)。
debugPrint('🛠 [调参] 未找到调参通道:确认本地覆盖包已生效(dependency_overrides)');
}
}
/// 读回原生侧当前真正生效的值,用于「改了参数到底有没有进插件」的定性验证。
static Future<RtspPlaybackTuning?> readBack() async {
try {
final Map<Object?, Object?>? m =
await _channel.invokeMethod<Map<Object?, Object?>>('get');
if (m == null) return null;
return RtspPlaybackTuning.fromMap(
m.map((k, v) => MapEntry<String, Object?>('$k', v)),
);
} catch (_) {
return null;
}
}
// ===== 持久化(跨启动保留,方便反复折腾对比)=====
static const String _prefsKey = 'local_camera_playback_tuning';
Future<void> save() async {
try {
final prefs = await SharedPreferences.getInstance();
await prefs.setString(_prefsKey, jsonEncode(toJson()));
} catch (_) {}
}
static Future<RtspPlaybackTuning> load() async {
try {
final prefs = await SharedPreferences.getInstance();
final raw = prefs.getString(_prefsKey);
if (raw == null || raw.isEmpty) return defaults;
final m = (jsonDecode(raw) as Map).cast<String, Object?>();
return RtspPlaybackTuning.fromMap(m);
} catch (_) {
return defaults;
}
}
Future<void> clearSaved() async {
try {
final prefs = await SharedPreferences.getInstance();
await prefs.remove(_prefsKey);
} catch (_) {}
}
/// 值相等:State 的 Equatable 比较、预设档位的选中高亮都依赖它,
/// 否则从缓存读回来的同参配置会被当成“另一个对象”而多刷一次屏。
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is RtspPlaybackTuning &&
other.forceRtpTcp == forceRtpTcp &&
other.minBufferMs == minBufferMs &&
other.maxBufferMs == maxBufferMs &&
other.bufferForPlaybackMs == bufferForPlaybackMs &&
other.bufferForPlaybackAfterRebufferMs == bufferForPlaybackAfterRebufferMs &&
other.rtspTimeoutMs == rtspTimeoutMs &&
other.targetBufferBytes == targetBufferBytes &&
other.decoderMode == decoderMode &&
other.profileSelect == profileSelect;
@override
int get hashCode => Object.hash(
forceRtpTcp,
minBufferMs,
maxBufferMs,
bufferForPlaybackMs,
bufferForPlaybackAfterRebufferMs,
rtspTimeoutMs,
targetBufferBytes,
decoderMode,
profileSelect,
);
@override
String toString() => summary;
}

View File

@@ -4,6 +4,7 @@ import 'dart:io';
import 'package:connectivity_plus/connectivity_plus.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:video_player/video_player.dart';
import 'package:shared_preferences/shared_preferences.dart';
@@ -11,26 +12,41 @@ import 'package:shared_preferences/shared_preferences.dart';
import '../../data/onvif_client.dart';
import '../../data/onvif_discovery_service.dart';
import '../../data/onvif_subnet_scanner.dart';
import '../../data/rtsp_link_probe.dart';
import '../../data/rtsp_playback_tuning.dart';
import '../../data/rtsp_url_guesser.dart';
import '../../domain/entities/onvif_camera.dart';
import 'local_camera_state.dart';
/// 本地摄像头(ONVIF 发现 + RTSP 播放)核心 Cubit。
/// 负责:网络检查 → WS-Discovery 搜索 → ONVIF 取 RTSP → video_player(ExoPlayer) 拉流播放 → 断流/失败处理。
class LocalCameraCubit extends Cubit<LocalCameraState> {
LocalCameraCubit({OnvifClient? client})
: _client = client ?? OnvifClient(username: 'admin', password: ''),
///
/// 生命周期由本类自己接管([WidgetsBindingObserver]):退后台 pause、回前台**重拉流**。
/// 原因见 [didChangeAppLifecycleState] 里的 `seekTo(0)` 陷阱,这个不能交给插件默认行为。
class LocalCameraCubit extends Cubit<LocalCameraState>
with WidgetsBindingObserver {
/// [autoPlayFirst]:发现到摄像头后自动选第一路拉流(免手点,供“自动获取”场景)。
/// [autoRecover]:断流 / 缓冲卡死时不留在“请重新连接”,延时自动重拉流。
LocalCameraCubit({
OnvifClient? client,
this.autoPlayFirst = false,
this.autoRecover = false,
}) : _client = client ?? OnvifClient(username: 'admin', password: ''),
super(const LocalCameraState());
final OnvifDiscoveryService _discovery = OnvifDiscoveryService();
final OnvifClient _client;
final bool autoPlayFirst;
final bool autoRecover;
Timer? _recoverTimer;
/// 网段扫描兜底(组播失败时不依赖组播,直接 TCP 探设 ONVIF 设备)。
late final OnvifSubnetScanner _scanner = OnvifSubnetScanner(client: _client);
// ===== 播放器(video_player / Android=ExoPlayer)=====
// ExoPlayer 原生支持 RTSP(RtspMediaSource),默认走 TCP 交错、缓冲小,天然低延迟,
// 不需要 mpv 那套 cache/demuxer 手动调参。
// ExoPlayer 原生支持 RTSP(RtspMediaSource)。注意:Media3 的 RTP 传输**默认是 UDP 单播**,
// 只在“播放未开始且长时间收不到 RTP”时才回退 TCP 交错;要强制 TCP 必须显式 setForceUseRtpTcp(true)。
// 两者已做成运行时可调项(见 RtspPlaybackTuning / 页面调参条)。
VideoPlayerController? _videoController;
VoidCallback? _controllerListener;
@@ -64,6 +80,19 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
// 延迟,绝不能拿它弹“解码跟不上推流”这种提示(曾经就这样误报过)。
// 真断流自有 hasError 与 isBuffering 的 12s stallTimer 负责,这里只留日志看趋势。
Timer? _lagTimer;
// ===== 链路探针:用上面的增量直接算出“送过来的数据缺不缺”,结论上屏 =====
// 不依赖原生字节计量(TrafficStats 对 USB 以太网网卡不一定统计得到),
// 只拿已经有的 position / buffered 两个读数做差,所以改完热重启即可生效。
// 用 ValueNotifier 而不是放进 state:每 2s 刷一次读数的重建只发生在探针那一行。
final ValueNotifier<RtspLinkSnapshot?> _probe =
ValueNotifier<RtspLinkSnapshot?>(null);
/// 链路探针读数(UI 用 ValueListenableBuilder 监听)。
ValueListenable<RtspLinkSnapshot?> get probe => _probe;
/// ONVIF 声明码率(kbps),由取流那一步带出来,给探针当分母。设备未报则 null。
int? _declaredKbps;
// 推进速率诊断:同一个积压数字可能是两种完全相反的病因——
// pos 推进 ≪ 墙钟 → 解码/渲染停滞(播放追不上)
// buf 推进 > 墙钟 → 媒体时间轴/推流异常
@@ -76,7 +105,9 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
/// 页面进入时调用:检查网络并自动搜索。
Future<void> start() async {
WidgetsBinding.instance.addObserver(this); // close() 里成对移除
_listenConnectivity();
await _loadTuning();
await _checkNetworkAndDiscover();
}
@@ -165,6 +196,10 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
message: null,
),
);
// 自动获取模式:不等手点,直接选第一路拉流
if (autoPlayFirst && enriched.isNotEmpty) {
unawaited(selectCamera(enriched.first));
}
} catch (e) {
emit(
state.copyWith(
@@ -180,6 +215,7 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
/// 候选顺序:① ONVIF 正规 GetStreamUri 结果 → ② RtspUrlGuesser 常见品牌模板。
Future<void> selectCamera(OnvifCamera cam) async {
_userStopped = false;
_recoverTimer?.cancel();
emit(
state.copyWith(
phase: LocalCameraPhase.connecting,
@@ -198,10 +234,19 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
// 1) 先按 ONVIF 正道取流(能拿到就放到候选第一位)
final urls = <String>[];
String? onvifUrl;
_declaredKbps = null;
try {
onvifUrl = await _client.resolveRtsp(cam.xAddr);
final (String uri, int? kbps) = await _client.resolveRtsp(
cam.xAddr,
profileSelect: _tuning.profileSelect,
);
onvifUrl = uri;
_declaredKbps = kbps;
urls.add(onvifUrl);
debugPrint('🎬 [拉流] ONVIF 解析成功:$onvifUrl');
debugPrint(
'🎬 [拉流] ONVIF 解析成功:$onvifUrl'
'${kbps != null ? '(声明 ${kbps}kbps)' : ''}',
);
} catch (e) {
debugPrint('🎬 [拉流] ONVIF 未给出 RTSP:$e');
}
@@ -263,14 +308,25 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
showReconnect: true,
),
);
_scheduleRecover(const Duration(seconds: 5));
}
/// 打开单个候选 URL,[timeout] 内完成 initialize() 且首帧就绪即视为成功。
/// ExoPlayer 对 RTSP 直播默认走 TCP 交错、缓冲小;失败/超时则 dispose 后返回 false。
/// 失败/超时则 dispose 后返回 false。传输方式(UDP/TCP)与缓冲水位在此刻由原生侧读调参配置决定。
Future<bool> _tryPlay(String url, {required Duration timeout}) async {
VideoPlayerController? c;
try {
c = VideoPlayerController.networkUrl(Uri.parse(url));
// 调参必须在 initialize 之前下发:LoadControl 与 RtspMediaSource.Factory 都是
// 在创建播放器那一刻读值,晚一步本轮拉流就用的是旧参数。
await _tuning.apply();
c = VideoPlayerController.networkUrl(
Uri.parse(url),
// 关键:关掉插件内置的生命周期观察者,改由本类的 didChangeAppLifecycleState 接管。
// 不设这一项的话,回前台那次 play() 会把直播 seek 回缓冲最前端(延迟棘轮)。
videoPlayerOptions: VideoPlayerOptions(
allowBackgroundPlayback: true,
),
);
await c.initialize().timeout(timeout);
// 直播流 initialize 完成即已连上并拿到分辨率;立即起播
await c.play();
@@ -332,7 +388,11 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
_controllerListener = null;
try {
await c.dispose();
} catch (_) {}
} catch (e) {
// 这里不能吞:原生没 release 就不会发 RTSP TEARDOWN,摄像头侧的会话会越积越多,
// 表现为“越播越慢”,网线直连的单播杂牌机尤其常见(并发会话路数受限)。
debugPrint('🧹 [释放] controller.dispose 失败(RTSP 会话可能未 TEARDOWN):$e');
}
}
}
@@ -341,51 +401,131 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
_openWatchdog = null;
}
// ===== 生命周期:后台必须自己管,不能留给 video_player 的默认行为 =====
// 插件内置观察者(allowBackgroundPlayback=false 时创建)在 resumed 调 play(),
// 而 play() 第一行是:
// if (value.position == value.duration) await seekTo(Duration.zero);
// 直播的 duration 恒为 0,position 又被 _updatePosition 钳到 0 → **条件恒成立**,
// 于是每次回前台都会被 seek 到【缓冲里最旧的那一帧】。RTSP 源 isSeekable=false 且没有
// LiveConfiguration(BEHIND_LIVE_WINDOW 那条追赶分支根本不会触发),只能 1x
// 从最旧帧重播 → 延迟当场变成“当时已缓冲的总时长”,且**只增不减(棘轮)**。
// 这就是“卡了一下、重进来就没之前快了”的机制。所以这里显式关掉内置观察者,
// 后台只 pause(pause 不带 seek,安全),回前台直接重建控制器重拉流把时间轴清零。
bool _resumeOnForeground = false;
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
// 参数必须叫 state(重写方法不得改名),所以下面访问 Cubit 自己的状态时必须带 this.。
final VideoPlayerController? c = _videoController;
if (state == AppLifecycleState.paused ||
state == AppLifecycleState.hidden) {
if (c != null &&
!c.value.hasError &&
this.state.phase == LocalCameraPhase.playing &&
c.value.isPlaying) {
_resumeOnForeground = true;
unawaited(c.pause());
// 后台期间不要把“断流判定/采样”继续跑:stallTimer 会把正常退后台误判成掉线,
// 而跨过后台的增量做差得出的进给/积压读数必然是假的。
_stallTimer?.cancel();
_stallTimer = null;
_stopLagWatchdog();
debugPrint('🧊 [生命周期] 退后台:已暂停(回前台将重拉流,不进 seek 陷阱)');
}
return;
}
if (state == AppLifecycleState.resumed && _resumeOnForeground) {
_resumeOnForeground = false;
if (_userStopped || isClosed) return;
// 同一条路径同时间只能跑一遍:重拉会 dispose + 新建控制器,
// 两遍同时跑会互相踩掉对方的 controller(表现为一闪就黑、或留下未释放的会话)。
if (this.state.phase == LocalCameraPhase.connecting) return;
debugPrint('🔥 [生命周期] 回前台:重拉流以回到实时边缘');
unawaited(reapplyAndReplay());
}
// inactive / detached 刻意不管:分屏、下拉通知栏、锁屏动画都会发 inactive,
// 据此重拉流只会把正常观看打断。
}
// ===== 延迟水位观测 =====
void _startLagWatchdog() {
_lagTimer?.cancel();
_prevPosMs = -1;
_prevBufMs = -1;
_prevSampleAtMs = 0;
_probe.value = null; // 重拉流后时间轴从头开始,旧读数一律作废
_lagTimer = Timer.periodic(
const Duration(seconds: 2),
(_) => _checkLagWatermark(),
(_) => unawaited(_checkLagWatermark()),
);
}
void _stopLagWatchdog() {
_lagTimer?.cancel();
_lagTimer = null;
_probe.value = null;
}
/// 只读不回写:“缓冲末尾 - 播放位置”= 播放器内部积压(直播时间轴从 0 起算)。
void _checkLagWatermark() {
///
/// ⚠️ position 一律走 `await c.position`(直连原生 getCurrentPosition),
/// 不能用 `c.value.position`:video_player 的 `_updatePosition()` 会把上报位置
/// **钳到 value.duration**,而 RTSP 直播的 duration == Duration.zero,于是
/// `value.position` 永远是 0:探针的“渲染”会恒为 0%(误报渲染停滞),
/// “积压”会等于 buffer 末尾本身(自开播算起的总时长)一路虚高。
Future<void> _checkLagWatermark() async {
final c = _videoController;
if (c == null || _userStopped || isClosed) return;
if (state.phase != LocalCameraPhase.playing || !c.value.isInitialized) return;
if (c.value.buffered.isEmpty) return;
final int bufferedEndMs = c.value.buffered.last.end.inMilliseconds;
final int positionMs = c.value.position.inMilliseconds;
// 直播流的缓冲位置可能取到 C.POSITION_UNSET(Long.MIN_VALUE),经 Duration 转换后
// 会变成荒谬值,只接受合理区间内的读数。
if (bufferedEndMs <= 0 || positionMs < 0) return;
final int lagMs = bufferedEndMs - positionMs;
if (lagMs < 0 || lagMs > _lagSaneMaxMs) {
debugPrint('⏱ [延迟水位] 读数异常(lag=${lagMs}ms),本轮不判定');
return;
if (bufferedEndMs <= 0) return;
// 原生读数:拿不到(已销毁/异常/荒谬值)就标记不可信,本轮只用 feed。
int rawPosMs = -1;
try {
final Duration? p = await c.position;
if (p != null) rawPosMs = p.inMilliseconds;
} catch (_) {
rawPosMs = -1;
}
// await 期间可能已经停播/关页:_probe 一旦 dispose 就不能再写。
if (_userStopped || isClosed) return;
final bool posUsable =
rawPosMs >= 0 && rawPosMs <= _lagSaneMaxMs * 200; // 上限防住 TIME_UNSET 类荒谬值
// 积压只在两个读数都合理时才给;超出合理区间当“不可信”处理,不因此中断采样。
final int lagRaw = posUsable ? bufferedEndMs - rawPosMs : -1;
final int? lagMs = (lagRaw >= 0 && lagRaw <= _lagSaneMaxMs) ? lagRaw : null;
final int nowMs = DateTime.now().millisecondsSinceEpoch;
final int dtMs = _prevSampleAtMs == 0 ? 0 : nowMs - _prevSampleAtMs;
final int dPos = _prevPosMs < 0 ? 0 : positionMs - _prevPosMs;
int? dPos = !posUsable || _prevPosMs < 0 ? null : rawPosMs - _prevPosMs;
final int dBuf = _prevBufMs < 0 ? 0 : bufferedEndMs - _prevBufMs;
_prevPosMs = positionMs;
if (dPos != null && dPos < -50) dPos = null; // 时间轴重置,这一轮不判渲染
_prevPosMs = posUsable ? rawPosMs : -1;
_prevBufMs = bufferedEndMs;
_prevSampleAtMs = nowMs;
debugPrint(
dtMs == 0
? '⏱ [延迟水位] 积压=${lagMs}ms pos=${positionMs}ms buf=${bufferedEndMs}ms'
: '⏱ [延迟水位] 积压=${lagMs}ms | ${dtMs}ms 内 pos推进=${dPos}ms · buf推进=${dBuf}ms',
'⏱ [延迟水位] ${lagMs == null ? '积压=不可信' : '积压=${lagMs}ms'}'
' pos=${posUsable ? '${rawPosMs}ms' : '不可信'} buf=${bufferedEndMs}ms'
'${dtMs == 0 ? '' : ' | ${dtMs}ms 内 pos推进=${dPos == null ? '—' : '${dPos}ms'} · buf推进=${dBuf}ms'}',
);
// 同上:绝对值不当判据,但【增量】是可信的,交给链路探针做分类。
final RtspLinkSnapshot? snap = evaluateLinkSnapshot(
dtMs: dtMs,
dPosMs: dPos,
dBufMs: dBuf,
lagMs: lagMs,
declaredKbps: _declaredKbps,
);
if (snap != null) {
_probe.value = snap;
debugPrint(
'📡 [链路探针] ${snap.verdict.label}|${snap.detail}'
'${snap.estLossPct > 0 ? '|丢帧≈${snap.estLossPct}%' : ''}'
'|${snap.verdict.advice}',
);
}
// 注意:此处故意不对 lagMs 做任何“失败”判定,也绝不 emit disconnected。
// 积压读数受媒体时间轴偏差影响,画面正常时也能涨到几千毫秒,据此提示只会误报。
}
@@ -400,6 +540,24 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
showReconnect: true,
),
);
// 卡顿(缓冲进度 0% 超 12s)/断流自动刷新:延时重拉,替代手动点“重新连接”
_scheduleRecover(const Duration(seconds: 3));
}
/// 自动恢复调度:仅 [autoRecover] 开启且用户未主动停播时生效。
void _scheduleRecover(Duration delay) {
if (!autoRecover || _userStopped || isClosed) return;
_recoverTimer?.cancel();
_recoverTimer = Timer(delay, () {
if (isClosed || _userStopped) return;
final cam = state.selected;
debugPrint('♻️ [自动恢复] ${cam != null ? '重拉流:${cam.xAddr}' : '无选中摄像头,重新搜索'}');
if (cam != null) {
unawaited(selectCamera(cam));
} else {
unawaited(_checkNetworkAndDiscover());
}
});
}
/// 点击"重新连接":有选中摄像头则重拉流,否则重新搜索。
@@ -412,6 +570,96 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
await selectCamera(cam);
}
// ===== 直播调参(花屏 / 延迟现场 A/B)=====
RtspPlaybackTuning _tuning = RtspPlaybackTuning.defaults;
/// 当前生效的调参(页面回显用)。
RtspPlaybackTuning get tuning => _tuning;
/// 读回原生插件里**真正生效**的值,用于确认“改了参数到底有没有进插件”。
Future<RtspPlaybackTuning?> readBackTuning() => RtspPlaybackTuning.readBack();
/// 进入页面:恢复上次调参并先下发一次(保证首拉就用对参数)。
Future<void> _loadTuning() async {
_tuning = await RtspPlaybackTuning.load();
emit(state.copyWith(tuning: _tuning));
await _tuning.apply();
}
/// 保存 + 下发一组调参。[reconnect] 为 true 且已在播/曾出画面时,
/// 直接用**当前已解析的 RTSP 地址**重拉一次(跳过发现与取流,方便反复对比)。
Future<void> updateTuning(
RtspPlaybackTuning tuning, {
bool reconnect = true,
}) async {
// 先比一下码流选择有没有变:它决定取哪一路 Profile,不能靠“同一个 URL 重拉”体现。
final bool profileChanged = tuning.profileSelect != _tuning.profileSelect;
_tuning = tuning;
await tuning.save();
emit(state.copyWith(tuning: tuning));
await tuning.apply();
debugPrint('🛠 [调参] 已保存并下发:${tuning.summary}');
if (!reconnect) return;
// 换码流 = 换一路 URL,必须重新走 ONVIF 取流;其余参数只影响播放器本身,
// 用已解析的地址直接重拉更快(避开发现/取流的十秒级耗时)。
final OnvifCamera? cam = state.selected;
if (profileChanged && cam != null) {
await selectCamera(cam);
return;
}
await reapplyAndReplay();
}
/// 恢复默认(Media3 原生行为),并重拉一次以排除自己改坏的参数。
Future<void> resetTuning() async {
await RtspPlaybackTuning.defaults.clearSaved();
await updateTuning(RtspPlaybackTuning.defaults);
}
/// 用当前 rtspUrl 重新拉流(不走发现/取流流程)。没有画面时只存不重连。
Future<void> reapplyAndReplay() async {
final url = state.rtspUrl;
if (url == null) return;
if (state.phase != LocalCameraPhase.playing &&
state.phase != LocalCameraPhase.disconnected &&
state.phase != LocalCameraPhase.playFailed) {
return;
}
_userStopped = false;
emit(
state.copyWith(
phase: LocalCameraPhase.connecting,
playStep: ChainStatus.running,
clearMessage: true,
showReconnect: false,
),
);
await _disposeController();
_armOpenWatchdog();
final ok = await _tryPlay(url, timeout: const Duration(seconds: 8));
_cancelWatchdog();
if (ok) {
emit(
state.copyWith(
phase: LocalCameraPhase.playing,
playStep: ChainStatus.success,
clearMessage: true,
showReconnect: false,
),
);
} else {
emit(
state.copyWith(
phase: LocalCameraPhase.playFailed,
playStep: ChainStatus.failed,
message: '重拉失败:当前参数下未能起播',
showReconnect: true,
),
);
_scheduleRecover(const Duration(seconds: 5));
}
}
/// 返回摄像头列表(重新搜索)。
Future<void> backToList() async {
_userStopped = true;
@@ -630,11 +878,14 @@ class LocalCameraCubit extends Cubit<LocalCameraState> {
@override
Future<void> close() async {
_userStopped = true;
WidgetsBinding.instance.removeObserver(this);
_openWatchdog?.cancel();
_stallTimer?.cancel();
_recoverTimer?.cancel();
_lagTimer?.cancel();
_connectivitySub?.cancel();
await _disposeController();
_probe.dispose();
return super.close();
}
}

View File

@@ -1,5 +1,6 @@
import 'package:equatable/equatable.dart';
import '../../data/rtsp_playback_tuning.dart';
import '../../domain/entities/onvif_camera.dart';
/// 链条每一步的状态
@@ -29,6 +30,7 @@ class LocalCameraState extends Equatable {
final String? rtspUrl;
final String? message; // 提示语
final bool showReconnect; // 是否显示"重新连接"按钮
final RtspPlaybackTuning tuning; // 直播调参(传输方式 / 缓冲水位),设置面板读写
const LocalCameraState({
this.phase = LocalCameraPhase.idle,
@@ -41,6 +43,7 @@ class LocalCameraState extends Equatable {
this.rtspUrl,
this.message,
this.showReconnect = false,
this.tuning = RtspPlaybackTuning.defaults,
});
bool get isPlaying => phase == LocalCameraPhase.playing;
@@ -65,6 +68,7 @@ class LocalCameraState extends Equatable {
String? message,
bool clearMessage = false,
bool? showReconnect,
RtspPlaybackTuning? tuning,
}) {
return LocalCameraState(
phase: phase ?? this.phase,
@@ -77,6 +81,7 @@ class LocalCameraState extends Equatable {
rtspUrl: clearRtsp ? null : (rtspUrl ?? this.rtspUrl),
message: clearMessage ? null : (message ?? this.message),
showReconnect: showReconnect ?? this.showReconnect,
tuning: tuning ?? this.tuning,
);
}
@@ -92,5 +97,6 @@ class LocalCameraState extends Equatable {
rtspUrl,
message,
showReconnect,
tuning,
];
}

View File

@@ -2,9 +2,12 @@ import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:video_player/video_player.dart';
import 'package:maibu_satabot_v2/features/pv_control/presentation/pages/pv_control_page.dart';
import '../../domain/entities/onvif_camera.dart';
import '../cubit/local_camera_cubit.dart';
import '../cubit/local_camera_state.dart';
import '../widgets/rtsp_tuning_panel.dart';
/// 本地视频页:ONVIF 自动发现 + RTSP 播放(搜索与播放合一)。
/// 上方为播放器 / 搜索状态 / 摄像头列表,下方为链路状态"链条"实时展示。
@@ -37,7 +40,8 @@ class _LocalCameraViewState extends State<_LocalCameraView> {
return BlocBuilder<LocalCameraCubit, LocalCameraState>(
builder: (context, state) {
return PopScope(
canPop: state.phase != LocalCameraPhase.playing &&
canPop:
state.phase != LocalCameraPhase.playing &&
state.phase != LocalCameraPhase.connecting,
onPopInvokedWithResult: (didPop, result) {
if (!didPop) {
@@ -61,7 +65,10 @@ class _LocalCameraViewState extends State<_LocalCameraView> {
),
title: const Text(
'本地视频',
style: TextStyle(color: Colors.white, fontWeight: FontWeight.w600),
style: TextStyle(
color: Colors.white,
fontWeight: FontWeight.w600,
),
),
centerTitle: true,
actions: [
@@ -71,12 +78,34 @@ class _LocalCameraViewState extends State<_LocalCameraView> {
icon: const Icon(Icons.refresh, color: Colors.white),
onPressed: () => cubit.runDiscovery(),
),
// 🔥 入口:进入光伏电站机器人远程控制(横屏动态大屏)页面
IconButton(
tooltip: '远程控制',
icon: const Icon(
Icons.sports_esports_outlined,
color: Colors.white,
),
onPressed: () {
Navigator.of(context).push(
MaterialPageRoute(
builder: (_) => const PvControlPage(deviceId: ''),
),
);
},
),
],
),
body: SafeArea(
child: Column(
children: [
Expanded(child: _buildContent(context, cubit, state)),
// 链路探针:只读结论,放在调参条上方(同样不遮住画面)。
RtspLinkProbeBar(probe: cubit.probe),
// 调参条:固定在链路条上方(不放画面上),改完直接重拉流做 A/B。
RtspTuningBar(
tuning: state.tuning,
onOpen: () => showRtspTuningSheet(context, cubit),
),
_buildChain(context, state),
],
),
@@ -128,9 +157,7 @@ class _LocalCameraViewState extends State<_LocalCameraView> {
) {
return Stack(
children: [
Positioned.fill(
child: _buildPlayer(cubit),
),
Positioned.fill(child: _buildPlayer(cubit)),
// 连接中遮罩
if (state.phase == LocalCameraPhase.connecting)
Positioned.fill(
@@ -171,10 +198,7 @@ class _LocalCameraViewState extends State<_LocalCameraView> {
? size.width / size.height
: 16 / 9;
return Center(
child: AspectRatio(
aspectRatio: ratio,
child: VideoPlayer(controller),
),
child: AspectRatio(aspectRatio: ratio, child: VideoPlayer(controller)),
);
}
@@ -229,45 +253,49 @@ class _LocalCameraViewState extends State<_LocalCameraView> {
return Container(
color: dark ? Colors.black.withValues(alpha: 0.65) : Colors.black,
alignment: Alignment.center,
child: Padding(
padding: const EdgeInsets.all(24),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
if (spinning)
const SizedBox(
width: 42,
height: 42,
child: CircularProgressIndicator(
color: Color(0xFF165DFF),
strokeWidth: 3,
// FittedBox:嵌入受限高度容器时整组等比缩小,避免「重试」按钮溢出
child: FittedBox(
fit: BoxFit.scaleDown,
child: Padding(
padding: const EdgeInsets.all(24),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
if (spinning)
const SizedBox(
width: 42,
height: 42,
child: CircularProgressIndicator(
color: Color(0xFF165DFF),
strokeWidth: 3,
),
)
else
Icon(icon, color: Colors.white54, size: 52),
const SizedBox(height: 18),
Text(
message,
textAlign: TextAlign.center,
style: const TextStyle(
color: Colors.white,
fontSize: 15,
height: 1.5,
),
)
else
Icon(icon, color: Colors.white54, size: 52),
const SizedBox(height: 18),
Text(
message,
textAlign: TextAlign.center,
style: const TextStyle(
color: Colors.white,
fontSize: 15,
height: 1.5,
),
),
if (actionLabel != null && onAction != null) ...[
const SizedBox(height: 22),
ElevatedButton.icon(
style: ElevatedButton.styleFrom(
backgroundColor: const Color(0xFF165DFF),
foregroundColor: Colors.white,
if (actionLabel != null && onAction != null) ...[
const SizedBox(height: 22),
ElevatedButton.icon(
style: ElevatedButton.styleFrom(
backgroundColor: const Color(0xFF165DFF),
foregroundColor: Colors.white,
),
onPressed: onAction,
icon: const Icon(Icons.refresh, size: 18),
label: Text(actionLabel),
),
onPressed: onAction,
icon: const Icon(Icons.refresh, size: 18),
label: Text(actionLabel),
),
],
],
],
),
),
),
);
@@ -346,7 +374,10 @@ class _ChainNode extends StatelessWidget {
child: loading
? Padding(
padding: const EdgeInsets.all(3),
child: CircularProgressIndicator(color: color, strokeWidth: 3),
child: CircularProgressIndicator(
color: color,
strokeWidth: 3,
),
)
: CircleAvatar(
backgroundColor: color,
@@ -360,7 +391,9 @@ class _ChainNode extends StatelessWidget {
Text(
step.label,
style: TextStyle(
color: step.status == ChainStatus.idle ? Colors.white38 : Colors.white,
color: step.status == ChainStatus.idle
? Colors.white38
: Colors.white,
fontSize: 12,
),
),
@@ -435,7 +468,10 @@ class _CameraTile extends StatelessWidget {
: (camera.manufacturer.isNotEmpty
? camera.manufacturer
: '未知型号'),
style: const TextStyle(color: Colors.white54, fontSize: 13),
style: const TextStyle(
color: Colors.white54,
fontSize: 13,
),
),
],
),

View File

@@ -0,0 +1,353 @@
import 'package:flutter/material.dart';
import '../../data/rtsp_playback_tuning.dart';
/// 调参弹窗用的公共小组件(标题 / 预设档位 / 传输方式 / 毫秒输入框)。
class TuningSectionTitle extends StatelessWidget {
const TuningSectionTitle({super.key, required this.text});
final String text;
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.only(bottom: 8),
child: Text(
text,
style: const TextStyle(
color: Color(0xFFEDEDED),
fontSize: 13,
fontWeight: FontWeight.w600,
),
),
);
}
}
class TuningHint extends StatelessWidget {
const TuningHint({super.key, required this.text});
final String text;
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.only(top: 6),
child: Text(
text,
// 不用 white38:在 #141414 底上对比度只有 2.3:1,太阳底下根本看不清。
style: const TextStyle(color: Color(0xFF9AA0A6), fontSize: 11, height: 1.5),
),
);
}
}
/// 预设档位:现场试验直接点一个再微调,省得对着数字猜。
class TuningPresetRow extends StatelessWidget {
const TuningPresetRow({super.key, required this.draft, required this.onPick});
final RtspPlaybackTuning draft;
final ValueChanged<RtspPlaybackTuning> onPick;
static const List<(String, RtspPlaybackTuning)> presets = <(String, RtspPlaybackTuning)>[
('原生默认', RtspPlaybackTuning.defaults),
('均衡', RtspPlaybackTuning.balanced),
('抗花屏', RtspPlaybackTuning.antiArtifact),
('低延迟', RtspPlaybackTuning.lowLatency),
];
@override
Widget build(BuildContext context) {
return Wrap(
spacing: 8,
runSpacing: 8,
children: [
for (final p in presets)
_TuningPresetPill(
label: p.$1,
selected: p.$2 == draft,
onTap: () => onPick(p.$2),
),
],
);
}
}
/// 预设档位药丸。
///
/// 之前用的是 ChoiceChip:弹窗底色是写死的深色,而 APP 可能是浅色主题,
/// chip 会拿到「浅色底 + 白色字」这种看不清的组合,且和下面的自绘卡片风格不统一。
/// 自己画可以彻底不依赖主题,也不随用户的浅色/深色设置漂移。
class _TuningPresetPill extends StatelessWidget {
const _TuningPresetPill({
required this.label,
required this.selected,
required this.onTap,
});
final String label;
final bool selected;
final VoidCallback onTap;
@override
Widget build(BuildContext context) {
return InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(14),
child: Container(
padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 8),
decoration: BoxDecoration(
color: selected ? const Color(0xFF165DFF) : const Color(0xFF2A2A2A),
borderRadius: BorderRadius.circular(14),
border: Border.all(
color: selected ? const Color(0xFF5B8DEF) : const Color(0xFF4A4A4A),
),
),
child: Text(
label,
style: TextStyle(
color: selected ? Colors.white : const Color(0xFFDDDDDD),
fontSize: 12,
fontWeight: selected ? FontWeight.w600 : FontWeight.w400,
),
),
),
);
}
}
/// UDP / TCP 二选一。用两个可点卡片而不是 Switch,是为了把各自的代价直接写在脸上。
class TuningTransportPicker extends StatelessWidget {
const TuningTransportPicker({super.key, required this.forceTcp, required this.onChanged});
final bool forceTcp;
final ValueChanged<bool> onChanged;
@override
Widget build(BuildContext context) {
return Row(
children: [
Expanded(
child: _TuningTransportOption(
title: 'UDP',
subtitle: '延迟低 / 丢包即花屏',
selected: !forceTcp,
onTap: () => onChanged(false),
),
),
const SizedBox(width: 10),
Expanded(
child: _TuningTransportOption(
title: 'TCP',
subtitle: '画面完整 / 可能卡顿',
selected: forceTcp,
onTap: () => onChanged(true),
),
),
],
);
}
}
class _TuningTransportOption extends StatelessWidget {
const _TuningTransportOption({
required this.title,
required this.subtitle,
required this.selected,
required this.onTap,
});
final String title;
final String subtitle;
final bool selected;
final VoidCallback onTap;
@override
Widget build(BuildContext context) {
return InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(8),
child: Container(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 10),
decoration: BoxDecoration(
color: selected
? const Color(0xFF165DFF).withValues(alpha: 0.30)
: const Color(0xFF232323),
borderRadius: BorderRadius.circular(8),
border: Border.all(
color: selected
? const Color(0xFF5B8DEF)
: const Color(0xFF3D3D3D),
width: selected ? 1.4 : 1,
),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
title,
style: TextStyle(
color: selected ? Colors.white : const Color(0xFFCCCCCC),
fontSize: 14,
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 2),
Text(
subtitle,
style: const TextStyle(color: Color(0xFF9AA0A6), fontSize: 11),
),
],
),
),
);
}
}
/// 毫秒参数输入框:右侧常驻一句“这个值到底影响什么”,避免瞎填。
class TuningMsField extends StatefulWidget {
const TuningMsField({
super.key,
required this.label,
required this.value,
required this.hint,
required this.onChanged,
this.suffix = 'ms',
});
final String label;
final int value;
final String hint;
final ValueChanged<int> onChanged;
/// 单位后缀。水位类是 ms,缓冲字节类是 KB。
final String suffix;
@override
State<TuningMsField> createState() => _TuningMsFieldState();
}
class _TuningMsFieldState extends State<TuningMsField> {
late final TextEditingController _ctrl =
TextEditingController(text: '${widget.value}');
@override
void didUpdateWidget(covariant TuningMsField oldWidget) {
super.didUpdateWidget(oldWidget);
// 点预设档位时要同步回填输入框;光标还在框里(用户正在输入)时不覆盖。
if (widget.value != oldWidget.value && !_ctrl.selection.isValid) {
_ctrl.text = '${widget.value}';
}
}
@override
void dispose() {
_ctrl.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.only(bottom: 10),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
widget.label,
style: const TextStyle(color: Color(0xFFCCCCCC), fontSize: 12),
),
const SizedBox(height: 4),
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
SizedBox(
width: 110,
child: TextField(
controller: _ctrl,
keyboardType: TextInputType.number,
// 浅色主题下默认 cursor 是深色,在深底输入框里几乎看不见。
cursorColor: const Color(0xFF94BFFF),
style: const TextStyle(color: Colors.white, fontSize: 14),
decoration: InputDecoration(
isDense: true,
suffixText: widget.suffix,
suffixStyle: const TextStyle(
color: Color(0xFF9AA0A6),
fontSize: 11,
),
filled: true,
fillColor: const Color(0xFF232323),
contentPadding: const EdgeInsets.symmetric(
horizontal: 10,
vertical: 8,
),
enabledBorder: const OutlineInputBorder(
borderSide: BorderSide(color: Color(0xFF3D3D3D)),
),
focusedBorder: const OutlineInputBorder(
borderSide: BorderSide(color: Color(0xFF5B8DEF)),
),
),
onChanged: (v) => widget.onChanged(int.tryParse(v.trim()) ?? 0),
),
),
const SizedBox(width: 6),
Expanded(
child: Padding(
padding: const EdgeInsets.only(top: 6),
child: Text(
widget.hint,
style: const TextStyle(
color: Color(0xFF9AA0A6),
fontSize: 11,
height: 1.4,
),
),
),
),
],
),
],
),
);
}
}
/// 多选一卡片行:把每个选项的代价直接写在卡片上,比下拉框更适合现场试参数。
class TuningChoiceRow<T> extends StatelessWidget {
const TuningChoiceRow({
super.key,
required this.options,
required this.labelOf,
required this.selected,
required this.onChanged,
this.subtitleOf,
});
final List<T> options;
final String Function(T) labelOf;
final String Function(T)? subtitleOf;
final T selected;
final ValueChanged<T> onChanged;
@override
Widget build(BuildContext context) {
return Row(
children: [
for (int i = 0; i < options.length; i++) ...[
if (i > 0) const SizedBox(width: 8),
Expanded(
child: _TuningTransportOption(
title: labelOf(options[i]),
subtitle: subtitleOf?.call(options[i]) ?? '',
selected: options[i] == selected,
onTap: () => onChanged(options[i]),
),
),
],
],
);
}
}

View File

@@ -0,0 +1,532 @@
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../data/rtsp_link_probe.dart';
import '../../data/rtsp_playback_tuning.dart';
import '../cubit/local_camera_cubit.dart';
import 'rtsp_tuning_fields.dart';
/// 链路条上方的「调参条」:一行显示当前生效策略,点开弹窗慢慢改。
///
/// 放这里而不是画面上:画面区域要留给视频本身,且改完参数会立刻重拉流,
/// 任何浮层都会干扰肉眼判断花屏/延迟的变化。
class RtspTuningBar extends StatelessWidget {
const RtspTuningBar({
super.key,
required this.tuning,
required this.onOpen,
});
final RtspPlaybackTuning tuning;
final VoidCallback onOpen;
@override
Widget build(BuildContext context) {
return Material(
color: const Color(0xFF0A0A0A),
child: InkWell(
onTap: onOpen,
child: Padding(
padding: const EdgeInsets.fromLTRB(12, 8, 8, 8),
child: Row(
children: [
const Icon(Icons.tune, color: Color(0xFF165DFF), size: 18),
const SizedBox(width: 8),
const Text('调参', style: TextStyle(color: Color(0xFFCCCCCC), fontSize: 12)),
const SizedBox(width: 10),
Expanded(
child: Text(
tuning.summary,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(
color: tuning.isDefault
? const Color(0xFF9AA0A6)
: const Color(0xFFFFC53D),
fontSize: 12,
),
),
),
if (!tuning.isDefault)
const Padding(
padding: EdgeInsets.only(right: 6),
child: Text(
'已自定义',
style: TextStyle(color: Color(0xFFFFC53D), fontSize: 11),
),
),
const Icon(Icons.chevron_right, color: Color(0xFF8A8A8A), size: 18),
],
),
),
),
);
}
}
/// 链路探针条:固定在三块信息区最上方,只读不改任何行为。
///
/// 它回答的是“图传送过来的数据到底缺不缺”:
/// 进给率明显低于实时 = 数据没到齐(链路吐不上/丢包,病在图传段);
/// 进给完整但画面仍花 = 数据都收到了还花,不是“不够”而是“内容坏了”。
class RtspLinkProbeBar extends StatelessWidget {
const RtspLinkProbeBar({super.key, required this.probe});
final ValueListenable<RtspLinkSnapshot?> probe;
static Color _colorOf(LinkVerdict v) {
switch (v) {
case LinkVerdict.healthy:
return const Color(0xFF3DDC84);
case LinkVerdict.lightLoss:
return const Color(0xFFFFC53D);
case LinkVerdict.starved:
return const Color(0xFFFF6B4A);
case LinkVerdict.decoderStalled:
return const Color(0xFFB388FF);
case LinkVerdict.backlogGrowing:
return const Color(0xFFFFB74D);
case LinkVerdict.unknown:
return const Color(0xFF8A8A8A);
}
}
static IconData _iconOf(LinkVerdict v) {
switch (v) {
case LinkVerdict.healthy:
return Icons.signal_cellular_alt;
case LinkVerdict.lightLoss:
case LinkVerdict.starved:
return Icons.network_check;
case LinkVerdict.decoderStalled:
return Icons.memory;
case LinkVerdict.backlogGrowing:
return Icons.hourglass_top;
case LinkVerdict.unknown:
return Icons.sensors_off;
}
}
@override
Widget build(BuildContext context) {
return ValueListenableBuilder<RtspLinkSnapshot?>(
valueListenable: probe,
builder: (context, snap, _) {
final LinkVerdict v = snap?.verdict ?? LinkVerdict.unknown;
final Color accent = _colorOf(v);
return Material(
color: const Color(0xFF0A0A0A),
child: Padding(
padding: const EdgeInsets.fromLTRB(12, 6, 12, 7),
child: Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Icon(_iconOf(v), color: accent, size: 16),
const SizedBox(width: 8),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
snap == null
? '链路探针:采样中(进画面后 2~4 秒出结果)'
: '${v.label} · ${snap.detail}',
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(
color: accent,
fontSize: 12,
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 2),
Text(
snap == null
? '靠 position/buffered 的增量判断进给完整度,不需重新编译'
: v.advice,
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: const TextStyle(
color: Color(0xFF9AA0A6),
fontSize: 10.5,
height: 1.35,
),
),
],
),
),
if (snap != null && snap.estLossPct > 0)
Padding(
padding: const EdgeInsets.only(left: 6),
child: Text(
'丢帧≈${snap.estLossPct}%',
style: TextStyle(color: accent, fontSize: 11),
),
),
],
),
),
);
},
);
}
}
/// 弹出调参面板。关闭时 Cubit 已完成「保存 + 下发(+ 视按钮重拉流)」。
///
/// 必须把 Cubit 从调用方的上下文传进来:showModalBottomSheet 走的是
/// Navigator 里的 Overlay,它在页面 BlocProvider 的**上层**,弹窗内部
/// context 原本看不到 LocalCameraCubit,会抛 ProviderNotFoundException。
/// 这里用 BlocProvider.value 把它重新注入到弹窗子树(不负责 dispose)。
Future<void> showRtspTuningSheet(BuildContext context, LocalCameraCubit cubit) {
return showModalBottomSheet<void>(
context: context,
isScrollControlled: true,
backgroundColor: const Color(0xFF141414),
shape: const RoundedRectangleBorder(
borderRadius: BorderRadius.vertical(top: Radius.circular(16)),
),
builder: (context) => BlocProvider.value(
value: cubit,
child: const _RtspTuningSheet(),
),
);
}
class _RtspTuningSheet extends StatefulWidget {
const _RtspTuningSheet();
@override
State<_RtspTuningSheet> createState() => _RtspTuningSheetState();
}
class _RtspTuningSheetState extends State<_RtspTuningSheet> {
late RtspPlaybackTuning _draft;
String _nativeEcho = '';
@override
void initState() {
super.initState();
_draft = context.read<LocalCameraCubit>().tuning;
}
/// 读回原生侧真正生效的值:用来定性「改了到底有没有进插件」。
Future<void> _readBack() async {
final RtspPlaybackTuning? live =
await context.read<LocalCameraCubit>().readBackTuning();
if (!mounted) return;
setState(() {
_nativeEcho = live == null
? '读回失败:调参通道不存在(确认本地覆盖包已生效 / 是否 Android 端)'
: '原生当前生效:TCP=${live.forceRtpTcp} · ${live.minBufferMs}~'
'${live.maxBufferMs}ms · 起播${live.bufferForPlaybackMs}ms · '
'超时${live.rtspTimeoutMs == 0 ? '默认' : '${live.rtspTimeoutMs}ms'} · '
'字节${live.targetBufferBytes == 0 ? '默认' : '${live.targetBufferBytes ~/ 1024}KB'} · '
'${live.decoderMode.label}';
});
}
void _apply({required bool replay}) {
context.read<LocalCameraCubit>().updateTuning(_draft, reconnect: replay);
final ScaffoldMessengerState messenger = ScaffoldMessenger.of(context);
Navigator.of(context).pop();
messenger.showSnackBar(
SnackBar(
content: Text(
replay ? '已应用并重拉流:${_draft.summary}' : '已应用(下次拉流生效):${_draft.summary}',
),
duration: const Duration(seconds: 2),
backgroundColor: const Color(0xFF165DFF),
),
);
}
@override
Widget build(BuildContext context) {
final double maxHeight = MediaQuery.sizeOf(context).height * 0.9;
// 弹窗底色是写死的深色,但 APP 可能跑在浅色主题上:不锁主题的话,
// 没显式给色的控件(按钮文字 / chip / 输入框 / 水波纹)会继承浅色主题的默认色,
// 就出现「白底 + 白字」看不清。只钉本弹窗这一棵子树,不影响全局主题。
return Theme(
data: _darkThemeOf(context),
child: Padding(
padding: EdgeInsets.only(bottom: MediaQuery.viewInsetsOf(context).bottom),
child: ConstrainedBox(
constraints: BoxConstraints(maxHeight: maxHeight),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
const _SheetHandle(),
Padding(
padding: const EdgeInsets.fromLTRB(16, 0, 16, 8),
child: Row(
children: [
const Expanded(
child: Text(
'直播调参(花屏 / 延迟)',
style: TextStyle(
color: Colors.white,
fontSize: 16,
fontWeight: FontWeight.w600,
),
),
),
TextButton(
onPressed: () =>
setState(() => _draft = RtspPlaybackTuning.defaults),
style: TextButton.styleFrom(
foregroundColor: const Color(0xFF94BFFF),
),
child: const Text('恢复默认', style: TextStyle(fontSize: 12)),
),
],
),
),
Flexible(child: _buildForm()),
_buildActions(),
],
),
),
),
);
}
/// 把弹窗子树锁到深色主题:保留宿主主题的字号/字体族(随系统无障碍缩放),
/// 只换 brightness / colorScheme / textTheme 这三样决定前景色的东西。
ThemeData _darkThemeOf(BuildContext context) {
final ThemeData base = Theme.of(context);
return base.copyWith(
brightness: Brightness.dark,
colorScheme: ColorScheme.fromSeed(
seedColor: const Color(0xFF165DFF),
brightness: Brightness.dark,
),
textTheme: base.textTheme.apply(
bodyColor: const Color(0xFFE8E8E8),
displayColor: Colors.white,
),
);
}
Widget _buildForm() {
return ListView(
padding: const EdgeInsets.fromLTRB(16, 0, 16, 8),
children: [
const TuningSectionTitle(text: '预设档位(先点一个再微调)'),
TuningPresetRow(
draft: _draft,
onPick: (t) => setState(() => _draft = t),
),
const SizedBox(height: 16),
const TuningSectionTitle(text: '策略一:传输方式(治花屏)'),
TuningTransportPicker(
forceTcp: _draft.forceRtpTcp,
onChanged: (v) => setState(() => _draft = _draft.copyWith(forceRtpTcp: v)),
),
const TuningHint(
text: 'UDP 不重传,空口丢包直接解出马赛克;TCP 会重传把画面补全,'
'代价是弱链路下卡顿与延迟上升。',
),
const SizedBox(height: 16),
const TuningSectionTitle(text: '策略二:缓冲水位(治延迟)'),
TuningMsField(
label: 'minBufferMs(重新加载水位)',
value: _draft.minBufferMs,
hint: 'Media3 有 500ms 硬下限,填更小不生效',
onChanged: (v) => setState(() => _draft = _draft.copyWith(minBufferMs: v)),
),
TuningMsField(
label: 'maxBufferMs(停止加载水位 = 延迟上限)',
value: _draft.maxBufferMs,
hint: '平均积压约 (min+max)/2;越小越跟手,太小易卡',
onChanged: (v) => setState(() => _draft = _draft.copyWith(maxBufferMs: v)),
),
TuningMsField(
label: 'bufferForPlaybackMs(起播所需缓冲)',
value: _draft.bufferForPlaybackMs,
hint: '直播建议 0:首帧到达即渲染',
onChanged: (v) =>
setState(() => _draft = _draft.copyWith(bufferForPlaybackMs: v)),
),
TuningMsField(
label: 'bufferForPlaybackAfterRebufferMs(卡完恢复所需缓冲)',
value: _draft.bufferForPlaybackAfterRebufferMs,
hint: '直播建议 0:避免每次卡完再攒一段',
onChanged: (v) => setState(
() => _draft = _draft.copyWith(bufferForPlaybackAfterRebufferMs: v),
),
),
TuningMsField(
label: 'rtspTimeoutMs(RTSP 超时,0=用默认)',
value: _draft.rtspTimeoutMs,
hint: '过小会在弱链路上误判「流结束」而断流',
onChanged: (v) => setState(() => _draft = _draft.copyWith(rtspTimeoutMs: v)),
),
const SizedBox(height: 16),
_buildStreamAndDecoder(),
const SizedBox(height: 8),
_buildSummary(),
TextButton(
onPressed: _readBack,
child: const Text(
'读回原生实际生效值(验证参数有没有真的进插件)',
style: TextStyle(color: Color(0xFF94BFFF), fontSize: 12),
),
),
],
);
}
/// 策略三:取哪一路码流 + 由谁解码 + 字节上限。
/// 这一区才是「播放层」:前面两项只能决定“坏数据怎么补”,这里决定“拿到的是什么数据”。
Widget _buildStreamAndDecoder() {
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const TuningSectionTitle(text: '策略三:取流与解码(播放层)'),
TuningChoiceRow<RtspProfileSelect>(
options: RtspProfileSelect.values,
labelOf: (p) => p.label,
selected: _draft.profileSelect,
onChanged: (p) =>
setState(() => _draft = _draft.copyWith(profileSelect: p)),
),
TuningHint(text: '当前:${_draft.profileSelect.desc}。改这一档会重新走 ONVIF 取流(URL 会变)。'),
const SizedBox(height: 12),
TuningChoiceRow<RtspDecoderMode>(
options: RtspDecoderMode.values,
labelOf: (m) => m.label,
selected: _draft.decoderMode,
onChanged: (m) =>
setState(() => _draft = _draft.copyWith(decoderMode: m)),
),
const TuningHint(
text: 'Media3 默认硬解,且硬解初始化失败不会自动回退软解;怀疑解码侧问题时,切软解对比同一画面。',
),
const SizedBox(height: 12),
TuningMsField(
label: 'targetBufferBytes(字节上限,按 KB 填)',
value: _draft.targetBufferBytes ~/ 1024,
suffix: 'KB',
hint: '0 = 用默认(视频约 2MB)。高码率下 2MB 不到 1 秒就撞上限,会频繁 rebuffer,可试 8192',
onChanged: (kb) => setState(
() => _draft = _draft.copyWith(targetBufferBytes: kb < 0 ? 0 : kb * 1024),
),
),
],
);
}
Widget _buildSummary() {
return Container(
padding: const EdgeInsets.all(10),
decoration: BoxDecoration(
color: const Color(0xFF1E1E1E),
borderRadius: BorderRadius.circular(8),
border: Border.all(color: const Color(0xFF3D3D3D)),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'预计稳态积压 ≈ ${_draft.estimatedBacklogMs}ms',
style: const TextStyle(color: Color(0xFF94BFFF), fontSize: 12),
),
const SizedBox(height: 4),
const Text(
'注意:这只是播放器内部水位,不等于肉眼端到端延迟——后端的大头通常在摄像头 GOP / '
'图传编码,而不是这里。',
style: TextStyle(color: Color(0xFF9AA0A6), fontSize: 11, height: 1.4),
),
if (_nativeEcho.isNotEmpty) ...[
const SizedBox(height: 6),
Text(
_nativeEcho,
style: const TextStyle(color: Color(0xFFB8B8B8), fontSize: 11),
),
],
],
),
);
}
// 底部两个按钮必须用同一套尺寸:主题只给 elevatedButtonTheme 设了
// padding(vertical:16, horizontal:24) 与 radius 12,outlinedButton 没被覆盖,
// 两个按钮默认内间距/圆角完全不同 → 一高一矮,看着就别扭。这里显式对齐。
static const EdgeInsets _actionPadding = EdgeInsets.symmetric(
horizontal: 10,
vertical: 12,
);
static const Size _actionMinSize = Size(0, 44);
static const TextStyle _actionText = TextStyle(
fontSize: 13,
fontWeight: FontWeight.w600,
);
static const OutlinedBorder _actionShape = RoundedRectangleBorder(
borderRadius: BorderRadius.all(Radius.circular(10)),
);
Widget _buildActions() {
return SafeArea(
top: false,
child: Padding(
padding: const EdgeInsets.fromLTRB(16, 8, 16, 12),
child: Row(
children: [
Expanded(
child: OutlinedButton(
onPressed: () => _apply(replay: false),
style: OutlinedButton.styleFrom(
foregroundColor: const Color(0xFFCCCCCC),
backgroundColor: Colors.transparent,
side: const BorderSide(color: Color(0xFF4A4A4A)),
padding: _actionPadding,
minimumSize: _actionMinSize,
textStyle: _actionText,
shape: _actionShape,
),
child: const Text('仅保存 · 下次拉流生效'),
),
),
const SizedBox(width: 10),
Expanded(
child: ElevatedButton(
onPressed: () => _apply(replay: true),
style: ElevatedButton.styleFrom(
backgroundColor: const Color(0xFF165DFF),
foregroundColor: Colors.white,
elevation: 0,
padding: _actionPadding,
minimumSize: _actionMinSize,
textStyle: _actionText,
shape: _actionShape,
),
child: const Text('保存 · 立即重拉流'),
),
),
],
),
),
);
}
}
class _SheetHandle extends StatelessWidget {
const _SheetHandle();
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.only(top: 8, bottom: 4),
child: Container(
width: 36,
height: 4,
decoration: BoxDecoration(
color: Colors.white24,
borderRadius: BorderRadius.circular(2),
),
),
);
}
}