uni-app 分享（十二）

uni.share(OBJECT)

分享。

平台支持

• 5+App

OBJECT 参数说明

参数名	类型	必填	说明
provider	String	是	分享服务提供商，通过 uni.getProvider 获取，如果不设置则弹出分享列表选择界面。
type	Number	否	分享类型。默认图文 0，更多值参考下面说明。
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 值说明

值	说明
0	图文
1	纯文字
2	纯图片
3	音乐
4	视频
5	小程序

scene 值说明

值	说明
WXSceneSession	分享到聊天界面
WXSenceTimeline	分享到朋友圈
WXSceneFavorite	分享到微信收藏

miniProgram 值说明

值	类型	说明
id	String	微信小程序原始id
path	String	点击链接进入的页面
type	Number	微信小程序版本类型，可取值： 0-正式版； 1-测试版； 2-体验版。 默认值为0。
webUrl	String	兼容低版本的网页链接

Tips:

• 仅支持分享小程序到微信聊天界面
• 分享到QQ必须含有href链接
• 分享文字到QQ时，title必选
• 新浪微博仅支持分享本地音视频
• 在ios端，若未安装微博客户端，则不能分享图片
• 分享新浪微博不会返回正确的成功回调

分享到微信聊天界面

分享文字

uni.share({
    provider: "weixin",
    scene: "WXSceneSession",
    type: 1,
    summary: "我正在使用HBuilderX开发uni-app，赶紧跟我一起来体验！",
    success: function (res) {
        console.log("success:" + JSON.stringify(res));
    },
    fail: function (err) {
        console.log("fail:" + JSON.stringify(err));
    }
});

分享图片

uni.share({
    provider: "weixin",
    scene: "WXSceneSession",
    type: 2,
    imageUrl: "https://img-cdn-qiniu.dcloud.net.cn/uniapp/images/[email protected]",
    success: function (res) {
        console.log("success:" + JSON.stringify(res));
    },
    fail: function (err) {
        console.log("fail:" + JSON.stringify(err));
    }
});

分享图文

href、imageUrl 为必选参数，title/summary 二选一，最好将这四个参数都选上。

uni.share({
    provider: "weixin",
    scene: "WXSceneSession",
    type: 0,
    href: "http://uniapp.dcloud.io/",
    title: "uni-app分享",
    summary: "我正在使用HBuilderX开发uni-app，赶紧跟我一起来体验！",
    imageUrl: "https://img-cdn-qiniu.dcloud.net.cn/uniapp/images/[email protected]",
    success: function (res) {
        console.log("success:" + JSON.stringify(res));
    },
    fail: function (err) {
        console.log("fail:" + JSON.stringify(err));
    }
});

分享到微信朋友圈

分享文字

uni.share({
    provider: "weixin",
    scene: "WXSenceTimeline",
    type: 1,
    summary: "我正在使用HBuilderX开发uni-app，赶紧跟我一起来体验！",
    success: function (res) {
        console.log("success:" + JSON.stringify(res));
    },
    fail: function (err) {
        console.log("fail:" + JSON.stringify(err));
    }
});

分享图片

uni.share({
    provider: "weixin",
    scene: "WXSenceTimeline",
    type: 2,
    imageUrl: "https://img-cdn-qiniu.dcloud.net.cn/uniapp/images/[email protected]",
    success: function (res) {
        console.log("success:" + JSON.stringify(res));
    },
    fail: function (err) {
        console.log("fail:" + JSON.stringify(err));
    }
});

分享图文

href、imageUrl 为必选参数，title、summary 至少有一项。

uni.share({
    provider: "weixin",
    scene: "WXSenceTimeline",
    type: 0,
    href: "http://uniapp.dcloud.io/",
    title: "uni-app分享",
    summary: "我正在使用HBuilderX开发uni-app，赶紧跟我一起来体验！",
    imageUrl: "https://img-cdn-qiniu.dcloud.net.cn/uniapp/images/[email protected]",
    success: function (res) {
        console.log("success:" + JSON.stringify(res));
    },
    fail: function (err) {
        console.log("fail:" + JSON.stringify(err));
    }
});

分享到小程序

uni.share({
    provider: 'weixin',
    type: 5,
    imageUrl: 'https://img-cdn-qiniu.dcloud.net.cn/uniapp/app/[email protected]',
    title: '欢迎体验uniapp',
    miniProgram: {
        id: 'gh_abcdefg',
        path: 'pages/index/index',
        type: 0,
        webUrl: 'http://uniapp.dcloud.io'
    },
    success: ret => {
        console.log(JSON.stringify(ret));
    }
});

官网原文地址