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

博主:xiaoweixiaowei 2022-04-23 条评论

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

目录

  • 1 准备工作
  • 2 使用插件
  • 3 功能列表
  • 4 短视频播放器 Demo

准备工作

注册腾讯云

  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 文档,及时了解功能更新。

参数名称类型默认值是否必填说明
appidstring请到腾讯云账号信息中查看
fileidstring即视频文件 ID,在云点播控制台上传视频后,媒资管理信息中查看
playeridstring表示视频容器的唯一 ID,开发者自己选填
controlsbooleantrue是否显示默认播放控件(播放/暂停按钮、播放进度、时间)
danmu-listArray.<object>弹幕列表
danmu-btnbooleanfalse是否显示弹幕按钮,只在初始化时有效,不能动态变更
enable-danmubooleanfalse是否展示弹幕,只在初始化时有效,不能动态变更
autoplaybooleanfalse是否自动播放
loopbooleanfalse是否循环播放
mutedbooleanfalse是否静音播放
initial-timenumber0指定视频初始播放位置
directionnumber设置全屏时视频的方向,不指定则根据宽高比自动判断
show-progressbooleantrue若不设置,宽度大于240时才会显示
show-fullscreen-btnbooleantrue是否显示全屏按钮
show-play-btnbooleantrue是否显示视频底部控制栏的播放按钮
show-center-play-btnbooleantrue是否显示视频中间的播放按钮
enable-progress-gesturebooleantrue是否开启控制进度的手势
object-fitstringcontain当视频大小与 video 容器大小不一致时,视频的表现形式
posterstring视频封面的图片网络资源地址或云文件 ID(2.3.0)。如果 controls 属性值为 false,则设置 poster 无效
show-mute-btnbooleanfalse是否显示静音按钮
titlestring视频的标题,全屏时在顶部展示
play-btn-positionstringbottom播放按钮的位置
enable-play-gesturebooleanfalse是否开启播放手势,即双击切换播放/暂停
auto-pause-if-navigatebooleantrue当跳转到其它小程序页面时,是否自动暂停本页面的视频
auto-pause-if-open-nativebooleantrue当跳转到其它微信原生页面时,是否自动暂停本页面的视频
vslide-gesturebooleanfalse在非全屏模式下,是否开启亮度与音量调节手势(同 page-gesture)
vslide-gesture-in-fullscreenbooleantrue在全屏模式下,是否开启亮度与音量调节手势
bindplayeventhandle当开始/继续播放时触发 play 事件
bindpauseeventhandle当暂停播放时触发 pause 事件
bindendedeventhandle当播放到末尾时触发 ended 事件
bindtimeupdateeventhandle播放进度变化时触发,event.detail = {currentTime, duration} 。触发频率250ms一次
bindfullscreenchangeeventhandle视频进入和退出全屏时触发,event.detail = {fullScreen, direction},direction 有效值为 vertical 或 horizontal
bindwaitingeventhandle视频出现缓冲时触发
binderroreventhandle视频播放出错时触发
bindprogresseventhandle加载进度变化时触发,只支持一段加载。event.detail = {buffered},百分比

短视频播放器 Demo

云点播为您提供了在小程序中引入短视频播放器的示例 Demo,详细请参见 Demo 源码。
扫描下面的二维码即可体验短视频播放器小程序插件。
腾讯云点播对接微信小程序

The End

发布于:2022-04-23,除非注明,否则均为 主机评测原创文章,转载请注明出处。