ShareSDK for Unity
创始人
2024-03-06 14:56:20

本文档使用Unity2019进行演示

下载unitypackage

从Mob的github地址下载ShareSDK.unitypackage:Git地址,如下图所示

)![image.png]//download.sdk.mob.com/2022/06/22/15/165588252810937.61.png)

下载完成后得到一个.unitypackage结尾的文件,如下图:

 

导入unitypackage

双击导入到unity项目中并勾选,如下图:

 

Demo.cs是demo的示例页面,可通用
Android (只需要勾选SSDKU3D.jar)
demokey.keystore:demo的打包签名文件
SSDKU3D.jar:java桥接层文件
iOS (全部勾选)
MOBTool:自动打包工具
ShareSDK:SDK必要的文件

 

按图选好之后,点击import导入

挂载ShareSDK.cs脚本文件

在unity界面左侧选择要使用的场景(例如Main Camera),点击Add Component 按钮添加ShareSDK.cs(ShareSDK核心文件),或者直接拖进去。如果要测试效果,也可以添加Demo.cs(ShareSDK示例UI),如下图所示:

 

挂接后会发现提供了当前支持的平台和及其配置信息,需要注意的是当前的编译环境是Android还是iOS,其字段名称是不同的哦!

修改编译环境

Platform设置,在unity中选择菜单栏-File-Build Settings,会打开Build Settings操作框,根据自己所编译的环境选择,如果是iOS的请选择iOS环境,如果是Android请选择Android环境,然后点击Switch Platform切换环境,如下图:

 

Android端集成编译配置

资源修改

1.把demokey.keystoreSSDKU3D.jar文件移动到上层目录下,也就从ShareSDK文件夹移动到Android文件夹;

2.删掉ShareSDK文件夹;

3.删掉Android目录下的baseProjectTemplate.gradlelauncherTemplate.gradle等文件;

 

最终Android目录下文件内容为下图:

 

修改Unity设置

生成Gradle文件

保持Build Settings操作框中左侧Platform列表Android项的选中状态,点击Player Settings,会打开Project Settings操作框,如下图:

左侧切换到Player标签,然后在右侧选择Publishing Settings卡片,勾选Custom Launcher Gradle TemplateCustom Base Gradle Template选项,如下图:

 

该操作会在"工程\Assets\Plugins\Android目录下"生成baseProjectTemplate.gradle、launcherTemplate.gradle文件。

修改gradle文件

修改baseProjectTemplate.gradle文件

打开baseProjectTemplate.gradle文件后有两处需要操作:

1.在classpath 'com.android.tools.build:gradle'后添加mob的classpath

classpath "com.mob.sdk:MobSDK:2018.0319.1724"

2.添加mob自己的maven仓库

maven {    url "https://mvn.mob.com/android/"}

最终baseProjectTemplate.gradle文件的参考结果为:

 

修改launcherTemplate.gradle文件

打开launcherTemplate.gradle,在文件的最下方加入以下代码:

apply plugin: 'com.mob.sdk'MobSDK {appKey "moba0b0c0d0"appSecret "5713f0d88511f9f4cf100cade0610a34"spEdition "fp"ShareSDK {devInfo {Wechat {appId "wx4868b35061f87885"appSecret "64020361b8ec4c99936c0e3999a9f249"withShareTicket truebypassApproval falseenable true}}}
}

这里的配置和Android原生配置无异,可参考Mob官方链接

配置签名文件

1.菜单打开Build Settings,左侧Platform列表选Android,点击Player Settings,在打开的Project Settings操作框中,左侧选择Player标签,右侧选择Publishing Settings卡片;

2.勾选Project Keystore下的Custom Key store;

3.点击Project Keystore下的Select选择一个keystore文件;

4.填写Project Keystore下的Password;

5.如Project Keystore下的Password填写正确,则Project Key下的Alias下拉框亮起,选择自己的别名;

6.填写Project Key下的Password;

iOS端编译配置

默认所有平台都已经初始化,客户需要做的操作:

修改初始化我们SDK的AppKey和AppSecret

配置您自己的ShareSDK的AppKey和AppSecret (获取可以点击查看注册流程

public class ShareSDK : MonoBehaviour {private int reqID;#elif UNITY_IPHONEpublic string appKey = "3276d3e413040";public string appSecret = "4280a3a6df667cfce37528dec03fd9c3";public string mobNetLater = "2";public List<string> customAssociatedDomains = new List<string>();#endif'''  '''}

修改第三方社交平台初始化信息配置

可以找到ShareSDKDevInfo.cs文件,进行修改。配置所需的平台信息

选择所需要的平台,不想要的可以直接注释或删掉

public class DevInfoSet{public SinaWeiboDevInfo sinaweibo;public WeChat wechat;public QQ qq;public QZone qzone;}

配置对应平台的信息(直接修改字符串值即可),例如微信平台修改

public class WeChat : DevInfo {#if UNITY_ANDROIDpublic string SortId = "5";public const int type = (int) PlatformType.WeChat;public string AppId = "wx4868b35061f87885";public string AppSecret = "64020361b8ec4c99936c0e3999a9f249";public string UserName = "gh_afb25ac019c9@app";public string Path = "/page/API/pages/share/share";public bool BypassApproval = false;public bool WithShareTicket = true;public string MiniprogramType = "0";#elif UNITY_IPHONEpublic const int type = (int) PlatformType.WeChat;public string app_id = "wx617c77c82218ea2c";public string app_secret = "c7253e5289986cf4c4c74d1ccc185fb1";public string app_universalLink = "https://70imc.share2dlink.com/";#endif}[Serializable]public class WeChatMoments : DevInfo {#if UNITY_ANDROIDpublic string SortId = "6";public const int type = (int) PlatformType.WeChatMoments;public string AppId = "wx4868b35061f87885";public string AppSecret = "64020361b8ec4c99936c0e3999a9f249";public bool BypassApproval = true;#elif UNITY_IPHONEpublic const int type = (int) PlatformType.WeChatMoments;public string app_id = "wx617c77c82218ea2c";public string app_secret = "c7253e5289986cf4c4c74d1ccc185fb1";public string app_universalLink = "https://70imc.share2dlink.com/";#endif}[Serializable]public class WeChatFavorites : DevInfo {#if UNITY_ANDROIDpublic string SortId = "7";public const int type = (int) PlatformType.WeChatFavorites;public string AppId = "wx4868b35061f87885";public string AppSecret = "64020361b8ec4c99936c0e3999a9f249";#elif UNITY_IPHONEpublic const int type = (int) PlatformType.WeChatFavorites;public string app_id = "wx617c77c82218ea2c";public string app_secret = "c7253e5289986cf4c4c74d1ccc185fb1";public string app_universalLink = "https://70imc.share2dlink.com/";#endif}public class WechatSeries : DevInfo {#if UNITY_ANDROID//for android,please set the configuraion in class "Wechat" ,class "WechatMoments" or class "WechatFavorite"//对于安卓端,请在类Wechat,WechatMoments或WechatFavorite中配置相关信息↑#elif UNITY_IPHONEpublic const int type = (int) PlatformType.WechatPlatform;public string app_id = "wx617c77c82218ea2c";public string app_secret = "c7253e5289986cf4c4c74d1ccc185fb1";public string app_universalLink = "https://70imc.share2dlink.com/";#endif}

确定文件里修改了AppKey等信息之后,要去挂载脚本那边同步看下AppKey是否修改,可以点击Reset,刷新,同步下修改后的信息,也可以自己直接在挂载脚本里面改,最后要确定脚本文件里和挂载脚本里都已经改为了自己的信息

 

 

接口调用

回传用户隐私授权结果(submitPolicyGrantResult)

调用示例

传入的第一个参数为Boolean类型的,true 代表同意授权、false代表不同意授权

mobsdk.submitPolicyGrantResult(true);

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

分享(ShowPlatformList)

首先引入命名空间:

using cn.sharesdk.unity3d;
public ShareSDK ssdk;

构造分享信息

ShareContent content = new ShareContent();content.SetText("this is a test string.");content.SetImageUrl("https://f1.webshare.mob.com/code/demo/img/1.jpg");content.SetTitle("test title");content.SetTitleUrl("http://www.mob.com");content.SetSite("Mob-ShareSDK");content.SetSiteUrl("http://www.mob.com");content.SetUrl("http://www.mob.com");content.SetComment("test description");content.SetMusicUrl("http://mp3.mwap8.com/destdir/Music/2009/20090601/ZuiXuanMinZuFeng20090601119.mp3");content.SetShareType(ContentType.Webpage);

常用的几个传参数方法说明(不常用的方法请看Assets/Plugins/ShareSDK/ShareContent.cs脚本):

Text :分享的文字

Title: 分享的标题

TitleUrl :标题的网络链接(QQ和QQ空间使用 )

SetImageUrl :iOS平台,本地以及网络图片都使用此方法

image:android平台分享本地图片与网络图片都用此方法

Url: 分享的链接(微信,微博,易信,Facebook等平台)

ShareType:分享类型(微信,易信)

FilePath:分享文件路径 (微信,易信)

MusicUrl :分享的音乐链接(微信,QQ,易信)

设置分享回调

ssdk.shareHandler = ShareResultHandler;//以下为回调的定义:void ShareResultHandler (int reqID, ResponseState state, PlatformType type, Hashtable result){if (state == ResponseState.Success){print ("share result :");print (MiniJSON.jsonEncode(result));}else if (state == ResponseState.Fail){print ("fail! throwable stack = " + result["stack"] + "; error msg = " + result["msg"]);}else if (state == ResponseState.Cancel) {print ("cancel !");}}

进行分享

//通过分享菜单分享
ssdk.ShowPlatformList (null, content, 100, 100);
//直接通过编辑界面分享
ssdk.ShowShareContentEditor (PlatformType.SinaWeibo, content);
//直接分享
ssdk.ShareContent (PlatformType.SinaWeibo, content);

授权(Authorize)

(每次都会跳转到第三方平台进行授权)

设置授权回调

ssdk.authHandler = AuthResultHandler;
//以下为回调的定义:
void AuthResultHandler(int reqID, ResponseState state, PlatformType type, Hashtable result)
{if (state == ResponseState.Success){print ("authorize success !");}else if (state == ResponseState.Fail){print ("fail! throwable stack = " + result["stack"] + "; error msg = " + result["msg"]);}else if (state == ResponseState.Cancel) {print ("cancel !");}
}

进行授权

ssdk.Authorize(PlatformType.SinaWeibo);

获取用户信息(GetUserInfo)

(只会在第一次跳转到第三方平台进行授权)

指定获取用户信息的回调

sdk.showUserHandler = GetUserInfoResultHandler;
//以下为回调的定义:
void GetUserInfoResultHandler (int reqID, ResponseState state, PlatformType type, Hashtable result)
{if (state == ResponseState.Success){print ("get user info result :");print (MiniJSON.jsonEncode(result));}else if (state == ResponseState.Fail){print ("fail! throwable stack = " + result["stack"] + "; error msg = " + result["msg"]);}else if (state == ResponseState.Cancel) {print ("cancel !");}
}

获取用户信息

ssdk.GetUserInfo(PlatformType.SinaWeibo);

注意:auth和getuser接口都可以实现授权登录功能,可以任意调用一个

打包使用

进行上述所有修改后,已经可以执行打包操作。

如集成过程中遇到问题,可详询MobTech技术支持,点击立即QQ咨询

相关内容

热门资讯

猫咪吃了塑料袋怎么办 猫咪误食... 你知道吗?塑料袋放久了会长猫哦!要说猫咪对塑料袋的喜爱程度完完全全可以媲美纸箱家里只要一有塑料袋的响...
埃菲尔铁塔在哪 中国仿建埃菲尔... 2019年4月26日,广西南宁市,街头惊现一座巨型山寨版埃菲尔铁塔,高约20米,白色塔身,造型逼真,...
苗族的传统节日 贵州苗族节日有... 【岜沙苗族芦笙节】岜沙,苗语叫“分送”,距从江县城7.5公里,是世界上最崇拜树木并以树为神的枪手部落...
北京的名胜古迹 北京最著名的景... 北京从元代开始,逐渐走上帝国首都的道路,先是成为大辽朝五大首都之一的南京城,随着金灭辽,金代从海陵王...
世界上最漂亮的人 世界上最漂亮... 此前在某网上,选出了全球265万颜值姣好的女性。从这些数量庞大的女性群体中,人们投票选出了心目中最美...
应用未安装解决办法 平板应用未... ---IT小技术,每天Get一个小技能!一、前言描述苹果IPad2居然不能安装怎么办?与此IPad不...
长白山自助游攻略 吉林长白山游... 昨天介绍了西坡的景点详细请看链接:一个人的旅行,据说能看到长白山天池全凭运气,您的运气如何?今日介绍...
脚上的穴位图 脚面经络图对应的... 人体穴位作用图解大全更清晰直观的标注了各个人体穴位的作用,包括头部穴位图、胸部穴位图、背部穴位图、胳...
demo什么意思 demo版本... 618快到了,各位的小金库大概也在准备开闸放水了吧。没有小金库的,也该向老婆撒娇卖萌服个软了,一切只...
埃菲尔铁塔在哪 中国仿建埃菲尔... 2019年4月26日,广西南宁市,街头惊现一座巨型山寨版埃菲尔铁塔,高约20米,白色塔身,造型逼真,...
苗族的传统节日 贵州苗族节日有... 【岜沙苗族芦笙节】岜沙,苗语叫“分送”,距从江县城7.5公里,是世界上最崇拜树木并以树为神的枪手部落...
北京的名胜古迹 北京最著名的景... 北京从元代开始,逐渐走上帝国首都的道路,先是成为大辽朝五大首都之一的南京城,随着金灭辽,金代从海陵王...
应用未安装解决办法 平板应用未... ---IT小技术,每天Get一个小技能!一、前言描述苹果IPad2居然不能安装怎么办?与此IPad不...