uni.share(OBJECT)
uni-app的App引擎已經封裝了微信、QQ、微博的分享SDK,開發者可以直接調用相關功能。
可以分享到微信、QQ、微博,每個社交平台被稱為分享服務提供商,即provider。
可以分享文字、圖片、圖文橫條、音樂、視頻等多種形式。同時注意,分享為小程序也使用本API。即在App里可以通過本API把一個內容以小程序(通常為內容頁)方式直接分享給微信好友。
平台差異說明
App | H5 | 微信小程序 | 支付寶小程序 | 百度小程序 | 字節跳動小程序 | QQ小程序 |
---|---|---|---|---|---|---|
√ | x | x | x | x | x | x |
OBJECT 參數說明
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
provider | String | 是 | 分享服務提供商(即weixin|qq|sinaweibo),通過 uni.getProvider 獲取可用的分享服務商,可用是指在manifest.json的sdk配置中配的分享sdk廠商,與本機安裝了什么社交App無關 |
type | Number | 否 | 分享形式,如圖文、純文字、純圖片、音樂、視頻、小程序等。默認圖文 0。不同分享服務商支持的形式不同,具體參考下面type值說明。 |
title | String | 否 | 分享內容的標題 |
scene | String | provider 為 weixin 時必選 | 場景,可取值參考下面說明。 |
summary | String | type 為 1 時必選 | 分享內容的摘要 |
href | String | type 為 0 時必選 | 跳轉鏈接 |
imageUrl | String | type 為 0、2、5 時必選 | 圖片地址。type為0時,推薦使用小於20Kb的圖片 |
mediaUrl | String | type 為 3、4 時必選 | 音視頻地址 |
miniProgram | Object | type 為 5 時必選 | 分享小程序必要參數 |
success | Function | 否 | 接口調用成功的回調 |
fail | Function | 否 | 接口調用失敗的回調函數 |
complete | Function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) |
type 值說明
值 | 說明 | provider 支持度 |
---|---|---|
0 | 圖文 | weixin、sinaweibo |
1 | 純文字 | weixin、qq |
2 | 純圖片 | weixin、qq |
3 | 音樂 | weixin、qq |
4 | 視頻 | weixin、sinaweibo |
5 | 小程序 | weixin |
scene 值說明
值 | 說明 |
---|---|
WXSceneSession | 分享到聊天界面 |
WXSenceTimeline | 分享到朋友圈 |
WXSceneFavorite | 分享到微信收藏 |
miniProgram 值說明
值 | 類型 | 說明 |
---|---|---|
id | String | 微信小程序原始id |
path | String | 點擊鏈接進入的頁面 |
type | Number | 微信小程序版本類型,可取值: 0-正式版; 1-測試版; 2-體驗版。 默認值為0。 |
webUrl | String | 兼容低版本的網頁鏈接 |
onShareAppMessage:function(){ return{ title: 'test', path: 'pages/index/index' } }