用途:指导微信小程序开发「分享到朋友圈」功能,覆盖配置、单页模式适配与限制处理。需基础库 2.11.3+、微信 8.0.24+。
主要能力与用法:页面须先实现 onShareAppMessage 启用「发送给朋友」,再实现 onShareTimeline 启用「分享到朋友圈」。onShareTimeline 返回 title、query(注意是 query 而非 path,不支持自定义路径)、imageUrl。Taro 中对应 useShareAppMessage 与 useShareTimeline。
单页模式:用户从朋友圈打开进入受限环境,scene 为 1154,无登录态、存储隔离、固定导航栏与底部「前往小程序」按钮;可用 getLaunchOptionsSync 判断,基础库 2.22.1+ 可用 wx.getApiCategory 返回 browseOnly 判断浏览态。页面需按此做降级:隐藏需登录的交互、改用公开接口取数、云开发开启未登录访问、底部留出操作栏 padding。
布局:页面 JSON 可配 navigationBarFit,float(默认浮动)或 squeezed(被导航栏挤压)。
限制:单页模式禁用 button open-type、camera、form、navigator、web-view、live-pusher 等组件,以及登录、路由、媒体、位置、支付、分享、设备、广告类 API;不允许横屏,tabBar 不渲染。运营上禁止诱导分享与强制跳转。选用命令与代码请以原始资料为准。