Skip to content

share 分享 ​

畫面層、邏輯層都可用。需要在 permissions 宣告 share.toChat,並需要容器 1.1.0。使用方式見分享到聊天。

sdk.share.toChat() ​

ts
sdk.share.toChat(options?: ShareOptions): Promise<boolean>

interface ShareOptions {
  title?: string; // 卡片大字,最多 60 字
  desc?: string;  // 沒有 title 時當卡片大字,最多 120 字
  path?: string;  // 收到的人點開時的起始頁,例如 '/orders/1'
}

打開原生的選擇會話頁,使用者選了才送出。回傳 true 表示已送出;false 表示使用者取消,或送出失敗(容器已顯示錯誤提示)。

參數規則
title最多 60 字
desc最多 120 字
path以 / 開頭、最多 512 字;不能有 .. 路徑段、\、開頭 //
失敗情況
NOT_ALLOWED沒有在 permissions 宣告 share.toChat
INVALID_PARAMS參數違反上表
RATE_LIMITED已經有一個分享頁開著(容器 1.2.0 起)
INTERNAL小程序沒有顯示在畫面上(保活中)
  • 不設逾時。
  • 卡片頁首永遠是平台登記的小程序名稱與圖示。