分享入口已经出现之后,对方看到的标题、图或落地页有时仍对不上。这时很容易以为:只要改了页面回调的返回值,私信和站外展示就一定会一起变。入口能不能被点出来,和发出去之后对方实际看到什么,并不是同一件事。前者要按开启方式和优先级排查;本文只处理后者,也就是字段和缺省规则分别管哪一层展示。
本文依据快手开放平台《私信分享与站外分享能力》。该页标注更新时间为2024年9月9日10:57:31,本轮于2026年11月11日(北京时间)再次读取,日期未变。它是可公开读取的官方说明,不能证明某一家小程序当前的实际展示已经按该页生效,也不能证明趣码或第三方“快手卡片”已经接入这套官方分享。站外分享在文档中确有 H5 链接(快口令)和海报两种形态,本文只用来对照它们各自展示哪些信息、缺省图从哪里来,不是在两种形态里做选型教程。
文档写明:当前分享能力支持站内私信分享与站外分享。在页面中定义 `onShareAppMessage` 时,该页会自动开启分享,其返回值会作为分享的内容。返回值字段是:`title` 为分享标题,`imageUrl` 为分享图标,`path` 为当前页面路径。
也就是说,私信里对方看到的标题和图,首先应对这三项返回值,而不是先去改尚未核实的第三方卡片模板。`path` 管的是打开后进入哪一个页面,它通常不会直接显示成标题;标题不对,应先看 `title`,图不对,应先看 `imageUrl`。文档没有写:这三项留空时,私信侧会用哪一种系统缺省。因此,不能把“我没填就应该自动用页面标题或截图”写成已核实规则,只能回到当前项目的实际返回值去核对。
若分享入口本身还没有出现,应先按官方优先级核接口、页面回调和配置项,那是另一篇文章的主线,本文不再重写。本文的前提是入口已经可以被发起,问题出在发出去之后的展示。
设置允许分享后,文档写明:可在小程序内发起站外 H5 链接分享,生成快口令(H5 链接);打开链接后,可在 H5 页面中点击跳转下载快手或唤起快手,并跳转至小程序对应页面。这里的“对应页面”,仍应回到分享内容里的路径去理解,而不是假定一定会落到首页。
H5 页面包含的小程序信息,文档列的是:小程序名称、logo、简介、分享标题、分享图标(若无,默认为分享页面截图)。和私信返回值对照,有两处不能混用。第一,小程序名称、logo、简介并不是 `onShareAppMessage` 那三个返回字段;它们来自小程序资料,改回调返回值并不等于这些资料会一起变。第二,分享图标若无,默认是分享页面截图。也就是说,站外 H5 上看起来“图不对”,既可能是 `imageUrl` 指到了错误地址,也可能是根本没有有效的分享图标,页面落到了截图缺省。截图当时的页面状态、是否含有弹层或加载中的样子,文档并未展开,本文也不编造成实测结论。
文档还列出了可直接分享的站外应用名单,并写明同时支持直接复制链接再粘贴至其他应用。这些只说明官方支持的发出途径,不能把它写成配置教程,也不能证明粘贴到名单之外的应用时,展示规则仍然相同。
海报:字段相近,但多了一枚官方所述的分享页面二维码站外还有一种形态是海报。文档写明:设置允许分享后,可在小程序内发起海报分享;被分享者保存海报到相册并打开快手,或通过快手扫一扫扫描图片上的二维码,经提示弹窗跳转至小程序对应页面。海报包含的信息是:小程序名称、logo、分享标题、分享图标(若无,默认为分享页面截图)、分享页面二维码。
和 H5 相比,海报同样有分享标题、分享图标,以及“若无则用分享页面截图”的缺省;同样会展示小程序名称和 logo。不同的是,海报不在该页列出“简介”,但多了官方所述的「分享页面二维码」。本文只转述这一官方用词,不绘制、不粘贴、不伪造真实二维码。配图若需示意,也只能用示意框并标明“示意,非真实二维码”。
因此,不能因为私信里的标题或图标已经改对,就推断海报或快口令页面一定已经同步。三者都会用到分享标题和分享图标,但站外还会叠加小程序资料,并在图标缺失时改走截图缺省;海报还多了扫码进入这一层。是否在具体版本里完全同步,应以当时文档和有权测试环境为准,本文不做效果承诺。
对方看到的标题或图不对时,建议按展示场景分开记录,而不是先改一套返回值、再假设所有出口都会变。
若是站内私信,先核对 `title`、`imageUrl`、`path` 的实际返回值,是否分别对上标题、图标和目标页面。若是站外 H5,除了分享标题和图标,还要看小程序名称、logo、简介是否来自资料本身;图标为空时,应预期可能出现分享页面截图,而不是继续只查返回值。若是海报,同样要核标题、图标和截图缺省,并意识到页面上还有官方所述的分享页面二维码,它不是用 `imageUrl` 生成的普通配图。
不要把第三方“快手卡片”或趣码产品直接写成已经接入上述官方分享。公开产品名里如果出现“快手卡片”,只说明厂商有相应叙事,不能证明已经调用 `onShareAppMessage`,也不能证明站外 H5 或海报的缺省规则已经由该产品代为实现。
- 当前问题发生在站内私信,还是站外 H5(快口令),或海报
- 私信侧:`title`、`imageUrl`、`path` 的实际返回值分别是什么,是否与对方看到的标题、图标和打开页面一致
- 站外 H5:小程序名称、logo、简介是否与资料一致;分享图标是返回值,还是文档所述的分享页面截图缺省
- 海报:标题和图标的来源同上;是否误把官方所述分享页面二维码理解成一张可随意替换的配图
- 未把改回调返回值写成站外展示一定同步
- 未把本文写成快口令与海报的二选一教程
- 所依据文档标题、更新时间(2024-09-09 10:57:31)和本次访问日期
- 未把趣码或第三方“快手卡片”写成已接入该官方分享
分享发出去之后对方看到什么,要先分清私信字段和站外页面的缺省规则。标题或图不对,不一定是入口没打开,更可能是返回值、小程序资料和“图标缺失时改用页面截图”这几层被叠在了一起。
[1] 快手开放平台:私信分享与站外分享能力(https://open.kuaishou.com/docs/develop/functionAccessGuide/share.html),更新时间 2024-09-09 10:57:31,访问日期 2026-11-11(北京时间)。本文依据该页关于 `onShareAppMessage` 返回值作为分享内容、字段 `title` / `imageUrl` / `path` 分别为分享标题/图标/当前页面路径;站外 H5 生成快口令,页面包含小程序名称、logo、简介、分享标题和分享图标(缺省为分享页面截图);海报包含小程序名称、logo、分享标题、分享图标(缺省为分享页面截图)及分享页面二维码等表述。本文不把站外两种形态写成选型教程,也不伪造真实二维码。