文档中心 云点播 产品简介 解决方案 短视频播放器小程序插件

短视频播放器小程序插件

最近更新时间:2019-09-05 17:10:01

短视频播放器小程序插件是云点播提供的短视频在小程序端播放的解决方案。该插件含有《信息网络传播视频许可证》的资质证书备案,同时可以帮助客户集成视频能力,将视频简单快捷地在集成在微信小程序端上播放,便于用户制作、编辑、集成并通过互联网向公众提供音视频节目。
短视频播放器小程序插件依托于云点播成熟的一站式服务平台,提供视频上传、视频处理、视频分发、视频 AI 及视频内容保护等功能,有效提高视频服务质量。

准备工作

注册腾讯云

  1. 注册腾讯云 账号,并完成 企业实名认证
  2. 访问 云点播控制台,获取 云点播 APPID,用于接入短视频播放器小程序插件。

注册小程序

微信公众平台 注册并登录小程序,小程序类目请根据您的实际场景选择。

说明:

短视频播放器小程序插件仅限非个人主体小程序使用。

添加插件

在使用插件前,首先要在小程序管理后台中添加插件,有以下添加方式:

  • 在小程序管理后台的【设置】>【第三方服务】中选择【添加插件】,弹出页面中搜索“云点播短视频播放器”,选中插件并添加。
  • 搜索云点播短视频播放器的 APPID:wx116d0dd5e6a39ac7,选中插件并添加。

用户需要申请并等待插件开发者通过后,即可在小程序中使用相应插件,详细请查阅微信官方的插件 使用文档,申请插件权限。

安装小程序开发工具

  • 下载并安装最新版本的 微信开发者工具
  • 使用小程序前,请先阅读微信小程序提供的插件 使用文档,了解插件的使用范围和限制。

使用插件

上传视频至控制台

  1. 将视频上传至云点播控制台,详细步骤请参见 视频上传
  2. 将视频转码为可在小程序端播放的视频,目前小程序视频播放仅支持 MP4、3GP 及 M3U8 格式的视频发布,详细步骤请参见 视频处理
  3. 视频转码成功后,会在 视频发布 列表中展示。

申请小程序视频发布

  • 用户需要在【媒资管理】>【视频管理】>【微信小程序视频发布】内对视频进行发布。
  • 由于微信小程序的视频上传要求,用户只能选择 MP4、3GP 及 M3U8 格式的视频进行发布,云点播平台会对该视频进行审核,确认是否授予播放资质。
  • 查询发布状态
    云点播会对审核后的视频显示发布状态,用来标识该视频是否可以发布:
    • 如果发布状态为发布通过,则表示该视频已经获取了云点播播放资质认证,该 fileId 下的视频已经可以在小程序播放器进行播放。
    • 如果发布状态为发布失败,则表示该视频可能涉嫌违规,需用户人工确认是否违规,若认为该视频内容未涉及违规,请 提交工单 反馈。

添加插件代码

在小程序中引入插件代码,请参见插件 使用文档。使用插件前需要插入如下代码:

// 在 wxml 里插入
<my-player appid="xxxxx" fileid="xxxxxxxx" playerid="myPlayerId"></my-player>
// 在 app.json 里声明使用的插件及版本
"plugins": {
    "myPlugin": {
      "version": "1.0.0",
      "provider": "wx116d0dd5e6a39ac7"
    }
  }
// 在页面的 xxxx.json 里声明
"usingComponents": {
    "my-player": "plugin://myPlugin/player"
  }
  • appid:必填参数。在控制台的【账号信息】中查看。
  • fileid:必填参数。表示视频文件的唯一 ID,视频上传后,通过 媒资管理 可以查看 fileid。
  • playerid:必填参数。表示视频容器的唯一 ID,在小程序里需要通过该 ID 获取具体的video context来控制视频。

功能列表

短视频播放器小程序插件提供的详细功能清单如下,同时请关注小程序官方 video 文档,及时了解功能更新。

参数名称 类型                 默认值 是否必填 说明
appid string - 请到腾讯云账号信息中查看
fileid string - 即视频文件 ID,在云点播控制台上传视频后,媒资管理信息中查看
playerid string - 表示视频容器的唯一 ID,开发者自己选填
controls boolean true 是否显示默认播放控件(播放/暂停按钮、播放进度、时间)
danmu-list Array.<object> - 弹幕列表
danmu-btn boolean false 是否显示弹幕按钮,只在初始化时有效,不能动态变更
enable-danmu boolean false 是否展示弹幕,只在初始化时有效,不能动态变更
autoplay boolean false 是否自动播放
loop boolean false 是否循环播放
muted boolean false 是否静音播放
initial-time number 0 指定视频初始播放位置
direction number - 设置全屏时视频的方向,不指定则根据宽高比自动判断
show-progress boolean true 若不设置,宽度大于240时才会显示
show-fullscreen-btn boolean true 是否显示全屏按钮
show-play-btn boolean true 是否显示视频底部控制栏的播放按钮
show-center-play-btn boolean true 是否显示视频中间的播放按钮
enable-progress-gesture boolean true 是否开启控制进度的手势
object-fit string contain 当视频大小与 video 容器大小不一致时,视频的表现形式
poster string - 视频封面的图片网络资源地址或云文件 ID(2.3.0)。如果 controls 属性值为 false,则设置 poster 无效
show-mute-btn boolean false 是否显示静音按钮
title string - 视频的标题,全屏时在顶部展示
play-btn-position string bottom 播放按钮的位置
enable-play-gesture boolean false 是否开启播放手势,即双击切换播放/暂停
auto-pause-if-navigate boolean true 当跳转到其它小程序页面时,是否自动暂停本页面的视频
auto-pause-if-open-native boolean true 当跳转到其它微信原生页面时,是否自动暂停本页面的视频
vslide-gesture boolean false 在非全屏模式下,是否开启亮度与音量调节手势(同 page-gesture)
vslide-gesture-in-fullscreen boolean true 在全屏模式下,是否开启亮度与音量调节手势
bindplay eventhandle - 当开始/继续播放时触发 play 事件
bindpause eventhandle - 当暂停播放时触发 pause 事件
bindended eventhandle - 当播放到末尾时触发 ended 事件
bindtimeupdate eventhandle - 播放进度变化时触发,event.detail = {currentTime, duration} 。触发频率250ms一次
bindfullscreenchange eventhandle - 视频进入和退出全屏时触发,event.detail = {fullScreen, direction},direction 有效值为 vertical 或 horizontal
bindwaiting eventhandle - 视频出现缓冲时触发
binderror eventhandle - 视频播放出错时触发
bindprogress eventhandle - 加载进度变化时触发,只支持一段加载。event.detail = {buffered},百分比

短视频播放器 Demo

云点播为您提供了在小程序中引入短视频播放器的示例 Demo,详细请参见 Demo 源码

购买流程

如需购买云点播的短视频播放器小程序插件服务,请 提交工单

购买指南

计费价格

短视频播放器小程序插件费用由两部分产生:云点播插件使用费和视频播放次数费用,详情如下表。

计费项 计费方式 单价
短视频播放器小程序插件服务费 预付费 - 按年数 30000元/年
小程序端视频播放次数 后付费 - 按次数 0.3元/次

其余使用云点播产生的费用,详细请参见 云点播 - 计费方式

计费说明

  • 如果购买多个插件,则使用期限在插件上叠加。
    例如,用户 A 于2018年08月01日购买了2个短视频播放器小程序插件,则该插件的有效期为2020年08月01日。
  • 一个腾讯云账户仅提供一个 APPID,即一个腾讯云账号仅支持购买一个插件。