Flutter中video_player插件无法播放网络视频如何解决

你当前代码存在5个核心问题，逐一对应修复即可：

• HTTP明文请求被系统拦截：你使用的url2、url3均为http://开头的非加密链接，Android 9.0+、iOS 9.0+默认禁止应用发起明文HTTP请求，未配置权限的情况下会直接阻断视频加载。
• 传入地址非视频直链：你定义的url、url2是TikTok的视频分享网页地址，不是可直接播放的mp4、m3u8等流媒体文件地址，video_player仅支持解析直接指向视频资源的链接，传入网页地址无法识别播放。
• 初始化逻辑缺失异常捕获：当前initialize()方法只写了初始化成功的回调，没有捕获加载失败的错误，出现网络异常、地址无效等问题时无错误日志，无法快速定位问题。
• 播放器渲染未判断初始化状态：如果自定义的VideoPlayerCustom组件没有等待控制器初始化完成就渲染视频画面，会触发尺寸异常、空指针等问题，导致播放失败。
• 静音逻辑未生效：你定义了isMute = true变量，但全程没有调用控制器的setVolume(0)方法，静音配置根本没有生效。

修复步骤 #

1. 配置平台HTTP明文访问权限 #

Android端

打开android/app/src/main/AndroidManifest.xml，在<application>标签上添加明文流量权限属性：

<application
    android:label="你的应用名称"
    android:usesCleartextTraffic="true"
    android:icon="@mipmap/ic_launcher">
    <!-- 保留原有其他配置 -->
</application>

同时确认文件中存在网络权限配置（一般插件会自动注入，没有就手动加在<manifest>标签根下）：

<uses-permission android:name="android.permission.INTERNET" />

iOS端

打开ios/Runner/Info.plist，添加ATS安全配置放开HTTP访问限制：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

2. 使用有效视频直链 #

测试阶段可以先使用url3验证功能，正式业务中如果需要播放TikTok等平台的视频，需要先通过平台开放接口、页面解析等方式获取到实际的视频文件直链，不能直接传入分享页地址。

3. 补全控制器逻辑 #

修改初始化与构建逻辑，增加异常捕获、状态判断，补全静音配置：

@override
void initState() {
  super.initState();
  videoController = VideoPlayerController.network(url3)
    ..addListener(() => setState(() {}))
    ..setLooping(true)
    ..setVolume(0) // 实现你需要的静音效果
    ..initialize().then((value) {
      videoController.play();
    }).catchError((error) {
      debugPrint('视频加载失败：$error');
    });
}

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: Center(
      // 等待初始化完成再渲染播放器，初始化中显示加载态
      child: videoController.value.isInitialized
          ? AspectRatio(
              aspectRatio: videoController.value.aspectRatio,
              // 可以先使用官方VideoPlayer组件验证功能，正常后再替换为你的自定义VideoPlayerCustom
              child: VideoPlayer(videoController),
            )
          : const CircularProgressIndicator(),
    ),
  );
}

4. 校验点 #

• 执行flutter pub get确认依赖安装完整，使用的video_player版本与当前Flutter SDK版本兼容
• 测试时确认设备/模拟器网络正常，无代理、防火墙拦截视频请求
• 如果使用自定义VideoPlayerCustom组件，先替换为官方自带的VideoPlayer组件验证播放功能正常，再排查自定义组件的逻辑问题

内容的提问来源于stack exchange，提问作者Công Hiến