抖音开放平台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 格式;