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' } }
