首页 > 技术文章 > 手机sdk 开发

hexihexi 2017-01-06 22:12 原文

题记:很多做游戏开发的人,估计都或多或少地接过渠道SDK,什么UC,当乐,91,小米,360......据统计国内市场当前不下于100家渠道,还包括一些没有SDK的小渠道。每个渠道SDK接入的方法呢,多是大同小异。但是,正是这些小异,又让SDK的接入,产生了无穷无尽的变数。所以,接入SDK之前,如果你没有经验,或者没有被SDK坑过,那么当你看到这系列文章的时候,你很幸运,你可以避免这一切了。如果你之前被坑过,而且还在继续被坑着,那么现在,就是你解脱的时刻。

 

上一篇文章我们说了整个U8 SDK抽象成的设计,那这篇文章,我们就来验证一下,他是否如我们期待的那样,简单灵活。

正如之前所说,对于每个游戏,只需要接入抽象层,而每个渠道SDK的接入,就是该抽象层的一个实现而已。最后通过一键打包工具来完成最后的产出。那么,我们先来看看,游戏怎么来调用这个抽象层。

我们假设我们已经开发了一款游戏,面临上线,需要接入SDK,需要接入UC,当乐,91,360,小米等渠道。因为采用U8 SDK统一接入框架的思想,游戏工程本身不耦合具体的每个渠道SDK,而只是调用U8 SDK抽象层。那么,根据上一篇文章谈到的抽象层,我们就来看看如何调用。

首先,我们用eclipse新建一个Android工程,作为我们这个模拟的游戏工程。这里需要说一下,如果你不是直接使用Android开发的游戏,而是采用像Unity3D,Cocos2D等游戏引擎,其接入也是一样的。只是多了一层JNI调用。我们新建一个主运行的Activity:

 

[java] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. package com.u8.sdk.demo;  
  2.   
  3. import com.u8.sdk.IU8SDKListener;  
  4. import com.u8.sdk.LoginResult;  
  5. import com.u8.sdk.PayParams;  
  6. import com.u8.sdk.U8SDK;  
  7. import com.u8.sdk.components.U8Pay;  
  8. import com.u8.sdk.components.U8User;  
  9.   
  10. import android.os.Bundle;  
  11. import android.view.View;  
  12. import android.widget.Button;  
  13. import android.widget.Toast;  
  14. import android.annotation.SuppressLint;  
  15. import android.app.Activity;  
  16. import android.content.Intent;  
  17.   
  18. public class MainActivity extends Activity {  
  19.   
  20.     @Override  
  21.     public void onCreate(Bundle savedInstanceState) {  
  22.         super.onCreate(savedInstanceState);  
  23.         setContentView(R.layout.activity_main);  
  24.           
  25.         U8SDK.getInstance().setSDKListener(new IU8SDKListener() {  
  26.               
  27.             @SuppressLint("ShowToast")  
  28.             @Override  
  29.             public void onResult(int arg0, String msg) {  
  30.                 Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT);  
  31.             }  
  32.               
  33.             @SuppressLint("ShowToast")  
  34.             @Override  
  35.             public void onLoginResult(LoginResult loginResult) {  
  36.                 Toast.makeText(MainActivity.this, "登录成功,sid:"+loginResult.getSid(), Toast.LENGTH_SHORT);  
  37.             }  
  38.         });  
  39.           
  40.         Button btn = (Button)findViewById(R.id.button1);  
  41.         btn.setOnClickListener(new View.OnClickListener() {  
  42.               
  43.             @Override  
  44.             public void onClick(View v) {  
  45.                 pay();  
  46.             }  
  47.         });  
  48.           
  49.         Button btnLogin = (Button)findViewById(R.id.button2);  
  50.         btnLogin.setOnClickListener(new View.OnClickListener() {  
  51.               
  52.             @Override  
  53.             public void onClick(View v) {  
  54.                    login();  
  55.                   
  56.             }  
  57.         });  
  58.           
  59.         U8SDK.getInstance().init(MainActivity.this);  
  60.        
  61.     }  
  62.   
  63.     private void login(){  
  64.   
  65.         U8SDK.getInstance().runOnMainThread(new Runnable() {  
  66.               
  67.             @Override  
  68.             public void run() {  
  69.                 U8User.getInstance().login();  
  70.             }  
  71.         });  
  72.     }  
  73.       
  74.     private void pay(){  
  75.         U8SDK.getInstance().runOnMainThread(new Runnable() {  
  76.               
  77.             @Override  
  78.             public void run() {  
  79.                 PayParams params = new PayParams();  
  80.                 params.setPrice(100);  
  81.                 params.setServerId("1");  
  82.                 params.setRoleId("1");  
  83.                 U8Pay.getInstance().pay(params);  
  84.             }  
  85.         });  
  86.     }  
  87.       
  88.     public void onActivityResult(int requestCode, int resultCode, Intent data){  
  89.         U8SDK.getInstance().onActivityResult(requestCode, resultCode, data);  
  90.         super.onActivityResult(requestCode, resultCode, data);  
  91.     }  
  92.     public void onPause(){  
  93.         U8SDK.getInstance().onPause();  
  94.         super.onPause();  
  95.     }  
  96.     public void onResume(){  
  97.         U8SDK.getInstance().onResume();  
  98.         super.onResume();  
  99.     }  
  100.     public void onNewIntent(Intent newIntent){  
  101.         U8SDK.getInstance().onNewIntent(newIntent);  
  102.         super.onNewIntent(newIntent);  
  103.     }  
  104.     public void onStop(){  
  105.         U8SDK.getInstance().onStop();  
  106.         super.onStop();  
  107.     }  
  108.     public void onDestroy(){  
  109.         U8SDK.getInstance().onDestroy();  
  110.         super.onDestroy();  
  111.     }  
  112.     public void onRestart(){  
  113.         U8SDK.getInstance().onRestart();  
  114.         super.onRestart();  
  115.     }  
  116.       
  117.     public void onBackPressed(){  
  118.         U8SDK.getInstance().onBackPressed();  
  119.         super.onBackPressed();  
  120.     }  
  121. }  

 

 

大家可以看到,在我们这个模拟的游戏中,接入SDK抽象层是一件多么Easy的事情,就是在onCreate里面进行初始化操作:

 

[java] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. U8SDK.getInstance().init(MainActivity.this);  

 

 

同时,如我们之前所说,我们是基于监听器模式的设计,我们需要设置一个监听,当具体SDK有状态变更,成功或者失败时,我们可以得到具体的信息:

 

[java] view plain copy
 在CODE上查看代码片派生到我的代码片
  1.      U8SDK.getInstance().setSDKListener(new IU8SDKListener() {  
  2.   
  3. @SuppressLint("ShowToast")  
  4. @Override  
  5. public void onResult(int arg0, String msg) {  
  6.     Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT);  
  7. }  
  8.   
  9. @SuppressLint("ShowToast")  
  10. @Override  
  11. public void onLoginResult(LoginResult loginResult) {  
  12.     Toast.makeText(MainActivity.this, "登录成功,sid:"+loginResult.getSid(), Toast.LENGTH_SHORT);  
  13. }  
  14. );  

 

 

其中,onResult在调试的时候,可以做一个Toast输出。onLoginResult则是渠道SDK登陆成功时的回调。在这里就是需要去做我们之前整个登陆流程里的第四步(u8appid,sid)访问U8 Server获取一个接下来登陆认证使用的一个token。

这样,初始化就完毕了。然后,就是在需要调用登陆界面的地方,调用:

 

[html] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. U8User.getInstance().login();  

在需要调用支付界面的地方调用:

 

 

[html] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. U8Pay.getInstance().pay(params);  

需要注意的是,这些接口需要在UI 线程中调用,所以,我们需要使用U8SDK.getInstance().runOnMainThread():

 

 

[java] view plain copy
 在CODE上查看代码片派生到我的代码片
  1.     U8SDK.getInstance().runOnMainThread(new Runnable() {  
  2.   
  3. @Override  
  4. public void run() {  
  5.     U8User.getInstance().login();  
  6. }  
  7. );  

 

 

最后,我们需要重写Activity相关的系统事件方法,在对应的方法里面,加上U8 SDK对应方法的调用。比如:

 

[java] view plain copy
 在CODE上查看代码片派生到我的代码片
  1. public void onPause(){  
  2.     U8SDK.getInstance().onPause();  
  3.     super.onPause();  
  4. }  

 

 

这样,对于我们这个“游戏”来说,就算完成了SDK的接入了。大家可以看到,对于游戏来说,接入是一件很简便的事。它不用考虑后面怎么打包,怎么生成渠道包,怎么管理配置,怎么升级,。。。对于TA,到这里就结束了。接下来,我们就要看看,对于一个渠道来说,比如UC,我们怎么来接入到这套框架中来呢?


 

 

推荐阅读