快手小程序行业播放器接入文档

更新时间：2026-02-25 11:17:44

背景

基于平台对小说剧行业的合规要求，我们研发了小说剧行业播放器插件，用于提供备案号、ai标签、异常状态的展示。

插件效果

模式	效果
全屏		左上角展示 ai 标签 备案号（6s后隐藏）   注：全屏模式是隐藏顶部导航栏场景下使用
半屏		左上角展示 ai 标签 备案号（6s后隐藏）   注：半屏模式是不隐藏顶部导航栏使用

插件接口协议

属性

属性名	类型	默认值	是否必传	备注
src	string	-	是	三方播放地址 仍需要传，作为降级兼容使用
dramaId	string	-	是	剧目id
playId	string	-	是	剧集id
showAiTag	bool	true	否	是否展示ai创作标签
onInitError	event => ({detail: string, code: number})	-	否	初始化异常
show-casting-button	-	-	-	显示投屏按钮 不支持
bindcastinguserselect	-	-	-	用户选择投屏设备时触发 不支持
bindcastingstatechange	-	-	-	投屏成功/失败时触发 不支持
bindcastinginterrupt	-	-	-	投屏被中断时触发 不支持
definition	-	-	-	清晰度 不支持
复用video属性 video 功能列表

onInitError

code	说明
10000424	短剧不存在
10000432	短剧资源被封禁
10000427	短剧资源不在线
10000426	当前小程序没有播放该短剧权限
10000440	资源不存在
10000429	视频播放链接获取失败

使用方式

注：

• 该行业播放器基于video改造而来，具备video的基本能力，可直接使用【插件tag】替换【video】，大多数情况可直接使用
• 开发者应使用最新版本快手开发者工具，避免其他因素影响

app.json

{
   
    "plugins": {
        "myPlugin": { // 插件名称，可任意自定义 
            "provider": "pluginf9dc3165f4" //插件ID是不能改的
        }
    }
}

使用页面、组件的 json 文件中声明

{
    "usingComponents": {
          // 自定义组件名称、插件导出组件路径
        "playlet-plugin": "plugin://myPlugin/playlet-plugin"           
    }
}

json 文件中的声明规则

ksml 中的使用  

<playlet-plugin
    id="videoId"
    src="xxxxxx"
    dramaId="ksxxxxx"
    playId="ksplayidxxxxxxxx"
/>