You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用youtube_player_flutter包时视频无法加载的问题求助

解决方案:youtube_player_flutter无法加载视频的排查与修复
  • 检查iOS端App Transport Security配置
    iOS默认限制非HTTPS请求,即便YouTube使用HTTPS,仍需在Info.plist中添加对应配置以允许视频加载:

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSExceptionDomains</key>
        <dict>
            <key>youtube.com</key>
            <dict>
                <key>NSIncludesSubdomains</key>
                <true/>
                <key>NSAllowsArbitraryLoads</key>
                <true/>
            </dict>
            <key>googlevideo.com</key>
            <dict>
                <key>NSIncludesSubdomains</key>
                <true/>
                <key>NSAllowsArbitraryLoads</key>
                <true/>
            </dict>
        </dict>
    </dict>
    
  • 验证播放器初始化参数
    初始化YoutubePlayerController时必须启用JavaScript,这是视频加载的关键配置:

    final YoutubePlayerController _controller = YoutubePlayerController(
      initialVideoId: '你的视频ID',
      flags: const YoutubePlayerFlags(
        autoPlay: true,
        mute: false,
        enableJavaScript: true,
      ),
    );
    
  • 完善Android端网络配置
    除INTERNET权限外,Android 9及以上需在AndroidManifest.xml的<application>标签中添加:

    <application
        ...
        android:usesCleartextTraffic="true">
    

    用于兼容部分CDN的HTTP请求。

  • 升级插件或更换替代方案
    youtube_player_flutter ^8.1.2版本较旧,存在兼容性问题,建议升级至最新稳定版。若问题仍存在,可改用基于WebView的youtube_player_iframe,兼容性更强:

    YoutubePlayerIFrame(
      controller: YoutubePlayerController.fromVideoId(
        videoId: '你的视频ID',
        autoPlay: true,
      ),
    );
    
  • 排查网络与布局约束
    确认设备可正常访问YouTube网站;若使用弹窗加载播放器,需保证弹窗布局有足够宽高,避免因约束不足导致播放器无法渲染。

内容的提问来源于stack exchange,提问作者Abel Moremi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.12 07:54:52