提交 8ca11a31 作者: yanfuxing

Merge branch 'release' into UnityTrunck_SDK

# UnitySDK 对接文档
# UnitySDK 对接文档
......@@ -4,9 +4,9 @@
刚开始拉取下来会有报错如下:
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/943a496b-0dec-422c-a7e7-075eefc8c8a3.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405362569255279f1d79.jpg)
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/bfa0c8bb-8e81-4df8-9d26-1d6e1e4510c3.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/1764054247692554e7cb827.jpg)
这是因为微信跟抖音小游戏在同一工程内,内置PlayerPrefs命名空间冲突,需要本地手动改下,打开报错的当前脚本,Ctrl+F,搜索当前脚本里面的PlayerPrefs,然后把PlayerPrefs替换成UnityEngine.PlayerPrefs 即可
......@@ -17,28 +17,28 @@
1. AndroidClass.cs 是实现安卓的回调接口,AndroidSdk 是unity层Sdk的桥接代码
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/d60627e1-c50f-443f-bc72-bbe28991eb19.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640542846925550c1be0f.jpg)
2.该文件夹存放安卓端的一些Sdk打包所需配置(包括拉取远端仓库等。)
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/dbf10ca6-f391-4e61-a1e5-9fedf04929bc.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405428869255510267db.jpg)
## 2.调用流程介绍
ps:可以先看下SDKExample.cs 里面包含了安卓、ios等调用
1. ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/c98ed441-633d-4e3b-ad80-1c1c20626efc.png),需要放到Awake里,最优先调用
1. ![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640542926925551490637.jpg),需要放到Awake里,最优先调用
2.调用![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/bf683ace-1e9a-4191-9105-b7b9901d4b9c.png) 这个是获取游戏配置,第一次会拉起隐私协议。
2.调用![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640542956925551776d02.jpg) 这个是获取游戏配置,第一次会拉起隐私协议。
3.SDKManager里包含了集成SDK的所有方法,里面有标注,集合方法是所有平台都有的方法,做了封装处理,因为有独有的方法,请注意甄别使用。
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/02f198c0-c69e-4881-9d1f-0d1a29ac161d.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640544076925558734b99.jpg)
4.回调处理,json的具体参数请查看安卓文档说明  ps: "status\_code" :1 成功回调,”status\_code“:0 失败回调
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/7ec356b4-a319-4dd1-8a60-b862fde3f42e.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/1764054803692557134ab93.jpg)
## 3.出包(空项目的情况下):
......@@ -55,28 +55,28 @@ ps:可以先看下SDKExample.cs 里面包含了安卓、ios等调用
1. IOSSdk 是unity层Sdk的代码,ZYouBridge.mm是桥接代码 通过Unity的\[DllImport("\_\_Internal")\] 来调用。
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/401c3d0a-3154-477d-9206-c7446da60b6f.png)![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/610d1096-ef58-4ef8-90b4-779880121795.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640544146925558e212e7.jpg)![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/1764054418692555920e3e8.jpg)
2.该文件夹存放ios的库和原生SDK文件,表格等
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/5f8c6af5-ca06-4f11-b084-e8f8e14fc9a8.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/1764054883692557632b205.jpg)
## 2.调用流程介绍
ps:可以先看下SDKExample.cs 里面包含了安卓、ios等调用
1. ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/c98ed441-633d-4e3b-ad80-1c1c20626efc.png),需要放到Awake里,最优先调用
1. ![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405488369255763299f4.jpg),需要放到Awake里,最优先调用
2.调用![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/bf683ace-1e9a-4191-9105-b7b9901d4b9c.png) 这个是获取游戏配置,第一次会拉起隐私协议。
2.调用![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405536769255947bd1ad.jpg) 这个是获取游戏配置,第一次会拉起隐私协议。
3.SDKManager里包含了集成SDK的所有方法,里面有标注,集合方法是所有平台都有的方法,做了封装处理,因为有独有的方法,请注意甄别使用。
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/02f198c0-c69e-4881-9d1f-0d1a29ac161d.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640548836925576329512.jpg)
4.回调处理,json的具体参数请查看ios文档说明 
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/ed9d0216-7af2-4bba-91bb-da4aa9c19395.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640548836925576300cae.jpg)
## 3.出包(空项目的情况下):
......@@ -98,53 +98,53 @@ Xcode相关配置:[iossdk\_appstore\_bridge对接说明文档.md · ios\_zlj
1. sdk.js原文件位置跟wxSdkBridge.js桥接代码位置如下,默认会被打进包里,wxSdkBridge.js文件的主要作用是封装sdk.js,C#层来调用
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/f3dd8535-ec35-40b3-a7f0-a85c79142364.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405488269255762e05d9.jpg)
2. C#跟js桥接文件位置如下,后续开发者层不用维护(做成统一 一套了),只用关心wxSdkBridge.js和C#回调层
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/0ae44e4c-f013-44d4-b08d-0c11f162a47f.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405488269255762d847f.jpg)
3. 小游戏(微信+抖音)统一回调处理类(**MiniGameSDKBridge.cs**),主要有两个方法,jsSdk成功返回的回调OnSuccessCallBack,失败返回的回调OnFailureCallBack
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/edc4f355-65e0-412c-8b8d-0209773e0df2.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405488269255762dfe5d.jpg)
## 2.调用流程介绍
1. 场景初始化统一都在**Launch.unity** 场景,所有按钮初始化都是通过Canvas上的SDKExample.cs脚本初始化(里面区分各个平台,启动的时候会自动初始化各个平台的调用触发按钮),如果有新增的方法,自己按照顺序自行绑定即可
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/41f37818-dcd6-4849-a507-139e5fe477e6.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405488269255762ee9c0.jpg)
2. 各个平台的调用管理,都通过**SDKManager.cs**进行统一分发处理,里面区分了宏定义,以初始化SDK为例子,外层按钮绑定调用只用关心InitSdk()方法即可,方法内部会进行各个平台的区分(具体可自行看代码)
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/de80c6ad-0411-445f-a251-4ffe1565205e.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405488269255762e593f.jpg)
## 3.出包
### 1.导出微信小游戏
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/ab66e1b8-c64b-4f17-b819-31e3a427dc63.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586ac18d1.jpg)
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/80086988-de5a-4f70-bc04-9ff273d86aa7.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586aa7443.jpg)
导出包文件:
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/917a37dd-72f4-4bd5-8e19-a216efd2133f.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586a86443.jpg)
### 2.导入微信小游戏开发者工具
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/1cc8f0b2-4a99-455a-85d1-badf5dd130d4.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586abcbf8.jpg)
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/98a632ef-39ed-482f-a313-f3b35eaa7118.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586a5c4ff.jpg)
1.   点击创建即可打开,如下所示,分别点击按钮(按钮名跟接入文档中的方法接口名字一致),Console面板中能成功显示回调回调成功即可,
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/9502bf33-a10d-4916-b38e-8761cf9a6c0f.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586aa0f89.jpg)
2. 如果需要处理回调成功之后的业务逻辑,可以在MiniGameSDKBridge.cs的回调成功方法OnSuccessCallBack中处理各个方法的回调,也可根据需求新增Case和逻辑处理方法,如下:
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/f59469b1-c885-4396-a900-3c5c06a0ec83.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586a6ade3.jpg)
# 4.抖音小游戏
......@@ -153,11 +153,11 @@ Xcode相关配置:[iossdk\_appstore\_bridge对接说明文档.md · ios\_zlj
1. dySdk.js原文件位置跟dySdkBridge.js桥接代码位置如下,默认会被打进包里,dySdkBridge.js文件的主要作用是封装sdk.js,C#层来调用
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/304f06fe-427e-4cbe-a744-c7f9834a6fe3.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586a1a811.jpg)
2.  C#跟js桥接文件位置如下,后续开发者层不用维护(做成统一 一套了),只用关心dySdkBridge.js和C#回调层,这个跟微信是一致的,不做过多赘述
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/823dd4b1-2cf2-4bf8-bc0a-861e35c2ef4b.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551456925586981c4f.jpg)
## 2.调用流程介绍
......@@ -167,23 +167,23 @@ Xcode相关配置:[iossdk\_appstore\_bridge对接说明文档.md · ios\_zlj
1. 导出抖音小游戏
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/70e994a0-c3fe-482f-84ae-c9ea4e4c1041.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405514569255869bc29f.jpg)
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/2c451bde-9d6f-4c6d-b0fb-031b576beb47.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/1764055145692558698e6ff.jpg)
最下层,选中开发者工具路径,然后点击构建webGL,构建成功之后,会自动弹出在开发者工具打开
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/feacf7de-882a-4e61-9972-4515e18ee82b.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/1764055145692558697fc76.jpg)
导出之后跟Unity Assets 平级目录会打出tt-minigame的文件夹
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/302bd804-b378-4002-876c-e5fbf3f097f9.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405514469255868bf8d2.jpg)
2. 抖音开发者工具运行,回调成功即可,
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/c3c07c5b-fed3-43e1-a9bc-0a111826bf5b.png)
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/17640551466925586a1d25d.jpg)
3.如果需要处理回调成功之后的业务逻辑,可以在MiniGameSDKBridge.cs的回调成功方法OnSuccessCallBack中处理各个方法的回调(已经做了平台区分),也可根据需求新增Case和逻辑处理方法,如下:
![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/4maOgXbm5g37mlWN/img/59239872-4243-4ddd-9b3d-4e99dff0baf9.png)
\ No newline at end of file
![image.png](https://zyouapk.zwnet.cn/zhangsheng/staging/image/wangeditor/176405514569255869497ef.jpg)
\ No newline at end of file
Markdown 格式
0%
您添加了 0 到此讨论。请谨慎行事。
请先完成此评论的编辑!
注册 或者 后发表评论