react-player

ReactPlayer 是一个 React 组件，通过单一接口嵌入来自多种来源的媒体播放。它接受媒体 URL 并自动加载播放所需的标记或外部 SDK。支持的来源包括：标准 HTML5 视频和音频文件路径、通过 hls.js 的 HLS 流、通过 dash.js 的 DASH 流、通过 mux-player 元素的 Mux 视频、通过 YouTube iFrame Player API 的 YouTube、通过 Vimeo Player API 的 Vimeo，以及通过 Wistia Player API 的 Wistia。 该组件暴露了丰富的 props 来控制播放，包括 src、playing、loop、controls、volume、muted、playbackRate、width、height、preload、playsInline、crossOrigin、disableRemotePlayback，以及在可用情况下的画中画支持。同时提供了常见播放器事件的回调用，包括 onReady、onStart、onPlay、onPlaying、onProgress、onTimeUpdate、onDurationChange、onPause、onWaiting、onSeeking、onSeeked、onRateChange、onEnded、onError，以及画中画进入/离开事件。config prop 允许针对 YouTube、Vimeo 和 HLS 设置源特定的配置。 ReactPlayer 包含静态辅助方法，如 canPlay 用于测试 URL 是否可播放，以及 addCustomPlayer 和 removeCustomPlayers 用于注册自定义播放器实现。通过 ref 访问的实例方法与 HTMLMediaElement 接口兼容。对于性能优化，当构建系统支持动态导入时，组件支持懒加载播放器块，从而只加载当前源所需的播放器，减小主打包体积。 其他功能包括：轻模式（先显示缩略图，仅在与用户交互后才加载完整播放器）、自定义缩略图支持、通过 width、height 和 aspect-ratio 样式实现响应式尺寸，以及与 Media Chrome 等自定义控件界面兼容。自版本 3 起，ReactPlayer 还支持类似原生 HTML 视频和音频元素的多个 source 和 track 子元素，支持备用格式和字幕轨道。README 注明，版本 3 是一次重大架构更新，与版本 2 不向后兼容，目前由 Mux 维护，仍保持开源。