登录

youtube_player_flutter

sarbagyasthaBSD-3-Clause更新放缓

Flutter 插件，基于官方 iFrame Player API 在 App 内嵌播放或流式播放 YouTube 视频，省去跳转外部应用的麻烦。

A Flutter plugin for inline playback or streaming of YouTube videos using the official iFrame Player API.

youtube_player_iframe-v3.0.3发布于 2022-08-14 15:15 UTC811star1,003fork同步于 2026-11-07 07:33 UTC
Flutter插件YouTube播放内嵌播放视频播放器iFrame API
对比 GitHub 官网androidandroid-youtube-playerflutterflutter-examplesflutter-plugin

怎么上手

由 README 提炼，执行前请确认
原文 
flutter pub add youtube_player_flutter
硬件要求按 README 说明

README 未说明

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

基于官方 iFrame API 的 Flutter YouTube 播放插件，可直接嵌入视频或直播

Flutter 插件，基于官方 iFrame Player API 在 App 内嵌播放或流式播放 YouTube 视频，省去跳转外部应用的麻烦。

核心能力

  • 内置播放控件、进度条、拖动跳转和捏合全屏
  • 提供直播流专用 UI
  • youtube_player_iframe 暴露完整 iFrame API 供自建 UI
  • 支持播放列表、元数据和缩略图懒加载组件
  • 覆盖 Android、iOS、macOS、Web 四个平台

容易踩的坑

播放依赖 YouTube iFrame Player API，需遵守 YouTube API 服务条款；youtube_player_iframe_web 由 youtube_player_iframe 自动引入，一般无需手动添加；README 未说明网络与地区限制等运行前提

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本youtube_player_iframe-v3.0.3
全部 release
  1. youtube_player_iframe-v3.0.3youtube_player_iframe v3.0.3最新正式版2022-08-14 · 2022-08-14 15:15 UTC
    • Fixed issues related to Fullscreen.
    • Added onInit & onFullscreenChange callbacks to YoutubePlayerController.
    • Added Migrating to v3 section in the docs.
    • Listed Swipe up/down to enter/exit fullscreen mode as a feature in the docs.
    • Deprecated autoPlay param in YoutubePlayerParams, as it's no longer used.
    • Removed hasPlayed, position & buffered from YoutubePlayerValue, as these values can be accessed through YoutubePlayerController.
  2. v1.0.1-iframeyoutube_player_iframe v1.0.12020-07-17 · 2020-07-17 03:16 UTC
    查看更新说明
    • Fixed Disabled navigation inside the player. This solves the issue where tapping on actions would navigate to different web pages.
    • Removed foreceHD param, in favor of desktopMode. The desktopMode also supports changing quality in fullscreen mode.
    • Added two new methods, hideTopMenu() and hidePauseOverlay(). Visit ReadMe for more detail.
  3. v1.0.0+4youtube_player_iframe v1.0.0+42020-07-12 · 2020-07-12 07:31 UTC
    查看更新说明

    Initial release of youtube_player_iframe

  4. v7.0.0+2Version 7.0.0+22020-06-01 · 2020-06-01 04:40 UTC
    查看更新说明
    • Added onEnterFullScreen & onExitFullScreen callback to YoutubePlayerBuilder.
    • Player switches back to normal mode on system back, if on fullscreen.
    • Added thumbnail parameter to YoutubePlayer, removed thumbnailUrl. Now any widget can be used as thumbnail.
    • Fixed issues with progress colors.
  5. v7.0.0+1Version 7.0.02020-05-31 · 2020-05-31 13:26 UTC
    查看更新说明
    • (Fixed) random crashes
    • (Fixed) issues with orientation
    • (Improvements) Added automatic fullscreen toggle wrt to orientation change

    BREAKING CHANGE

    • Requires iOS: --ios-language swift, Xcode version >= 11
    • Requires Android: minSdkVersion 17
    • Removed exported WebView widget

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    Packages

    PackageVersionDemoDescriptionPlatforms
    youtube_player_flutterpubdemoBatteries-included YouTube player with built-in controls, gestures, and live stream UIAndroid, iOS, macOS, Web
    youtube_player_iframepubdemoFull-control Flutter port of the YouTube iFrame API. Build your own UI.Android, iOS, macOS, Web
    youtube_player_iframe_webpubWeb platform implementation for youtube_player_iframe (added automatically)Web

    Which package should I use?

    youtube_player_flutter: just want a player that works

    The quickest path to YouTube playback in your app. It ships with ready-made controls, a progress bar, drag-to-seek, pinch-to-fullscreen, and a live stream UI, all out of the box. Drop it in, point it at a video ID, and you're done.

    flutter pub add youtube_player_flutter

    Best for: apps that want a polished, functional player with minimal setup.

    youtube_player_iframe: want full control over the player

    A lower-level package that gives you the complete YouTube iFrame API. You own the UI; the package handles playback state, playlists, metadata, fullscreen transitions, thumbnails, and more. Includes a lazy-loading thumbnail widget perfect for video lists.

    flutter pub add youtube_player_iframe

    Best for: apps with a custom player design, complex playback logic, or playlist management needs.

    youtube_player_iframe_web: you probably don't need to add this

    This is the web platform implementation consumed automatically by youtube_player_iframe. You only need to add it directly if you're building a platform plugin or working inside this monorepo.

    License

    BSD-3-Clause. See LICENSE for details.

    This project uses the YouTube IFrame Player API. By using these packages, you agree to the YouTube API Services Terms of Service.

    API method documentation is adapted from the YouTube IFrame Player API Reference, © Google LLC, licensed under CC BY 4.0. See NOTICE for details.

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    iina
    iina·Swift

    macOS 上基于 mpv 的现代视频播放器，用 Swift 编写，界面原生美观，支持几乎所有视频格式，适合替代 QuickTime 日常看片。

    视频播放器+4视频播放器进阶
    47086+473.0kv1.5.12026-11-10 03:26 UTC
    video.js
    videojs·TypeScript

    开源媒体播放器框架，支持 HTML 和 React，统一处理 HLS、DASH 等流媒体格式，帮你在网页里快速搭出稳定可定制的视频播放器。

    视频播放器+4视频播放器进阶
    40158+487.5k[email protected]2026-11-11 00:55 UTC
    mpv
    mpv-player·C

    轻量级命令行视频播放器，基于 FFmpeg 解码，支持硬件加速、字幕渲染和脚本扩展，适合在终端或嵌入其他应用中播放音视频。

    命令行播放器+4视频播放器进阶
    38056+1143.6kv0.42.02026-11-10 16:51 UTC
    peach
    peach-mitao·Python

    本地优先的视频元数据刮削与媒体库管理工具，自动整理影片信息并支持自托管播放，适合搭建个人影音库。

    媒体库管理+4视频播放器进阶
    14860+1641.7kv0.57.02026-11-10 05:46 UTC