小川 / SdkGitbook

Download as
Browse Code »

Commit c7e4d8752414019d9a6fb8977ab92ac3c23a080c

Authored by 小川 费
1 parent 5131e216
Exists in master

1

Showing 5 changed files with 48 additions and 33 deletions   Show diff stats
@@ -2,6 +2,19 @@ @@ -2,6 +2,19 @@
2 2
3 ------ 3 ------
4 4
  5 +## [v1.0.0.2 下载](https://dep.miso-lab.com/sdkword/versions/sdk-out-v1.0.0.2.zip)
  6 +
  7 +> *发布时间*：2019.09.11
  8 +
  9 +**修复：**
  10 +
  11 +1. 修复外部游戏设置openId导致userId为0的问题：外部游戏openId替换userId。
  12 +
  13 +**新增：**
  14 +
  15 +1. 外部游戏修改setLogind接口为setLoginInfo( { openId: strinng , retTime: number } );
  16 +2. loadingFinish传递isActive参数，isActive为true SDK在loadingFinish结束后自动调用active。
  17 +
5 ## [v1.0.0.1 下载](https://dep.miso-lab.com/sdkword/versions/sdk-out-v1.0.0.1.zip) 18 ## [v1.0.0.1 下载](https://dep.miso-lab.com/sdkword/versions/sdk-out-v1.0.0.1.zip)
6 19
7 > *发布时间*：2019.09.04 20 > *发布时间*：2019.09.04
1 -事件模块  
2 \ No newline at end of file 1 \ No newline at end of file
  2 +# 事件模块
  3 +事件是一种观察者的设计模式，对象可以发布事件，然后其它对象可以观察该对象，等待这些时刻到来并通过运行代码来响应。噗嗤SDK中。
  4 +
@@ -155,9 +155,9 @@ @@ -155,9 +155,9 @@
155 error：此次分发失败的错误消息 155 error：此次分发失败的错误消息
156 error返回枚举值为： 156 error返回枚举值为：
157 { code: 1000, msg: '要看完视频哦!' }, 157 { code: 1000, msg: '要看完视频哦!' },
158 - { code: 1001, msg: '加载视频广告失败!' }, 158 + { code: 1001, msg: '视频加载失败!' },
159 { code: 999, msg: '视频UID不存在!' }, 159 { code: 999, msg: '视频UID不存在!' },
160 - { code: 1002, msg: '加载视频广告失败!' }, 160 + { code: 1002, msg: '视频组件未开放!' },
161 { code: 1003, msg: '正在观看视频中...' }, 161 { code: 1003, msg: '正在观看视频中...' },
162 { code: 1004, msg: '分享失败，请尝试发送至不同群！' }, 162 { code: 1004, msg: '分享失败，请尝试发送至不同群！' },
163 { code: 1005, msg: '别总骚扰这个群，换个群分享吧!' }, 163 { code: 1005, msg: '别总骚扰这个群，换个群分享吧!' },
stat_active.md
  Diff comments   View file @c7e4d87
@@ -25,8 +25,8 @@ @@ -25,8 +25,8 @@
25 25
26 | **名称** | **功能说明** | 26 | **名称** | **功能说明** |
27 | ------------------------ | ------------------------------------------------------------ | 27 | ------------------------ | ------------------------------------------------------------ |
28 -| PCSDK.stat.loadingFinish | 加载游戏资源完成时打点，不是微信代码包白屏加载完成，游戏加载完成游戏ui界面图、json资源 |  
29 -| PCSDK.stat.setLogind | 设置SDK必须要使用的用户id、第一次创建角色的注册时间（单位秒），游戏接入方登录游戏服务器后调用 | 28 +| PCSDK.stat.loadingFinish | 加载游戏资源完成时打点，不是微信代码包白屏加载完成。例如：游戏加载完成游戏ui界面图、json资源等 |
  29 +| PCSDK.stat.setLogind | 设置SDK必须要使用的用户id、第一次创建角色的注册时间（时间戳转换，单位秒），游戏接入方登录游戏服务器后调用 |
30 | PCSDK.stat.active | 用户活跃/新增注册上报，切记在setLogind设置需要的信息过后使用（设置setLogind后此api不限于使用位置），不然会导致新增注册数据统计异常 | 30 | PCSDK.stat.active | 用户活跃/新增注册上报，切记在setLogind设置需要的信息过后使用（设置setLogind后此api不限于使用位置），不然会导致新增注册数据统计异常 |
31 31
32 32
@@ -41,7 +41,7 @@ @@ -41,7 +41,7 @@
41 PCSDK.stat.loadingFinish(): void 41 PCSDK.stat.loadingFinish(): void
42 ``` 42 ```
43 43
44 - 定义：加载游戏资源（UI界面图，json资源等）完成时打点 44 + 定义：加载游戏资源完成时打点，不是微信代码包白屏加载完成。例如：游戏加载完成游戏ui界面图、json资源等
45 45
46 参数： 46 参数：
47 47
@@ -82,22 +82,22 @@ @@ -82,22 +82,22 @@
82 PCSDK.stat.setLogind( data: object ): void 82 PCSDK.stat.setLogind( data: object ): void
83 ``` 83 ```
84 84
85 - 定义：游戏成功登录到服务器后得到用户信息：<font color="#FF0000">用户id和用户第一次注册时间（时间戳，单位秒），设置SDK必需的用户信息</font> 85 + 定义：游戏成功登录到服务器后得到用户信息：<font color="#FF0000">用户id和用户第一次注册时间（时间戳转换，单位秒），设置SDK必需的用户信息</font>
86 86
87 参数： 87 参数：
88 88
89 ```javascript 89 ```javascript
90 data: object 90 data: object
91 { 91 {
92 - userId: string | number 必传, 用户唯一标识id  
93 - regTime: number 必传，用户第一次创建角色的注册时间（时间戳，单位秒） 92 + userId: string | number 必传，用户唯一标识id
  93 + regTime: number 必传，用户第一次创建角色的注册时间（时间戳转换，单位秒）
94 } 94 }
95 ``` 95 ```
96 96
97 - 示例：游戏登录完成后，获取用户信息后进行打点（该示例，只是模拟使用环境） 97 + 示例：游戏登录游戏服务器后，获取用户信息（用户id和用户第一次注册时间）后进行打点。该示例，只是模拟使用环境。
98 98
99 ```javascript 99 ```javascript
100 - // 发起登录请求成功后，得到用户信息，调用setLogind设置SDK必需的用户信息 100 + // 发起登录请求成功后，得到用户信息：user_id、user_reg_time，调用setLogind设置SDK必需的用户信息。
101 Api.login().then( data => { 101 Api.login().then( data => {
102 let { user_id, user_reg_time } = data; 102 let { user_id, user_reg_time } = data;
103 PCSDK.stat.setLogind({ 103 PCSDK.stat.setLogind({
@@ -8,17 +8,17 @@ @@ -8,17 +8,17 @@
8 8
9 噗嗤游戏提供了3种类型的交叉推广位，后台可对交叉推广位进行配置管理，对交叉推广位各项指标分析查看。 9 噗嗤游戏提供了3种类型的交叉推广位，后台可对交叉推广位进行配置管理，对交叉推广位各项指标分析查看。
10 10
11 -**3种广告类型：交叉悬浮广告框、交叉抽屉式广告位、交叉猜你喜欢广告位** 11 +**3种广告类型：悬浮框交叉推广位、抽屉式交叉推广位、猜你喜欢交叉推广位**
12 12
13 -1. 交叉悬浮广告框，推荐位置：首页、结算页 13 +1. 悬浮框交叉推广位，推荐位置：首页、结算页
14 14
15 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_013.png "🔍点击查看大图") 15 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_013.png "🔍点击查看大图")
16 16
17 -2. 交叉抽屉式广告位，推荐位置：首页、结算页 17 +2. 抽屉式交叉推广位，推荐位置：首页、结算页
18 18
19 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_014.png "🔍点击查看大图") 19 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_014.png "🔍点击查看大图")
20 20
21 -3. 交叉猜你喜欢广告位，推荐位置：结算页 21 +3. 猜你喜欢交叉推广位，推荐位置：结算页
22 22
23 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_015.png "🔍点击查看大图") 23 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_015.png "🔍点击查看大图")
24 24
@@ -98,7 +98,7 @@ @@ -98,7 +98,7 @@
98 PCSDK.stat.loadingFinish(banner_type): Promise<any> 98 PCSDK.stat.loadingFinish(banner_type): Promise<any>
99 ``` 99 ```
100 100
101 - 定义：根据类型获取对应类型交叉广告列表，目前SDK支持3种类型 101 + 定义：根据类型获取对应类型交叉推广位列表，目前SDK支持3种类型
102 102
103 参数： 103 参数：
104 104
@@ -190,7 +190,7 @@ @@ -190,7 +190,7 @@
190 */ 190 */
191 export default class TestBannerSample { 191 export default class TestBannerSample {
192 constructor() { 192 constructor() {
193 - // 示例：加载交叉悬浮广告框 193 + // 示例：加载悬浮框交叉推广位
194 this.loadBannerList(BannerType.TYPE_CROSS) 194 this.loadBannerList(BannerType.TYPE_CROSS)
195 .then((dataList: Array<BannerData>) => { 195 .then((dataList: Array<BannerData>) => {
196 // 渲染广告位数据 196 // 渲染广告位数据
@@ -234,9 +234,9 @@ @@ -234,9 +234,9 @@
234 234
235 // 广告位类型的枚举 235 // 广告位类型的枚举
236 enum BannerType { 236 enum BannerType {
237 - TYPE_CROSS = 40, // 交叉悬浮广告框  
238 - TYPE_LIKE = 50, // 交叉猜你喜欢广告位  
239 - TYPE_LIST = 70, // 交叉抽屉广告位 237 + TYPE_CROSS = 40, // 悬浮框交叉推广位
  238 + TYPE_LIKE = 50, // 猜你喜欢交叉推广位
  239 + TYPE_LIST = 70, // 抽屉式交叉推广位
240 } 240 }
241 241
242 /* 242 /*
@@ -275,7 +275,7 @@ @@ -275,7 +275,7 @@
275 } 275 }
276 ``` 276 ```
277 277
278 - 示例：获取猜你喜欢推广位，以列表的形式显示在界面上，点击任意一项游戏跳转其他游戏 278 + 示例：获取猜你喜欢交叉推广位，以列表的形式显示在界面上，点击任意一项游戏跳转其他游戏
279 279
280 ```javascript 280 ```javascript
281 // 发起登录请求，得到登录数据信息，调用setLogind设置SDK用户信息 281 // 发起登录请求，得到登录数据信息，调用setLogind设置SDK用户信息
@@ -301,7 +301,7 @@ @@ -301,7 +301,7 @@
301 this.list.renderHandler = new Laya.Handler(this, this.renderAdItem); 301 this.list.renderHandler = new Laya.Handler(this, this.renderAdItem);
302 this.boxList.addChild(this.list); 302 this.boxList.addChild(this.list);
303 303
304 - // 示例：加载猜你喜欢广告位数据列表 304 + // 示例：加载猜你喜欢交叉推广位数据列表
305 this.loadBannerList(BannerType.TYPE_LIKE) 305 this.loadBannerList(BannerType.TYPE_LIKE)
306 .then((dataList: Array<BannerData>) => { 306 .then((dataList: Array<BannerData>) => {
307 this.renderAdLikeList(dataList); 307 this.renderAdLikeList(dataList);
@@ -372,9 +372,9 @@ @@ -372,9 +372,9 @@
372 372
373 // 广告位类型的枚举 373 // 广告位类型的枚举
374 enum BannerType { 374 enum BannerType {
375 - TYPE_CROSS = 40, // 交叉悬浮广告框  
376 - TYPE_LIKE = 50, // 交叉猜你喜欢广告位  
377 - TYPE_LIST = 70, // 交叉抽屉广告位 375 + TYPE_CROSS = 40, // 悬浮框交叉推广位
  376 + TYPE_LIKE = 50, // 猜你喜欢交叉推广位
  377 + TYPE_LIST = 70, // 抽屉式交叉推广位
378 } 378 }
379 379
380 /* 380 /*
@@ -411,11 +411,11 @@ @@ -411,11 +411,11 @@
411 411
412 > 提示： 412 > 提示：
413 > 413 >
414 - > 展示猜你喜欢/抽屉推广位：获取到9个推广位数据，展示了其中5个，调用曝光接口传入推广位数据为展示的5个，剩余的4个需在其展示的时候再调用曝光api接口传入。 414 + > 展示猜你喜欢/抽屉式交叉推广位：获取到9个推广位数据，展示了其中5个，调用曝光接口传入推广位数据为展示的5个，剩余的4个需在其展示的时候再调用曝光api接口传入。
415 > 415 >
416 - > 展示交叉悬浮框推广位：展示一个，将此推广位传入曝光接口，点击展示下一个，则把这个最新的数据传入曝光api 416 + > 展示悬浮框交叉推广位：展示一个，将此推广位传入曝光接口，点击展示下一个，则把这个最新的数据传入曝光api
417 417
418 - 示例：根据交叉悬浮框类型调用PCSDK.stat.bannnerList接口获取交叉悬浮框推广位列表，显示第一个，每隔4秒切换到下一个，点击一个切换下一个展示。此示例没有使用定时器方式，采用的是监听动画帧实现。 418 + 示例：根据悬浮框交叉推广位类型调用PCSDK.stat.bannnerList接口获取悬浮框交叉推广位列表，显示第一个，每隔4秒切换到下一个，点击一个切换下一个展示。此示例没有使用定时器方式，采用的是监听动画帧实现。
419 ```javascript 419 ```javascript
420 /** 420 /**
421 * 演示交叉推广位使用示例 421 * 演示交叉推广位使用示例
@@ -432,7 +432,7 @@ export default class TestBannerSample extends ui.ads.ADbtnUI { @@ -432,7 +432,7 @@ export default class TestBannerSample extends ui.ads.ADbtnUI {
432 this.on(Laya.Event.CLICK, this, this.onJumpGame); 432 this.on(Laya.Event.CLICK, this, this.onJumpGame);
433 } 433 }
434 434
435 - // 初始化显示交叉悬浮框广告位 435 + // 初始化显示悬浮框交叉推广位
436 init(isFirst: boolean) { 436 init(isFirst: boolean) {
437 isFirst && (this.count = 0); 437 isFirst && (this.count = 0);
438 this.anim_entice.play(0, true); 438 this.anim_entice.play(0, true);
@@ -443,7 +443,7 @@ export default class TestBannerSample extends ui.ads.ADbtnUI { @@ -443,7 +443,7 @@ export default class TestBannerSample extends ui.ads.ADbtnUI {
443 this.refresh(); 443 this.refresh();
444 } 444 }
445 445
446 - // 清理交叉悬浮框广告位 446 + // 清理悬浮框交叉推广位
447 clear() { 447 clear() {
448 this.anim_entice.gotoAndStop(0); 448 this.anim_entice.gotoAndStop(0);
449 this.anim_entice.removeLabel('refresh'); 449 this.anim_entice.removeLabel('refresh');
@@ -523,8 +523,8 @@ export default class TestBannerSample extends ui.ads.ADbtnUI { @@ -523,8 +523,8 @@ export default class TestBannerSample extends ui.ads.ADbtnUI {
523 523
524 // 广告位类型的枚举 524 // 广告位类型的枚举
525 enum BannerType { 525 enum BannerType {
526 - TYPE_CROSS = 40, // 交叉悬浮广告框  
527 - TYPE_LIKE = 50, // 交叉猜你喜欢广告位  
528 - TYPE_LIST = 70, // 交叉抽屉广告位 526 + TYPE_CROSS = 40, // 悬浮框交叉推广位
  527 + TYPE_LIKE = 50, // 猜你喜欢交叉推广位
  528 + TYPE_LIST = 70, // 抽屉式交叉推广位
529 } 529 }
530 ``` 530 ```
531 \ No newline at end of file 531 \ No newline at end of file