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

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

1.简介

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

• video组件：视频组件
• camera组件：相机组件
• audio组件：音频组件
• image组件：图片组件

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

2.简单案例

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

3.自动循环播放

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

属性	类型	默认值	必填	说明
autoplay	boolean	false	否	是否自动播放
loop	boolean	false	否	是否循环播放

4.容器适配

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

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

object-fit属性 有如下取值：

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

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

5.小窗模式

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

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

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

此外，小窗还支持以下特性：

• 小窗容器尺寸会根据原组件尺寸自动判断
• 点击小窗，用户会被导航回小窗对应的播放器页面
• 小窗出现后，用户可点击小窗右上角的关闭按钮或调用 context.exitPictureInPicture() 接口关闭小窗

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

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

"container">
  "primary" size="mini" bindtap="gotoPrevideo">跳转到prevideo界面
  "primary" size="mini" style="margin: 10px;" bindtap="gotoNextvideo">跳转到nextvideo界面

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)方法来发送弹幕

在这里我们定义两个监听函数bindInputBlur和bindSendDanmu

• bindInputBlur：用来获取用户在文本框组件上输入的文字
• bindSendDanmu：用来监听按钮发送弹幕

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

bindInputBlur(e){
    this.inputValue=e.detail.value;
  },

  bindSendDanmu(){
    this.videoContext.sendDanmu({
      text:this.inputValue,
      color:'#ff00ff'
    })
  },

6.2完整代码

<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.小试牛刀