ShareSDK Uni-app 插件

准备
下载开发工具HBuilderX

准备uniapp项目
如果没有已经创建好的项目,可以自行创建新的项目

ShareSDK Uni-app 插件_第1张图片

之后选择新建uni-app项目。打开HBuildX的文件->导入->本地项目导入创建的文件夹->创建。

ShareSDK Uni-app 插件_第2张图片

插件集成

本地插件集成
[下载离线插件
](https://ext.dcloud.net.cn/plu...)
ShareSDK Uni-app 插件_第3张图片

将下载好的插件放在项目的nativeplugins文件夹中。(若没有则创建此目录) 目录结构如下:

ShareSDK Uni-app 插件_第4张图片

之后在uniapp的“manifest.json”中选择“app原生插件配置”,点击选择本地插件,如图:

ShareSDK Uni-app 插件_第5张图片

云端插件集成

在uniapp的“manifest.json”中选择“app原生插件配置”,点击选择云端插件,如图:

ShareSDK Uni-app 插件_第6张图片

注意:本地插件和云端插件可以任选一样配置,区别在于本地插件存放到工程nativeplugins目录下的原生插件,适用于未发布到插件市场的私有原生插件进行云打包,云端插件是已经在插件市场购买或绑定试用的插件,无需下载插件到工程中,云打包时会直接合并打包原生插件到App中。不过我们提供的插件是免费的哦!
iOS平台相关配置
配置初始化信息和URL SCheme
在“app原生插件配置”中添加MobTech平台注册的MOBAppKey和MOBAppSecret,如何得到这2个参数,请参考这个流程。以及微信、QQ、新浪、Facebook、Twitter等平台的注册平台信息。各平台注册地址,请点击 这里
ShareSDK Uni-app 插件_第7张图片

并在“app常用其他设置”中的“iOS设置”中填写URL Scheme,以及白名单等信息,具体每个平台如何配置,请参考 原生文档配置Xcode项目这块

ShareSDK Uni-app 插件_第8张图片

配置平台的Universal Link

微信以及qq要求用户在新版SDK中填写universalLink,所以需要在应用中配置通用链接,需要在manifest.json的源码视图添"app-plus"->"distribute"->"ios"下,添加如下代码:

ShareSDK Uni-app 插件_第9张图片

Android平台相关配置

注意:安卓端只支持本地依赖方式导入

添加依赖

  1. 在uniapp插件市场找到ShareSDK插件,点击下载for离线打包

ShareSDK Uni-app 插件_第10张图片

2.解压到uni-app应用的nativeplugins目录中
具体参考:https://ask.dcloud.net.cn/art...,完成后如下图:

ShareSDK Uni-app 插件_第11张图片

配置分享平台信息

配置ShareSDK.xml文件
在项目中mob-sharesdk/android下新建assets目录,在新创建的assets目录中创建名为ShareSDK.xml的文件,如下图:

ShareSDK.xml文件内容示例为:

其中各平台的appkey等信息仅为demo示例,正式使用请替换为自己在分享授权平台申请的

























































配置manifest.json
选择manifest.json文件中的App原生插件配置,添加本地插件或云端插件mob-sharesdk,分别填写Mob-AppKey、Mob-AppSecret、QQ-AppId、Facebook-AppKey、Line-CallBackScheme,其中Mob-AppKey、Mob-AppSecret为必填,其余三项可按需填写。

ShareSDK Uni-app 插件_第12张图片

接口调用

编写相关代码
在index.vue中编写代码,包括页面和点击方法。

ShareSDK Uni-app 插件_第13张图片

引入模块(必要)

const modal = uni.requireNativePlugin('modal');
const pluginMobShare = uni.requireNativePlugin('mob-sharesdk');

ShareSDK功能接口
submitPrivacyGrantResult()回传隐私授权状态
例子调用:

//回传用户授权结果
            //isurl参数如果传入字符串‘true’则表示接受隐私协议
            submitPrivacyGrantResult() {
                pluginMobShare.submitPrivacyGrantResult({
                    isUrl: 'true',
                    mobAppkey: 'moba0b0c0d0',
                    mobSecret: '5713f0d88511f9f4cf100cade0610a34',
                }, result => {
                    const msg = JSON.stringify(result);
                    modal.toast({
                        message: msg,
                        duration: 2 ,
                    });
                });
            },

注意:该接口必须接入,否则可能造成无法使用MobTech各SDK提供的相关服务。
generalShare() 直接分享方法接口

可传参数说明:
String PLATNAME = "platName";          //平台名
 String MOB_APPKEY = "mobAppkey";       //MobSDK的appkey
 String MOB_SECRET = "mobSecret";       //MobSDK的appSecret
 String PLAT_APPKEY = "platAppkey";     //平台的appkey
 String PLAT_APPSECRET = "platAppSecret";//平台的appsecret
 String PLAT_REDIRECTURL = "platRedirectUrl";//平台的回掉地址

 String PLAT_SHAREBYAPPCLIENT = "platShareByAppClient";//平台的是否通过客户端分享
 String PLAT_BYPASSAPPROVAL = "platBypassApproval";//平台的是否绕过审核

 String TEXT = "text"; //文本
 String TITLE = "title"; //标题
 String URL = "url";//链接地址
 String IMAGE_URL = "imageUrl";//网络图片地址
 SHARETYPE = "shareType";//分享类型
 String TITLE_URL = "titleUrl";//QQ平台需要的参数
 String IMAGE_PATH = "imagePath";//本地图片地址
 String MUSIC_URL = "musicUrl";//音乐链接地址
 String SITE = "site";//QQ需要的参数
 SITE_URL = "siteUrl";//QQ需要的参数
 FILE_PATH = "filePath";//文件本地路径

返回类型

//state : number类型 状态 1、成功,2、失败,3、取消
//userData:对象类型, 用户信息
//contentEtitiy: 对象类型, 内容实体
//error:对象类型,错误信息
{
state: 1 
userData:{}
contentEtitiy:{}
error:{}
}

例子调用:

mobShareWebpage() {
                    pluginMobShare.generalShare({
                    platName: SSDKPlatformID.WeChat,
                    params: {
                        text: 'text',
                        title: "title",
                        imageUrl: "http://img1.2345.com/duoteimg/qqTxImg/2012/04/09/13339485237265.jpg",
                        url: "http://m.93lj.com/sharelink?mobid=ziqMNf",
                    },
                    shareType: SSDKContentType.WebPage,
                }, result => {

                    const modal = uni.requireNativePlugin('modal');
                    const msg = JSON.stringify(result);
                    modal.toast({
                        message: msg,
                        duration: 1.5
                    });

                });
            }

authorize()授权方法接口

参数说明:platName: 平台号
mobAppkey: 申请的MobSDK的appkey
mobSecret: 申请的MobSDK的secret

iOS返回:

//state : number类型 状态 1、成功,2、失败,3、取消
//userData:对象类型, 用户信息
//error:对象类型,错误信息
{
state: 1 
userData:{}
error:{}
}

例子调用

mobAuthorize() {
                pluginMobShare.authorize({
                    platName: '24',
                    mobAppkey: 'moba0b0c0d0',
                    mobSecret: '5713f0d88511f9f4cf100cade0610a34',
                }, result => {
                    const msg = JSON.stringify(result);
                    modal.toast({
                        message: msg,
                        duration: 2 ,
                    });

                });
                    switch (result.type) {
                        case 'onComplete':
                            console.log("callback---onComplete--" + result.onCompleteResult);
                            break;
                        case 'onError':
                            console.log("callback---onError--" + result.onErrorResult);
                            break;
                        case 'onCancel':
                            console.log("callback---onCancel--");
                            break;
                }
            }

cancelauthorize() 取消授权

参数说明:
platName: 平台号
mobAppkey: 申请的MobSDK的appkey
mobSecret: 申请的MobSDK的secret

返回类型:

//error:取消授权失败返回信息
{
error:{}
}

例子调用

mobCancelAuthorize() {
                pluginMobShare.cancelauthorize({
                    platName: '24',
                    mobAppkey: 'moba0b0c0d0',
                    mobSecret: '5713f0d88511f9f4cf100cade0610a34',
                }, result => {
                    const msg = JSON.stringify(result);
                    modal.toast({
                        message: msg,
                        duration: 2 ,
                    });

                });
                    switch (result.type) {
                        case 'onComplete':
                            console.log("callback---onComplete--" + result.onCompleteResult);
                            break;
                        case 'onError':
                            console.log("callback---onError--" + result.onErrorResult);
                            break;
                }
            }

getUserInfo() 获取用户信息

参数说明:
platName: 平台号
mobAppkey: 申请的MobSDK的appkey
mobSecret: 申请的MobSDK的secret
返回参数
//state : number类型 状态 1、成功,2、失败,3、取消
//userData:对象类型, 用户信息
//error:对象类型,错误信息
{
state: 1 
userData:{}
error:{}
}

例子调用

mobgetUserInfo() {
                pluginMobShare.getUserInfo({
                    platName: '24',
                    mobAppkey: 'moba0b0c0d0',
                    mobSecret: '5713f0d88511f9f4cf100cade0610a34',
                }, result => {
                    const msg = JSON.stringify(result);
                    modal.toast({
                        message: msg,
                        duration: 2 ,
                    });

                });
                    switch (result.type) {
                        case 'onComplete':
                            console.log("callback---onComplete--" + result.onCompleteResult);
                            break;
                        case 'onError':
                            console.log("callback---onError--" + result.onErrorResult);
                            break;
                        case 'onCancel':
                            console.log("callback---onCancel--");
                            break;
                }
            }

调试

将插件放入uniapp项目中调试
打自定义基座

ShareSDK Uni-app 插件_第14张图片

将证书等信息添加进去,等待云打包完成后
ShareSDK Uni-app 插件_第15张图片
ShareSDK Uni-app 插件_第16张图片

选中自定义基座,运行这个项目,进行调试
自此,整个流程就走完了。如有问题,可以联系官方技术支持QQ:4006852216
备注:关于参数platName平台号对照表

SinaWeibo 1
TencentWeibo 2
Douban 5
QZone 6
Renren 7
KaiXin 8
Facebook 10
Twitter 11
Evernote 12
FourSquare 13
GooglePlus 14
Instagram 15
LinkedIn 16
Tumblr 17
Email 18
Wechat 22
WechatMoments 23
QQ 24
Instapaper 25
Pocket 26
YouDao 27
Pinterest 30
Flickr 34
Dropbox 35
VKontakte 36
WechatFavorite 37
Yixin 38
YixinMoments 39
Mingdao 41
Line 42
WhatsApp 43
KakaoTalk 44
KakaoStory 45
FacebookMessenger 46
Bluetooth 48
Alipay 50
AlipayMoments 51
Dingding 52
Youtube 53
Meipai 54
Cmcc 55
Reddit 56
Telecom 57
Douyin 58
Accountkit 59
备注:关于参数SHARETYPE平台号对照表

Auto 0
Text 1
Image 2
Webpage 3
App 4
Audio 5
Video 6
File 7

你可能感兴趣的