# Gump SDK 5 for Android接入文档

  V5  

  2019年08月01日

  
  ## 版本概述
  
  此版本为使用AndroidStudio开发的版本,使用aar在线依赖的方式提供sdk接入包,相对上一版本没有任何继承关系,请按此文档描述接入.
  
  此SDK适用android4.0以上系统.
  
  本SDK分为两个部分:登录和支付,请按需引用依赖包.
  
  ## 第一章  接入指南
  ### 1.依赖导入
  配置gradle,以下为必须项
  
      repositories{
          maven{
          	url "http://117.50.8.198:8081/nexus/content/repositories/sdk"
      	}
      }
      dependencies {

  		//登录功能依赖

          implementation 'com.gump:Passport:5.2.2'

  		//支付功能依赖

          implementation 'com.gump:Payment:5.2.5'

      }
  
  ### 2.修改AndroidManifest.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"/>
      <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. -->
      <uses-permission android:name="com.android.vending.BILLING" />
  
  创建一个strings 配置如下
  
  	<string name="app_id">your_play_games_app_id</string>
  
  增加play games的meta-data配置
  
  	<meta-data
         android:name="com.google.android.gms.games.APP_ID"
         android:value="@string/app_id"/>
      <meta-data
         android:name="com.google.android.gms.version"
         android:value="@integer/google_play_services_version"/>
  
  ### 3.1 初始化与配置    

  
  *若要使用V4版支付请设置
  
      SDKAgent.getSettings().setPaymentVersion(PaymentVersion.V4);
  
  *执行初始化     
  
  	SDKAgent.init(Context,Appid,ChannelId);
  
  ### 3.2 登录接入

  AndroidManifest.xml配置: 
  
  	<activity
              android:name="com.gump.gpassport.GumpLoginActivity"
              android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout"
              android:launchMode="singleTask"
              android:screenOrientation="behind"
              android:theme="@style/Theme.AppCompat.Light.NoActionBar"/>

  构建Passport实例
  	
  	passport = new Passport.Builder().context(Context).setListener(StateListener).build();  
  
  其中StateListener为登录状态监听接口,需要实现如下方法
  	
  	//成功回调,成功事件类型由action枚举对象标识,player是成功返回的玩家对象
  	void onActionSucced(Actions action, GamePlayer player)
  	//失败回调
  	void onActionFailured()

  Actinos枚举:
  
  	SIGN 登录
  	SWITCH_PENDING 切换PlayGame账号,需重启游戏
  	SWITCH 已切换甘普账号,需重新加载用户角色信息

  调用登录
  
  	passport.signIn(Activity);

  接下来,添加生命周期处理方法
  
  	@Override
      protected void onResume() {
          super.onResume();
          passport.onResume();
      }
  
  处理结果返回
  
  	@Override
      protected void onActivityResult(int requestCode, int resultCode, Intent data) {
          if (!passport.onActivityResult(requestCode, resultCode, data))
              super.onActivityResult(requestCode, resultCode, data);
      }

  ### 3.3 账号联动

    
  	passport.link(Activity);
  
  ### 3.4 账号切换

  切换到PlayGame账号
  
  	passport.switchAccount();

  ### 3.5 支付接入

  注册相应的Activity，具体如下：
      
      <activity

              android:name="com.gump.payment.PaymentActivity"
              android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout"
              android:screenOrientation="behind"
              android:launchMode="singleTask"
              android:theme="@style/Theme.Translucent">
              <intent-filter>
                  <action android:name="android.intent.action.VIEW"/>
  
                  <category android:name="android.intent.category.DEFAULT"/>
  
                  <category android:name="android.intent.category.BROWSABLE"/>
  
                  <data
                      android:host="com.gump.sdk"
                      android:scheme="gump+游戏的appId"/>
              </intent-filter>
          </activity>
                 

  1)判断是否使用三方支付
  
      Payment.shouldUseCoPay(this, serverId, roleId, new ResultCallback() {
              @Override
              public void onResult(boolean isRisk) {
                 //isRisk==true时使用IAB支付,isRisk==false时使用三方支付
              }
          });
  
  2)三方支付调用

  
  	Bundle payInfo = new Bundle();
      payInfo.putString("product", "wa2");
      payInfo.putFloat("amount", 0.1f);
      payInfo.putString("extraInfo", "This is demo!");
      payInfo.putString("serverId", "100");
      payInfo.putString("roleId", "41080");
      Payment.pay(Activity, payInfo, PurchaseCallback);

  3)Google IAB支付调用

  
  	Bundle payInfo = new Bundle();
      payInfo.putString("product", "180010");
      payInfo.putFloat("amount", 0.1f);
      payInfo.putString("extraInfo", "This is demo!");
      payInfo.putString("serverId", "100");
      payInfo.putString("roleId", "41080");
      Payment.launchIAP(Activity, payInfo, PurchaseCallback);
  
  PurchaseCallback为支付状态回调接口,此接口含有3个方法  
  
      @Override
      public void onPurchaseCompleted(PurchaseResult result) {
          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");
      }
  
  ## 第二章 常见问题      
  ### 问题1： 如何避免混淆对SDK的影响？       
  解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
  类，导致SDK无法正常工作，解决方法如下:      
  Ø  请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上       
  
      -keep class com.gump.payment.web.* {*;}
      
  使得混淆的时候不会影响SDK的命名空间。