微信小程序 分享到朋友圈（Beta）

分享到朋友圈（Beta）

從基礎(chǔ)庫 2.11.3 開始支持

此功能為beta版，暫僅在Android平臺(tái)支持

可將小程序頁面分享到朋友圈。適用于內(nèi)容型頁面的分享，不適用于有較多交互的頁面分享。

設(shè)置分享狀態(tài)

小程序頁面默認(rèn)不可被分享到朋友圈，開發(fā)者需主動(dòng)設(shè)置“分享到朋友圈”。頁面允許被分享到朋友圈，需滿足兩個(gè)條件：

1. 首先，頁面需設(shè)置允許“發(fā)送給朋友”。具體參考 Page.onShareAppMessage 接口文檔
2. 滿足條件 1 后，頁面需設(shè)置允許“分享到朋友圈”，同時(shí)可自定義標(biāo)題、分享圖等。具體參考 Page.onShareTimeline 接口文檔

滿足上述兩個(gè)條件的頁面，可被分享到朋友圈。

單頁模式

用戶在朋友圈打開分享的小程序頁面，并不會(huì)真正打開小程序，而是進(jìn)入一個(gè)“小程序單頁模式”的頁面，“單頁模式”有以下特點(diǎn)：

1. “單頁模式”下，頁面頂部固定有導(dǎo)航欄，標(biāo)題顯示為當(dāng)前頁面 JSON 配置的標(biāo)題。底部固定有操作欄，點(diǎn)擊操作欄的“前往小程序”可打開小程序的當(dāng)前頁面。頂部導(dǎo)航欄與底部操作欄均不支持自定義樣式。
2. “單頁模式”默認(rèn)運(yùn)行的是小程序頁面內(nèi)容，但由于頁面固定有頂部導(dǎo)航欄與底部操作欄，很可能會(huì)影響小程序頁面的布局。因此，請開發(fā)者特別注意適配“單頁模式”的頁面交互，以實(shí)現(xiàn)流暢完整的交互體驗(yàn)。
3. “單頁模式”下，一些組件或接口存在一定限制，詳情見下文單頁模式下的限制章節(jié)

頁面適配

可通過判斷場景值等于 1154 的方法來進(jìn)行頁面適配。另外，在單頁模式下，可設(shè)置頂部導(dǎo)航欄與頁面的相交狀態(tài)，具體參考 navigationBarFit 配置。

還需留意的是，在單頁模式下，wx.getSystemInfo 接口返回的 safeArea 為整個(gè)屏幕空間。

單頁模式下的限制

小程序“單頁模式”適用于純內(nèi)容展示場景，可實(shí)現(xiàn)的交互與接口能力有限，因此存在如下限制：

1. 頁面無登錄態(tài)，與登錄相關(guān)的接口，如 wx.login 均不可用；云開發(fā)資源需開啟未登錄訪問方可在單頁模式下使用，詳見未登錄模式。
2. 不允許跳轉(zhuǎn)到其它頁面，包括任何跳小程序頁面、跳其它小程序、跳微信原生頁面
3. 不允許橫屏使用
4. 若頁面包含 tabBar，tabBar 不會(huì)渲染，包括自定義 tabBar
5. 本地存儲(chǔ)與小程序普通模式不共用

對(duì)于一些會(huì)產(chǎn)生交互的組件或接口，在點(diǎn)擊后調(diào)用時(shí)，會(huì)彈 toast 提示“請前往小程序使用完整服務(wù)”。為達(dá)到良好的用戶體驗(yàn)，請注意適配單頁模式的接口能力，請勿大量使用被禁用的接口或組件。

禁用能力列表：

運(yùn)營須知

分享朋友圈能力是為了滿足純內(nèi)容場景的分享訴求，濫用于營銷、誘導(dǎo)等行為將會(huì)被打擊。

1. 小程序提供的服務(wù)中，不得存在濫用分享違規(guī)行為。如強(qiáng)制用戶分享行為；分享立即獲得利益的誘導(dǎo)行為；以及通過明示或暗示的樣式來達(dá)到誘導(dǎo)分享目的的行為等。詳見《微信小程序平臺(tái)運(yùn)營規(guī)范》
2. 在“單頁模式”下，不得誘導(dǎo)或強(qiáng)制用戶點(diǎn)擊“打開小程序”，應(yīng)在“單頁模式”中盡可能呈現(xiàn)完整的內(nèi)容

提示：

1. 低版本微信客戶端打開時(shí)，會(huì)進(jìn)入一個(gè)升級(jí)提示頁面
2. 不支持在小程序頁面內(nèi)直接發(fā)起分享
3. 自定義分享內(nèi)容時(shí)不支持自定義頁面路徑
4. 存在 web-view 組件的頁面不支持發(fā)起分享
5. 支持打開開發(fā)版、體驗(yàn)版，無權(quán)限人員進(jìn)入時(shí)頁面會(huì)提示無權(quán)限