1

小川费
1 parent 6a23c5db
Showing 17 changed files with 50 additions and 50 deletions Show diff stats
images/sdk_021.png
images/sdk_022.png
images/sdk_023.png
images/sdk_024.png
images/sdk_025.png
images/sdk_026.png
images/sdk_027_1.png
images/sdk_027_2.png
images/sdk_027_3.png
images/sdk_027_4.png
images/sdk_028.png
images/sdk_029.png
images/sdk_030.png
images/sdk_031.png
images/sdk_032.png
install.md
platform.md
@@ -85,7 +85,7 @@
           ZoneId: "1",                  // 分区ID，默认：1
           Mode: "game",                 // 支付的类型，不同的支付类型有各自额外要传的附加参数，默认：game
           CurrencyType: "CNY",          // 币种，默认：CNY
-        Platform: ''                    // 申请接入时的平台，platform与应用id有关。默认：android（ios暂时没有开放，这里需要配置Platform，开放后，删掉此配置，sdk已经判断平台）
+          Platform: ''                  // 申请接入时的平台，platform与OfferId（米大师申请的应用id）有关，详情请阅读文档config.js参数MidasPay下的Platform配置
       }
   };
 ```
@@ -193,7 +193,7 @@
     CurrencyType：币种，默认："CNY"
-    Platform：申请接入时的平台，platform与应用id有关。
+    Platform：申请接入时的平台，platform与OfferId（米大师申请的应用id）有关。
     1）接入了米大师，填写"android"（ios暂时没有开放）
@@ -8,27 +8,18 @@
 #### **此模块是参照微信小游戏提供的api进行封装的公用方法，提供了以下游戏中常用到的功能：**
-**支付打点：logPay** (此模块保留logPay调用只是为了兼容已经接入的游戏，该api已经归类到【统计模块】下面的[支付打点](stat_pay.md)栏)。
+1. **支付打点：logPay** (此模块保留logPay调用只是为了兼容已经接入的游戏，该api已经归类到【统计模块】下面的[支付打点](stat_pay.md)栏)。
+2. **打开客服消息：openCustomerServiceConversation**  整理[wx.openCustomerServiceConversation](https://developers.weixin.qq.com/minigame/dev/api/open-api/customer-message/wx.openCustomerServiceConversation.html)
-**打开客服消息：openCustomerServiceConversation**  整理[wx.openCustomerServiceConversation](https://developers.weixin.qq.com/minigame/dev/api/open-api/customer-message/wx.openCustomerServiceConversation.html)
-
-**检测版本更新：checkUpdate**  整理来自：[wx.getUpdateManager](https://developers.weixin.qq.com/minigame/dev/api/base/update/UpdateManager.html)
-
-**显示模态弹出框：showModal**  整理来自：[wx.showModal](https://developers.weixin.qq.com/minigame/dev/api/ui/interaction/wx.showModal.html)
-
-**复制文本：copy** 整理来自：[wx.setClipboardData](https://developers.weixin.qq.com/minigame/dev/api/device/clipboard/wx.setClipboardData.html)
-
-**长震动：vibrateLong**  整理来自：[wx.vibrateLong](https://developers.weixin.qq.com/minigame/dev/api/device/vibrate/wx.vibrateLong.html)
-
-**短震动：vibrateShort**  整理来自：[wx.vibrateShort](https://developers.weixin.qq.com/minigame/dev/api/device/vibrate/wx.vibrateShort.html)
-
-**更新转发属性：updateShareMenu**  整理来自：[wx.updateShareMenu](https://developers.weixin.qq.com/minigame/dev/api/share/wx.updateShareMenu.html)
-
-**微信小游戏推荐弹窗组件GamePortal：isGamePortalPlaying 与 gamePortalShow**  整理来自：[wx.createGamePortal](https://developers.weixin.qq.com/minigame/dev/api/game-portal/GameBanner.html)
-
-**微信小游戏推荐icon组件GameIcon：gameIconShow 与 gameIconDestroy**  整理来自：[wx.createGameIcon](https://developers.weixin.qq.com/minigame/dev/api/game-portal/wx.createGameIcon.html)
-
-**微信小游戏插屏广告组件InterstitialAd：isInterstitialPlaying 与 interstitialShow**  整理来自：[wx.createInterstitialAd](https://developers.weixin.qq.com/minigame/dev/api/ad/InterstitialAd.html)
+3. **检测版本更新：checkUpdate**  整理来自：[wx.getUpdateManager](https://developers.weixin.qq.com/minigame/dev/api/base/update/UpdateManager.html)
+4. **显示模态弹出框：showModal**  整理来自：[wx.showModal](https://developers.weixin.qq.com/minigame/dev/api/ui/interaction/wx.showModal.html)
+5. **复制文本：copy** 整理来自：[wx.setClipboardData](https://developers.weixin.qq.com/minigame/dev/api/device/clipboard/wx.setClipboardData.html)
+6. **长震动：vibrateLong**  整理来自：[wx.vibrateLong](https://developers.weixin.qq.com/minigame/dev/api/device/vibrate/wx.vibrateLong.html)
+7. **短震动：vibrateShort**  整理来自：[wx.vibrateShort](https://developers.weixin.qq.com/minigame/dev/api/device/vibrate/wx.vibrateShort.html)
+8. **更新转发属性：updateShareMenu**  整理来自：[wx.updateShareMenu](https://developers.weixin.qq.com/minigame/dev/api/share/wx.updateShareMenu.html)
+9. **微信小游戏推荐弹窗组件GamePortal：isGamePortalPlaying 与 gamePortalShow**  整理来自：[wx.createGamePortal](https://developers.weixin.qq.com/minigame/dev/api/game-portal/GameBanner.html)
+10. **微信小游戏推荐icon组件GameIcon：gameIconShow 与 gameIconDestroy**  整理来自：[wx.createGameIcon](https://developers.weixin.qq.com/minigame/dev/api/game-portal/wx.createGameIcon.html)
+11. **微信小游戏插屏广告组件InterstitialAd：isInterstitialPlaying 与 interstitialShow**  整理来自：[wx.createInterstitialAd](https://developers.weixin.qq.com/minigame/dev/api/ad/InterstitialAd.html)
@@ -149,7 +140,6 @@
    ```
    示例2：应用场景如进入客服会话跳转领取体力、钻石等等： 示例为跳转客服领取18888钻石奖励，success函数中记录数据状态（用于客服返回，执行onShow生命周期函数时逻辑判断）。
    <iframe height=498 width=740 src="https://dep.miso-lab.com/sdkword/sdk_video_001.mp4" frameborder=0 allowfullscreen></iframe>
-   
    ```javascript
     // 跳转客服领取18888钻石奖励，开发者可根据示例修改
     PCSDK.platform.openCustomerServiceConversation({
@@ -169,20 +159,20 @@
             console.log("openCustomerServiceConversation fail: ", err);
         }
     });
-
-    // 在游戏中全局注册的onShow事件监听中检测是
+   
+ // 在游戏中全局注册的onShow事件监听中检测是
     // 游戏入口：Main.cs
     class Main {
         constructor() {
             this.init();
         }
-
-        private init() {
+   
+     private init() {
             PCSDK.event.add('app.show', this.onShow, this);  // 等同于wx.onShow(this.onShow.bind(this));
             PCSDK.event.add('app.hide', this.onHide, this);  // 等同于wx.onHide(this.onHide.bind(this));
         }
-
-        private onShow(opts) {
+   
+     private onShow(opts) {
             // 判断是否是来源于客服会话，上面的openCustomerServiceConversation的success设置的数据状态做判断
             let serviceRewardData = AppDataManager.I.get('service.reward.data');
             if (serviceRewardData && serviceRewardData.status === 1) {
@@ -190,15 +180,14 @@
                 // 奖励发放，处理发放后的逻辑，比如每天只能领取一次的记录，防止重复刷奖励
             }
         }
-
-        private onHide(){
+   
+     private onHide(){
             // 监听平台的onHide事件
         }
     }
    ```
    示例3：应用场景例如进入客服会话，success函数中记录数据状态（用于客服返回，执行onShow生命周期函数时逻辑判断），点击右下角的充值按钮后，跳转充值，充值完成后在onShow中处理：需要后台提供api接口，验证充值合理性并发放奖励，**此接口需要后端支持**。
    <iframe height=498 width=740 src="https://dep.miso-lab.com/sdkword/sdk_video_002.mp4" frameborder=0 allowfullscreen></iframe>
-   
    ```javascript
     // 跳转客服充值，开发者可根据示例修改，sendMessagePath请严格按照示例中提供的参数
     /**
@@ -226,21 +215,21 @@
             }
         });
     }
-
+   
     // 在游戏中全局注册的onShow事件监听中检测是
-    // 游戏入口：Main.cs
+ // 游戏入口：Main.cs
     class Main {
         constructor() {
             this.init();
         }
-
+   
         private init() {
-            PCSDK.event.add('app.show', this.onShow, this);  // 等同于wx.onShow(this.onShow.bind(this));
+         PCSDK.event.add('app.show', this.onShow, this);  // 等同于wx.onShow(this.onShow.bind(this));
             PCSDK.event.add('app.hide', this.onHide, this);  // 等同于wx.onHide(this.onHide.bind(this));
         }
-
+   
         private onShow(opts) {
-            // 判断是否是来源于客服会话，上面的openCustomerServiceConversation的success设置的数据状态做判断
+         // 判断是否是来源于客服会话，上面的openCustomerServiceConversation的success设置的数据状态做判断
             let serviceRewardData = AppDataManager.I.get('service.pay.data');
             if (serviceRewardData && serviceRewardData.status === 1) {
                 AppDataManager.I.set('service.pay.data', null);
@@ -248,9 +237,9 @@
                 // 请求后端接口验证奖励合理性
             }
         }
-
+   
         private onHide(){
-            // 监听平台的onHide事件
+         // 监听平台的onHide事件
         }
     }
    ```
@@ -284,6 +273,8 @@
    ```
    示例：在游戏入口类中检测是否有版本更新
+
+   1）、依照下面的示例接入checkUpdate api
    ```javascript
     class Main {
@@ -311,43 +302,52 @@
     }
    ```
+   2）、接入代码完毕后，按照下图的操作本地开发工具调试是否接入成功。
+   
+   I、选择：添加编译模式。
+   ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_030.png "🔍点击查看大图")
+   II、选择：自定义模式名称、勾选下次编译时模拟更新、选择模拟成功还是失败状态，点击确定。
+   ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_031.png "🔍点击查看大图")
+   III、开发工具会自动重新启动游戏，弹出更新框，看到弹出框接入成功。
+   ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_032.png "🔍点击查看大图")
+
 <div id="vibrate"></div>   
 4.0 **vibrateShort**
-  
+
    ```javascript
    PCSDK.platform.vibrateShort(): Promise<any>
    ```
    定义：使手机发生较短时间的振动（15 ms）。仅在 iPhone 7 / 7 Plus 以上及 Android 机型生效
-   
+
    参数：
-   
+
    ```javascript
    无
    ```
-   
+
    示例：
-   
+
    ```javascript
    PCSDK.platform.vibrateShort();
    ```
 4.1 **vibrateLong**
-  
+
    ```javascript
    PCSDK.platform.vibrateShort(): Promise<any>
    ```
    定义：使手机发生较长时间的振动（400 ms)
-   
+
    参数：
-   
+
    ```javascript
    无
    ```
-   
+
    示例：
-   
+
    ```javascript
    PCSDK.platform.vibrateLong();
	@@ -85,7 +85,7 @@		@@ -85,7 +85,7 @@
85	ZoneId: "1", // 分区ID，默认：1	85	ZoneId: "1", // 分区ID，默认：1
86	Mode: "game", // 支付的类型，不同的支付类型有各自额外要传的附加参数，默认：game	86	Mode: "game", // 支付的类型，不同的支付类型有各自额外要传的附加参数，默认：game
87	CurrencyType: "CNY", // 币种，默认：CNY	87	CurrencyType: "CNY", // 币种，默认：CNY
88	- Platform: '' // 申请接入时的平台，platform与应用id有关。默认：android（ios暂时没有开放，这里需要配置Platform，开放后，删掉此配置，sdk已经判断平台）	88	+ Platform: '' // 申请接入时的平台，platform与OfferId（米大师申请的应用id）有关，详情请阅读文档config.js参数MidasPay下的Platform配置
89	}	89	}
90	};	90	};
91	```	91	```
	@@ -193,7 +193,7 @@		@@ -193,7 +193,7 @@
193		193
194	CurrencyType：币种，默认："CNY"	194	CurrencyType：币种，默认："CNY"
195		195
196	- Platform：申请接入时的平台，platform与应用id有关。	196	+ Platform：申请接入时的平台，platform与OfferId（米大师申请的应用id）有关。
197		197
198	1）接入了米大师，填写"android"（ios暂时没有开放）	198	1）接入了米大师，填写"android"（ios暂时没有开放）
199		199