From 97a07a9ec4d713f56ebfb38a69b172ba6870aee3 Mon Sep 17 00:00:00 2001
From: 小川 费 <449111130@qq.com>
Date: Mon, 9 Sep 2019 19:27:13 +0800
Subject: [PATCH] 1
---
data.md | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++--
stat_ads.md | 2 ++
stat_level.md | 23 +++++++++++++----------
3 files changed, 88 insertions(+), 12 deletions(-)
diff --git a/data.md b/data.md
index 7e23171..595d6df 100644
--- a/data.md
+++ b/data.md
@@ -19,8 +19,12 @@
| PCSDK.data.RegTime | 获取用户注册时间 |
| PCSDK.data.ShareId | 获取进入游戏的分享会话ID，不是从分享会话进入ShareId为0 |
| PCSDK.data.ShareKey | 接入SDK的分享视频模块后，从分享会话进去游戏，获取到分享会话的分享key |
-| PCSDK.data.Platform | 获取游戏运行平台环境：devtools（开发者调试工具）、ios(苹果设备)、android（安卓设备） |
+| PCSDK.data.Platform | 获取游戏运行平台环境，字符串形式：devtools、ios、android。devtools（开发者调试工具）、ios(苹果设备)、android（安卓设备） |
+| PCSDK.data.SystemId | 获取游戏运行平台环境，整数形式：0、1。0（开发者调试工具或ios）、1（安卓设备） |
| PCSDK.data.QueryUserInviteUid | 获取此次分享会话进入游戏，分享来源者用户ID |
+| PCSDK.data.IsCross | 获取是否显示/隐藏交叉悬浮框推广位，true：显示，false：隐藏 |
+| PCSDK.data.IsDrawer | 获取是否显示/隐藏交叉抽屉推广位，true：显示，false：隐藏 |
+| PCSDK.data.IsGuessLike | 获取是否显示/隐藏交叉猜你喜欢推广位，true：显示，false：隐藏 |
@@ -132,7 +136,29 @@
break;
}
```
-8. ##### **QueryUserInviteUid**
+8. ##### **SystemId**
+
+ ```javascript
+ PCSDK.data.SystemId: number
+ ```
+
+ 定义：获取游戏运行平台环境：0（开发者调试工具或ios）、1（安卓设备）
+
+ 示例：
+
+ ```javascript
+ let systemId = PCSDK.data.SystemId;
+ switch (systemId) {
+ case 0: // 开发者工具 or 苹果设备
+
+ break;
+
+ case 1: // 安卓设备
+
+ break;
+ }
+ ```
+9. ##### **QueryUserInviteUid**
```javascript
PCSDK.data.QueryUserInviteUid: any
@@ -152,4 +178,49 @@
```javascript
// 从分享会话邀请链接进入，获得的值为邀请者用户id，不是分享会话邀请进入获取值为0
let inviteUid = PCSDK.data.QueryUserInviteUid;
+ ```
+10. ##### **IsCross**
+
+ ```javascript
+ PCSDK.data.IsCross: boolean
+ ```
+
+ 定义：获取是否显示/隐藏交叉悬浮框推广位，true：显示，false：隐藏
+
+ 示例：获取是否显示交叉悬浮框推广位
+
+ ```javascript
+ // 设置交叉悬浮框推广位ui的显示隐藏
+ let isShow = PCSDK.data.IsCross;
+ this.uiCross.visible = isShow;
+ ```
+11. ##### **IsDrawer**
+
+ ```javascript
+ PCSDK.data.IsDrawer: boolean
+ ```
+
+ 定义：获取是否显示/隐藏交叉抽屉推广位，true：显示，false：隐藏
+
+ 示例：
+
+ ```javascript
+ // 设置交叉抽屉推广位ui的显示隐藏
+ let isShow = PCSDK.data.IsDrawer;
+ this.uiDrawer.visible = isShow;
+ ```
+12. ##### **IsGuessLike**
+
+ ```javascript
+ PCSDK.data.IsGuessLike: boolean
+ ```
+
+ 定义：获取是否显示/隐藏交叉猜你喜欢推广位，true：显示，false：隐藏
+
+ 示例：
+
+ ```javascript
+ // 设置交叉猜你喜欢推广位ui的显示隐藏
+ let isShow = PCSDK.data.IsGuessLike;
+ this.uiGuessLike.visible = isShow;
```
\ No newline at end of file
diff --git a/stat_ads.md b/stat_ads.md
index 66635b1..082f1b1 100644
--- a/stat_ads.md
+++ b/stat_ads.md
@@ -38,6 +38,8 @@
- 由于微信对每个游戏可跳转其他游戏有10个限制，可跳转的其它游戏需要在小游戏根目录下的全局配置文件game.json中进行添加配置：navigateToMiniProgramAppIdList，该参数定义请详读[小程序全局配置](https://developers.weixin.qq.com/minigame/dev/reference/configuration/app.html)。
+- **接入3种交叉推广位后，为了防止微信审核被拒（被拒理由：微信认定游戏跳转到其他游戏太多，判断游戏是一个游戏盒子，拒绝审核通过），为了防范被拒，在[数据模块](data.md)提供了三个数据获取api：PCSDK.data.IsCross、PCSDK.data.IsDrawer、PCSDK.data.IsGuessLike，控制3种推广位广告的显示隐藏，开发者在游戏中对三种广告控制显示隐藏状态。[详请请阅读数据api](data.md#ad_cross)。**
+
- 噗嗤游戏为了方便开发者接入调试交叉推广位，后台已经配置测试使用的3种类型推广位，提供以下10个推广位appid，开发者复制下面的navigateToMiniProgramAppIdList json数据，配置到game.json的navigateToMiniProgramAppIdList参数：
水果爆破 ："wx26822126b4d99eda",
diff --git a/stat_level.md b/stat_level.md
index bbac1c8..255bdad 100644
--- a/stat_level.md
+++ b/stat_level.md
@@ -29,7 +29,7 @@
1. #### **logLevelRelive**
```javascript
- PCSDK.stat.logLevelRelive(levelId: string | number , params?: { attr?: number, ext?: string } ): void
+ PCSDK.stat.logLevelRelive(levelId: string | number , params?: { attr?: number, ext?: any } ): void
```
定义：关卡复活成功数据上报
@@ -42,7 +42,7 @@
params: object 选传，关卡需要的其他参数，目前只支持传递2个属性: attr、ext
{
attr: number 选传 战斗属性（例如:关卡战斗中所使用的枪支等级）
- ext: string 选传 扩展参数：key1=val1&key2=val2的格式
+ ext: object 选传 扩展参数：{ key1:val1, key2:val2 }的格式
}
```
@@ -51,7 +51,7 @@
2. #### **logLevelHide**
```javascript
- PCSDK.stat.logLevelHide(levelId: string | number , params?: { attr?: number, ext?: string } ): void
+ PCSDK.stat.logLevelHide(levelId: string | number , params?: { attr?: number, ext?: any } ): void
```
定义：监听游戏战斗界面onHide时上报关卡的数据。什么是界面onHide？[请详读微信小游戏wx.onHide](https://developers.weixin.qq.com/minigame/dev/api/base/app/life-cycle/wx.onHide.html)
注意事项：
@@ -73,8 +73,8 @@
params: object 选传，关卡需要的其他参数，目前只支持传递2个属性: attr、ext
{
- attr: number 战斗属性（例如:关卡战斗中所使用的枪支等级）
- ext: string 选传 扩展参数：key1=val1&key2=val2的格式
+ attr: number 选传 战斗属性（例如:关卡战斗中所使用的枪支等级）
+ ext: object 选传 扩展参数：{ key1:val1, key2:val2 }的格式
}
```
[点此查看完整示例](stat_level.md#sample)如何添加关卡onHide打点代码
@@ -82,7 +82,7 @@
3. #### **logLevelFail**
```javascript
- PCSDK.stat.logLevelFail(levelId: string | number , params: { ctime: number, first: number, attr?: number, ext?: string } ): void
+ PCSDK.stat.logLevelFail(levelId: string | number , params: { ctime: number, first: number, attr?: number, ext?: any } ): void
```
定义：关卡失败数据上报
@@ -97,7 +97,7 @@
ctime: number 必传 关卡耗时 = 当前时间-关卡进入时间，单位秒
first: number 必传 是否第一次体验关卡，1是，0否
attr: number 选传 战斗属性（例如:关卡战斗中所使用的枪支等级）
- ext: string 选传 扩展参数：key1=val1&key2=val2的格式
+ ext: object 选传 扩展参数：{ key1:val1, key2:val2 }的格式
}
```
[点此查看完整示例](stat_level.md#sample)如何添加关卡失败打点代码
@@ -105,7 +105,7 @@
4. #### **logLevelWin**
```javascript
- PCSDK.stat.logLevelWin(levelId: string | number , params: { ctime: number, first: number, attr?: number, ext?: number } ): void
+ PCSDK.stat.logLevelWin(levelId: string | number , params: { ctime: number, first: number, attr?: number, ext?: any } ): void
```
定义：关卡成功通关数据上报
@@ -120,7 +120,7 @@
ctime: number 必传 关卡耗时 = 当前时间-关卡进入时间，单位秒
first: number 必传 是否第一次体验关卡，1是，0否
attr: number 选传 战斗属性（例如:关卡战斗中所使用的枪支等级）
- ext: string 选传 扩展参数：key1=val1&key2=val2的格式
+ ext: object 选传 扩展参数：{ key1:val1, key2:val2 }的格式
}
```
完整示例，以上四个接口使用场景：
@@ -223,7 +223,10 @@
PCSDK.stat.logLevelWin(this.missionId, {
ctime: costTime,
first: failNum ? 0 : 1,
- attr: this.currSelectGun
+ attr: this.currSelectGun,
+ ext: {
+ currHp: 100000
+ }
});
break;
--
libgit2 0.21.0