资讯 / 文章页
快手页面里写了分享回调,配出来的一定是私信分享卡片吗?先分清官方 type 里的分享、视频挂载、收藏和直播挂载
快手卡片
2026-11-19

快手小程序文档把分享内容的自定义,写在页面里的分享回调里。有人会以为:只要页面写了这个回调,配出来的就一定是发到私信里的分享卡片。2026年11月19日(北京时间)阅读的《Page》文档,并没有把这一回调只写成「私信分享卡片专用」。该页在回调说明里写:它监听用户所有分享行为,并自定义分享内容;分享行为包括右上角菜单的分享按钮、收藏本页和设为常用、稍后再看、按钮组件的分享和收藏行为,以及绑定短视频挂载。同一段还用 type 参数标明,当前这次设置要配到什么地方,其中 share 是配置到分享内容,plc 是配置到左下角视频挂载,favorite 是配置到收藏行为,live 是配置到直播挂载,videoPublish 是配置到发布快手视频。要把回调本身、type 所指向的配置位置,以及私信分享卡片和直播间讲解卡的差别,分成几层来看。《Page》页标更新时间为2025年8月19日10:54:10。《私信分享与站外分享能力》页标更新时间为2024年9月9日10:57:31。本文是对官方公开文档的对象辨析,不是分享接入教程,也不能证明某一第三方工具已经代为完成这些配置。

https://cdn2.quma.cn/uploads/2/2026/11/19/Fuyuc50uqCm-fd3T_l6RecrQToa5.jpg

写了分享回调,不等于只在配私信卡片

《私信分享与站外分享能力》开篇写:当前分享能力支持站内私信分享与站外分享。同一页也写,页面中如果定义了分享回调,则本页面自动开启分享,同时该回调的返回值会作为分享的内容。这容易让人把「页面已经写了回调」理解成「现在配的就是私信里那张卡片」。

《Page》把这件事写得更完整。该页给这个回调的说明是:分享、视频挂载、收藏等操作触发。后面又写,它监听用户所有分享行为,并自定义分享内容。也就是说,回调被触发时,不一定是用户正在把页面发到私信;也可能是在收藏、设为常用、稍后再看,或在绑定短视频挂载。定义了这个函数之后,右上角菜单才会显示「分享」按钮,同时本页面会自动开启分享。开启分享,和这一次回调到底在为哪一种行为填内容,仍然是两件事情。

分享能力页后半部分还写了站外的H5链接分享和海报分享。那是另一组打开路径,不能用来回答「这个回调配出来的是不是私信卡片」。如何开启分享、接口和配置项谁优先,也是另一组问题,不能代替本次要分清的 type。

先看 type:同样的返回值,可能配到不同位置

《Page》为回调的入参准备了 type 字段,说明是「配置类型,标明当前通过这个方法设置的内容用来配置在什么地方」。该页列出的取值是:share,配置到分享内容;plc,配置到左下角视频挂载;favorite,配置到收藏行为;live,配置到直播挂载;videoPublish,配置到发布快手视频。

这五类并不是同一张「私信分享卡片」的别名。share 才对应该页所说的「配置到分享内容」;plc 对的是左下角视频挂载,同一页后面还写,当开发者自定义了分享标题,挂载在短视频上的标题继承该处指定。favorite 对的是收藏行为,和右上角「收藏本页和设为常用」是同一侧的问题,不是把收藏入口写成私信卡片。live 和 videoPublish 则分别指向直播挂载、发布快手视频。该页没有把这五个取值写成可以互相替代,也没有写「只要返回了标题和路径,就一律按私信卡片发出」。

需要留心的是:在「分享行为包括以下场景」那一份列举里,写明的是右上角分享按钮、收藏本页和设为常用、稍后再看、按钮组件的分享和收藏,以及绑定短视频挂载;列举里没有把直播挂载、发布快手视频单独写成与分享按钮并列的条目。但 type 取值表里确实列了 live 和 videoPublish。该页没有解释这两份清单如何一一对应,不能自行补上缺失的对应关系,也不能因为列举里没单独点名,就否定 type 表里已经写下的取值。

from 只说明是按钮还是右上角菜单,不能代替 type

同一回调的入参里还有 from。该页写:from 表示分享事件来源,button 是页面内转发按钮,menu 是右上角转发菜单。如果 from 的值来自对象,则 target 是触发这次转发事件的按钮组件,否则为没有对应对象。

from 能回答的是:这一次是页面里的按钮触发的,还是右上角菜单触发的。它不能回答:这次要配的是分享内容、左下角视频挂载、收藏,还是直播挂载。把 from 看成 type,很容易只检查了按钮和菜单,却没有核对当前配置要落到哪一种位置。分享能力页也提示,参数中包含 from、type 字段,可以用来判断当前分享的触发来源、触发方式,并指向《Page》文档。两页都是把来源和配置类型分开写的。

该页还写,如果这个回调执行报错,会中断分享行为,并弹出分享失败提示。这只说明回调执行失败时分享会被打断,不能用来推断 type 填错时一定失败或一定仍按私信卡片发出。

返回的标题和路径,并不自动证明这是私信卡片

《Page》写,页面中如果定义了该回调,返回值会作为分享的内容。返回值字段包括:title(分享标题)、imageUrl(分享图标)、path(当前页面路径),以及 desc(转发内容)。《私信分享与站外分享能力》里的返回值表只列了 title、imageUrl 和 path,没有列出 desc。两页应以各自当场原文为准,不能把多写的字段当成另一页也已列出。

这些字段描述的是分享内容里有哪些项,并不能单独证明「这一次配出的就是私信分享卡片」。同一页写,自定义了分享标题时,挂载在短视频上的标题继承该处指定;自定义路径时,可在路径上追加参数,以区分不同分享带来的转化。前一句明确说的是短视频挂载会继承这里的标题,没有写直播挂载或收藏也按同一句继承。后一句只说明路径上可以追加参数,没有在本页展开参数要写在哪里、路径为空会不会进首页。路径怎么写、缺省时对方看到什么,是另一组问题,不能拿来倒推这次配置的对象。

用户打开小程序之后,可以用官方《场景值》文档里的入口编号,核对这次是从哪一类路径进来的。该页把场景值定义为「用来描述用户进入小程序的路径」,页标更新时间为2025年10月23日11:22:42。快手应用一侧,私信分享对应 011001,视频左下角导流入口(短视频挂载)对应 011009,小程序中心我的收藏(页面)对应 011019,侧边栏稍后再看对应 011023,直播间小程序入口对应 011022。场景值能帮助判断进入路径,不能反过来证明:写了分享回调,就只会配出私信分享卡片。该页也没有把这些场景值,与 type 的五个取值写成一一对应。

直播挂载不是直播间讲解卡

type 取值里的 live,官方写的是「配置到直播挂载」。这不能直接理解成直播间里的讲解卡。讲解卡写在另一份《小程序直播助手》文档里,和页面分享回调不是同一套说明;该页也没有把「路径为空则默认跳转至小程序首页」这类规则,写进《Page》的 live 取值里。不能把讲解卡的路径规则,套到本次的直播挂载上来用。

《场景值》里还出现了「直播间小程序入口」和「直播开播前,打开小程序添加直播间入口」。它们描述的是用户后来从哪里进入小程序,同样没有在《Page》里被写成与 live 取值的对应表。没有当场文档把三者写成同一个对象之前,不应自行划等号。

因此,看到页面里写了分享回调,先应核对这一次回调的 type 指向哪里,而不是默认它配出的就是私信里的分享卡片。share、plc、favorite、live 和 videoPublish 是官方已经分开写下的配置位置;私信分享卡片只是其中与分享内容相关的一种结果,不是这一回调的全部。

参考资料

[1] 快手小程序文档:Page https://open.kuaishou.com/docs/develop/frame/page/page_page.html,页标更新时间2025-08-19 10:54:10,访问日期2026-11-19(北京时间)。本文依据该页关于分享回调的触发场景、from 与 type 参数、type 取值(share、plc、favorite、live、videoPublish)以及返回值字段等表述。

[2] 快手小程序文档:私信分享与站外分享能力 https://open.kuaishou.com/docs/develop/functionAccessGuide/share.html,页标更新时间2024-09-09 10:57:31,访问日期2026-11-19(北京时间)。本文依据该页关于站内私信分享与站外分享、定义回调后自动开启分享并以返回值作为分享内容,以及站外H5与海报为另一组能力等表述。

[3] 快手小程序文档:场景值 https://open.kuaishou.com/docs/develop/frame/sceneid.html,页标更新时间2025-10-23 11:22:42,访问日期2026-11-19(北京时间)。本文仅引用该页对进入路径的编号说明,用于区分私信分享、短视频挂载、收藏、稍后再看和直播间入口,不把场景值写成与 type 取值的一一对应表。

购买咨询
微信扫码咨询
400-600-7511