👨‍🎓作者简介:一位喜欢写作,计科专业大三菜鸟
🏡个人主页:starry陆离
🕒首发日期:2022年9月15日星期四
如果文章有帮到你的话记得点赞👍+收藏💗支持一下哦

『从零开始学小程序』媒体组件video组件

  • 1.简介
  • 2.简单案例
  • 3.自动循环播放
  • 4.容器适配
  • 5.小窗模式
  • 6.视频弹幕案例
    • 6.1wxml设计
    • 6.2VideoContext类方法
    • 6.2完整代码
  • 7.小试牛刀

1.简介

多媒体包括音频、视频和相机等,为了更好地在小程序中使用这些多媒体功能,微信官方也为开发者提供了一系列多媒体组件和API接口。多媒体组件如下所示:

video,视频组件。组件的属性可以实现视频的播放暂停,发送弹幕,获取视频所处位置等。

2.简单案例

属性 类型 默认值 必填 说明
src string 要播放视频的资源地址,支持网络路径、本地临时路径、云文件ID

<video src="cloud://cloud1-0gq03z948cf60a2f.636c-cloud1-0gq03z948cf60a2f-1313616796/a2.mp4"></video>

『从零开始学小程序』媒体组件video组件

3.自动循环播放

官方组件还提供了是否自动播放和是否循环播放的属性。通过设置autoplayloop的值来实现相应功能。

属性 类型 默认值 必填 说明
autoplay boolean false 是否自动播放
loop boolean false 是否循环播放
<video src="cloud://cloud1-0gq03z948cf60a2f.636c-cloud1-0gq03z948cf60a2f-1313616796/a2.mp4"
autoplay="true" loop="true"></video>

『从零开始学小程序』媒体组件video组件

4.容器适配

可以看到我们现在的视频是有黑边的这很影响视觉体验,那么如何去掉黑边呢,可以通过object-fit属性来调整视频和video容器的大小关系。

属性 类型 默认值 必填 说明
object-fit string contain 当视频大小与 video 容器大小不一致时,视频的表现形式

object-fit属性 有如下取值:

合法值 说明
contain 包含
fill 填充
cover 覆盖

通过使用三种取值我发现取值为fill时,视频会去通过拉伸去适配容器;而取值为cover时会等比缩放视频,然后裁剪多余的部分去适配容器

『从零开始学小程序』媒体组件video组件

『从零开始学小程序』媒体组件video组件

5.小窗模式

属性 类型 默认值 必填 说明
picture-in-picture-mode string/Array 设置小窗模式: push, pop,空字符串或通过数组形式设置多种模式(如: [“push”, “pop”])

video 小窗支持以下三种触发模式(在组件上设置 picture-in-picture-mode 属性):

  1. push 模式,即从当前页跳转至下一页时出现小窗(页面栈push)
  2. pop 模式,即离开当前页面时触发(页面栈pop)
  3. 以上两种路由行为均触发小窗

此外,小窗还支持以下特性:

当播放器进入小窗模式后,播放器所在页面处于 hide 状态(触发 onHide 生命周期),该页面不会被销毁。当小窗被关闭时,播放器所在页面会被 unload (触发 onUnload 生命周期)。

注意:在虚拟机上调试是无法看到小窗效果的,在手机真机上是可以的。

<!--pages/video/video.wxml-->
<video src="cloud://cloud1-0gq03z948cf60a2f.636c-cloud1-0gq03z948cf60a2f-1313616796/a2.mp4"
autoplay="true" loop="true" object-fit="cover" picture-in-picture-mode="push"></video>
<view class="container">
  <button type="primary" size="mini" bindtap="gotoPrevideo">跳转到prevideo界面</button>
  <button type="primary" size="mini" style="margin: 10px;" bindtap="gotoNextvideo">跳转到nextvideo界面</button>
</view>

『从零开始学小程序』媒体组件video组件

6.视频弹幕案例

本案例针对video组件的实践应用场景编写了一个简单的发送视频弹幕的页面,其中使用到了播放视频相关的API函数:

可以看到我们弹幕中实现了静态的设置第几秒出现弹幕(绿色的弹幕)和按钮点击获取文本框里的文字然后输出到弹幕。

6.1wxml设计

具体怎么实现的呢,我来一一分说:首先在wxml中我们还是定义了一个video容器,并为之取了一个id(id="myVideo"),其次我们还用到了如下的属性:

属性 类型 默认值 必填 说明
danmu-list Array. 弹幕列表
danmu-btn boolean false 是否显示弹幕按钮,只在初始化时有效,不能动态变更
enable-danmu boolean false 是否展示弹幕,只在初始化时有效,不能动态变更

除此之外我们还需要定义一个文本框来获取用户输入,和一个监听按钮来发送弹幕,代码如下:

 <input bindblur="bindInputBlur" type="text" placeholder="输入弹幕内容" style="margin: 10px;"/>
 <button type="primary" size="mini" bindtap="bindSendDanmu">发送弹幕</button>

6.2VideoContext类方法

VideoContext 实例,可通过 wx.createVideoContext获取。

VideoContext 通过 id 跟一个 video 组件绑定,操作对应的video组件。(这是为什么我们要在wxml中给video容器加一个id属性)

/**
   * 生命周期函数--监听页面初次渲染完成
   */
  onReady() {
    this.videoContext=wx.createVideoContext('myVideo')
  },

在这里我们需要用到VideoContext.sendDanmu(Object data)方法来发送弹幕

在这里我们定义两个监听函数bindInputBlurbindSendDanmu

如此我们就大功告成了,还是很简单的,大家可以看看动图的效果。

bindInputBlur(e){
    this.inputValue=e.detail.value;
  },
  bindSendDanmu(){
    this.videoContext.sendDanmu({
      text:this.inputValue,
      color:'#ff00ff'
    })
  },

『从零开始学小程序』媒体组件video组件

6.2完整代码

<!--pages/video/video.wxml-->
<video id="myVideo" src="cloud://cloud1-0gq03z948cf60a2f.636c-cloud1-0gq03z948cf60a2f-1313616796/a2.mp4"
autoplay="true" loop="true" object-fit="cover" picture-in-picture-mode="push"
danmu-btn="true" danmu-list="{{danmuList}}" enable-danmu="true"></video>
<view class="container">
  <input bindblur="bindInputBlur" type="text" placeholder="输入弹幕内容" style="margin: 10px;"/>
  <button type="primary" size="mini" bindtap="bindSendDanmu">发送弹幕</button>
  <button type="primary" size="mini" style="margin: 10px;" bindtap="gotoPrevideo">跳转到prevideo界面</button>
  <button type="primary" size="mini" style="margin: 10px;" bindtap="gotoNextvideo">跳转到nextvideo界面</button>
</view>
// pages/video/video.js
Page({
  /**
   * 页面的初始数据
   */
  inputValue:'',
  data: {
    danmuList:[
      {text:'第1s出现的弹幕',color:'#ff0000',time:1},
      {text:'第3s出现的弹幕',color:'#00ff00',time:3},
    ]
  },
  /**
   * 生命周期函数--监听页面初次渲染完成
   */
  onReady() {
    this.videoContext=wx.createVideoContext('myVideo')
  },
  bindInputBlur(e){
    this.inputValue=e.detail.value;
  },
  bindSendDanmu(){
    this.videoContext.sendDanmu({
      text:this.inputValue,
      color:'#ff00ff'
    })
  },
  gotoPrevideo:function(){
    wx.navigateTo({
      url: '../prevideo/prevideo',
    })
  },
  gotoNextvideo:function(){
    wx.navigateTo({
      url: '../nextvideo/nextvideo',
    })
  }
})
/* pages/video/video.wxss */
video{
  width: 100%;
  height: 250px;
  border-radius: 10px;
}
.container{
  display: flex;
  text-align: center;
  justify-items: center;
  vertical-align: center;
}

7.小试牛刀