平台差异说明

    属性说明

    属性名类型默认值说明平台差异说明
    srcString要播放视频的资源地址
    autoplayBooleanfalse是否自动播放
    loopBooleanfalse是否循环播放头条小程序不支持
    mutedBooleanfalse是否静音播放头条小程序不支持
    initial-timeNumber指定视频初始播放位置,单位为秒(s)。头条小程序不支持
    durationNumber指定视频时长,单位为秒(s)。头条小程序不支持
    controlsBooleantrue是否显示默认播放控件(播放/暂停按钮、播放进度、时间)头条小程序不支持
    danmu-listObject Array弹幕列表头条小程序不支持
    danmu-btnBooleanfalse是否显示弹幕按钮,只在初始化时有效,不能动态变更头条小程序不支持
    enable-danmuBooleanfalse是否展示弹幕,只在初始化时有效,不能动态变更头条小程序不支持
    page-gestureBooleanfalse在非全屏模式下,是否开启亮度与音量调节手势微信小程序、H5
    directionNumber设置全屏时视频的方向,不指定则根据宽高比自动判断。有效值为 0(正常竖向), 90(屏幕逆时针90度), -90(屏幕顺时针90度)头条小程序不支持
    show-progressBooleantrue若不设置,宽度大于240时才会显示头条小程序不支持
    show-fullscreen-btnBooleantrue是否显示全屏按钮头条小程序不支持
    show-play-btnBooleantrue是否显示视频底部控制栏的播放按钮头条小程序不支持
    show-center-play-btnBooleantrue是否显示视频中间的播放按钮头条小程序不支持
    enable-progress-gestureBooleantrue是否开启控制进度的手势头条小程序不支持
    objectFitStringcontain当视频大小与 video 容器大小不一致时,视频的表现形式。contain:包含,fill:填充,cover:覆盖微信小程序、H5
    posterString视频封面的图片网络资源地址,如果 controls 属性值为 false 则设置 poster 无效头条小程序不支持
    @playEventHandle当开始/继续播放时触发play事件头条小程序不支持
    @pauseEventHandle当暂停播放时触发 pause 事件头条小程序不支持
    @endedEventHandle当播放到末尾时触发 ended 事件头条小程序不支持
    @timeupdateEventHandle播放进度变化时触发,event.detail = {currentTime, duration} 。触发频率 250ms 一次头条小程序不支持
    @fullscreenchangeEventHandle当视频进入和退出全屏时触发,event.detail = {fullScreen, direction},direction取为 vertical 或 horizontal头条小程序不支持
    @waitingEventHandle视频出现缓冲时触发头条小程序不支持
    @errorEventHandle视频播放出错时触发头条小程序不支持

    默认宽度 300px、高度 225px,可通过 css 设置宽高。

    示例

    1. export default {
    2. data() {
    3. return {
    4. src: '',
    5. danmuList: [{
    6. text: '第 1s 出现的弹幕',
    7. color: '#ff0000',
    8. time: 1
    9. },
    10. {
    11. text: '第 3s 出现的弹幕',
    12. color: '#ff00ff',
    13. time: 3
    14. }
    15. ],
    16. danmuValue: ''
    17. },
    18. onReady: function(res) {
    19. // #ifndef MP-ALIPAY
    20. // #endif
    21. },
    22. methods: {
    23. sendDanmu: function() {
    24. this.videoContext.sendDanmu({
    25. text: this.danmuValue,
    26. color: this.getRandomColor()
    27. });
    28. this.danmuValue = '';
    29. },
    30. videoErrorCallback: function(e) {
    31. uni.showModal({
    32. showCancel: false
    33. })
    34. },
    35. getRandomColor: function() {
    36. const rgb = []
    37. for (let i = 0; i < 3; ++i) {
    38. let color = Math.floor(Math.random() * 256).toString(16)
    39. rgb.push(color)
    40. }
    41. return '#' + rgb.join('')
    42. }
    43. }
    44. }

    相关api:

    注意

    • 视频播放格式说明:

      • H5平台:支持支持的视频格式视浏览器而定,一般通用的都支持:mp4、webm 和 ogg。(<video/> 组件编译到 H5 时会替换为标准 html 的 video 标签)。H5端也可以自行在条件编译里使用video.js等三方库,这些库可以自动判断环境兼容以决定使用标准video或flash来播放。
      • 小程序平台:各小程序平台支持程度不同,详见各家文档:微信小程序视频组件文档、支付宝不支持video组件、、头条小程序视频组件文档
      • App平台: 支持本地视频(mp4/flv)、网络视频地址(mp4/flv/m3u8)及流媒体(rtmp/hls/rtsp)。
    • video全屏后,如何自行绘制界面?比如加个标题、加个分享按钮

      • 微信基础库 2.4.0 以上可通过cover-view来绘制界面覆盖元素
      • app端 2.1.5 以上nvue页面的video也可以通过cover-view来绘制界面覆盖元素
      • H5端可通过通用h5做法实现
      • 其他端无法全屏后自行绘制内容
      • 微信基础库 2.4.0 和app端nvue 2.1.5 以上,可通过在垂直的swiper中内嵌video来实现。原生导航栏设置为custom,视频长宽设为手机屏幕大小,通过cover-view覆盖视频内容。
    • <video/> 组件在非H5端是原生组件,层级高于普通前端组件,覆盖其需要使用组件或plus.nativeObj.view、subNVue。微信基础库 2.4.0 起已支持 video 组件的同层渲染,也就是video在非全屏时,可以被前端元素通过调节zindex来遮挡,但video全屏时,仍需要cover-view覆盖。

    • 除微信基础库 2.4.0 和app端nvue页面 2.1.5 以上,其他情况下非H5的video不能放入scroll-view和swiper。注意参考 原生组件使用限制

    • App平台:使用 组件,打包 App 时必须勾选 manifest.json->App 模块权限配置->VideoPlayer 模块。

    • H5平台: 在部分浏览器中会强制调用原生播放器播放(如:微信内置浏览器、UC浏览器等),在 x5 内核的浏览器中支持配置。