playlet

更新时间：2025-03-27 11:15:54

基础库1.76.0开始支持,低版本需做兼容处理

开发者工具1.47.0开始支持

短剧播放器（推荐使用：短剧插件 (opens new window)）
为响应短剧行业政策要求并加速开发者完成备案审核流程（详见《短剧类小程序接入内容备案审核系统公告》 (opens new window)），本平台现推出专为短剧行业设计的播放器组件，内置提供内容库资源(备案后)、提供上下滑交互能力，以统一短剧C端交互。

属性

属性	类型	默认值	必填	说明
playlet-id	string		否	剧目id
episode-id-list	string[]		否	剧集id数组
play-id	string		否	指定播放剧集id或者是剧集数，若不指定或未匹配到，则从第一集开始播放
show-bottom-safe-area	boolean	true	否	是否展示底部安全区，默认展示，会空出底部区域（目的：避免播放器进度条与全屏手势操作冲突），若关闭则播放器充满整个组件高度
ext-params	ExtParamsOptions		否	扩展数据
show-share	boolean	false	否	是否展示分享按钮（true: 展示、false：不展示）
object-fit	'contain' | 'fill' | 'cover'	'contain'	否	视频大小与 video 容器大小不一致时，视频的表现形式，参考video 的object-fit属性
playback-rate	1 | 2 | 0.5 | 0.8 | 1.25 | 1.5	1	否	设置播放倍率。可选值： 0.5/0.8/1/1.25/1.5/2
referrer-policy	'origin' | 'no-referrer'	'no-referrer'	否	格式固定为 https://miniapi.ksapisrv.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；
binderror	(e: { detail: { errorCode: number, errorMsg: string } } & Event) => void		否	视频播放出错时触发
bindnopermissionplay	(e: { detail: { episodeId: string, playEpisodeNumber: number } } & Event) => void		否	无播放权限时回调
bindaction	(e: { detail: { type: 'share' | 'like' | 'collect' | 'follow' | 'operation', action: boolean, episodeNumber: number } } & Event) => void		否	用户功能区点击时回调
bindchange	(e: { detail: { episodeId: string, playEpisodeNumber: number } } & Event) => void		否	播放剧集切换时回调
bindplay	(e: { detail: { episodeId: string, playEpisodeNumber: number, type: 'START_PLAY' | 'PLAY' } } & Event) => void		否	剧集播放 ("START_PLAY"： 开始播放； "PLAY"：继续播放)
bindpause	(e: { detail: { episodeId: string, playEpisodeNumber: number } } & Event) => void		否	剧集播放暂停
bindend	(e: { detail: { episodeId: string, playEpisodeNumber: number } } & Event) => void		否	剧集播放结束

ext-params-options

扩展配置

属性

属性	类型	必填	说明
free-list	number[]	否	免费剧集数的数组
payed-list	number[]	否	已付费剧集数的数组
source-list	any	否	其他扩展信息
config-list	ConfigOptions[]	否	功能区配置数据

config-options

功能区配置

属性

属性	类型	必填	说明
like	LikeOptions	否	点赞信息
collect	CollectOptions	否	订阅信息
operation	OperationOptions	否	运营信息
follow	FollowOptions	否	关注信息

like-options

点赞配置

属性

属性	类型	必填	说明
liked	boolean	否	是否已点赞
liked-count	number	否	已点赞数

collect-options

订阅配置

属性

属性	类型	必填	说明
has-collected	boolean	否	是否已订阅

operation-options

运营位配置

属性

属性	类型	必填	说明
operation-url	string	否	运营位图片
operation-desc	string	否	运营位描述

follow-options

关注配置

属性

属性	类型	必填	说明
avatar	string	否	展示头像网络地址/base64
followed	boolean	否	是否已关注

扫码体验

示例代码