// Author: fruit.com.cn import 'package:flutter/foundation.dart'; import 'package:flutter/material.dart'; import 'package:video_player/video_player.dart'; const Duration _videoFadeDuration = Duration(milliseconds: 200); const double _errorHorizontal = 32; const int _errorMaxLines = 3; /// 黑色底层与视频层共用同一控制器,视频首帧就绪后再淡入。 class PlayerVideoSurface extends StatefulWidget { const PlayerVideoSurface({ super.key, required this.controller, required this.videoUrl, required this.theater, required this.onTap, }); final VideoPlayerController? controller; final String videoUrl; final bool theater; final VoidCallback onTap; @override State createState() => _PlayerVideoSurfaceState(); } class _PlayerVideoSurfaceState extends State { String? _lastDebugState; @override void didUpdateWidget(covariant PlayerVideoSurface oldWidget) { super.didUpdateWidget(oldWidget); if (oldWidget.controller != widget.controller) _lastDebugState = null; } @override Widget build(BuildContext context) { final controller = widget.controller; if (controller == null) return _frame(null); return ValueListenableBuilder( valueListenable: controller, builder: (context, value, _) => _frame(value), ); } Widget _frame(VideoPlayerValue? value) { final controller = widget.controller; final reveal = _shouldReveal(value); _logStateChange(value); return Stack( fit: StackFit.expand, children: [ const ColoredBox( key: Key('player-fallback-background'), color: Colors.black, ), AnimatedOpacity( key: const Key('player-video-opacity'), opacity: reveal ? 1 : 0, duration: _videoFadeDuration, curve: Curves.easeOut, child: reveal && controller != null ? _VideoLayer( controller: controller, value: value!, theater: widget.theater, onTap: widget.onTap, ) : const SizedBox.expand(), ), if (kDebugMode && value?.hasError == true) Center( child: Padding( padding: const EdgeInsets.symmetric(horizontal: _errorHorizontal), child: Text( value?.errorDescription ?? 'unknown video error', key: const Key('player-video-error'), maxLines: _errorMaxLines, overflow: TextOverflow.ellipsis, textAlign: TextAlign.center, style: const TextStyle(color: Colors.white70, fontSize: 13), ), ), ), ], ); } bool _shouldReveal(VideoPlayerValue? value) { return value != null && !value.hasError && value.isInitialized && value.size.width > 0 && (value.position > Duration.zero || value.isPlaying); } void _logStateChange(VideoPlayerValue? value) { if (!kDebugMode) return; final status = _debugStatus(value); final signature = '$status|${value?.isInitialized ?? false}|' '${value?.errorDescription ?? 'none'}'; if (signature == _lastDebugState) return; _lastDebugState = signature; final source = widget.controller?.dataSource ?? widget.videoUrl; debugPrint( '[video] init=${value?.isInitialized ?? false} ' 'err=${value?.errorDescription ?? 'none'} host=${_host(source)}', ); } String _debugStatus(VideoPlayerValue? value) { if (value == null) return 'loading'; if (value.hasError) { return 'error: ${value.errorDescription ?? 'unknown'}'; } if (value.isBuffering) return 'buffering'; if (value.isInitialized) return 'initialized'; return 'loading'; } String _host(String source) { final uri = Uri.tryParse(source); if (uri == null || uri.host.isEmpty) return 'unknown'; final port = uri.hasPort ? uri.port : uri.scheme == 'https' ? 443 : 80; return '${uri.host}:$port'; } } class _VideoLayer extends StatelessWidget { const _VideoLayer({ required this.controller, required this.value, required this.theater, required this.onTap, }); final VideoPlayerController controller; final VideoPlayerValue value; final bool theater; final VoidCallback onTap; @override Widget build(BuildContext context) { return GestureDetector( behavior: HitTestBehavior.opaque, onTap: onTap, child: FittedBox( fit: theater ? BoxFit.contain : BoxFit.cover, child: SizedBox( width: value.size.width, height: value.size.height, child: VideoPlayer(controller, key: ValueKey(controller)), ), ), ); } }