腾讯云点播对接微信小程序

首先我要说明,腾讯云点播对接微信小程序是需要企业认证,否则无法开通这个功能。

准备工作

注册腾讯云

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

注册小程序

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

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

添加插件

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

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

添加插件完毕后,用户可在小程序中使用相应插件。

安装小程序开发工具

下载并安装最新版本的 微信开发者工具

使用小程序前,请先阅读微信小程序提供的插件 使用文档,了解插件的使用范围和限制。

使用插件

上传视频至控制台

将视频上传至云点播控制台,详细步骤请参见 视频上传。

将视频转码为可在小程序端播放的视频,目前小程序视频播放仅支持 MP4、3GP 及 M3U8 格式的视频发布,详细步骤请参见 视频处理。

视频转码成功后,会在 视频发布 列表中展示。
腾讯云点播对接微信小程序

申请小程序视频发布

用户需要在【媒资管理】>【视频管理】>【微信小程序视频发布】内对视频进行发布。

由于微信小程序的视频上传要求,用户只能选择 MP4、3GP 及 M3U8 格式的视频进行发布,云点播平台会对该视频进行智能识别,确认是否授予播放资质。

查询发布状态
云点播会对智能识别后的视频显示发布状态,用来标识该视频是否可以发布:

如果发布状态为发布通过,则表示该视频已经获取了云点播播放资质认证,该 fileId 下的视频已经可以在小程序播放器进行播放。

如果发布状态为发布失败,则表示该视频可能有不适宜内容,需用户人工确认是否有不适宜内容,若认为该视频内容未涉及不适宜内容。
腾讯云点播对接微信小程序

添加插件代码

在小程序中引入插件代码。使用插件前需要插入如下代码:

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

添加插件

在使用插件前,首先要在小程序管理后台的“设置-第三方服务-插件管理”中添加插件。开发者可登录小程序管理后台,通过 appid 查找插件并添加。如果插件无需申请,添加后可直接使用;否则需要申请并等待插件开发者通过后,方可在小程序中使用相应的插件。可以参考文档:添加插件

引入插件代码包

使用插件前,使用者要在 app.json 中声明需要使用的插件,例如:

代码示例:

{
  "plugins": {
    "myPlugin": {
      "version": "1.0.0",
      "provider": "wxidxxxxxxxxxxxxxxxx"
    }
  }
}

如上例所示, plugins 定义段中可以包含多个插件声明,每个插件声明以一个使用者自定义的插件引用名作为标识,并指明插件的 appid 和需要使用的版本号。其中,引用名(如上例中的 myPlugin)由使用者自定义,无需和插件开发者保持一致或与开发者协调。在后续的插件使用中,该引用名将被用于表示该插件。

功能列表

短视频播放器小程序插件提供的详细功能清单如下,同时请关注小程序官方 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 源码
扫描下面的二维码即可体验短视频播放器小程序插件。
腾讯云点播对接微信小程序

https://www.shluqu.cn/13157.html
点赞
4.00 平均评分 (85% 分数) - 1

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注