首先我要说明,腾讯云点播对接微信小程序是需要企业认证,否则无法开通这个功能。
准备工作
注册腾讯云
- 注册腾讯云 账号,并完成 企业实名认证。
- 访问 云点播控制台,获取 云点播 APPID,用于接入短视频播放器小程序插件。
- 购买 短视频播放器小程序插件。
注册小程序
在 微信公众平台 注册并登录小程序,小程序类目请根据您的实际场景选择。
说明:短视频播放器小程序插件仅限非个人主体小程序使用。
添加插件
在使用插件前,首先要在小程序管理后台中添加插件,有以下添加方式:
- 在小程序管理后台的【设置】>【第三方服务】中选择【添加插件】,弹出页面中搜索“云点播短视频播放器”,选中插件并添加。
- 搜索云点播短视频播放器的 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 源码。
扫描下面的二维码即可体验短视频播放器小程序插件。