大白鲨1.0

xuguohong
Commit fc7513d6dfb802c03d1f1e161484bd950fde7b2a fc7513d6 1 parent 2b9534db
Showing 4 changed files with 72 additions and 120 deletions
README.md
publicAndroidSDK/demo/Demo_PoolSdk/libs/poolsdkV2.jar
publicAndroidSDK/doc/公共SDK客户端接入文档.md
publicAndroidSDK/libs/poolsdkV2.jar
--- a/README.md
View file @fc7513d
+++ b/README.md
View file @fc7513d
 # 更新说明
-2016-07-26:  
-1、公共SDK安卓版本提交
-<br>2016-12-7:
-<br>1、添加注销接口，切换账号接口
-<br>2、添加了onSaveInstanceState，onRestoreInstanceState，onWindowFocusChanged，onWindowAttributesChanged等接口
-<br>3、提交角色方法增加了字段
-
-```xml
-2016-12-14
-1、公共SDK加入9133正式版SDK
-```
-
-```xml
-2017-1-10
-1、重新替换asset/poolsdk.xml
-```
-
-```xml
-2017-2-09
-1、已接入直接替换poolsdkV2.jar
-```
-```xml
-2017-2-22
-1、assets中添加sdk,sdk.zip,sdkconfig.ini文件
-2、替换YouaiSDK.jar为XingWanSDK.jar
-3、更新poolsdkV2.jar
-```
-
-2017-07-07<br>
-1、sdk更新和添加文件损坏处理
-
-2017-07-24<br>
-1、添加聊天统计，修改安装标识码
\ No newline at end of file
+2017-07-31<br>
+1、大白鲨1.0版本
\ No newline at end of file
--- a/publicAndroidSDK/demo/Demo_PoolSdk/libs/poolsdkV2.jar
View file @fc7513d
+++ b/publicAndroidSDK/demo/Demo_PoolSdk/libs/poolsdkV2.jar
View file @fc7513d
--- a/publicAndroidSDK/doc/公共SDK客户端接入文档.md
View file @fc7513d
+++ b/publicAndroidSDK/doc/公共SDK客户端接入文档.md
View file @fc7513d
@@ -10,18 +10,17 @@
 #### 1.2、复制SDK压缩包中assets目录下的所有内容到游戏工程的assets目录 ####
 - 将游戏中的闪屏图片放到assets中poolsdk_splash目录下
-- 将assets中的sdk,sdk.zip,sdkconfig.ini复制到接入工程中
+- 将assets中的poolsdk.xml中的`YA_APPKEY，YA_APPID，gamesimplename` 修改为后台生成的参数（必填）
-- 将assets中的poolsdk.xml中的`YA_APPKEY，YA_APPID，gamesimplename` 修改为后台生成的参数
+- channelparameter1 和 channelparameter2 为后台对应渠道编号1和2（选填）
-- channelparameter1 和 channelparameter2 为后台对应渠道编号1和2
+- custom 为自定义参数（选填）
-- custom 为自定义参数
+- gamechannelid 为游戏渠道号（选填）
-- gamechannelid 为游戏渠道号
 ![](http://i.imgur.com/gcqAjL1.png)
 #### 1.3、修改游戏工程的AndroidManifest.xml（可以参照复制Demo中	AndroidManifest.xml文件） ####
 - 添加声明权限：
-- 
+- 
 ```xml
         <uses-permission android:name="android.permission.INTERNET" />
         <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
@@ -98,21 +97,6 @@
             android:exported="true"
             android:launchMode="singleTop" />
-        <uses-library
-            android:name="org.simalliance.openmobileapi"
-            android:required="false" />
-
-        <activity
-            android:name="com.unionpay.uppay.PayActivity"
-            android:configChanges="orientation|keyboardHidden|keyboard"
-            android:screenOrientation="portrait" >
-        </activity>
-        <activity
-            android:name="com.unionpay.UPPayWapActivity"
-            android:configChanges="orientation|keyboardHidden|fontScale"
-            android:screenOrientation="portrait"
-            android:windowSoftInputMode="adjustResize" >
-        </activity>
 ```
@@ -139,10 +123,10 @@
         2.2.1、方法定义
             public static void init(final Activity activity,final PoolSDKCallBackListener callBackListener) 
         2.2.2、参数说明
-参数 |说明
+| 参数               | 说明                               |
------------- 		| ------------- 
+| ---------------- | -------------------------------- |
-activity 			| Activity 对应  
+| activity         | Activity 对应                      |
-callBackListener 	| 初始化完成回调通知,需实现 poolSdkCallBack 方法        	
+| callBackListener | 初始化完成回调通知,需实现 poolSdkCallBack 方法 |
         2.2.3、代码示例:
         PoolSdkHelper.init(this, new PoolSDKCallBackListener() {
@@ -166,10 +150,10 @@ callBackListener 	| 初始化完成回调通知,需实现 poolSdkCallBack 方法
         2.3.1、方法定义
         public static void login(final String paramCustom,final 			PoolLoginListener poolLoginListener)
         2.3.2、参数说明
-参数 |说明
+| 参数                | 说明                                       |
------------- 		| ------------- 
+| ----------------- | ---------------------------------------- |
-paramCustom 		| 游戏自定义参数,可通过登录成功回调方法onLoginSuccess 中的参数PoolLoginInfo 对象的 getCustom()获取  
+| paramCustom       | 游戏自定义参数,可通过登录成功回调方法onLoginSuccess 中的参数PoolLoginInfo 对象的 getCustom()获取 |
-poolLoginListener 	| 登录结果回调通知,需实现 onLoginSuccess 方法
+| poolLoginListener | 登录结果回调通知,需实现 onLoginSuccess 方法           |
 	    2.3.3、代码示例
 			PoolSdkHelper.login("登录自定义字段", new PoolLoginListener() {
@@ -192,34 +176,34 @@ poolLoginListener 	| 登录结果回调通知,需实现 onLoginSuccess 方法
 	2.4、提交角色数据接口(必接)
 	    接口说明:游戏提交角色数据接口,该接口需要在以下 3 中情况下
-        调用:进入游戏主场景、创建角色、角色升级
+	    调用:进入游戏主场景、创建角色、角色升级(如果游戏创建角色时没有角色名，需要在用户创建角色名时调用多一次进入游戏统计，否则用户名无法正常统计，投放测试无法通过)
 	    2.4.1、方法定义
 	    public static void submitRoleData(final PoolRoleInfo poolRoleInfo,
 			final PoolRoleListener poolRoleListener)
 		2.4.2、参数说明
-参数 |说明
+| 参数               | 说明               |
------------- 		| ------------- 
+| ---------------- | ---------------- |
-poolRoleInfo 		| 角色数据实体类
+| poolRoleInfo     | 角色数据实体类          |
-poolRoleListener 	| 角色数据提交结果回调通知,需实现
+| poolRoleListener | 角色数据提交结果回调通知,需实现 |
 		PoolRoleInfo 实体类字段说明
-字段名 				|说明
+| 字段名            | 说明                                       |
------------- 		| ------------- 
+| -------------- | ---------------------------------------- |
-callType 			| 调用类型Type_EnterGame 登录游戏主 场景;Type_CreatRole 为创建角 色;Type_RoleUpgrade 为角色升级
+| callType       | 调用类型Type_EnterGame 登录游戏主 场景;Type_CreatRole 为创建角 色;Type_RoleUpgrade 为角色升级 |
-roleId			 	| 角色 Id
+| roleId         | 角色 Id                                    |
-roleName 			| 角色名称
+| roleName       | 角色名称                                     |
-roleLevel 			| 角色等级
+| roleLevel      | 角色等级                                     |
-roleSex 			| 角色性别(1 男 0 女,如果角 色不分性别请填写 0)
+| roleSex        | 角色性别(1 男 0 女,如果角 色不分性别请填写 0)             |
-serverId 			| 服务器 id
+| serverId       | 服务器 id                                   |
-serverName 			| 服务器名称
+| serverName     | 服务器名称                                    |
-custom 				| 自定义字段
+| custom         | 自定义字段                                    |
-roleCTime 			| 角色创建时间(秒)
+| roleCTime      | 角色创建时间(秒)                                |
-partyName 			| 公会名称
+| partyName      | 公会名称                                     |
-roleType 			| 角色类型
+| roleType       | 角色类型                                     |
-roleChangeTime 		| 角色等级更新时间(以秒为单位)
+| roleChangeTime | 角色等级更新时间(以秒为单位)                          |
-vipLevel 			| VIP等级
+| vipLevel       | VIP等级                                    |
-diamond 			| 余额
+| diamond        | 余额                                       |
-moneyType 			| 商品单位
+| moneyType      | 商品单位                                     |
 		2.4.3、代码示例
 		/********************************************
@@ -255,24 +239,24 @@ moneyType 			| 商品单位
 	    2.5.1、方法定义
 	        public static void pay(final PoolPayInfo poolPayInfo,final PoolPayListener poolPayListener)
 	    2.5.2、参数说明
-参数 |说明
+| 参数               | 说明               |
------------- 		| ------------- 
+| ---------------- | ---------------- |
-poolRoleInfo 		| 角色数据实体类
+| poolRoleInfo     | 角色数据实体类          |
-poolRoleListener 	| 角色数据提交结果回调通知,需实现
+| poolRoleListener | 角色数据提交结果回调通知,需实现 |
 	   支付信息实体类(PoolPayInfo)字段说明
-参数 |说明
+| 参数          | 说明                  |
------------- 		| ------------- 
+| ----------- | ------------------- |
-amount 		| 金额(单位元,必须大于 0)
+| amount      | 金额(单位元,必须大于 0)      |
-productId 	| 商品 ID(如果没有可以传空字符 串)
+| productId   | 商品 ID(如果没有可以传空字符 串) |
-productName | 商品描述
+| productName | 商品描述                |
-roleid 		| 角色 id
+| roleid      | 角色 id               |
-rolelevel 		| 角色等级
+| rolelevel   | 角色等级                |
-roleName 	| 角色名称
+| roleName    | 角色名称                |
-serverId 		| 服务器 id
+| serverId    | 服务器 id              |
-serverName 	| 服务器名称
+| serverName  | 服务器名称               |
-exchange 		| 游戏币与人民币(元)的兑换比例
+| exchange    | 游戏币与人民币(元)的兑换比例     |
-custom 	| 自定义透传参数,通过回调函数原样返回
+| custom      | 自定义透传参数,通过回调函数原样返回  |
 	   2.5.3、代码示例
 	        /********************************************
@@ -339,9 +323,9 @@ custom 	| 自定义透传参数,通过回调函数原样返回
 	2.8.1、方法定义
 	public static void setLogoutCallback(final PoolLogoutListener poolLogoutListener)
 	2.8.2、参数说明
-参数 |说明
+| 参数                 | 说明                                |
------------- 			| ------------- 
+| ------------------ | --------------------------------- |
-poolLogoutListener 		| 账户注销成功回调监听,需实现 onLogoutSuccess 方法
+| poolLogoutListener | 账户注销成功回调监听,需实现 onLogoutSuccess 方法 |
     2.8.3、代码示例
         PoolSdkHelper.setLogoutCallback(new PoolLogoutListener() {
@@ -360,9 +344,9 @@ poolLogoutListener 		| 账户注销成功回调监听,需实现 onLogoutSuccess 
     	2.9.1、方法定义
     	    public static void showExitDialog(final PoolExitDialogListener exitDialogListener)
     	2.9.2、参数说明
-  参数 |说明
+| 参数                 | 说明                             |
------------- 			| ------------- 
+| ------------------ | ------------------------------ |
-exitDialogListener 		| 退出结果回调监听,需实现 onDialogResult 方法
+| exitDialogListener | 退出结果回调监听,需实现 onDialogResult 方法 |
     	2.9.3、代码示例
@@ -485,10 +469,10 @@ exitDialogListener 		| 退出结果回调监听,需实现 onDialogResult 方法
     	2.11.1、方法定义
     		public static void expansionInterface(final String paramCustom,final PoolExpansionListener poolExpansionListener)
     	2.11.2、参数说明
- 参数 |说明
+| 参数                    | 说明                   |
------------- 			| ------------- 
+| --------------------- | -------------------- |
-paramCustom 			| 自定义参数
+| paramCustom           | 自定义参数                |
-poolExpansionListener 	| 方法回调参数,实现onSuccess方法
+| poolExpansionListener | 方法回调参数,实现onSuccess方法 |
     2.12、获取渠道包标识(可选)
         接口名称:PoolSdkHelper.getGameChannelId()
@@ -508,9 +492,9 @@ poolExpansionListener 	| 方法回调参数,实现onSuccess方法
     	2.15.1、方法定义
     	public static void logout(final Activity paramActivity) ;
     	2.15.2、参数说明
-参数 |说明
+| 参数            | 说明   |
------------- 			| ------------- 
+| ------------- | ---- |
-paramActivity 			| 上下文
+| paramActivity | 上下文  |
 		2.15.3、代码示例
 		private void logout(){
@@ -523,9 +507,9 @@ paramActivity 			| 上下文
 		2.16.1、方法定义
 		public static void switchAccount(final Activity paramActivity)；
 		2.16.2、参数说明
-参数 |说明
+| 参数            | 说明   |
------------- 			| ------------- 
+| ------------- | ---- |
-paramActivity 			| 上下文
+| paramActivity | 上下文  |
 		2.16.3、代码示例
 		/**
@@ -537,21 +521,20 @@ paramActivity 			| 上下文
 			}
 		}
-		
 		2.17、聊天统计
 		说明：在用户发送聊天信息时调用改接口
-		方法：public static void reportChat(final String content, final String accountId,final 		String accountName, final int level, final String serverId,final String serverName)
+		方法：public static void reportChat(final String content,String type， final String accountId,final 		String accountName, final int level, final String serverId,final String serverName)
 		参数说明：
 参数 |说明
 ------------ 			| ------------- 
 content 			| 聊天内容
+type	 			| 聊天类型（世界，私聊等）
 accountId 			| 角色ID
 accountName 		| 角色名称
 level 				| 角色等级
 serverId 			| 服务器ID
 serverName 			| 服务器名称
-
 # 3、自测用例 #
 ### 3.1、进入游戏会弹出下面的登录界面,表示登录接口接入正常; ###
@@ -568,4 +551,4 @@ serverName 			| 服务器名称
 - 后台配置正确的游戏充值回调地址可以进行充值测试是否到账
 # 4、母包 #
-    4.1、接入公共 SDK 编译生成的 apk 即为打包工具使用的母包
+    4.1、接入公共 SDK 编译生成的 apk 即为打包工具使用的母包（可以删掉assets下的data.bin,libs下的SDK相关so库，YouaiSDK.jar）
--- a/publicAndroidSDK/libs/poolsdkV2.jar
View file @fc7513d
+++ b/publicAndroidSDK/libs/poolsdkV2.jar
View file @fc7513d