第三方分享

接口声明

在manifest.json文件的 features属性中增加如下配置。

{
    "name": "service.share"
    "params":{
    }
}

导入模块

在调用接口页面的<script>部分增加如下配置。

import share from '@service.share'

或

var share = require("@service.share")

使用限制

接口定义

share.getProvider(OBJECT)

描述

获取服务提供商，如厂商的英文品牌名称。

返回值

字符串，服务提供商的代号，如厂商的英文品牌名称，如果无此服务则返回空字符串。返回空字符串时，请勿调用该服务其他接口，否则将抛出异常。

示例代码

share.getProvider();

share.share(OBJECT)

描述

分享内容。

OBJECT参数

示例代码

share.share({
    shareType:0,
    title:"我是标题",
    summary:"我是摘要",
    imagePath:"xxx/xxx/xxx/share.jpg",
    targetUrl:"https://www.example.com",
    success:function() {
        console.log(“message”);
    },
    fail: function(data, code) {
        console.log("handling fail, code=" + code);
    }
})

share.getAvailablePlatforms(OBJECT)（1030+）

描述

获取当前可用的支持分享的平台列表。

OBJECT参数

success返回值：

示例代码

share.getAvailablePlatforms({
    success:function(data) {
        For(const i in data.platforms) {
             console.log(“platforms: ” + data.platforms[i]);
        }
    },
    Fail:function(data, code) {
         console.log(“handling fail, code = ” + code);
    }
})

Demo

<template>
    <div>
        <div>
            <text>{{interface}}</text>
        </div>
        <div class="btn-wrap-column ">
        <input type="button" value="设置分享的SD卡图片" onclick="pickSDPhoto" />
            <input type="button" value="设置分享的应用内部图片" onclick="pickDataPhoto" />
            <input type="button" value="设置分享的网络图片" onclick="pickNetPhoto" />
            <input type="button" value="服务提供商" onclick="getProvider" />
            <input type="button" value="可分享平台列表" onclick="getAvailablePlatforms" />
            <input type="button" value="微信好友分享" onclick="wxFriendShare" />
            <input type="button" value="微信朋友圈分享" onclick="wxCircleShare" />
            <input type="button" value="系统分享" onclick="systemShare" />
            <input type="button" value="多平台分享" onclick="morePlatforms" />
            <input type="button" value="全平台分享" onclick="allPlatforms" />
        </div>
    </div>
</template>
<style>
    @import '../Common/css/common.css';
    .item-container {
        margin-bottom: 50px;
        margin-right: 60px;
        margin-left: 60px;
        justify-content: center;
    }
    .item-title {
        padding-left: 30px;
        padding-bottom: 20px;
    }
    .item-content {
        height: 300px;
        justify-content: center;
    }
    .btn-wrap-column {
        margin-left: 60px;
        flex-direction: column;
    }
</style>
<script>
    import share from '@service.share'
    import media from '@system.media'
    import prompt from '@system.prompt'
    export default {
        data: {
            interface: "第三方分享",
            //默认是本地应用内部图片
            photoUri: '/Common/logo.png'
        },
        onInit() {
            this.$page.setTitleBar({ text: 'service_share' })
        },
        getProvider: function () {
            prompt.showToast({
                message: 'message provider ：' + share.getProvider(),
                duration: 0
            })
        },
        getAvailablePlatforms: function () {
            share.getAvailablePlatforms({
                success: function (data) {
                    for (const i in data.platforms) {
                        console.log("share platforms: " + data.platforms[i]);
                    }
                },
                fail: function (data, code) {
                    console.log("handling fail, code = " + code);
                }
            })
        },
        wxFriendShare: function () {
            share.share({
                shareType: 2,
                title: '微信的标题',
                summary: '微信的摘要',
                imagePath: this.photoUri,
                targetUrl: 'https://www.baidu.com/',
                mediaUrl: 'https://ss0.bdstatic.com/-0U0bnSm1A5BphGlnYG/cae-legoup-video-target/93be3d88-9fc2-4fbd-bd14-833bca731ca7.mp4',
                platforms: ["WEIXIN"],
                fail: function (data, code) {
                    prompt.showToast({
                        message: 'message fail message ：' + data + " code " + code,
                        duration: 0
                    })
                },
                cancel: function () {
                    prompt.showToast({
                        message: 'message cancel ：',
                        duration: 0
                    })
                }
            })
        },
        wxCircleShare: function () {
            share.share({
                shareType: 4,
                title: '微信朋友圈的标题',
                summary: '微信朋友圈的摘要',
                imagePath: this.photoUri,
                targetUrl: 'https://www.baidu.com/',
                mediaUrl: 'https://ss0.bdstatic.com/-0U0bnSm1A5BphGlnYG/cae-legoup-video-target/93be3d88-9fc2-4fbd-bd14-833bca731ca7.mp4',
                platforms: ["WEIXIN_CIRCLE"],
                fail: function (data, code) {
                    prompt.showToast({
                        message: 'message fail message ：' + data + " code " + code,
                        duration: 0
                    })
                },
                cancel: function () {
                    prompt.showToast({
                        message: 'message cancel ：',
                        duration: 0
                    })
                }
            })
        },        
        systemShare: function () {
            share.share({
                shareType: 4,
                title: '系统的标题',
                summary: '系统的摘要',
                imagePath: this.photoUri,
                targetUrl: 'https://www.baidu.com/',
                mediaUrl: 'https://ss0.bdstatic.com/-0U0bnSm1A5BphGlnYG/cae-legoup-video-target/93be3d88-9fc2-4fbd-bd14-833bca731ca7.mp4',
                platforms: ["SYSTEM"],
                fail: function (data, code) {
                    prompt.showToast({
                        message: 'message fail message ：' + data + " code " + code,
                        duration: 0
                    })
                },
                cancel: function () {
                    prompt.showToast({
                        message: 'message cancel ：',
                        duration: 0
                    })
                }
            })
        },
        morePlatforms: function () {
            share.share({
                shareType: 4,
                title: '多平台的标题',
                summary: '多平台的摘要',
                imagePath: this.photoUri,
                targetUrl: 'https://www.baidu.com/',
                mediaUrl: 'https://ss0.bdstatic.com/-0U0bnSm1A5BphGlnYG/cae-legoup-video-target/93be3d88-9fc2-4fbd-bd14-833bca731ca7.mp4',
                platforms: ["WEIXIN", "WEIBO", "SYSTEM"],
                fail: function (data, code) {
                    prompt.showToast({
                        message: 'message fail message ：' + data + " code " + code,
                        duration: 0
                    })
                },
                cancel: function () {
                    prompt.showToast({
                        message: 'message cancel ：',
                        duration: 0
                    })
                }
            })
        },
        allPlatforms: function () {
            share.share({
                shareType: 4,
                title: '全平台的标题',
                summary: '全平台的摘要',
                imagePath: this.photoUri,
                targetUrl: 'https://www.baidu.com/',
                mediaUrl: 'https://ss0.bdstatic.com/-0U0bnSm1A5BphGlnYG/cae-legoup-video-target/93be3d88-9fc2-4fbd-bd14-833bca731ca7.mp4',
                platforms: "",
                fail: function (data, code) {
                    prompt.showToast({
                        message: 'message fail message ：' + data + " code " + code,
                        duration: 0
                    })
                },
                cancel: function () {
                    prompt.showToast({
                        message: 'message cancel ：',
                        duration: 0
                    })
                }
            })
        },
        pickSDPhoto: function () {
            var that = this;
            media.pickImage({
                success: function (ret) {
                    that.photoUri = ret.uri;
                },
                fail: function (erromsg, errocode) {
                    prompt.showToast({ message: "pickImage fail------" + errocode + ': ' + erromsg })
                    console.log('media.pickImage----------' + errocode + ': ' + erromsg)
                },
                cancel: function () {
                    console.log('media.pickImage----------cancel')
                },
                complete: function () {
                    console.log('media.pickImage----------complete')
                }
            })
        },
        pickDataPhoto: function () {
            var that = this;
            that.photoUri = '/Common/logo.png';
        },
        pickNetPhoto: function () {
            var that = this;
            that.photoUri = 'https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1542175176&di=948a7a2a8cec225c82741c773fcd8e64&imgtype=jpg&er=1&src=http%3A%2F%2Fpic9.nipic.com%2F20100813%2F3525627_135840092720_2.jpg';
        }
    }
</script>

版本更新说明

相关链接

FAQ

• 调用接口，提示“ilmess=null featureparmas of serviceshare code=200”，如何处理？
• 使用系统分享接口在微信上进行分享，为什么发起分享的手机与接收分享的手机内容不一样？发起分享的手机内容显示为超链接，但是接收的手机显示的是<a>标签。
• 第三方分享接口调用报错，提示“data: support sdk share code 203”，如何处理？

案例

• 如何获取微信分享链接中携带的数据
• 使用微信分享大图报错