Showing
3 changed files
with
176 additions
and
78 deletions
... | @@ -24,6 +24,7 @@ | ... | @@ -24,6 +24,7 @@ |
24 | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> | 24 | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> |
25 | <uses-permission android:name="org.simalliance.openmobileapi.SMARTCARD" /> | 25 | <uses-permission android:name="org.simalliance.openmobileapi.SMARTCARD" /> |
26 | <uses-permission android:name="android.permission.NFC" /> | 26 | <uses-permission android:name="android.permission.NFC" /> |
27 | + | ||
27 | <uses-feature android:name="android.hardware.nfc.hce" /> | 28 | <uses-feature android:name="android.hardware.nfc.hce" /> |
28 | <!-- SDK end --> | 29 | <!-- SDK end --> |
29 | 30 | ||
... | @@ -40,7 +41,6 @@ | ... | @@ -40,7 +41,6 @@ |
40 | android:theme="@android:style/Theme.NoTitleBar.Fullscreen" > | 41 | android:theme="@android:style/Theme.NoTitleBar.Fullscreen" > |
41 | <intent-filter> | 42 | <intent-filter> |
42 | <action android:name="android.intent.action.MAIN" /> | 43 | <action android:name="android.intent.action.MAIN" /> |
43 | - | ||
44 | <category android:name="android.intent.category.LAUNCHER" /> | 44 | <category android:name="android.intent.category.LAUNCHER" /> |
45 | </intent-filter> | 45 | </intent-filter> |
46 | </activity> | 46 | </activity> |
... | @@ -61,7 +61,8 @@ | ... | @@ -61,7 +61,8 @@ |
61 | android:name="com.youai.sdk.YouaiSDK" | 61 | android:name="com.youai.sdk.YouaiSDK" |
62 | android:label="youai_sdk" | 62 | android:label="youai_sdk" |
63 | android:launchMode="singleTask" | 63 | android:launchMode="singleTask" |
64 | - android:theme="@android:style/Theme.Dialog" /> | 64 | + android:theme="@android:style/Theme.Dialog" > |
65 | + </activity> | ||
65 | 66 | ||
66 | <service | 67 | <service |
67 | android:name="com.youai.sdk.YouaiService" | 68 | android:name="com.youai.sdk.YouaiService" | ... | ... |
... | @@ -11,4 +11,5 @@ | ... | @@ -11,4 +11,5 @@ |
11 | #proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt | 11 | #proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt |
12 | 12 | ||
13 | # Project target. | 13 | # Project target. |
14 | +# Project target. | ||
14 | target=android-20 | 15 | target=android-20 | ... | ... |
... | @@ -5,22 +5,20 @@ | ... | @@ -5,22 +5,20 @@ |
5 | 5 | ||
6 | #### 1.1、将 SDK 压缩包中 libs 目录下的所有 资源 包复制到游戏工程的libs 目录下 #### | 6 | #### 1.1、将 SDK 压缩包中 libs 目录下的所有 资源 包复制到游戏工程的libs 目录下 #### |
7 | 7 | ||
8 | - | ||
9 | - | ||
10 | #### 1.2、复制SDK压缩包中assets目录下的所有内容到游戏工程的assets目录 #### | 8 | #### 1.2、复制SDK压缩包中assets目录下的所有内容到游戏工程的assets目录 #### |
11 | 9 | ||
12 | -- 将游戏中的闪屏图片放到assets中poolsdk_splash目录下 | 10 | +- 将游戏中的闪屏图片放到assets中poolsdk_splash目录下(选用,图片文件名任意,最多支持2张闪屏) |
13 | -- 将assets中的poolsdk.xml中的`YA_APPKEY,YA_APPID,gamesimplename` 修改为后台生成的参数(必填) | 11 | +- 将assets中的poolsdk.xml中的 **YA_APPKEY,YA_APPID,gamesimplename** 修改为申请的参数(必填)(请与相关人员申请) |
14 | -- channelparameter1 和 channelparameter2 为后台对应渠道编号1和2(选填) | 12 | +- channelparameter1 和 channelparameter2 为后台对应渠道编号1和2(选填)(游戏客户端可以通过文档 2.12 方法获取) |
15 | - custom 为自定义参数(选填) | 13 | - custom 为自定义参数(选填) |
16 | -- gamechannelid 为游戏渠道号(选填) | 14 | +- gamechannelid 为游戏渠道号(选填)(游戏客户端可以通过文档 2.12 方法获取) |
17 | 15 | ||
18 |  | 16 |  |
19 | 17 | ||
20 | #### 1.3、修改游戏工程的AndroidManifest.xml(可以参照复制Demo中 AndroidManifest.xml文件) #### | 18 | #### 1.3、修改游戏工程的AndroidManifest.xml(可以参照复制Demo中 AndroidManifest.xml文件) #### |
21 | 19 | ||
22 | - 添加声明权限: | 20 | - 添加声明权限: |
23 | -- | 21 | + |
24 | ```xml | 22 | ```xml |
25 | <uses-permission android:name="android.permission.INTERNET" /> | 23 | <uses-permission android:name="android.permission.INTERNET" /> |
26 | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> | 24 | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> |
... | @@ -100,14 +98,20 @@ | ... | @@ -100,14 +98,20 @@ |
100 | ``` | 98 | ``` |
101 | 99 | ||
102 | 100 | ||
103 | -### 2、功能接口 ### | 101 | +### 2、功能接口 (注意:以下所有接口都必须在 SDK 初始化完成之后才能调用) ### |
102 | + | ||
104 | 103 | ||
105 | - (注意:以下所有接口都必须在 SDK 初始化完成之后才能调用) | 104 | +#### 2.1、继承 PoolSDKApplication(必接) |
106 | - 2.1、继承 PoolSDKApplication(必接) | 105 | + |
107 | - 说明:<br> | 106 | +游戏工程如果没有Application,请在 AndroidManifest.xml 中添加SDK的Application,如下所示: |
108 | - 游戏工程如果没有Application,请在 AndroidManifest.xml 中添加SDK的Application,如下所示: | 107 | + |
109 | - <application android:name="com.gzyouai.publicsdk.application.PoolSDKApplication"> | 108 | +```xml |
110 | - 游戏工程如果有 Application,请继承 SDK 中 PoolSDKApplication: | 109 | +<application android:name="com.gzyouai.publicsdk.application.PoolSDKApplication"> |
110 | +``` | ||
111 | + | ||
112 | +游戏工程如果有 Application,请继承 SDK 中 PoolSDKApplication: | ||
113 | + | ||
114 | +```java | ||
111 | public class XXXXApplication extends PoolSDKApplication { | 115 | public class XXXXApplication extends PoolSDKApplication { |
112 | @Override | 116 | @Override |
113 | public void onCreate() { | 117 | public void onCreate() { |
... | @@ -115,19 +119,23 @@ | ... | @@ -115,19 +119,23 @@ |
115 | super.onCreate(); | 119 | super.onCreate(); |
116 | } | 120 | } |
117 | } | 121 | } |
118 | - 2.2、初始化接口(必接) | 122 | +``` |
123 | +#### 2.2、初始化接口(必接) | ||
119 | 接口说明: | 124 | 接口说明: |
120 | 首先在程序开始的地方调用 SDK 的初始化 init 方法,并设 置 Activity 对像和初始化完成回调 | 125 | 首先在程序开始的地方调用 SDK 的初始化 init 方法,并设 置 Activity 对像和初始化完成回调 |
121 | 监听(在初始化失败情况下不 再调用其它 SDK 接口方法) | 126 | 监听(在初始化失败情况下不 再调用其它 SDK 接口方法) |
122 | 注意:要确保在 SDK 初始化成功后才可调用其它接口 | 127 | 注意:要确保在 SDK 初始化成功后才可调用其它接口 |
123 | 2.2.1、方法定义 | 128 | 2.2.1、方法定义 |
124 | public static void init(final Activity activity,final PoolSDKCallBackListener callBackListener) | 129 | public static void init(final Activity activity,final PoolSDKCallBackListener callBackListener) |
125 | - 2.2.2、参数说明 | 130 | + |
131 | +#### 2.2.2、参数说明 | ||
132 | + | ||
126 | | 参数 | 说明 | | 133 | | 参数 | 说明 | |
127 | | ---------------- | -------------------------------- | | 134 | | ---------------- | -------------------------------- | |
128 | | activity | Activity 对应 | | 135 | | activity | Activity 对应 | |
129 | | callBackListener | 初始化完成回调通知,需实现 poolSdkCallBack 方法 | | 136 | | callBackListener | 初始化完成回调通知,需实现 poolSdkCallBack 方法 | |
130 | 137 | ||
138 | +```java | ||
131 | 2.2.3、代码示例: | 139 | 2.2.3、代码示例: |
132 | PoolSdkHelper.init(this, new PoolSDKCallBackListener() { | 140 | PoolSdkHelper.init(this, new PoolSDKCallBackListener() { |
133 | @Override | 141 | @Override |
... | @@ -145,16 +153,26 @@ | ... | @@ -145,16 +153,26 @@ |
145 | } | 153 | } |
146 | }); | 154 | }); |
147 | 155 | ||
148 | - 2.3、登录接口(必接) | 156 | + ``` |
149 | - 接口说明:游戏登录时调用 | 157 | +#### 2.3、登录接口(必接) |
150 | - 2.3.1、方法定义 | 158 | + |
151 | - public static void login(final String paramCustom,final PoolLoginListener poolLoginListener) | 159 | +接口说明:游戏登录时调用 |
152 | - 2.3.2、参数说明 | 160 | + |
161 | +#### 2.3.1、方法定义 | ||
162 | + | ||
163 | +```java | ||
164 | +public static void login(final String paramCustom,final PoolLoginListener poolLoginListener) | ||
165 | +``` | ||
166 | + | ||
167 | +#### 2.3.2、参数说明 | ||
168 | + | ||
153 | | 参数 | 说明 | | 169 | | 参数 | 说明 | |
154 | | ----------------- | ---------------------------------------- | | 170 | | ----------------- | ---------------------------------------- | |
155 | | paramCustom | 游戏自定义参数,可通过登录成功回调方法onLoginSuccess 中的参数PoolLoginInfo 对象的 getCustom()获取 | | 171 | | paramCustom | 游戏自定义参数,可通过登录成功回调方法onLoginSuccess 中的参数PoolLoginInfo 对象的 getCustom()获取 | |
156 | | poolLoginListener | 登录结果回调通知,需实现 onLoginSuccess 方法 | | 172 | | poolLoginListener | 登录结果回调通知,需实现 onLoginSuccess 方法 | |
157 | 173 | ||
174 | + | ||
175 | +```java | ||
158 | 2.3.3、代码示例 | 176 | 2.3.3、代码示例 |
159 | PoolSdkHelper.login("登录自定义字段", new PoolLoginListener() { | 177 | PoolSdkHelper.login("登录自定义字段", new PoolLoginListener() { |
160 | @Override | 178 | @Override |
... | @@ -174,13 +192,22 @@ | ... | @@ -174,13 +192,22 @@ |
174 | } | 192 | } |
175 | }); | 193 | }); |
176 | 194 | ||
177 | - 2.4、提交角色数据接口(必接) | 195 | +``` |
178 | - 接口说明:游戏提交角色数据接口,该接口需要在以下 3 中情况下 | 196 | + |
179 | - 调用:进入游戏主场景、创建角色、角色升级(如果游戏创建角色时没有角色名,需要在用户创建角色名时调用多一次进入游戏统计,否则用户名无法正常统计,投放测试无法通过) | 197 | +#### 2.4、提交角色数据接口(必接) |
180 | - 2.4.1、方法定义 | 198 | +接口说明:游戏提交角色数据接口,该接口需要在以下3中情况下调用: |
181 | - public static void submitRoleData(final PoolRoleInfo poolRoleInfo, | 199 | + |
182 | - final PoolRoleListener poolRoleListener) | 200 | +进入游戏主场景、创建角色、角色升级 |
183 | - 2.4.2、参数说明 | 201 | + |
202 | +**(如果游戏创建角色时没有角色名,需要在用户创建角色名时调用多一次进入游戏统计,否则用户名无法正常统计,投放测试无法通过)** | ||
203 | + | ||
204 | +#### 2.4.1、方法定义 | ||
205 | + | ||
206 | +```java | ||
207 | +public static void submitRoleData(final PoolRoleInfo poolRoleInfo,final PoolRoleListener poolRoleListener) | ||
208 | +``` | ||
209 | +#### 2.4.2、参数说明 | ||
210 | + | ||
184 | | 参数 | 说明 | | 211 | | 参数 | 说明 | |
185 | | ---------------- | ---------------- | | 212 | | ---------------- | ---------------- | |
186 | | poolRoleInfo | 角色数据实体类 | | 213 | | poolRoleInfo | 角色数据实体类 | |
... | @@ -205,6 +232,8 @@ | ... | @@ -205,6 +232,8 @@ |
205 | | diamond | 余额 | | 232 | | diamond | 余额 | |
206 | | moneyType | 商品单位 | | 233 | | moneyType | 商品单位 | |
207 | 234 | ||
235 | + | ||
236 | +```java | ||
208 | 2.4.3、代码示例 | 237 | 2.4.3、代码示例 |
209 | /******************************************** | 238 | /******************************************** |
210 | * 以下所有字段都是必填项 | 239 | * 以下所有字段都是必填项 |
... | @@ -224,9 +253,9 @@ | ... | @@ -224,9 +253,9 @@ |
224 | poolRoleInfo.setVipLevel("10");//vip等级 | 253 | poolRoleInfo.setVipLevel("10");//vip等级 |
225 | poolRoleInfo.setDiamond("1000");//余额 | 254 | poolRoleInfo.setDiamond("1000");//余额 |
226 | poolRoleInfo.setMoneyType("金币");//商品单位 | 255 | poolRoleInfo.setMoneyType("金币");//商品单位 |
227 | - poolRoleInfo.setCallType(PoolRoleInfo.Type_EnterGame); | 256 | + poolRoleInfo.setCallType(PoolRoleInfo.Type_EnterGame);//进入游戏 |
228 | - // poolRoleInfo.setCallType(PoolRoleInfo.Type_CreateRole); | 257 | + // poolRoleInfo.setCallType(PoolRoleInfo.Type_CreateRole);//创建角色(如果游戏创建角色时没有角色名,需要在用户创建角色名时调用多一次进入游戏统计,否则用户名无法正常统计,投放测试无法通过) |
229 | - // poolRoleInfo.setCallType(PoolRoleInfo.Type_RoleUpgrade); | 258 | + // poolRoleInfo.setCallType(PoolRoleInfo.Type_RoleUpgrade);//角色升级 |
230 | 259 | ||
231 | PoolSdkHelper.submitRoleData(poolRoleInfo, new PoolRoleListener() { | 260 | PoolSdkHelper.submitRoleData(poolRoleInfo, new PoolRoleListener() { |
232 | @Override | 261 | @Override |
... | @@ -235,10 +264,17 @@ | ... | @@ -235,10 +264,17 @@ |
235 | } | 264 | } |
236 | }); | 265 | }); |
237 | 266 | ||
238 | - 2.5、支付接口(必接) | 267 | +``` |
239 | - 2.5.1、方法定义 | 268 | + |
240 | - public static void pay(final PoolPayInfo poolPayInfo,final PoolPayListener poolPayListener) | 269 | +#### 2.5、支付接口(必接) |
241 | - 2.5.2、参数说明 | 270 | + |
271 | +#### 2.5.1、方法定义 | ||
272 | +```java | ||
273 | +public static void pay(final PoolPayInfo poolPayInfo,final PoolPayListener poolPayListener) | ||
274 | +``` | ||
275 | + | ||
276 | +#### 2.5.2、参数说明 | ||
277 | + | ||
242 | | 参数 | 说明 | | 278 | | 参数 | 说明 | |
243 | | ---------------- | ---------------- | | 279 | | ---------------- | ---------------- | |
244 | | poolRoleInfo | 角色数据实体类 | | 280 | | poolRoleInfo | 角色数据实体类 | |
... | @@ -258,6 +294,8 @@ | ... | @@ -258,6 +294,8 @@ |
258 | | exchange | 游戏币与人民币(元)的兑换比例 | | 294 | | exchange | 游戏币与人民币(元)的兑换比例 | |
259 | | custom | 自定义透传参数,通过回调函数原样返回 | | 295 | | custom | 自定义透传参数,通过回调函数原样返回 | |
260 | 296 | ||
297 | + | ||
298 | +```java | ||
261 | 2.5.3、代码示例 | 299 | 2.5.3、代码示例 |
262 | /******************************************** | 300 | /******************************************** |
263 | * 以下所有字段都是必填项 | 301 | * 以下所有字段都是必填项 |
... | @@ -284,7 +322,7 @@ | ... | @@ -284,7 +322,7 @@ |
284 | poolPayInfo.setExchange("10"); | 322 | poolPayInfo.setExchange("10"); |
285 | // 自定义参数 | 323 | // 自定义参数 |
286 | poolPayInfo.setCustom("我是自定义参数"); | 324 | poolPayInfo.setCustom("我是自定义参数"); |
287 | - // TODO Auto-generated method stub | 325 | + // 充值回调以服务端回调为准 |
288 | PoolSdkHelper.pay(poolPayInfo, new PoolPayListener() { | 326 | PoolSdkHelper.pay(poolPayInfo, new PoolPayListener() { |
289 | @Override | 327 | @Override |
290 | public void onPaySuccess(String paramCustom) { | 328 | public void onPaySuccess(String paramCustom) { |
... | @@ -296,16 +334,29 @@ | ... | @@ -296,16 +334,29 @@ |
296 | + errorMsg); | 334 | + errorMsg); |
297 | } | 335 | } |
298 | }); | 336 | }); |
337 | +``` | ||
338 | + | ||
339 | +#### 2.6、检测 SDK 是否含有用户中心接口(必接) | ||
340 | + | ||
341 | +说明:如果接口返回为 true,表示需要游戏方在合适的界面中添加一个用户中心的按钮,点击按钮时调用文档中 2.7 的用户中心接口; | ||
342 | + | ||
343 | +如果返回 false,则不做处理 | ||
344 | + | ||
345 | +#### 2.6.1、方法定义 | ||
346 | +```java | ||
347 | +public static boolean hasChannelCenter() | ||
348 | +``` | ||
349 | +#### 2.7、用户中心接口(必接) | ||
350 | + | ||
351 | +说明:打开渠道用户中心界面 | ||
352 | + | ||
353 | +#### 2.7.1、方法定义 | ||
354 | +```java | ||
355 | +public static void openChannelCenter() | ||
356 | +``` | ||
357 | + | ||
358 | +```java | ||
299 | 359 | ||
300 | - 2.6、检测 SDK 是否含有用户中心接口(必接) | ||
301 | - 说明:如果接口返回为 true,表示需要游戏方在合适的界面中添加一个用户中心的按钮,点击按钮时调用文 | ||
302 | - 档中 2.7 的用户中心接口;如果返回 false,则不做处理 | ||
303 | - 2.6.1、方法定义 | ||
304 | - public static boolean hasChannelCenter() | ||
305 | - 2.7、用户中心接口(必接) | ||
306 | - 说明:打开渠道用户中心界面 | ||
307 | - 2.7.1、方法定义 | ||
308 | - public static void openChannelCenter() | ||
309 | 2.7.2、代码示例 | 360 | 2.7.2、代码示例 |
310 | /** | 361 | /** |
311 | * 用户中心 | 362 | * 用户中心 |
... | @@ -318,15 +369,25 @@ | ... | @@ -318,15 +369,25 @@ |
318 | PoolSdkHelper.openChannelCenter(); | 369 | PoolSdkHelper.openChannelCenter(); |
319 | } | 370 | } |
320 | 371 | ||
321 | - 2.8、注销登录监听接口 | 372 | +``` |
322 | - 说明:可在游戏启动时设置注销监听事件,渠道注销成功后 SDK 会回调 onLogoutSuccess 方法通知游戏,游戏可在此处理切换账号逻辑 | 373 | +#### 2.8、注销登录监听接口 |
323 | - 2.8.1、方法定义 | 374 | + |
324 | - public static void setLogoutCallback(final PoolLogoutListener poolLogoutListener) | 375 | +说明:可在游戏启动时设置注销监听事件,渠道注销成功后 SDK 会回调 onLogoutSuccess 方法通知游戏,游戏可在此处理切换账号逻辑 |
325 | - 2.8.2、参数说明 | 376 | + |
377 | +#### 2.8.1、方法定义 | ||
378 | + | ||
379 | +```java | ||
380 | +public static void setLogoutCallback(final PoolLogoutListener poolLogoutListener) | ||
381 | +``` | ||
382 | + | ||
383 | +#### 2.8.2、参数说明 #### | ||
384 | + | ||
326 | | 参数 | 说明 | | 385 | | 参数 | 说明 | |
327 | | ------------------ | --------------------------------- | | 386 | | ------------------ | --------------------------------- | |
328 | | poolLogoutListener | 账户注销成功回调监听,需实现 onLogoutSuccess 方法 | | 387 | | poolLogoutListener | 账户注销成功回调监听,需实现 onLogoutSuccess 方法 | |
329 | 388 | ||
389 | + | ||
390 | +```java | ||
330 | 2.8.3、代码示例 | 391 | 2.8.3、代码示例 |
331 | PoolSdkHelper.setLogoutCallback(new PoolLogoutListener() { | 392 | PoolSdkHelper.setLogoutCallback(new PoolLogoutListener() { |
332 | @Override | 393 | @Override |
... | @@ -336,19 +397,26 @@ | ... | @@ -336,19 +397,26 @@ |
336 | PoolSdkLog.logInfo("游戏中logoutSuccess"); | 397 | PoolSdkLog.logInfo("游戏中logoutSuccess"); |
337 | } | 398 | } |
338 | }); | 399 | }); |
400 | +``` | ||
401 | + | ||
402 | +#### 2.9、退出游戏接口(必接) | ||
339 | 403 | ||
340 | - 2.9、退出游戏接口(必接) | ||
341 | 说明:在游戏需要退出时调用,调用此接口时需先用 PoolSdkHelper.hasExitDialog() 判断 sdk 是否有退出界 | 404 | 说明:在游戏需要退出时调用,调用此接口时需先用 PoolSdkHelper.hasExitDialog() 判断 sdk 是否有退出界 |
342 | 面,为 true表示有退出界面需调用 showExitDialog()显示退出界面,为 false 时表示没有退出界面,游戏需自己处 | 405 | 面,为 true表示有退出界面需调用 showExitDialog()显示退出界面,为 false 时表示没有退出界面,游戏需自己处 |
343 | 理退出逻辑且在确认 游戏退出前调用 PoolSdkHelper.exitGame 通知 SDK 游戏要退出 (具体可参照 Demo 示例) | 406 | 理退出逻辑且在确认 游戏退出前调用 PoolSdkHelper.exitGame 通知 SDK 游戏要退出 (具体可参照 Demo 示例) |
344 | - 2.9.1、方法定义 | 407 | + |
345 | - public static void showExitDialog(final PoolExitDialogListener exitDialogListener) | 408 | +#### 2.9.1、方法定义 |
346 | - 2.9.2、参数说明 | 409 | +```java |
410 | +public static void showExitDialog(final PoolExitDialogListener exitDialogListener) | ||
411 | +``` | ||
412 | + | ||
413 | +#### 2.9.2、参数说明 | ||
414 | + | ||
347 | | 参数 | 说明 | | 415 | | 参数 | 说明 | |
348 | | ------------------ | ------------------------------ | | 416 | | ------------------ | ------------------------------ | |
349 | | exitDialogListener | 退出结果回调监听,需实现 onDialogResult 方法 | | 417 | | exitDialogListener | 退出结果回调监听,需实现 onDialogResult 方法 | |
350 | 418 | ||
351 | - | 419 | +```java |
352 | 2.9.3、代码示例 | 420 | 2.9.3、代码示例 |
353 | @Override | 421 | @Override |
354 | public boolean dispatchKeyEvent(KeyEvent pKeyEvent) { | 422 | public boolean dispatchKeyEvent(KeyEvent pKeyEvent) { |
... | @@ -379,9 +447,13 @@ | ... | @@ -379,9 +447,13 @@ |
379 | } | 447 | } |
380 | return super.dispatchKeyEvent(pKeyEvent); | 448 | return super.dispatchKeyEvent(pKeyEvent); |
381 | } | 449 | } |
382 | - 2.10、Android 生命周期接口(必接) | 450 | +``` |
451 | + | ||
452 | +### 2.10、Android 生命周期接口(必接) ### | ||
383 | 说明:在游戏 Activity 的 onStart、onPause、onResume、 onStop、onDestroy、onRestart、onNewIntent、 onActivityResult、onConfigurationChanged、onSaveInstanceState、onRestoreInstanceState、onWindowFocusChanged、onWindowAttributesChanged 中分别调用对应的接口 | 453 | 说明:在游戏 Activity 的 onStart、onPause、onResume、 onStop、onDestroy、onRestart、onNewIntent、 onActivityResult、onConfigurationChanged、onSaveInstanceState、onRestoreInstanceState、onWindowFocusChanged、onWindowAttributesChanged 中分别调用对应的接口 |
384 | - 2.10.1、代码示例 | 454 | + |
455 | +```java | ||
456 | + 2.10.1 代码示例 | ||
385 | @Override | 457 | @Override |
386 | public void onStart() { | 458 | public void onStart() { |
387 | super.onStart(); | 459 | super.onStart(); |
... | @@ -463,8 +535,9 @@ | ... | @@ -463,8 +535,9 @@ |
463 | super.onWindowAttributesChanged(params); | 535 | super.onWindowAttributesChanged(params); |
464 | PoolSdkHelper.onWindowAttributesChanged(params); | 536 | PoolSdkHelper.onWindowAttributesChanged(params); |
465 | } | 537 | } |
538 | +``` | ||
466 | 539 | ||
467 | - 2.11、扩展接口(可选) | 540 | +### 2.11、扩展接口(可选) ### |
468 | 说明:该接口为扩展的万能接口,留作备用,目前游戏方可以不接入 | 541 | 说明:该接口为扩展的万能接口,留作备用,目前游戏方可以不接入 |
469 | 2.11.1、方法定义 | 542 | 2.11.1、方法定义 |
470 | public static void expansionInterface(final String paramCustom,final PoolExpansionListener poolExpansionListener) | 543 | public static void expansionInterface(final String paramCustom,final PoolExpansionListener poolExpansionListener) |
... | @@ -474,43 +547,57 @@ | ... | @@ -474,43 +547,57 @@ |
474 | | paramCustom | 自定义参数 | | 547 | | paramCustom | 自定义参数 | |
475 | | poolExpansionListener | 方法回调参数,实现onSuccess方法 | | 548 | | poolExpansionListener | 方法回调参数,实现onSuccess方法 | |
476 | 549 | ||
477 | - 2.12、获取渠道包标识(可选) | 550 | +### 2.12、获取渠道包标识(可选) ### |
478 | 接口名称:PoolSdkHelper.getGameChannelId() | 551 | 接口名称:PoolSdkHelper.getGameChannelId() |
479 | 接口说明:获取在企业平台配置的渠道标识,返回类型为 String | 552 | 接口说明:获取在企业平台配置的渠道标识,返回类型为 String |
480 | 接口名称:PoolSdkHelper. getChannelParameter1 () | 553 | 接口名称:PoolSdkHelper. getChannelParameter1 () |
481 | 接口说明:获取在企业平台配置的渠道参数 1,返回类型为 String | 554 | 接口说明:获取在企业平台配置的渠道参数 1,返回类型为 String |
482 | 接口名称:PoolSdkHelper. getChannelParameter2 () | 555 | 接口名称:PoolSdkHelper. getChannelParameter2 () |
483 | 接口说明:获取在企业平台配置的渠道参数 2,返回类型为 String | 556 | 接口说明:获取在企业平台配置的渠道参数 2,返回类型为 String |
484 | - 2.13、获取渠道自定义参数(可选) | 557 | +### 2.13、获取渠道自定义参数(可选) ### |
485 | 接口名称:PoolSdkHelper.getCustomValue() | 558 | 接口名称:PoolSdkHelper.getCustomValue() |
486 | 接口说明:获取在企业平台配置的渠道自定义参数,返回类型为 String | 559 | 接口说明:获取在企业平台配置的渠道自定义参数,返回类型为 String |
487 | - 2.14、打开论坛接口(UC 平台专用) | 560 | +### 2.14、打开论坛接口(UC 平台专用) ### |
488 | 接口名称:PoolSkHelper.openForum() | 561 | 接口名称:PoolSkHelper.openForum() |
489 | 接口说明:打开渠道的论坛界面 | 562 | 接口说明:打开渠道的论坛界面 |
490 | - 2.15、注销接口 | 563 | +### 2.15、注销接口 ### |
491 | - 说明:该接口在游戏需要注销账号时调用,注销结果通知到PoolLogoutListener回调中,调用之前先判断是否包含此接口(hasLogout()) | 564 | + |
492 | - 2.15.1、方法定义 | 565 | +说明:该接口在游戏需要注销账号时调用,注销结果通知到PoolLogoutListener回调中,调用之前先判断是否包含此接口(hasLogout()) |
493 | - public static void logout(final Activity paramActivity) ; | 566 | + |
494 | - 2.15.2、参数说明 | 567 | +#### 2.15.1、方法定义 |
568 | +```java | ||
569 | +public static void logout(final Activity paramActivity) ; | ||
570 | +``` | ||
571 | +#### 2.15.2、参数说明 | ||
572 | + | ||
495 | | 参数 | 说明 | | 573 | | 参数 | 说明 | |
496 | | ------------- | ---- | | 574 | | ------------- | ---- | |
497 | | paramActivity | 上下文 | | 575 | | paramActivity | 上下文 | |
498 | 576 | ||
577 | +```java | ||
499 | 2.15.3、代码示例 | 578 | 2.15.3、代码示例 |
500 | private void logout(){ | 579 | private void logout(){ |
501 | if(PoolSdkHelper.hasLogout()){ | 580 | if(PoolSdkHelper.hasLogout()){ |
502 | PoolSdkHelper.logout(this); | 581 | PoolSdkHelper.logout(this); |
503 | } | 582 | } |
504 | } | 583 | } |
505 | - 2.16、切换账号接口 | 584 | +``` |
506 | - 说明:该接口在游戏切换账号时调用,切换成功回通知到登录监听回调中,调用前请判断是否含有此接口(hasSwitchAccount) | 585 | + |
507 | - 2.16.1、方法定义 | 586 | +### 2.16、切换账号接口 |
508 | - public static void switchAccount(final Activity paramActivity); | 587 | + |
509 | - 2.16.2、参数说明 | 588 | + |
589 | +#### 2.16.1、方法定义 | ||
590 | +```java | ||
591 | +public static void switchAccount(final Activity paramActivity); | ||
592 | +``` | ||
593 | + | ||
594 | +#### 2.16.2、参数说明 | ||
595 | + | ||
510 | | 参数 | 说明 | | 596 | | 参数 | 说明 | |
511 | | ------------- | ---- | | 597 | | ------------- | ---- | |
512 | | paramActivity | 上下文 | | 598 | | paramActivity | 上下文 | |
513 | 599 | ||
600 | +```java | ||
514 | 2.16.3、代码示例 | 601 | 2.16.3、代码示例 |
515 | /** | 602 | /** |
516 | * 切换帐号 | 603 | * 切换帐号 |
... | @@ -520,11 +607,17 @@ | ... | @@ -520,11 +607,17 @@ |
520 | PoolSdkHelper.switchAccount(this); | 607 | PoolSdkHelper.switchAccount(this); |
521 | } | 608 | } |
522 | } | 609 | } |
610 | +``` | ||
611 | + | ||
612 | +### 2.17、聊天统计 ### | ||
613 | + | ||
614 | +说明:在用户发送聊天信息时调用该接口 | ||
615 | + | ||
616 | +```java | ||
617 | +public static void reportChat(final String content,String type,final String accountId,final String accountName, final int level, final String serverId,final String serverName) | ||
618 | +``` | ||
619 | +参数说明: | ||
523 | 620 | ||
524 | - 2.17、聊天统计 | ||
525 | - 说明:在用户发送聊天信息时调用改接口 | ||
526 | - 方法:public static void reportChat(final String content,String type, final String accountId,final String accountName, final int level, final String serverId,final String serverName) | ||
527 | - 参数说明: | ||
528 | 参数 |说明 | 621 | 参数 |说明 |
529 | ------------ | ------------- | 622 | ------------ | ------------- |
530 | content | 聊天内容 | 623 | content | 聊天内容 |
... | @@ -551,4 +644,7 @@ serverName | 服务器名称 | ... | @@ -551,4 +644,7 @@ serverName | 服务器名称 |
551 | - 后台配置正确的游戏充值回调地址可以进行充值测试是否到账 | 644 | - 后台配置正确的游戏充值回调地址可以进行充值测试是否到账 |
552 | 645 | ||
553 | # 4、母包 # | 646 | # 4、母包 # |
554 | - 4.1、接入公共 SDK 编译生成的 apk 即为打包工具使用的母包(可以删掉assets下的data.bin,libs下的SDK相关so库,YouaiSDK.jar) | 647 | +``` |
648 | +4.1、接入公共 SDK 编译生成的 apk 即为打包工具使用的母包(接入完成测试通过后 如果需要使用打包工具打渠道包则母包必须删除assets下的公共SDK相关资源, libs下的YouaiSDK.jar,删除接入时manifest中添加的activity) | ||
649 | +``` | ||
650 | + | ... | ... |
-
Please register or login to post a comment