“Sdk-data-android”的版本间的差异

来自陌陌游戏WIKI
跳转至： 导航、 搜索
（→‎设置Other Linker Flags）
（→‎channelId 对应关系）
 
（未显示2个用户的16个中间版本）
第29行： 第29行：
  
 
===接口调用===
 
===接口调用===
 +
 +
====启动次数统计接口====
 +
appBecomeActive接口 CP需要做的是，在程序回到前台的时候调用SDK的启动次数统计接口，使用示例如下：
 +
StatisticSDK.getInstance().appBecomeActive(this);
 +
 
====登录相关的接口====
 
====登录相关的接口====
 
在登录成功的地方添加代码：
 
在登录成功的地方添加代码：
第41行： 第46行：
  
 
====支付相关的接口====
 
====支付相关的接口====
 +
说明：支付统计CP可自行选择以下两种方式中的一种进行统计，支付金额的单位为<font color="red" >元</font>
 +
 +
=====SDK接口=====
 
在支付成功的地方添加代码：
 
在支付成功的地方添加代码：
 +
<font color="red" >【重要】支付成功指游戏为玩家下发道具，指服务器最终校验通过，不是客户端支付完成</font>
  
 
   //支付相关数据统计的接口
 
   //支付相关数据统计的接口
第52行： 第61行：
 
             propId 为道具 ID;
 
             propId 为道具 ID;
 
             context 为程序的上下文。</font>
 
             context 为程序的上下文。</font>
 +
 +
=====服务器端接口=====
 +
接  口  名：https://game-api.immomo.com/game/ows/server/dc/pay
 +
调用时机：服务器校验支付成功之后
 +
参数如下：
 +
  <table border="1" cellpadding="1" cellspacing="0">
 +
<tr>
 +
      <th>参数名</th>
 +
      <th>类型</th>
 +
      <th>必填</th>
 +
      <th>说明</th>
 +
    </tr>
 +
    <tr>
 +
      <td>appid</td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>应用ID</td>
 +
    </tr>
 +
    <tr>
 +
      <td>app_secret</td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>应用密码</td>
 +
      </tr>
 +
      <tr>
 +
      <td>trade_no</td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>订单号</td>
 +
      </tr>
 +
    <tr>
 +
      <td> productid </td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>道具id</td>
 +
      </tr>
 +
    <tr>
 +
      <td> uid </td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>用户id</td>
 +
      </tr>
 +
    <tr>
 +
      <td> channelid </td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>渠道id</td>
 +
      </tr>
 +
    <tr>
 +
      <td> total_fee </td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>支付金额</td>
 +
      </tr>
 +
    <tr>
 +
      <td> client </td>
 +
      <td>string</td>
 +
      <td>Y</td>
 +
      <td>操作系统android /ios</td>
 +
      </tr>
 +
</table>
 +
 +
 
  
 
====退出的接口====
 
====退出的接口====
第57行： 第129行：
  
 
   StatisticSDK.exit();
 
   StatisticSDK.exit();
−
 
  
 
===channelId 对应关系===
 
===channelId 对应关系===
第115行： 第186行：
 
   Y53——i苹果
 
   Y53——i苹果
 
   Y54——乐8
 
   Y54——乐8
 +
  Y55——机锋
 +
  Y56——TT语音
 +
  Y57——数游07073
  
−
 
−
<font color="red" >注：如果游戏接入棱镜，同时需要接入陌陌数据SDK，需要将棱镜的渠道号转为陌陌对应的channelId。
 
−
棱镜获取渠道号的方法为：String channelId = XMUtil.getChannelLabel(Context context);</font>
 
−
 
−
 
−
===SDK Data iOS接入说明===
 
−
====1.0.0版本功能介绍====
 
−
    1. 登录统计；
 
−
    2. 支付统计；
 
−
    3. 在线时长统计；
 
−
    4. 注销；
 
−
 
−
===SDK 导入===
 
−
    <font color="red" >【重要】未接入陌陌SDK、陌陌多渠道SDK的游戏才需要接入数据SDK</font>
 
−
====添加framework====
 
−
 
 
−
  [[文件:DataFramework.jpg]]
 
−
 
−
====设置Other Linker Flags====
 
−
    在项目Target对应的Build Settings里搜索找到Other Linker Flags设置项，设置值为-ObjC，参考截图：<br />
 
−
    [[文件:设置Other Linker Flags.png|500px]]
 
−
 
−
====设置C++ Standard Library====
 
−
    C++ Standard Library的值参照下图设置或者改为Compiler Default。<br />
 
−
    [[文件:设置C++.png|500px]]<br />
 
−
 
−
====基本API配置====
 
−
  使用SDK接口前，需要先引用对应模块的头文件；也可以一次性引入所有的SDK头文件，方式参考如下：
 
−
 
 
−
    [[文件:statictis_so.png]]
 
−
 
−
===接口调用===
 
−
====注册接口====
 
−
在程序的入口AppDelegate类didFinishLaunchingWithOptions方法中添加代码：
 
−
 
−
  //DataSDK初始化接口
 
−
  + (BOOL)registerWithAppKey:(NSString *)appkey channelId:(NSString *)channelId;
 
−
 
−
    <font color="red" >说明: appkey 由陌陌分配的appID,作为app的唯一标识,请找运营获取。
 
−
                channelId 游戏当前接入渠道的标识.</font>
 
−
 
−
====登录统计接口====
 
−
在登录成功的地方添加代码：
 
−
 
−
  //用户相关数据统计接口
 
−
  - (void)loginStatisticWithUserId:(NSString *)userId;
 
−
 
 
−
  <font color="red" >说明: userId 为登录的用户 ID;
 
−
 
−
====支付统计接口====
 
−
在支付成功的地方添加代码：
 
−
 
−
  //支付相关数据统计的接口
 
−
  - (void)payStatisticWithUserId:(NSString *)userId
 
−
                      tradeNo:(NSString *)tradeNo
 
−
                    productId:(NSString *)productId
 
−
                      tradeFee:(double)tradeFee;
 
−
 
 
−
  <font color="red" >说明:
 
−
            userId      为登录的用户 ID;
 
−
            tradeNo  为支付成功回调的交易号;
 
−
            propId    为道具 ID;
 
−
            tradeFee  为支付金额(注:金额应该为 double类型); </font>
 
−
 
−
====注销接口====
 
−
在程序退出的地方添加代码：
 
−
 
−
  //用户注销或切换账号接口
 
−
  - (void)logout;<br />
 
−
  <font color="red" >说明：注销接口主要是暂停在线时长统计 </font>
 
−
 
−
===注意事项===
 
 
<font color="red" >注：如果游戏接入棱镜，同时需要接入陌陌数据SDK，需要将棱镜的渠道号转为陌陌对应的channelId。
 
<font color="red" >注：如果游戏接入棱镜，同时需要接入陌陌数据SDK，需要将棱镜的渠道号转为陌陌对应的channelId。
 
棱镜获取渠道号的方法为：String channelId = XMUtil.getChannelLabel(Context context);</font>
 
棱镜获取渠道号的方法为：String channelId = XMUtil.getChannelLabel(Context context);</font>

2016年2月23日 (二) 08:21的最新版本

更新说明

1.0.2版本

  优化无网情况可能导致支付数据丢失的情况

SDK 导入

   【重要】未接入陌陌SDK、陌陌多渠道SDK的游戏才需要接入数据SDK

添加jar包

  将需要的Jar文件添加到项目的libs目录，较新版本的ADT会自动将Jar包添加到项目的Library中。如果你ADT不支持这个特性，请在Eclipse中右键点击jar文件，
  在弹出的菜单中选择”Build Path”-->”Add To Build Path”即可。
  需要添加的Jar包：statisticSDK_beta_1.0.0_20150805.jar，陌陌数据统计接口SDK
  Statictid lib.png

添加so文件

  在项目的libs目录下新建armeabi文件夹，把需要的so文件复制到这里。即：libstatisticSDK.so
  
  Statictis so.png

AndroidManifest 配置

  将下面的权限复制至AndroidManifest.xml清单文件中的manifest节点下。
  
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 
  <uses-permission android:name="android.permission.INTERNET" /> 
  <uses-permission android:name="android.permission.WRITE_SETTINGS" /> 
  <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> 
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

接口调用

启动次数统计接口

appBecomeActive接口 CP需要做的是，在程序回到前台的时候调用SDK的启动次数统计接口，使用示例如下：
StatisticSDK.getInstance().appBecomeActive(this);

登录相关的接口

在登录成功的地方添加代码： 

  //用户相关数据统计接口
  StatisticSDK.statisticUser(String appId, String userId,String channelId, Context context);
  
  说明:appId 为应用的 ID,需要向陌陌工作人员获取;
           userId 为登录的用户 ID;
           channelId 为渠道 ID,需要向陌陌工作人员获取;
           context 为程序的上下文。

支付相关的接口

说明：支付统计CP可自行选择以下两种方式中的一种进行统计，支付金额的单位为元

SDK接口

在支付成功的地方添加代码： 【重要】支付成功指游戏为玩家下发道具，指服务器最终校验通过，不是客户端支付完成 

  //支付相关数据统计的接口
  StatisticSDK.statisticPay(String appId, String channelId, String tradeNo, float tradeFee, String propId, Context context);
  
  说明:appId 为应用的 ID,需要向陌陌工作人员获取; 
           channelId 为渠道 ID,需要向陌陌工作人员获取; 
           tradeNo 为支付成功回调的交易号;
           tradeFee 为支付金额(注:金额应该为 double类型); 
           propId 为道具 ID;
           context 为程序的上下文。
服务器端接口

接 口 名：https://game-api.immomo.com/game/ows/server/dc/pay 调用时机：服务器校验支付成功之后 参数如下：

参数名 类型 必填 说明
appid string Y 应用ID
app_secret string Y 应用密码
trade_no string Y 订单号
productid string Y 道具id
uid string Y 用户id
channelid string Y 渠道id
total_fee string Y 支付金额
client string Y 操作系统android /ios


退出的接口

在程序退出的地方添加代码： 

  StatisticSDK.exit();

channelId 对应关系

  Y1——百度
  Y2——UC
  Y3——小米
  Y4——豌豆荚
  Y5——360
  Y6——棱镜
  Y7——安智
  Y8——OPPO
  Y9——魅族
  Y10——益玩
  Y11——联想
  Y12——华为
  Y13——拇指玩
  Y14——金立
  Y15——优酷
  Y16——酷派
  Y17——搜狗
  Y18——PPTV
  Y19——4399
  Y20——37玩
  Y21——当乐
  Y22——178
  Y23——PPS
  Y24——17173
  Y25——HTC
  Y26——应用宝
  Y27——三星应用商店
  Y28——应用汇
  Y29——沃友玩
  Y30——沃友玩_bad
  Y31—— 叉叉助手
  Y32—— 酷狗
  Y33—— 靠谱助手
  Y34——vivo
  Y35——联通
  Y36——暴风影音
  Y37——陌陌
  Y38——琵琶网
  Y39——玉米助手
  Y40——酷我
  Y41——乐视
  Y42——快用
  Y43——XY
  Y44——新浪
  Y45——猎宝
  Y46——itools
  Y47——虫虫
  Y48——游龙
  Y49——爱思
  Y50——同步推
  Y51——PP助手
  Y52——海马
  Y53——i苹果
  Y54——乐8
  Y55——机锋
  Y56——TT语音
  Y57——数游07073

注：如果游戏接入棱镜，同时需要接入陌陌数据SDK，需要将棱镜的渠道号转为陌陌对应的channelId。 棱镜获取渠道号的方法为：String channelId = XMUtil.getChannelLabel(Context context);

取自“http://sdkwiki.immomogame.com/index.php?title=Sdk-data-android&oldid=1936”