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 | 小程序沒有顯示在畫面上(保活中) |
- 不設逾時。
- 卡片頁首永遠是平台登記的小程序名稱與圖示。