SDK / GameSDK4-android

Browse Code »

Commit 442078de6e09aea29bc482ee255be647d33ec176

Authored by 赵康 2021-07-29 14:47:01 +0800

1 parent d71917580c

Exists in master

add createUser of event callback

Showing 3 changed files with 20 additions and 5 deletions Inline Diff

GameSDKDemo/build.gradle
GameSDKDemo/src/main/java/com/gump/game/sdk/demo/MainActivity.java
README.md

GameSDKDemo/build.gradle

Diff comments View file @ 442078d

1	apply plugin: 'com.android.application'	1	apply plugin: 'com.android.application'
2		2
3	/*The config for internal testing,you could ignore it	3	/*The config for internal testing,you could ignore it
4	* gump内部测试使用，你可以自行配置，或者直接删除这部分内容	4	* gump内部测试使用，你可以自行配置，或者直接删除这部分内容
5	* --start--	5	* --start--
6	*/	6	*/
7	def keystorePSW = ''	7	def keystorePSW = ''
8	def keystoreAlias = ''	8	def keystoreAlias = ''
9	def keystoreAliasPSW = ''	9	def keystoreAliasPSW = ''
10	// default keystore file, PLZ config file path in local.properties	10	// default keystore file, PLZ config file path in local.properties
11	def keyfile = file('s.keystore.temp')	11	def keyfile = file('s.keystore.temp')
12		12
13	Properties properties = new Properties()	13	Properties properties = new Properties()
14	// local.properties file in the root director	14	// local.properties file in the root director
15	properties.load(project.file('local.properties').newDataInputStream())	15	properties.load(project.file('local.properties').newDataInputStream())
16	def keystoreFilepath = properties.getProperty("keystore.path")	16	def keystoreFilepath = properties.getProperty("keystore.path")
17		17
18	if (keystoreFilepath) {	18	if (keystoreFilepath) {
19	keystorePSW = properties.getProperty("keystore.password")	19	keystorePSW = properties.getProperty("keystore.password")
20	keystoreAlias = properties.getProperty("keystore.alias")	20	keystoreAlias = properties.getProperty("keystore.alias")
21	keystoreAliasPSW = properties.getProperty("keystore.key_passwd")	21	keystoreAliasPSW = properties.getProperty("keystore.key_passwd")
22	keyfile = file(keystoreFilepath)	22	keyfile = file(keystoreFilepath)
23	}	23	}
24	/*	24	/*
25	* The config for internal testing,you could ignore it	25	* The config for internal testing,you could ignore it
26	* gump内部测试使用，你可以自行配置，或者直接删除这部分内容	26	* gump内部测试使用，你可以自行配置，或者直接删除这部分内容
27	* --end--	27	* --end--
28	*/	28	*/
29		29
30	repositories {	30	repositories {
31	maven {	31	maven {
32	url "http://117.50.8.198:8081/nexus/content/repositories/sdk"	32	url "http://117.50.8.198:8081/nexus/content/repositories/sdk"
33	}	33	}
34	jcenter()	34	jcenter()
35	google()	35	google()
36	}	36	}
37		37
38	android {	38	android {
39	compileSdkVersion 30	39	compileSdkVersion 30
40	buildToolsVersion '28.0.3'	40	buildToolsVersion '28.0.3'
41		41
42	signingConfigs {	42	signingConfigs {
43	release {	43	release {
44	storeFile keyfile	44	storeFile keyfile
45	storePassword keystorePSW	45	storePassword keystorePSW
46	keyPassword keystoreAliasPSW	46	keyPassword keystoreAliasPSW
47	keyAlias keystoreAlias	47	keyAlias keystoreAlias
48	}	48	}
49	}	49	}
50		50
51	defaultConfig {	51	defaultConfig {
52	minSdkVersion 14	52	minSdkVersion 14
53	targetSdkVersion 30	53	targetSdkVersion 30
54	applicationId "com.ecgaaa.uuac"	54	applicationId "com.ecgaaa.uuac"
55	versionCode 38	55	versionCode 38
56	versionName "1.0.3"	56	versionName "1.0.3"
57	testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"	57	testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
58	signingConfig signingConfigs.release	58	signingConfig signingConfigs.release
59	}	59	}
60	buildTypes {	60	buildTypes {
61	release {	61	release {
62	minifyEnabled false	62	minifyEnabled false
63	proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'	63	proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
64	zipAlignEnabled true	64	zipAlignEnabled true
65	}	65	}
66	debug {	66	debug {
67	signingConfig signingConfigs.release	67	signingConfig signingConfigs.release
68	}	68	}
69	}	69	}
70	lintOptions {	70	lintOptions {
71	abortOnError false	71	abortOnError false
72	}	72	}
73	compileOptions {	73	compileOptions {
74	sourceCompatibility JavaVersion.VERSION_1_8	74	sourceCompatibility JavaVersion.VERSION_1_8
75	targetCompatibility JavaVersion.VERSION_1_8	75	targetCompatibility JavaVersion.VERSION_1_8
76	}	76	}
77	applicationVariants.all {	77	applicationVariants.all {
78	variant ->	78	variant ->
79	variant.outputs.all {	79	variant.outputs.all {
80	outputFileName = "GameSDKDemo-" + variant.name + defaultConfig.versionName + ".apk"	80	outputFileName = "GameSDKDemo-" + variant.name + defaultConfig.versionName + ".apk"
81	}	81	}
82	}	82	}
83		83
84	}	84	}
85		85
86	dependencies {	86	dependencies {
87	implementation fileTree(include: ['*.jar'], dir: 'libs')	87	implementation fileTree(include: ['*.jar'], dir: 'libs')
88	// implementation 'com.android.support:support-v4:27.1.1'	88	// implementation 'com.android.support:support-v4:27.1.1'
89	implementation 'androidx.appcompat:appcompat:1.2.0'	89	implementation 'androidx.appcompat:appcompat:1.2.0'
90	implementation 'androidx.fragment:fragment:1.2.5'	90	implementation 'androidx.fragment:fragment:1.2.5'
91	implementation 'com.google.android.material:material:1.2.1'	91	implementation 'com.google.android.material:material:1.2.1'
92	testImplementation 'junit:junit:4.12'	92	testImplementation 'junit:junit:4.12'
93	// implementation 'com.android.support:appcompat-v7:27.1.1'	93	// implementation 'com.android.support:appcompat-v7:27.1.1'
94	// implementation 'com.android.support:design:27.1.1'	94	// implementation 'com.android.support:design:27.1.1'
95	// implementation project(':GameSDK')	95	// implementation project(':GameSDK')
96	// implementation project(':IAP5Helper')	96	// implementation project(':IAP5Helper')
97	implementation 'com.gumptech.sdk:GameSDK:4.9.0'	97	implementation 'com.gumptech.sdk:GameSDK:4.9.1'
98	// implementation 'com.gump.game.sdk:SamsungIAP:5.1.1'	98	// implementation 'com.gump.game.sdk:SamsungIAP:5.1.1'
99	}	99	}
100		100

GameSDKDemo/src/main/java/com/gump/game/sdk/demo/MainActivity.java

Diff comments View file @ 442078d

 package com.gump.game.sdk.demo;
 import android.os.Bundle;
 import android.util.Log;
 import android.widget.Button;
 import android.widget.TextView;
 import android.widget.Toast;
 import com.gump.game.sdk.GameSDK;
 import com.gump.game.sdk.GumpPreference;
 import com.gump.game.sdk.SDKSettings;
 import com.gump.game.sdk.bean.GumpUser;
 import com.gump.game.sdk.callback.LoginStateListener;
 import com.gump.game.sdk.callback.RechargeCallback;
 import com.gump.game.sdk.passport.fb.FBAccessToken;
 import java.util.Locale;
 import androidx.appcompat.app.AppCompatActivity;
 public class MainActivity extends AppCompatActivity implements RechargeCallback {
     private static final String TAG = "MainActivity";
     private TextView tvVersion;
     private TextView userInfo;
     private Button btnLoginOrLogout;
     private Button btnCheckState;
     private Button btnPay;
     private Button btnIap;
     private String appId = "100";
     private String channelId = "1001";
     private GumpUser gumpUser;
     /**
      * 测试数据
      */
     String serverId = "S168";
     String roleId = "168000089";
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         tvVersion = findViewById(R.id.version);
         userInfo = findViewById(R.id.user_info);
         btnLoginOrLogout = findViewById(R.id.login_or_logout);
         btnCheckState = findViewById(R.id.check_state);
         btnLoginOrLogout.setOnClickListener(v -> {
             if (btnLoginOrLogout.getTag() == null || (Integer) btnLoginOrLogout.getTag() == 0)
                 GameSDK.login(MainActivity.this);
             else
                 GameSDK.logout(MainActivity.this);
         });
         btnCheckState.setOnClickListener(v -> {
             GameSDK.iapUsable(MainActivity.this, serverId, roleId, usable -> {
                 btnIap.setEnabled(usable);
                 btnPay.setEnabled(!usable);
             });
         });
         btnPay = findViewById(R.id.pay);
         btnPay.setOnClickListener(v -> {
             PaymentInfoSubmitFragment submitFragment = PaymentInfoSubmitFragment.newInstance(payInfo -> GameSDK.pay(MainActivity.this, payInfo, MainActivity.this));
             submitFragment.show(getSupportFragmentManager(), "pay");
         });
         btnIap = findViewById(R.id.iap);
         btnIap.setOnClickListener(v -> {
             PaymentInfoSubmitFragment submitFragment = PaymentInfoSubmitFragment.newInstance(payInfo -> GameSDK.iap(MainActivity.this, payInfo, MainActivity.this));
             submitFragment.show(getSupportFragmentManager(), "iap");
         });
         Log.i("DEMO", "country:" + Locale.getDefault().getCountry() + ",language:" + Locale.getDefault().getLanguage());
         GameSDK.getSettings().setDebug(false);
         /**
          * 设置是否打印debug日志
          */
         GameSDK.getSettings().enableDebugLogging(true);
         /**
          * 设置启用facebook登录
          */
         GameSDK.getSettings().requestThirdSupport(SDKSettings.THIRD_SUPPORT_FB);
         /**
          * 设置启用google登录
          */
         GameSDK.getSettings().requestThirdSupport(SDKSettings.THIRD_SUPPORT_GOOGLE);
         /**
          * 设置启用Line登录
          */
         GameSDK.getSettings().requestThirdSupport(SDKSettings.THIRD_SUPPORT_LINE);
         /**
          * 设置用户登录状态监听器
          */
         GameSDK.setUserStateListener(new LoginStateListener() {
+            @Override
+            public void onCreateUser() {
+                //新用户注册,用于事件打点。勿阻塞此方法，否则将影响登录流程
+                Log.i(TAG,"Someone registers an new Account");
+            }
             @Override
             public void onLoginSuccess(GumpUser user) {
                 btnCheckState.setEnabled(true);
                 gumpUser = user;
                 String userType = null;
                 switch (user.getAccountType()) {
                     case GumpPreference.ACCOUNT_TYPE_FB:
                         userType = "Facebook登录";
                         String fbToken = FBAccessToken.getCurrentAccessToken().getToken();
                         Log.d(TAG, "FBAccessToken:" + fbToken);
                         break;
                     case GumpPreference.ACCOUNT_TYPE_QUICK_REG:
                         userType = "快速登录";
                         break;
                     case GumpPreference.ACCOUNT_TYPE_REG:
                         userType = "gump注册用户";
                         break;
                     case GumpPreference.ACCOUNT_TYPE_GOOGLE:
                         userType = "google 登录";
                         break;
                     case GumpPreference.ACCOUNT_TYPE_LINE:
                         userType = "Line登录";
                         break;
                 }
                 userInfo.setText(" Userid:" + user.getUid() + "\n accountType:(" + user.getAccountType() + ") " + userType + "\n sessionKey:" + user.getSessionKey()
                         .getToken());
                 btnLoginOrLogout.setText("Logout");
                 btnLoginOrLogout.setTag(1);
             }
             @Override
             public void onLoginFailed(int code, String msg) {
                 userInfo.setText(msg);
                 Toast.makeText(MainActivity.this, "Login failed:code=" + code + ",message=" + msg, Toast.LENGTH_SHORT).show();
             }
             @Override
             public void onLoginCanceled() {
                 Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show();
             }
             @Override
             public void onLogout() {
                 btnLoginOrLogout.setText("Login");
                 btnLoginOrLogout.setTag(0);
                 userInfo.setText("User is logout");
             }
             @Override
             public void onPermissionDenied(String[] deniedPermissions) {
                 StringBuilder sb = new StringBuilder();
                 for (String s : deniedPermissions) {
                     sb.append(s);
                     sb.append(",");
                 }
                 Toast.makeText(MainActivity.this, "Permission denied:" + sb.toString(), Toast.LENGTH_SHORT).show();
             }
         });
         /**
          * 初始化sdk
          */
         GameSDK.init(getApplicationContext(), appId,channelId);
         tvVersion.setText("SDK Version:" + GameSDK.getVersion());
     }
     private void checkRisk() {
         GameSDK.inspectRiskLevel(this, isRisk -> Log.i(TAG, isRisk ? "There is some risks" : "Nothing is risk"));
     }
     @Override
     public void onPurchaseCompleted() {
         Log.i(TAG, "purchase completed");
     }
     @Override
     public void onPurchaseError(int code, String msg) {
         Log.i(TAG, "purchase error:"+code+","+msg);
     }
     @Override
     public void onPurchaseCanceled() {
         Log.i(TAG, "purchase canceled");
     }
 }

README.md

Diff comments View file @ 442078d

 # Gump SDK 4 for Android接入文档
-V4.9.0
+V4.9.1
-2021年06月21日
+2021年07月29日
 ## 版本概述
 此版本为使用AndroidStudio开发的版本,使用aar的方式提供sdk接入包,并使用gradle在线依赖方式,aar内别不包含依赖包,请按此文档描述接入.
 此SDK适用android4.0以上系统.
 ## 第一章  接入指南
 ### 1.依赖导入
 配置gradle,以下为必须项
 ```groovy
 repositories{
     maven{
     	url "http://117.50.8.198:8081/nexus/content/repositories/sdk"
 	}
 }
 dependencies {
-    implementation 'com.gumptech.sdk:GameSDK:4.9.0'
+    implementation 'com.gumptech.sdk:GameSDK:4.9.1'
 }
 ```
 ### 2.修改AndroidManifest.xml文件
 首先添加必要的权限，如下所示：
 ```xml
 <uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
 ```
 其次注册相应的Activity，具体如下：
 ```xml
 <activity
         android:name="com.gump.game.sdk.PassportActivity"
         android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout"
         android:launchMode="singleTask"
         android:theme="@style/Theme.Origin" //登录界面的主题,可选项:Theme.Origin\Theme.Orange\Theme.Blue\Theme.Pink
         android:screenOrientation="behind"
         android:windowSoftInputMode="stateAlwaysHidden|adjustPan">
 </activity>
 <activity
     android:name="com.gump.game.sdk.RechargeActivity"
     android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout"
     android:launchMode="singleTask"
 	android:screenOrientation="behind"
     android:theme="@style/Theme.Translucent" >
     <intent-filter>
         <category android:name="android.intent.category.DEFAULT" />
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data
             android:host="com.gump.sdk"
             android:scheme="gump+游戏的appId" />
     </intent-filter>
 </activity>
 ```
 ### 3.向Gump平台索要游戏ID（AppID），完成代码接入
 正式开始接入逻辑代码前,先介绍下一些附加设置,以方便代码接入
 *是否打印debug日志
 ```java
 GameSDK.getSettings().enableDebugLogging(true);
 ```
 *设置需要启用的第三方登录，参数可选类型见第二章：[第三方登录平台](http://repository.gumptech.com:81/document/gamesdk4-android/blob/master/IntegrationGuide.md#1-third_plat) 字段说明
 ```java
 GameSDK.getSettings().requestThirdSupport(SDKSettings.THIRD_SUPPORT_*)；
 ```
 #### 1.调用GameSDK前需要执行初始化。
 若不需要分渠道
 ```java
 GameSDK.init(Context,Appid);
 ```
 如果需要定义渠道,必须使用如下方法
 ```java
 GameSDK.init(Context,Appid,ChannelId);
 ```
 #### 2.调用GameSDK的登录方法,将执行登录流程,需要一个Activity实例作参数
 ```java
 GameSDK.login(Activity);
 ```
 在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下:
 ```java
 GameSDK.setUserStateListener(new LoginStateListener() {
+     	@Override
+        public void onCreateUser() {
+           //新用户注册,用于事件打点。勿阻塞此方法,否则影响登录流程
+            Log.i(TAG,"Someone registers an new Account");
+        }
         @Override
         public void onLoginSuccess(GumpUser gumpUser) {
             //登录成功,用户信息包含在GumpUser对象里
         }
         @Override
         public void onLoginFailed(int code, String msg) {
             //登录出错,根据错误码和信息判断错误类型
             Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show();
         }
         @Override
         public void onLoginCanceled() {
             //用户取消登录
             Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show();
         }
         @Override
         public void onLogout() {
             //用户登出
         }
      @Override
         public void onPermissionDenied(String[] deniedPermissions) {
 		//用户未授予权限,参数为没有获取的权限
         }
     });
 ```
 如上成功登录后收到的GumpUser对象包含以下信息
 ```java
 gumpUser.getUid();//获取用户的userid,此Id标识唯一用户!
 gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取
 gumpUser.getSessionKey();//登录的sessionKey对象,获取sessionKey字符串请使用此对象的getToken()方法
 ```
 #### 3.支付功能
 调用支付前需先判断支付状态,根据状态调用支付方法
 ```java
 GameSDK.iapUsable(Activity, serverId, roleId, new ResultCallback() {
                 @Override
                 public void onResult(boolean result) {
                     if(result){
 					//调用GameSDK.iap
 					}else{
 					//调用GameSDK.pay
 					}
                 }
             });
 ```
 1)调用GameSDK.pay
 ```java
 Bundle payInfo = new Bundle();
 payInfo.putString("product", "元宝");
 payInfo.putFloat("amount", 40.0f);
 payInfo.putString("extraInfo", "This is demo!");
 payInfo.putString("serverId", "B4003");
 payInfo.putString("roleId", "10010");
 payInfo.putString("currency","currency");
 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback);
 ```
-调用pay方法时,必须穿入一个bundle对象,包含如上字段,所有字段必须全部包含
+调用pay方法时,必须传入一个bundle对象,包含如上字段,所有字段必须全部包含
 2)IAP支付
 ```java
 Bundle payInfo = new Bundle();
 payInfo.putString("product", "gp_skuId");
 payInfo.putFloat("amount", 0.1f);
 payInfo.putString("extraInfo", "This is demo!");
 payInfo.putString("serverId", "100");
 payInfo.putString("roleId","100123");
 GumpSDK.iap(MainActivity.this, payInfo, PurchaseCallback);
 ```
 3)PurchaseCallback为支付状态回调接口,此接口含有3个方法
 ```java
 @Override
 public void onPurchaseCompleted() {
     Log.i(TAG,"purchase completed");
 }
 @Override
 public void onPurchaseError(int code, String msg) {
     Log.i(TAG,"purchase error");
 }
 @Override
 public void onPurchaseCanceled() {
     Log.i(TAG,"purchase canceled");
 }
 ```
 #### 4.注销登录
 ```java
 GameSDK.logout(Activity);
 ```
 当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序!为了便于用户切换登录账户,请在游戏内提供用户注销的触发按钮
 #### 5.运营开关接口，若需要接入，会有我方运营人员提出需求，否则不需要接入（若对此接口不知所云，即可认为不需要接入，请自行忽略）
 ```java
 GameSDK.inspectRiskLevel(this, new ResultCallback() {
         @Override
         public void onResult(boolean result) {
             Log.i(TAG,result?"There is some risks":"Nothing is risk");
         }
     });
 ```
 ## 第二章 常量字段与代码
 ### 1.第三方登录平台(third_plat)
 	|         常量字段                |    说明       |
 	|--------------------------------|--------------|
 	|SDKSettings.THIRD_SUPPORT_FB    | Facebook登录  |
 	|SDKSettings.THIRD_SUPPORT_GOOGLE| Google登录    |
 	|SDKSettings.THIRD_SUPPORT_LINE  | Line登录      |
 ### 2.登录账户类型
 	|               常量字段               |      说明     |
 	|-------------------------------------|--------------|
 	|GumpPreference.ACCOUNT_TYPE_FB       | Facebook用户  |
 	|GumpPreference.ACCOUNT_TYPE_REG      | Gump注册用户  |
 	|GumpPreference.ACCOUNT_TYPE_QUICK_REG| 游客          |
 	|GumpPreference.ACCOUNT_TYPE_GOOGLE   | Google用户    |
 	|GumpPreference.ACCOUNT_TYPE_LINE     | Line用户      |
 ## 第三章 常见问题
 ### 问题1： 如何避免混淆对SDK的影响？
 解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
 类，导致SDK无法正常工作，解决方法如下:
 Ø  请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上
     -keepattributes *Annotation*,InnerClasses,SourceFile,LineNumberTable
     -keep public class * extends android.app.Service
     -keep public class com.google.vending.licensing.ILicensingService
     -keep public class com.android.vending.licensing.ILicensingService
     -keep class com.gump.game.sdk.view.* {*;}
     -keep class com.gump.game.sdk.web.* {*;}
 使得混淆的时候不会影响SDK的命名空间。