安装
yarn add react-native-video
RN6.x 一般无需再配置了，具体可参考 官方文档，这里说下文档中没提到的，该 video 组件在 android 平台下有两个，分别是 MediaPlayer 和 Exoplayer，具体分别可自行搜索，简而言之，Exoplayer 更强大一点，MediaPlayer 兼容性更好，支持低版本 android，体积也相对小一点。默认使用的是 MediaPlayer ，切换到 Exoplayer 版本，RN6 以上使用的 autolink，官方文档的配置方法不是特别好，正确的方法是在项目根目录创建一个 react-native.config.js
module.exports = {
dependencies: {
'react-native-video': {
platforms: {
android: {
sourceDir: '../node_modules/react-native-video/android-exoplayer',
}
}
},
}
};
这样 autolink 就会切换到 Exoplayer 了，可 cd android && gradlew clean 清空缓存生效新配置。
属性
未写前缀的代表通用，写了的表示仅部分平台生效。
allowsExternalPlayback
【iOS】是否支持外部播放形式，如 AirPlay 或 HDMI.
默认：true
audioOnly
仅播放音频，需设置 poster 才生效
默认：false
automaticallyWaitsToMinimizeStalling
【iOS】指示播放器是否应自动延迟播放以最小化停顿。iOS 10.0和更高版有效
默认：true
bufferConfig
【Android ExoPlayer】缓冲设置
bufferConfig={{
minBufferMs: 15000,
maxBufferMs: 50000,
bufferForPlaybackMs: 2500,
bufferForPlaybackAfterRebufferMs: 5000
}}
controls
【Android ExoPlayer, iOS, react-native-dom】是否显示控制条
默认：false
- iOS 全屏模式下总是显示
- Android MediaPlayer 根本就没控制条，需自行制作
- Android ExoPlayer 有控制条，当可以自行制作
disableFocus
【Android Exoplayer】是否应覆盖Android设备中的背景音乐/音频。
默认：false
filter
【iOS】视频滤镜，支持滤镜
filterEnabled
【iOS】是否启用 filter 设置的滤镜
默认：false
fullscreen
【iOS, Android Exoplayer】是否全屏播放
默认：false
fullscreenOrientation
【iOS】全屏模式， all(default) | landscape | portrait
Android MediaPlayer 不支持全屏模式，需自行模拟
Android Exoplayer 全屏模式总是为 landscape
fullscreenAutorotate
【iOS】fullscreenOrientation 指定来全屏方向后，用户是否仍可通过旋转手机来改变视频的全屏方向
默认：true
headers
视频地址为 URL，配置请求 URL 的 HTTP headers
headers={{
Authorization: 'bearer some-token-value',
}}
hideShutterView
【Android ExoPlayer】是否在加载过程中显示占位视图（一个黑屏）
默认：false
id
【react-native-dom】DOM id，不是给 react-native 准备的，是网页版
ignoreSilentSwitch
【iOS】播放器的静音按钮设置
- inherit 由播放自行决定(默认)
- ignore 总是播放声音
- obey 总是不播放声音
maxBitRate
【iOS，Android ExoPlayer】限制加载速度，单位为 Bit
默认：0 （不限制）
minLoadRetryCount
加载失败时的重试次数
默认：3
muted
是否静音
默认：false
paused
是否暂停
默认：false
pictureInPicture
【iOS】是否以画中画模式播放
默认：false
playInBackground
【Android ExoPlayer, Android MediaPlayer, iOS】是否可以在后台继续播放，网页版不支持
iOS 需要设置 ignoreSilentSwitch="ignore" 并在 xcode 中 启用
默认：false
playWhenInactive
【iOS】视频不在最前（如用户下拉查看通知）时，是否继续播放
默认：false
poster
视频的封面图片URL
posterResizeMode
封面图片的缩放模式
contain（defulat） | center | cover | none | repeat | stretch
progressUpdateInterval
onProgress 事件通知的频率 （单位：毫秒）
默认：250
rate
播放速率
默认：1
repeat
是否循环播放
默认：false
reportBandwidth
【Android ExoPlayer】是否触发下载带宽 onBandwidthUpdate 回调事件，这个频率较高，如不需要，就不要开启
默认：false
resizeMode
当视频宽高比例 与 style 所设置的比例不同时，视频的缩放模式
none（defulat） | contain | cover | stretch
selectedAudioTrack
【Android ExoPlayer, iOS】设置当前音轨
selectedTextTrack
【Android ExoPlayer, iOS】设置当前字幕
selectedVideoTrack
【Android ExoPlayer, iOS】设置生效视频
source
视频地址
// 在线地址
source={{
uri: 'https://blabla.mp4'
}}
// 本地地址
source={{
uri: 'ipod-library:///path/to/music.mp3'
}}
source={{
uri: 'content:///path/to/music.mp3'
}}
// 文件
source={require('./file/xx.mp4')}
stereoPan
【Android MediaPlayer】左右声道平衡值，-1.0 ~ 1.0 之间，默认为：0
textTracks
【Android ExoPlayer, iOS】多字幕设置，更多
useTextureView
【Android ExoPlayer】字幕是否使用 android 的 TextureView 原生组件，反之则使用 SurfaceView
默认：true
volume
音量， 0~1， 默认为：1
事件
onAudioBecomingNoisy
【Android ExoPlayer, iOS】音频输出发生变化时的回调，比如从耳机切换到扬声器，可监听该变化暂停视频
onBandwidthUpdate
【Android ExoPlayer】下载带宽发生变化时
onEnd
视频播放完毕
onExternalPlaybackChange
【iOS】外部播放模式发生变化， ？ AirPlay 或 HDMI.
onFullscreenPlayerWillPresent
【Android ExoPlayer, Android MediaPlayer, iOS】即将进入全屏模式
onFullscreenPlayerDidPresent
【Android ExoPlayer, Android MediaPlayer, iOS】进入全屏模式后
onFullscreenPlayerWillDismiss
【Android ExoPlayer, Android MediaPlayer, iOS】即将退出全屏模式
onFullscreenPlayerDidDismiss
【Android ExoPlayer, Android MediaPlayer, iOS】退出全屏模式后
onLoad
当视频加载成功，准备好播放了
onLoadStart
开始加载视频时
onReadyForDisplay
视频已显示第一帧，封面 poster 被移除
onPictureInPictureStatusChanged
【iOS】当进入或退出画中画模式时
onPlaybackRateChange
播放速度发生变化，包括 暂停/开始
onProgress
播放进度通知，通知频率由 progressUpdateInterval 设置决定
onSeek
重新定位播放位置时
onRestoreUserInterfaceForPictureInPictureStop
【iOS】画中画播放完毕，恢复到原界面后
onTimedMetadata
视频元数据获取成功后
以下还有几个官方页面没有写的
onPlaybackStalled
onPlaybackResume
看名字是 外部播放 停止/重新开始 的回调
onAudioFocusChanged
后台播放状态发生变化时
网友评论