抖音开放平台Logo
开发者文档
小程序
控制台
  • 组件概述
  • 基础内容
  • 视图容器
  • 表单
  • 导航
  • 媒体
  • image 图片
  • video 视频
  • live-player 实时视频播放器
  • live-preview 直播预览流组件
  • camera 相机
  • rtc-room组件
  • 画布
  • 地图
  • 开放能力
  • 行业开放
  • 原生组件

    • 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 格式；