video-player 组件
输入“/”快速插入
video-player 组件
飞书用户1055
飞书用户1997飞书用户6953
飞书用户5940飞书用户48312023年9月1日创建
基础库 2.77.0 开始支持本组件。
推荐使用预取 API tt.preloadResourceVideo 进行播放性能优化。
为了保证视频流畅播放，提升播放质量和安全，建议阅读 【短剧行业专属】<video-player> 组件接入教程 ，同时我们也在 IDE 上增加了短剧小程序模板，欢迎大家结合教程体验。
使用限制
🚅
注意：
版本校验
video-player 只在抖音、抖极、抖火 23.8 及以上版本支持，使用前可通过 tt.canIUse 校验当前抖音能否使用。若不支持可使用老版video组件进行播放或提示用户升级抖音。
tt.canIUse('video-player')
属性说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
album-id | string | 无 | 是 | 行业SDK | |
episode-id | string | 无 | 是 | 行业SDK | |
cloud-type | number | 无 | 是 | 使用cdn类型，1: 抖音云 2: 三方云。 可用 tt.canIUse('video-player.cloudType') 判断是否支持该属性。 | 行业SDK |
three-party-cloud | string | 无 | 否 | 三方云链接，当cloud_type为2，即三方云时必传 | 行业SDK |
version | string | 无 | 是 | 废弃字段。为了兼容老版本，请传 1 。 | 行业SDK |
autoplay | boolean | false | 否 | 是否自动播放。 | 2.74.0 |
poster | string | 无 | 否 | 视频封面的图片网络资源地址。 | 2.74.0 |
loop | boolean | false | 否 | 是否循环播放。 | 2.74.0 |
show-fullscreen-btn | boolean | true | 否 | 是否显示全屏按钮。 | 2.74.0 |
show-play-btn | boolean | true | 否 | 是否显示播放、暂停、重播按钮，不包括视频封面的播放按钮。 | 2.74.0 |
controls | boolean | true | 否 | 是否显示全部播放控件。 | 2.74.0 |
object-fit | string | contain | 否 | 当视频大小与 video 容器大小不一致时，视频的表现形式。 • contain（包含） • fill（填充） • cover（覆盖） | 2.74.0 |
play-btn-position | string | center | 否 | 播放按钮的位置。 • center（视频中间） • bottom（控制条上） | 2.74.0 |
vslide-gesture | boolean | false | 否 | 在非全屏模式下，是否开启亮度与音量调节手势，开启后表现详见手势响应-亮度与音量。 | 2.74.0 |
vslide-gesture-in-fullscreen | boolean | true | 否 | 在全屏模式下，是否开启亮度与音量调节手势，开启后表现详见手势响应-亮度与音量。 | 2.74.0 |
enable-progress-gesture | boolean | false | 否 | 是否开启控制进度的手势，开启后表现详见手势响应-播放进度。 | 2.74.0 |
enable-play-gesture | boolean | false | 否 |