live-player 实时视频播放器

收藏
我的收藏
基础库 1.44.0 开始支持本组件。​
实时视频播放器。 live-player 组件还提供丰富的 api, 来控制实时视频的播放、暂停、全屏等,详请见 tt.createLivePlayerContext。​
该能力需申请权限使用,满足申请条件后,开发者登录控制台,在小程序应用中筛选“能力-互动能力-小程序直播”,申请直播组件能力,能力使用规范详情查看直播组件能力开通及使用规范;申请条件如下:​
    1.信用分 >= 90分​
    2.服务类目​
一级类目
二级类目
三级目录
教育 ​
教育 ​
在线教育 ​
汽车 ​
汽车 ​
车展服务、汽车经销商/4s店、汽车厂商/下属子(分)公司、二手车 ​
备注:具体开放类目依据后台申请入口显示状态为准,更多类目开放可关注平台公告。 ​

属性说明​

属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
src​
string​
无​
是​
视频地址。目前支持 flv、rtmp 和 hls,支持跨域。​
1.44.0​
autoplay​
boolean​
false​
否​
是否自动播放​
1.44.0​
muted​
boolean​
false​
否​
是否静音​
1.44.0​
orientation​
string​
vertical​
否​
画面朝向,vertical 为竖直,horizontal 为水平,详情见 orientation 的合法值。​
1.44.0​
object-fit​
string​
contain​
否​
填充模式,可选值有 contain,fillCrop,详情见 object-fit 的合法值。
1.44.0​
signature​
Signature​
无​
否​
设置署名水印,属性说明详见Signature 类型说明
2.48.0​
show-casting-button​
boolean​
false​
否​
是否显示投屏按钮(当前仅支持 Android,iOS 敬请期待)​
2.48.0​
bindstatechange​
EventHandle​
无​
否​
播放状态变化事件,detail = {code},code 取值见状态码
1.44.0​
bindfullscreenchange​
EventHandle​
无​
否​
全屏变化事件,detail = {direction, fullScreen}。​
1.44.0​
binderror​
EventHandle​
无​
否​
播放错误事件​
1.44.0​

src​

直播流地址如果跨域,则必须满足 cors 约束才能正常播放,具体设置可参考:​
    Access-Control-Allow-Headers: x-requested-with​
    Access-Control-Allow-Methods: GET,POST,PUT,DELETE,OPTIONS​
    Access-Control-Allow-Origin: *​
    Access-Control-Max-Age: 1800​

orientation 的合法值​

值​
说明​
最低支持版本​
vertical​
竖直​
1.44.0​
horizontal​
水平​
1.44.0​

object-fit 的合法值​

值​
说明​
最低支持版本​
contain​
图像长边填满屏幕,短边区域会被填充⿊⾊。​
1.44.0​
fillCrop​
图像铺满屏幕,超出显示区域的部分将被截掉。​
1.44.0​

Signature 类型说明​

object 类型,属性如下:​
属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
enable​
boolean​
true​
否​
是否显示署名水印​
2.48.0​
content​
string​
无​
是​
署名水印内容​
2.48.0​
position​
number​
0​
否​
署名水印位置:0(右上), 1(右下), 2(左下), 3(左上)​
2.48.0​
color​
Color​
#FFFFFF​
否​
署名水印颜色,只支持 HEX 格式。​
2.48.0​

状态码​

code​
说明​
2004​
视频播放开始​
2005​
视频播放进度​
2006​
视频播放结束​
2007​
视频播放缓冲​
2009​
直播分辨率改变​
2103​
网络出错,正在抢救​
-2301​
网络失败,无法播放​
2201​
审核封禁​
2202​
直播流地址连接错误​

扫码体验​

代码示例​

Bug & Tip​

    Tip:抖音 Android 890、iOS 753 以上版本支持,头条 Android 746、iOS 753 以上版本支持;​
    Tip:部分 Android 设备在切换全屏时偶现闪动的体验问题;​
    Tip:基础库 1.66.0 以上版本支持页面多实例同时播放;​
    Tip:小程序开发者工具中的 live-player 组件不支持 rtmp 格式;​