react-native-video使用攻略


源码在此 仅供参考


一、简介

react-native-video是一个可以播放视频的组件,它的用法简单,功能完备,是React native项目中很好用的一个Video播放的组件。

它的功能主要有以下10个:

  1. 控制播放速率
  2. 控制音量大小
  3. 支持静音功能
  4. 支持播放和暂停
  5. 支持后台音频播放
  6. 支持定制样式,比如设置宽高
  7. 丰富的事件调用,如onLoad,onEnd,onProgress,onBuffer等等,可以通过对应的事件进行UI上的定制处理,如onBuffer时我们可以显示一个进度条提示用户视频正在缓冲。
  8. 支持全屏播放,使用presentFullscreenPlayer方法。这个方法在iOS上可行,在android上不起作用。参看issue#534,#726也是同样的问题。
  9. 支持跳转进度,使用seek方法跳转到指定的地方进行播放
  10. 可以加载远程视频地址进行播放,也可以加载RN本地存放的视频。

二、使用

使用步骤如下:

  1. 导入依赖库

在项目Terminal中输入命令行:

npm install react-native-video --save

或者用yarn:

yarn add react-native-video

IOS环境下:

直接运行下面命令来链接react-native-video库。

react-native link 

如果你想允许其他应用在你的视频组件上播放音乐,请打开AppDelegate.m文件并且添加:

AppDelegate.m

#import <AVFoundation/AVFoundation.h>  // import

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  ...
  [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryAmbient error:nil];  // allow
  ...
}

Android环境下:

直接运行下面命令来链接react-native-video库。

react-native link 

如果上面的方式失败了,那么你可以尝试手动添加配置,这步比较麻烦。

android/settings.gradle
较新的ExoPlayer库适用于大多数人。(推荐使用这个库)

include ':react-native-video'
project(':react-native-video').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-video/android-exoplayer')

如果您需要使用旧的基于Android MediaPlayer的播放器,请改用以下内容:

include ':react-native-video'
project(':react-native-video').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-video/android')

android/app/build.gradle

dependencies {
   ...
   compile project(':react-native-video')
}

MainApplication.java
在java文件顶部位置记得添加import:

import com.brentvatne.react.ReactVideoPackage;

将ReactVideoPackage类添加到导出的包列表中:

@Override
protected List<ReactPackage> getPackages() {
    return Arrays.asList(
            new MainReactPackage(),
            new ReactVideoPackage()
    );
}

三、案例分析

screen

上面这张动图可以看出,我们可以通过自定义的样式和功能来使用react-native-video。
其中实现的功能有:调节播放速率,调节视频音量,以及调节视频播放器的样式,这三个功能分别对应下图中的三个红色边框离的选项。


screenshot

此外,我们还给这个视频播放器组件添加了很多事件属性,例如播放进度条的监听(onProgress),播放完回到视频起点的设置(onEnd)等,下面我们跟随代码一步步分析这个组件的一些属性和用法。

  • 首先我们声明一个组件来使用这个Video,在此之前先将它导进来
import React, {
    Component
} from 'react';

import {
    StyleSheet,
    Text,
    TouchableOpacity,
    View,
} from 'react-native';

import Video from 'react-native-video';

export default class VideoPlayer extends Component {
      ···  ···
}
  • 接着初始化一些state,之后会用到。比如rate表示视频播放速率初始化为1,即正常速率。
 state = {
        rate: 1,
        volume: 1,
        muted: false,
        resizeMode: 'contain',
        duration: 0.0,
        currentTime: 0.0,
        paused: true,
    };
  • 渲染Video组件
<Video
    ref={(ref: Video) => { //方法对引用Video元素的ref引用进行操作
        this.video = ref
    }}
    /* source={{ uri: 'https://gslb.miaopai.com/stream/HNkFfNMuhjRzDd-q6j9qycf54OaKqInVMu0YhQ__.mp4?ssig=bbabfd7684cae53660dc2d4c2103984e&time_stamp=1533631567740&cookie_id=&vend=1&os=3&partner=1&platform=2&cookie_id=&refer=miaopai&scid=HNkFfNMuhjRzDd-q6j9qycf54OaKqInVMu0YhQ__', type: 'mpd' }} */
    source={require('../../background.mp4')}//设置视频源  
    style={styles.fullScreen}//组件样式
    rate={this.state.rate}//播放速率
    paused={this.state.paused}//暂停
    volume={this.state.volume}//调节音量
    muted={this.state.muted}//控制音频是否静音
    resizeMode={this.state.resizeMode}//缩放模式
    onLoad={this.onLoad}//加载媒体并准备播放时调用的回调函数。
    onProgress={this.onProgress}//视频播放过程中每个间隔进度单位调用的回调函数
    onEnd={this.onEnd}//视频播放结束时的回调函数
    onAudioBecomingNoisy={this.onAudioBecomingNoisy}//音频变得嘈杂时的回调 - 应暂停视频
    onAudioFocusChanged={this.onAudioFocusChanged}//音频焦点丢失时的回调 - 如果焦点丢失则暂停
    repeat={false}//确定在到达结尾时是否重复播放视频。
/>

ps:这里要注意!
react-native-video通过source属性设置视频,播放远程视频时使用uri来设置视频地址,如下:

source={{uri: "http://www.xxx.com/xxx/xxx/xxx.mp4"}}

复制代码播放本地视频时,使用方式如下:

source={require('../assets/video/turntable.mp4')}

复制代码需要注意的是,source属性不能为空,uri或本地资源是必须要设置的,否则会导致app闪退。uri不能设置为空字符串,必须是一个具体的地址。

  • 关于进度条
    在render中声明两个量:flexCompleted和flexRemaining,前者表示已经播放完成的进度,后者表示剩余的进度,,这两个量分别作为包裹在View中组件的flex属性的值:
render() {
        const flexCompleted = this.getCurrentTimePercentage() * 100;
        const flexRemaining = (1 - this.getCurrentTimePercentage()) * 100;
        ...  ...
        <View style={styles.progress}>
            <View style={[styles.innerProgressCompleted, {flex: flexCompleted}]}/>
            <View style={[styles.innerProgressRemaining, {flex: flexRemaining}]}/>
        </View>
}
getCurrentTimePercentage() {
        if (this.state.currentTime > 0) {
            return parseFloat(this.state.currentTime) / parseFloat(this.state.duration);
        }
        return 0;
};
  • 点击事件的处理
    通过点击组件中的选项,我们可以调节视频的音量、播放速率、缩放的样式等。
    先把布局定义下:
<View style={styles.controls}>
    <View style={styles.generalControls}>
        <View style={styles.rateControl}>
            {this.renderRateControl(0.25)}
            {this.renderRateControl(0.5)}
            {this.renderRateControl(1.0)}
            {this.renderRateControl(1.5)}
            {this.renderRateControl(2.0)}
        </View>

        <View style={styles.volumeControl}>
            {this.renderVolumeControl(0.5)}
            {this.renderVolumeControl(1)}
            {this.renderVolumeControl(1.5)}
        </View>

        <View style={styles.resizeModeControl}>
            {this.renderResizeModeControl('cover')}
            {this.renderResizeModeControl('contain')}
            {this.renderResizeModeControl('stretch')}
        </View>
    </View>

需要重写三个方法来填充事件的内容:
renderRateControl(rate):设置播放速率,改方法接收一个值表示速率的大小,1.0表示正常速率播放。注意:对于Android的播放器,rate属性仅在Android6.0或者更高版本中生效。

 renderRateControl(rate) {
        const isSelected = (this.state.rate === rate);

        return (
            <TouchableOpacity onPress={() => {
                this.setState({rate})
            }}>
                <Text style={[styles.controlOption, {fontWeight: isSelected ? 'bold' : 'normal'}]}>
                    {rate}x
                </Text>
            </TouchableOpacity>
        );
    }

renderVolumeControl(volume):该方法接收一个值作为音量大小,1.0为正常音量

renderVolumeControl(volume) {
        const isSelected = (this.state.volume === volume);

        return (
            <TouchableOpacity onPress={() => {
                this.setState({volume})
            }}>
                <Text style={[styles.controlOption, {fontWeight: isSelected ? 'bold' : 'normal'}]}>
                    {volume * 100}%
                </Text>
            </TouchableOpacity>
        )
    }

renderResizeModeControl(resizeMode):该方法接收的参数resizeMode有四种模式:
"none"(默认) - 不匹配大小
"contain" - 均匀缩放视频(保持视频的宽高比),使视频的尺寸(宽度和高度)等于或小于视图的相应尺寸(减去填充)
"cover" - 均匀缩放视频(保持视频的宽高比),使图像的尺寸(宽度和高度)等于或大于视图的相应尺寸(减去填充)
"stretch" - 独立缩放宽度和高度,这可能会改变src的宽高比

renderResizeModeControl(resizeMode) {
        const isSelected = (this.state.resizeMode === resizeMode);

        return (
            <TouchableOpacity onPress={() => {
                this.setState({resizeMode})
            }}>
                <Text style={[styles.controlOption, {fontWeight: isSelected ? 'bold' : 'normal'}]}>
                    {resizeMode}
                </Text>
            </TouchableOpacity>
        )
    }
  • 最后,重新定义事件属性onLoad、onEnd、onProgress等
    video: Video;
    onLoad = (data) => {
        this.setState({duration: data.duration});
    };

    onProgress = (data) => {
        this.setState({currentTime: data.currentTime});
    };

    onEnd = () => {
        this.setState({paused: true});
        this.video.seek(0)
    };

    onAudioBecomingNoisy = () => {
        this.setState({paused: true})
    };

    onAudioFocusChanged = (event: { hasAudioFocus: boolean }) => {
        this.setState({paused: !event.hasAudioFocus})
    };

注意一下onEnd的回调中用到了seek()方法,这个方法接收的参数的单位是秒,意味着seek(定位)到由秒表示的指定位置,seek(0)也就是定位到视频开始播放的位置。

附录

这样,一个可灵活使用的视频播放器Demo就已经做好了,当然我们也可以自己定制喜欢的样式和布局,例如下面这种:

screenshot2

实现上图的源码在这

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,053评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,527评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,779评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,685评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,699评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,609评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,989评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,654评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,890评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,394评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,976评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2 342

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,418评论 25 707
  • 清洁的天 宛如神仙的衣袖拂拭 眼前的城 弥漫昔日的流彩异光 一袭微风吹乱端详的云 在我心中惊起滔天巨浪 走不进的世...
    花苞谷牌干脆面阅读 281评论 0 1
  • 晚上6点才下班,到家要清理小黑的屎尿,先用肥皂水拖一遍地去味道,再用清水拖一遍地去肥皂水怕滑倒,接着弄晚饭...
    田心妙阅读 194评论 0 1