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

@@ -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,
];
}