海外整合SDK安卓接入文档

1 文档说明

1.1 功能描述

此文档主要是用于在游戏及应用开发商需要接入掌趣SDK时，各个用户和计费相关的接口参考说明。
用于在游戏及应用开发商需要接入掌趣BASE SDK时，了解BASE SDK如何接入，接入过程中需注意的事项等。

1.2 阅读对象

接入掌趣的游戏及应用的android 客户端开发者。

2 接入准备

服务端配置：请参考 通用接入文档—> 《SDK服务端接入说明文档》

3 特别说明

3.1 游戏版本命名

安卓包是指androidmainfest.xml中的versionName。

3.2 渠道识别

在掌趣自动打包系统里，serviceId是区分渠道信息的标识，研发如果要识别当前游戏包属于哪个渠道，请调用获取serviceId的接口，并和技术经理匹配各serviceId对应的渠道。

3.3 游戏中接入第三方SDK

如果产品接入了第三方SDK，有需要根据包名、签名分配参数的情况，一定要提前通知技术经理。各个渠道包的包名、签名、证书等都不一样。自动打包将替换客户端包名、签名和证书。但不会自动替换第三方的参数。
如地图、语音、推送能功能的第三方SDK。具体如何实现，需要根据具体情况操作。
可以将使用到包名的地方配置为:ourpalm_package_name 。打包时掌趣打包工具会将ourpalm_package_name替换为包名。

4 接入BASE SDK注意事项

4.1 游戏res资源文件命名注意事项

游戏res资源文件中，png及xml文件命名最好不好过于简单，以免和第三方渠道重复。如close.png或close.xml命名的文件，可以加上游戏名前缀，game_close.png或game_close.xml

4.2 游戏必须接入掌趣 “用户中心”，“切换账号”，“注销”这三个接口

游戏需要调用Ourpalm_GetEnableInterface这个接口，根据的返回值来确认游戏是否需要启用这三个接口和相应的UI按钮展示。因为根据渠道不同会用到其中之一或者所有都不用。返回值详见Ourpalm_GetEnableInterface接口说明。

4.3 游戏必须接入掌趣SDK与Activity生命周期相关的接口

具体接口介绍参见：11 Activity生命周期相关接口的调用

Ourpalm_Entry.getInstance(this).Ourpalm_onPause()
Ourpalm_Entry.getInstance(this).Ourpalm_onRestart()
Ourpalm_Entry.getInstance(this).Ourpalm_onResume()
Ourpalm_Entry.getInstance(this).Ourpalm_onStart()
Ourpalm_Entry.getInstance(this).Ourpalm_onStop()
Ourpalm_Entry.getInstance(this).Ourpalm_onDestroy()
Ourpalm_Entry.getInstance(this).Ourpalm_onActivityResult()
Ourpalm_Entry.getInstance(this).Ourpalm_onConfigurationChanged()
Ourpalm_Entry.getInstance(this).Ourpalm_onNewIntent()

4.4调用支付接口需要注意内容

支付接口中的参数注意：
propName：商品名称（也可以理解为商品单位）。
propCount：商品数量。
注意：对该接口中的商品名称和商品数量2个参数具体说明。
如游戏中所卖商品在游戏界面显示为“100元宝或100金币”，当调用支付接口时，商品名称务必传“元宝或金币”，商品数量务必传“100”。切记不可商品名称传“100元宝或100金币”，商品数量传“1”；
如游戏中所卖商品在游戏界面显示为“月卡或礼包”一类，当调用支付接口时，商品名称请直接传“月卡或礼包”，商品数量传“1”。
切记 如果当前商品是某种虚拟游戏货币，商品名称中不要出现数量的概念。

5 导入BASE SDK

5.1 res中资源和lib库的导入

方式一：游戏工程直接引用《OurpalmAndroid_SDK_Lib_Base完整版本号》此lib工程，工程内已包含res中的资源和lib库，assets中资源，请自行从《资源，LIB库和配置文件》目录中复制assets文件夹中内容到游戏工程的assets目录。如何引用lib工程这里不做详细说明，如不清楚如何导入lib工程到游戏工程请上网搜索，或者咨询掌趣SDK技术人员。

方式二：直接导入base sdk的aar接入。

5.2 AndroidManifest.xml的配置

5.2.1 权限配置

<!-- OurpalmSDK需要的权限 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />

5.2.2 其他必须配置项

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="our.test.base.demo"
    android:installLocation="auto"
    android:versionCode="1"
    android:versionName="1.0.1" >
    <!-- 如游戏本身有Application类，则需要在代码中继承ourpalm.android.channels.Info.Ourpalm_Channels_Application；如游戏本身没有Application类，则需要在此添加配置，将AndroidManifest.xml中application的名字命名为"ourpalm.android.channels.Info.Ourpalm_Channels_Application" -->
    <application android:name="ourpalm.android.channels.Info.Ourpalm_Channels_Application"
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="ourpalm.android.opservice.Ourpalm_OpService_Activity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:theme="@android:style/Theme.Translucent.NoTitleBar" >
        </activity>
        <!-- 打开指定页面Activity V3.4.0版本新增加-->
        <activity
            android:name="ourpalm.android.view.Ourpalm_WebView_Activity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:screenOrientation="sensor"
            android:theme="@android:style/Theme.Translucent.NoTitleBar" >
        </activity>
        <!-- 游戏自己的启动activity类名，需要完整路径，必须配置 -->
        <meta-data
            android:name="ourpalm_class_name"
            android:value="com.ourpalm.test_ourpalm_v3.MainActivity" />
        <!-- 游戏请配置自己游戏的展示类型，竖屏游戏请配置成 portrait，横屏游戏请配置成landscape -->
        <meta-data
            android:name="ourpalm_screenOrientation"
            android:value="landscape" />
        <meta-data
            android:name="ourpalm_gametype_console"
            android:value="false" />
    </application>

注意：APK安装位置属性必须配置为android:installLocation=”auto”

6 登录相关接口介绍

6.1 流程介绍

1 手机游戏客户端会调用掌趣sdk进行sdk初始化操作
2 掌趣sdk向掌趣用户中心服务器发起登录/注册的请求
3 掌趣用户中心服务器向掌趣sdk返回token、用户信息等等
4 掌趣sdk向游戏客户端返回登录结果，包含token和用户相关信息
5 游戏客户端上传用户信息到游戏服务器
6 服务器根据token向掌趣用户中心服务器获取用户信息
7 掌趣用户中心服务器向游戏服务器返回用户信息
8 游戏服务器向游戏客户端返回登录结果

6.2 SDK初始化接口

6.2.1 功能说明

1. 为SDK中各个功能的使用提供必要的准备工作。
2. 获取初始化数据。
3. 检查版本更新。
4. 发送激活日志。
5. 初始化第三方SDK。
6. 必须在游戏主activity的onCreate生命周期接口中调用。

6.2.2 接口定义

/**
* 初始化SDK
* 
* @param gameType
*            游戏类型 1：网游；2：单机
* @param gameVer
*            游戏版本号
* @param gameResVer
*            游戏资源版本号,无资源版本号可传""
* @param listener
*            回调接口
**/
public void Ourpalm_Init(String gameType, String gameVer, String gameResVer, Ourpalm_CallBackListener listener)

6.2.3 参数说明

6.2.4 接口实例

// 初始化SDK
        Ourpalm_Entry.getInstance(this).Ourpalm_Init("1", gameVer, gameResVer, new Ourpalm_CallBackListener() {
            @Override
            public void Ourpalm_LogoutSuccess() {
                // TODO Auto-generated method stub
                // 当前渠道带有注销功能的话由游戏实现，如返回到登录界面。
                // 单机游戏不用实现
            }
            @Override
            public void Ourpalm_LogoutFail(int code) {
                // TODO Auto-generated method stub
                // 当前渠道带有注销功能的话由游戏实现
                // 单机游戏不用实现
            }
            @Override
            public void Ourpalm_LoginSuccess(String tokenId, String data) {
                // TODO Auto-generated method stub
                // 登录成功回调，网络游戏必须实现
                // 单机游戏不用实现
            }
            @Override
            public void Ourpalm_LoginFail(int code) {
                // TODO Auto-generated method stub
                // 登录失败回调，网络游戏必须实现
                // 单机游戏不用实现
            }
            @Override
            public void Ourpalm_InitSuccess() {
                // TODO Auto-generated method stub
                // 待SDK的初始化完成后，游戏开始实现游戏本身的初始化
                // 初始化游戏
            }
            @Override
            public void Ourpalm_InitFail(int code) {
                // TODO Auto-generated method stub
                // SDK初始化失败的回调，游戏可以在这里实现自己的逻辑处理，可以只提示用户后退出游戏，也可以继续游戏，但SDK的某些功能可能会受到影响
            }
            @Override
            public void Ourpalm_ExitGame() {
                // TODO Auto-generated method stub
                // 游戏使用掌趣SDK退出接口时必须实现此回调，在此处实现退出游戏的功能。
                MainActivity.this.finish();
                // android.os.Process.killProcess(android.os.Process.myPid());
            }
            @Override
            public void Ourpalm_SwitchingAccount(boolean Success, String tokenId, String userInfo) {
                // TODO Auto-generated method stub
                // 当前渠道带有切换账号功能时，游戏需要实现此接口逻辑进行游戏登录。切换账号分2种情况：
                // 一是调用SDK的切换账号接口实现账号的切换，此类型的切换账号按钮是由游戏去实现，建议放到登录界面，切换账号成功后，登录数据会在此接口返回，游戏可执行游戏的登录流程，类似登录成功接口的回调。
                // 二是渠道SDK的悬浮框或者用户中心页面带有切换账号功能，如用户点击切换账号并登录成功后，登录数据会在此接口返回，但如果当前游戏场景处于游戏中，游戏正常应该先返回到登录界面，然后再通过SDK切换账号成功返回的数据执行游戏的登录流程（游戏能在游戏中直接实现账号切换，人物改变的除外，不需返回登录界面）。
                // Success=true表示切换成功，Success=false表示切换失败，tokenId和userInfo同登录成功接口
                // 单机游戏不用实现
            }
        });

6.2.5 回调接口说明

登陆注销成功：public void Ourpalm_LogoutSuccess()；
登陆注销失败：public void Ourpalm_LogoutFail(int code)；
登陆成功：public void Ourpalm_LoginSuccess(String tokenId, String data)；
登陆失败：public void Ourpalm_LoginFail(int code)；
初始化成功：public void Ourpalm_InitSuccess()；
初始化失败：public void Ourpalm_InitFail(int code)；
退出游戏：public void Ourpalm_ExitGame()；
切换账号回调：public void Ourpalm_SwitchingAccount(boolean Success, 
    String tokenId, String userInfo)；

以上接口中的code参数为错误码。

6.3 登录接口

6.3.1 功能说明

调用第三方SDK的登陆功能。
当为官网包时会自动调用掌趣官网登陆界面。

6.3.2 接口定义

/**
* 登陆接口
*/
public void Ourpalm_Login();

6.3.3 接口实例

Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_Login();

6.3.4 登录成功回调说明

public void Ourpalm_LoginSuccess(String tokenId, String data)

6.3.4.1 参数说明

6.3.4.2 数据说明

tokenId == 45bf7d3b-5041-451d-b660-b872ba4c831d
data == {"id":"0101540000000000000000000000000623530796","userName":"oPlat000000001000047","returnJson":{"ErrorCode":"1","ErrorDesc":"有效"}}
id：掌趣用户中心生成的用户ID，游戏应以此ID作为用户登陆的唯一标识。
userName：掌趣用户中心生成的用户名称。
returnJson：第三方用户系统返回给掌趣用户中心的数据，不同渠道返回的数据会有所不同，游戏根据情况酌情使用，不需要的话可以不取。

6.3.5 登录失败回调说明

public void Ourpalm_LoginFail(int code)

6.3.5.1 参数说明

6.4 注销

6.4.1 功能说明

注销当前登陆账号，注销成功后会调用游戏实现功能后的注销回调接口。
客户端需要根据Ourpalm_GetEnableInterface 返回值，判断是否需要展示UI和调用此接口

6.4.2 接口定义

/**
* 登陆注销
*/
public void Ourpalm_Logout()

6.4.3 接口实例

Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_Logout();

6.5 切换账号

6.5.1 功能说明

某些渠道SDK当登陆过一次后下次登陆会变成自动登陆，这个时候如果SDK内部没有注销或者切换账号的按钮，需要游戏调用此接口实现账号切换功能。
客户端需要根据Ourpalm_GetEnableInterface 返回值，判断是否需要展示UI和调用此接口

6.5.2 接口定义

/**
* 账号切换
*/
public void Ourpalm_SwitchAccount();

6.5.3 接口实例

Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SwitchAccount();

6.6 设置角色信息

6.6.1 功能说明

成功登录并进入游戏后，游戏客户端必须调用此接口设置用户的角色信息，角色信息在其他功能接口中需要用到，如未调用则无法使用支付功能。用户首次创建或注册角色并登录时，需要调用一次注册设置(type=1)和一次登录设置(type=2)；用户使用老角色登录，则只需要调用一次登录设置(type=2)。
注意：
1.游戏内没有角色注册行为的，在游戏自动给用户创建角色的时候，即认为注册。
2.用户首次创建或注册角色并登录时，需先调用注册设置（type=1），再调用登录设置（type=2）

6.6.2 接口定义

    /**
     * 设置游戏角色信息
     * @param type
     * 1：角色注册，2：角色登录
     * @param gameServerName
     * 当前角色所属服务器名称
     * @param gameServerId
     * 当前角色所属服务器ID（必须纯数字）
     * @param roleName
     * 当前角色名字（不支持富文本）
     * @param roleId
     * 当前角色ID（不可使用特殊符号）
     * @param rolelv
     * 当前角色等级，无等级可传""
     * @param roleViplv
     * 当前角色VIP等级，无VIP等级可传""
     * 
     */
public void Ourpalm_SetGameInfo(int type, String gameServerName,
            String gameServerId, String roleName, String roleId,
            String rolelv,String roleViplv)

6.6.3 接口实例

Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_SetGameInfo(1, "服务器名称", "服务器ID", "测试角色名称", "测试角色ID", "测试角色等级", "测试角色VIP等级");

6.6.4 参数说明

6.7 用户中心账号绑定回调

6.7.1 功能说明

用户在SDK的用户中心界面操作,可以为当前账号绑定其它登录方式(账号)。比如账号升级、Google、Facebook、邮箱等，也可以在用户中心界面为当前账号解绑，需要二次打包测试。

6.7.2 接口实例

/ 特殊功能回调接口。
Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
   @Override
   public void Ourpalm_Spreads(String id, String... arg) {
      // TODO Auto-generated method stub
      Logs.i("info", "  Ourpalm_Spreads  id = " + id);
         if (id.equals("Ucenter_BindAccount_Success")) {
      Logs.i("info", "bind account success");
      Logs.i("info", "arg[0]"+arg[0]);
      //arg[0] 为平台标识：facebook，google，twitter，vk，email，account
      Logs.i("info", "arg[1]"+arg[1]);
      //arg[1]为平台返回用户参数 Json
      /**
       facebook范例：
      {"token_for_business":"AbwRsy594dBTNzKJ","name":"指针","picture":{"data":{"height":600,"is_silhouette":false,
       "url":"https:\/\/platform-lookaside.fbsbx.com\/platform\/profilepic\/?asid=1801576980023900&gaming_photo_type=unified_picture&ext=1639723523&hash=AeSpx1PW3H4p6XbHTs4","width":600}},"id":"1801576980023900","originalProductUserId":"1801576980023900"}
      google 范例：
      {"uid":"116113243026395000456","name":"刘利男"}
      twitter 范例：
       {"userId":"1438080497515515908","name":"leecm","screen_name":"leecm_test"}
       vk 范例：没有返回用户名字，注意判断
      email 范例：
      {"name":"testmail111@gmail.com"}
      account 范例：
      {"name":"luginsssass"}
       **/
      Toast.makeText(MainActivity.this, "账号绑定成功"+arg[0], Toast.LENGTH_LONG).show();
} else if (id.equals("Ucenter_BindAccount_Fail")) {
   //arg[0] 为平台标识：facebook，google，twitter，vk
   Toast.makeText(MainActivity.this, "账号绑定失败"+arg[0], Toast.LENGTH_LONG).show();
}else if (id.equals("Ucenter_unBindAccount_Fail")) {
   //arg[0] 为平台标识：facebook，google，twitter，vk
   Logs.i("info", "arg[0]"+arg[0]);
   Toast.makeText(MainActivity.this, "解绑失败"+arg[0], Toast.LENGTH_LONG).show();
}else if (id.equals("Ucenter_unBindAccount_Success")){
   //arg[0] 为平台标识：facebook，google，twitter，vk
   Logs.i("info", "arg[0]"+arg[0]);
   Toast.makeText(MainActivity.this, "解绑成功"+arg[0], Toast.LENGTH_LONG).show();
}
});

6.8 谷歌渠道删除账号

6.8.1 功能说明

谷歌渠道要求所有上架的应用都需要带删除账号功能，实现删除账号功能调用此接口即可。

6.8.2 接口实例

// 删除账号
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads("CloseAccountWithUserInfo");

6.8.3 接口回调

此接口为自定义接口，可以在自定义接口中接受回调

6.8.4 接口回调实例

回调示例 {“code”:”0”,”desc”:””,”success”:”1”}

// 特殊功能回调接口。
        Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
            @Override
            public void Ourpalm_Spreads(String id, String... arg) {
                // TODO Auto-generated method stub
                Logs.i("info", "  Ourpalm_Spreads  id = " + id);
                if(id.equals("CloseAccountWithUserInfo")){
                    Toast.makeText(MainActivity.this, "删除账号信息："+arg[0], Toast.LENGTH_LONG).show();
                }

6.9 恢复账号回调

恢复账号回调是自定义接口

回调示例：{“status”:”1”,”desc”:”恢复账号成功”,”reset”:”1000”,”id”:”0800010000000000000000000000000010000703”}

// 特殊功能回调接口。
        Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
            @Override
            public void Ourpalm_Spreads(String id, String... arg) {
                // TODO Auto-generated method stub
                Logs.i("info", "  Ourpalm_Spreads  id = " + id);
                if(id.equals("resumeAccountCallBack")){
                    Toast.makeText(MainActivity.this, "恢复账号成功："+arg[0], Toast.LENGTH_LONG).show();
                }

6.10 绑定邮箱接口

6.10.1 是否绑定邮箱接口

判断当前账号是否绑定邮箱，二次打包测试。

6.10.1.1 接口实例

Ourpalm_Entry.getInstance(MainActivity.mMainActivity).
        Ourpalm_Channel_Spreads("CheckBindEmail");

6.10.1.2 接口回调

// 特殊功能回调接口。
        Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
            @Override
            public void Ourpalm_Spreads(String id, String... arg) {
                // TODO Auto-generated method stub
                Logs.i("info", "  Ourpalm_Spreads  id = " + id);
                if(id.equals("Callback_CheckBindEmail")){
                    try {
                        JSONObject checkResultJson = new JSONObject(arg[0]);
                        JSONObject dataJson = new                                                                 JSONObject(checkResultJson.getString("data"));
                        String emailName = dataJson.getString("emailAccount");
                        if (Ourpalm_Statics.IsNull(emailName)) {
                            Toast.makeText(MainActivity.this,
                                    "没有绑定邮箱, arg[0] ="+arg[0],                                                 Toast.LENGTH_LONG).show();
                        } else {
                            Toast.makeText(MainActivity.this,
                                    "已绑定邮箱, arg[0] ="+arg[0],                                                    Toast.LENGTH_LONG).show();
                        }
                    } catch (Exception e) {
                    }
                }

此接口为自定义接口，可以在自定义接口中接受回调，如果返回的emailAccount字段为空串，即表示当前账号没有绑定邮箱账号，要是已绑定邮箱，emailAccount字段即为绑定的邮箱账号。

回调示例：{“success”:”1”,”data”:{“curBindingPlatform”:”email”,”emailAccount”:”emailAccount”:”aaaaabbbb@126.com”},”code”:”0”}

6.10.2 打开绑定邮箱界面接口

打开绑定邮箱界面接口，如果当前账号已绑定邮箱，会回调返回绑定的邮箱账号，如果没绑定，会弹出绑定邮箱界面，玩家绑定成功后会回调返回绑定的邮箱账号，二次打包测试。

6.10.2.1 接口实例

Ourpalm_Entry.getInstance(MainActivity.mMainActivity).
        Ourpalm_Channel_Spreads("ShowBindEmail");

6.10.2.2 接口回调

// 特殊功能回调接口。
        Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
            @Override
            public void Ourpalm_Spreads(String id, String... arg) {
                // TODO Auto-generated method stub
                Logs.i("info", "  Ourpalm_Spreads  id = " + id);
                if(id.equals("Callback_ShowBindEmail")){
                    try {
                        JSONObject checkResultJson = new JSONObject(arg[0]);
                        JSONObject dataJson = new                                                                 JSONObject(checkResultJson.getString("data"));
                        String emailName = dataJson.getString("emailAccount");
                        if (Ourpalm_Statics.IsNull(emailName)) {
                            Toast.makeText(MainActivity.this,
                                    "邮箱绑定失败, arg[0] ="+arg[0],                                                 Toast.LENGTH_LONG).show();
                        } else {
                            Toast.makeText(MainActivity.this,
                                    "邮箱绑定成功, arg[0] ="+arg[0],                                                    Toast.LENGTH_LONG).show();
                        }
                    } catch (Exception e) {
                    }
                }

此接口为自定义接口，可以在自定义接口中接受回调，如果返回的emailAccount字段为空串，即表示当前账号没有绑定邮箱账号，要是邮箱绑定成功，emailAccount字段即为绑定的邮箱账号。

回调示例：{“success”:”1”,”data”:{“curBindingPlatform”:”email”,”emailAccount”:”emailAccount”:”aaaaabbbb@126.com”},”code”:”0”}

7 计费相关接口介绍

7.1 流程介绍

1 base sdk向掌趣计费中心发起支付请求；
2 掌趣计费中心生成订单号，并向base sdk返回支付结果；
3 掌趣计费中心通知游戏服务器发货；
4 游戏服务器发送虚拟物品至玩家手机游戏客户端；
5 游戏服务器向计费中心返回发货结果；

7.2 支付接口

7.2.1 功能说明

调用自有支付功能或者第三方SDK的支付功能，实现游戏中的道具购买。
注意：对该接口中的商品名称和商品数量2个参数具体说明，如游戏中所卖商品在游戏界面显示为“100元宝”，当调用支付接口时，商品名称请传“元宝”，商品数量请传“100”，切记不可商品名称传“100元宝”，商品数量传“1”。

7.2.2 接口定义

/**
 * 
 * @param propId
 *            游戏自定义的商品ID
 * @param chargeCash
 *            商品价格
 * @param currencyType
 *            货币类型(1人民币2美元3日元4港币5英镑6新加坡币7越南盾8台币9韩元10泰铢)
 * @param propName
 *            商品名称
 * @param propCount
 *            商品数量
 * @param propDes
 *            商品描述
 * @param Gameurl
 *            掌趣计费中心回调游戏发货地址
 * @param ExtendParams
 *            扩展参数
 * @param callBack
 *            支付回调接口
 * @param rolelv
 *            角色等级
 * @param roleviplv
 *            角色VIP等级
 * @param userId
 *            掌趣SDK登录成功返回的userId
 * @param serverId
 *            玩家登录的游戏服id
 * @param roleId
 *            玩家角色id
 * @param purchaseInfo
 *            游戏自定义参数，值为json字符串,其中包含礼包ID(package_id,order_funnel_id,dev_order_id)，暂时用于数据统计
*/
public void Ourpalm_Pay(final String propId, final String chargeCash, final String currencyType,final String propName, final String propCount, final String propDes, final String Gameurl,final String ExtendParams, final Ourpalm_PaymentCallBack callBack, final String rolelv,final String roleviplv,
final String userId, final String serverId, final String roleId, final String purchaseInfo)

注：Android相比于iOS新增 userId、serverId、roleId等参数

7.2.3 参数说明

7.2.4 接口实例

Ourpalm_Entry.getInstance(this).Ourpalm_Pay("商品ID", "100", "1", "商品名称", "1", "商品描述", "回调地址", "我是扩展参数",
    new Ourpalm_PaymentCallBack() {
    @Override
    public void Ourpalm_PaymentSuccess(int code, String ssid, String channelOrderId, String pbid) {
        Logs.i("info", "Ourpalm_PaymentSuccess ssid == " + ssid +
                ", channelOrderId = " + channelOrderId + " , pbid = " + pbid);
        Toast.makeText(MainActivity.mMainActivity, "花钱成功了。。。*_*", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void Ourpalm_PaymentFail(int code, String ssid, String channelOrderId, String pbid) {
        Logs.i("info", "Ourpalm_PaymentFail code = " + code + "ssid == " + ssid +
            ", channelOrderId = " + channelOrderId + " , pbid = " + pbid);
        Toast.makeText(MainActivity.mMainActivity, "支付失败了", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void Ourpalm_OrderSuccess(int code, String ssid, String channelOrderId, String pbid) {
        Logs.i("info", "Ourpalm_OrderSuccess code = " + code + "ssid == " + ssid +
            ", channelOrderId = " + channelOrderId + " , pbid = " + pbid);
        Toast.makeText(MainActivity.mMainActivity, "下单成功了", Toast.LENGTH_SHORT).show();
    }
}, RoleLv, RoleVipLv, userId, serverId, roleId, purchaseInfo);

7.2.5 回调接口说明(Ourpalm_PaymentCallBack)

7.2.5.1 支付成功

public void Ourpalm_PaymentSuccess(int code, String ssid, String channelOrderId, String pbid);

7.2.5.2 支付失败

public void Ourpalm_PaymentFail(int code, String ssid, String channelOrderId, String pbid);

7.2.5.3 下单成功

/* "下单成功"表示当前订单已经成功提交，但用户是否进行支付，以计费中心服务器的通知为准。 下单成功代表支付流程结束。下单成功回调触发以后不会在有支付成功和支付失败的回调，游戏需要根据服务器通知为准。*/
public void Ourpalm_OrderSuccess(int code, String ssid, String channelOrderId, String pbid);

7.2.6 回调参数说明

注：1、Android端和iOS端返回错误码不一致。2、Android返回参数key为小写{String ssid, String pbid}，iOS端返回json中的key为小驼峰{ “desc”:成功描述,”propId”:”道具ID”,”reset”:”120”,”ssId”:”订单号}

8 客服反馈相关

8.1 AiHelp客户反馈接口

8.1.1 AIHelp H5版本接口

游戏登录成功后，调用此接口，打开客服反馈页面
游戏需要自己设计UI展示以及展示位置，当用户点击此按钮时，调用接口，打开客服反馈页面。

Ourpalm_OpService_Entry.getInstance().EnterServiceQuestion();

8.1.2 AIHelp SDK版本智能客服接口

调用该接口会拉起AIHelp智能客服页面。
注意：android包要使用AIHelpSDK接口，需要业务同学先在dev后台-三方参数-三方能力中添加AIHelp sdk,再二次打包测试。

Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads("aihelp_openServiceDialog","{\"entranceId\":\"CS01\",\"userTags\":\"paid\",\"customData\":\"{\"baseLevel\":\"123\",\"loadingProgress\":\"25\"}\"}");

entranceId和userTags这两个参数都需要业务同学事先在AIHelp后台配置，customData是自定义用户数据json串，由研发和业务同学一起确认需要传哪些参数。
事例：

JSONObject customDataJson = new JSONObject();
customDataJson.put("baseLevel", "123");
customDataJson.put("loadingProgress", "25");
aihelpJson.put("customData", customDataJson.toString());
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).
      Ourpalm_Channel_Spreads("aihelp_openServiceDialog",
            aihelpJson.toString());

8.1.3 AIHelp SDK版本帮助中心接口

调用该接口会拉起AIHelp智能客服页面。
注意：android包要使用AIHelpSDK接口，需要业务同学先在dev后台-三方参数-三方能力中添加AIHelp sdk,再二次打包测试。

Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads("aihelp_openFAQs","{\"entranceId\":\"E001\",\"userTags\":\"paid\",\"customData\":\"{\"baseLevel\":\"123\",\"loadingProgress\":\"25\"}\"}");

entranceId和userTags这两个参数都需要业务同学事先在AIHelp后台配置，customData是自定义用户数据json串，由研发和业务同学一起确认需要传哪些参数。
事例：

JSONObject aihelpJson = new JSONObject();
aihelpJson.put("entranceId", "E001");
aihelpJson.put("userTags", "paid");
JSONObject customDataJson = new JSONObject();
customDataJson.put("baseLevel", "120");
customDataJson.put("loadingProgress", "100");
aihelpJson.put("customData", customDataJson.toString());
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).
      Ourpalm_Channel_Spreads("aihelp_openFAQs", aihelpJson.toString());

8.2 HelpShift客服功能

8.2.1 功能说明

提供helpshift在线客服功能及打开FAQ页面功能。

8.2.2 在线客服弹窗接口

调用此接口，可以拉起HelpShift在线客服反馈页面。

/**
 * 打开helpshift客服弹框
 * @param  id 接口id
 * @param  tag 客服入口打点
*/
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads(
                    "helpShift_openServiceDialog","opentags");

注意：当游戏设立多个客服入口时，每个入口都要设定一个tag，同时需要把所有的tag值都提供给运营同学，运营同学在helpShift后台Settings-WORKFLOWS-Tags下添加所有定义好的tag.

8.2.3 FAQ弹窗接口

调用此接口，可以拉起HelpShift FAQ页面。

/**
    * 打开helpshift FAQ弹窗
    * @param  id 接口id
    */
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads(
                    "helpShift_openFAQs");

8.2.4 打开指定问题ID FAQ弹窗接口

调用此接口，可以拉起指定问题id的helpshift客服FAQ页面，问题id由运营同学提供。

/**
* 打开helpshift指定FAQ弹窗
*
* @param activity
* @param questionPublishId
*/
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads(
                    "helpShift_openSingleFAQ", "25");

8.2.5 打开指定问题ID的FAQ列表接口

调用此接口，可以拉起指定问题id的helpshiftFAQ列表页面，问题id由运营同学提供。

/**
* 打开指定问题id的faq列表
*
* @param activity
* @param questionPublishId
*/
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads(
                    "helpShift_openFAQSection", "29");

8.2.6 helpShift用户信息设置接口

调用此接口，可以设置helpshift用户信息，如果登录前调用，userId传空串，登录成功选服后，sdk会自动此调用。

            Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads(
                    "helpShift_setUserInfo", userId, userName, roleId, serverId, vLevel, roleName);

8.2.7 回复通知数回调接口

客服人员回复消息后，玩家重进后会收到此回调

// 特殊功能回调接口。
Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
    @Override
    public void Ourpalm_Spreads(String id, String... arg) {
        // TODO Auto-generated method stub
        Logs.i("info", "  Ourpalm_Spreads  id = " + id);
        if (id.equals("helpShift_NotificationCount")){
            //arg[0] 为回复通知数，"0"表示没有新的通知
            Logs.i("info", "arg[0]"+arg[0]);
            Toast.makeText(MainActivity.this, "helpshift回复通知数="+arg[0], Toast.LENGTH_LONG).show();
        }
    }
});

9 礼包兑换相关

9.1 礼包码兑换接口

9.1.1 功能说明

兑换礼包码
CP接入礼包码功能时，由SDK来直接提示错误提示语。

9.1.2 接口定义

/**
* 礼包码兑换接口
* @param GiftCode 礼包码
* @param url  发货地址
* @param extendParams 扩展参数
* @param mListener  回调
*/
public void Ourpalm_GiftExchange(String GiftCode, String url,final String extendParams,final Ourpalm_GiftExchangeCallBack mListener);

9.1.3 参数说明

9.1.4 接口实例

Ourpalm_Entry.getInstance(this).Ourpalm_GiftExchange("用户输入的礼包码", "游戏发货服务器地址", "透传参数",new Ourpalm_GiftExchangeCallBack());

9.1.5 回调接口说明

9.1.5.1 兑换成功回调

/**
* 操作成功
* packageId 礼包码ID
* extendParams 游戏透传参数（游戏传进来的透传参数）
*/
public void Ourpalm_Success(String packageId, String extendParams);

9.1.5.2 兑换失败回调

/*
* 操作失败
* @param code
* 错误码
*/
public abstract void Ourpalm_Fail(int code);

11 Activity生命周期相关接口的调用

11.1 功能说明

因为某些第三方SDK需要用到生命周期中的某些方法，所以游戏客户端Activity中 必须调用掌趣SDK中定义的生命周期方法，否则可能会出现不可预估的问题。

11.2 接口介绍

11.2.1 onStart 接口示例

@Override
protected void onStart() {
    // TODO Auto-generated method stub
    super.onStart();
    Ourpalm_Entry.getInstance(this).Ourpalm_onStart();
}

11.2.2 onResume 接口示例

@Override
protected void onResume() {
    // TODO Auto-generated method stub
    super.onResume();
    Ourpalm_Entry.getInstance(this).Ourpalm_onResume();
}

11.2.3 onPause 接口示例

@Override
protected void onPause() {
    // TODO Auto-generated method stub
    super.onPause();
    Ourpalm_Entry.getInstance(this).Ourpalm_onPause();
}

11.2.4 onStop 接口示例

@Override
protected void onStop() {
    // TODO Auto-generated method stub
    super.onStop();
    Ourpalm_Entry.getInstance(this).Ourpalm_onStop();
}

11.2.5 onRestart 接口示例

@Override
protected void onRestart() {
    // TODO Auto-generated method stub
    super.onRestart();
    Ourpalm_Entry.getInstance(this).Ourpalm_onRestart();
}

11.2.6 onDestroy 接口示例

@Override
protected void onDestroy() {
    // TODO Auto-generated method stub
    super.onDestroy();
    Ourpalm_Entry.getInstance(this).Ourpalm_onDestroy();
}

11.2.7 onDestroy 接口示例

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    // TODO Auto-generated method stub
    super.onActivityResult(requestCode, resultCode, data);
    Ourpalm_Entry.getInstance(this).Ourpalm_onActivityResult(requestCode, resultCode, data);
}

11.2.8 onConfigurationChanged 接口示例

@Override
public void onConfigurationChanged(Configuration newConfig) {
    // TODO Auto-generated method stub
    super.onConfigurationChanged(newConfig);
    Ourpalm_Entry.getInstance(this).Ourpalm_onConfigurationChanged(newConfig);
}

11.2.9 onNewIntent调用示例

@Override
protected void onNewIntent(Intent intent) {
    // TODO Auto-generated method stub
    super.onNewIntent(intent);      Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_onNewIntent(intent);
}

11.2.10 onActivityResult调用示例

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    // TODO Auto-generated method stub
    super.onActivityResult(requestCode, resultCode, data);      Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_onActivityResult(this, requestCode, resultCode, data);
}

12 其他功能接口

12.1 获取可选接口中的可用接口

12.1.1 功能说明

“用户中心”，“切换账号”，“登录注销”等接口必须接入。
提供此接口用来引导游戏合理使用以上三个接口。根据SDK返回的值，判断是否在相应渠道客户端中显示或隐藏UI展示，以及和是否调用以上三个接口。
比如当前渠道需要调用用户中心接口，则需要将用户中心按钮显示出来并实现其接口调用的功能，如不需要，则需要隐藏用户中心的按钮。其他功能同理。
此三个功能SDK只提供功能接口，无UI显示，所以需要游戏实现展示或者隐藏“用户中心”，“切换账号”，“登录注销”的UI按钮。根据返回值给予显示或者隐藏。

12.1.2 接口定义

/**
* 获取当前渠道游戏包是否要调用“用户中心”，“切换账号”，“登陆注销”等接口
*/
public String Ourpalm_GetEnableInterface()

12.1.3 接口示例

String enable = Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_GetEnableInterface();

12.1.4 返回数据解析

{"Logout":"Disabled","SwitchAccount":"Disabled","UserCenter":"Enabled"}
Enabled: 表示需要调用
Disabled: 表示不需要调用
例如以上返回数据说明：登陆注销接口不需要调用；切换账号接口不需要调用，进入用户中心接口需要调用。

12.2 进入用户中心或论坛接口

12.2.1 功能说明

进入第三方渠道SDK的用户中心或者论坛界面，或者进入官网SDK的用户中心界面。
客户端调用，根据第三方渠道SDK要求来决定是否调用

12.2.2 接口定义

/**
* 进入用户中心接口，如果是用官网登陆的则进入官网的用户中心
*/
public void Ourpalm_GoCenter()

12.2.3 接口示例

Ourpalm_Entry.getInstance(MainActivity.this).Ourpalm_GoCenter();

12.3 退出游戏接口

12.3.1 功能说明

调用第三方SDK的退出提示接口，如第三方SDK无退出提示接口则调用掌趣的退出 提示界面或者直接退出游戏。

12.3.2 接口定义

/**
* 调用第三方SDK退出提示页面，如果第三方SDK无退出提示页面则调用掌趣提示页面
* @param usetip
*            是否使用掌趣SDK的退出提示界面
*/
public void Ourpalm_ExitGame(boolean usetip)

12.3.3 参数说明

12.3.4 接口示例

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
// TODO Auto-generated method stub
    if (keyCode == KeyEvent.KEYCODE_BACK) {
    Ourpalm_Entry.getInstance(this).Ourpalm_ExitGame(true);
    return true;
    }
    return super.onKeyDown(keyCode, event);
}

12.4 开启SDK日志输出

12.4.1 功能说明

打开后能在logcat看到SDK的日志输出，TAG为“info”和”msg”, 用于游戏接入SDK的调试阶段，出正式游戏包时请务必关闭日志输出。

12.4.2 接口定义

/**
* 是否打开日志
* @param log 是否打开日志输出
*/
public void SetLogs(boolean log)

12.4.3 参数说明

12.4.4 接口示例

// 设置打开日志输出
Ourpalm_Entry.getInstance(this).SetLogs(true);

12.5 获取ServiceId

12.5.1 功能说明

获取当前游戏包中的ServiceId。

12.5.2 接口定义

/** 
* @return 业务ID
*
public String getServiceId();

12.5.3 接口示例

Ourpalm_Entry.getInstance(this).getServiceId();

12.6 获取渠道ID

12.6.1 功能说明

获取当前游戏包内打入的渠道ID。

12.6.2 接口定义

/** 
* @return 渠道ID
*
public String getChannelId();

12.6.3 接口示例

Ourpalm_Entry.getInstance(this).getChannelId();

12.7 获取机型组ID

12.7.1 功能说明

获取当前游戏包内打入的机型组ID。

12.7.2 接口定义

/**
* @return 机型组ID
*/
public String getDeviceGroupId();

12.7.3 接口示例

Ourpalm_Entry.getInstance(this).getDeviceGroupId();

12.8 获取语言ID

12.8.1 功能说明

获取当前游戏包内打入的语言ID。

12.8.2 接口定义

/**
* @return 语言ID
*/
public String getLocaleId();

12.8.3 接口示例

Ourpalm_Entry.getInstance(this).getLocaleId();

12.9 获取OPID

12.9.1 功能说明

获取当前游戏包内打入的OPID。

12.9.2 接口定义

/**
* @return OPID
*/
public String getOpId();

12.9.3 接口示例

Ourpalm_Entry.getInstance(this).getOpId();

12.10 获取ServiceCode

12.10.1 功能说明

1.需要先调用初始化接口Ourpalm_Init后 再调用 本接口获取 ServiceCode；
2.游戏研发人员 获取ServiceCode后，联系掌趣服务器端同学联调服务端日志，获取ServiceCode接入工作正式完成。

12.10.2 接口定义

/**
* 获取ServiceCode
* @param  gameResVer
* 游戏资源版本号,无资源版本号可传""
*
* @return 返回ServiceCode
*/
public String Ourpalm_getServiceCode(final String gameResVer);

12.10.3 接口实例

// 获取掌趣serviceCode接口，游戏需要调用(SDK接口)
Ourpalm_ServiceCode_Entry.getInstance(this).Ourpalm_getServiceCode("资源版本号");

12.11 开启ServiceCode Debug日志输出

12.11.1 功能说明

打开后能在logcat看到SDK的日志输出，TAG为“info”, 用于游戏接入SDK的调试阶段，出正式游戏包时请务必关闭日志输出。

12.11.2 接口定义

/**
* 是否打开日志
*
* @param log
*/
public void SetLogs(boolean log)

12.11.3 接口实例

// 设置打开日志输出，出正式包时务必注释掉，或者传false
Ourpalm_ServiceCode_Entry.getInstance(this).SetLogs(true);

12.12 打开指定页面（可用于论坛、社区、活动）

12.12.1 功能说明

打开指定url的web页面接口（可用于论坛、社区、活动）。

12.12.2 接口定义

 /**
     * 加载指定URL的Web页面
     * 
     * @param webUrl
     *            页面URL
     * 
     * @author lgc 2018年04月11日 上午11:17:52
     */
    public void Ourpalm_OpenSpecificWebView(String webUrl)

12.12.3 参数说明

12.12.4 接口示例

Ourpalm_Entry.getInstance(MainActivity.mMainActivity).
    Ourpalm_OpenSpecificWebView(
        "http://www.baidu.com");

12.13 OpenInstall邀请码功能

12.13.1 功能说明

游戏登录成功后调用本接口可以打开系统分享界面，给其它玩家分享邀请内容及邀请码，其它玩家可以通过分享app上的邀请链接拉起或安装游戏包。
注意：游戏必须接入base sdk的onNewIntent 这个生命期接口。

12.13.2 接口说明

Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).
        Ourpalm_Channel_Spreads(id, inviteMsg, inviteCode);

参数说明:

接口示例

Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).
        Ourpalm_Channel_Spreads("OpenInstall_sendShareInvite", "test openinstall invite", "testvalue");

12.13.3回调说明

其它玩家可以通过分享app上的邀请链接拉起或安装游戏包时，会收到这个回调。其中，arg[0]即为邀请者的邀请码。

Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
        @Override
        public void Ourpalm_Spreads(String id, String... arg) {
        // TODO Auto-generated method stub
        Logs.i("info", "  Ourpalm_Spreads  id = " + id);
            if (id.equals("OpenInstall_InviteData")) {
                Logs.i("info", "  Ourpalm_Spreads OpenInstall_InviteData = " + arg[0]);
            }
            }
        });

12.14 多语言切换功能

12.14.1 功能说明

游戏内切换多语言时调用。

12.14.2 切换语言需要的权限

<uses-permission android:name="android.permission.CHANGE_CONFIGURATION" />

12.14.3 必须实现attachBaseContext接口

游戏必须在主activity中实现生命周期接口attachBaseContext，具体代码如下：

 @Override
protected void attachBaseContext(Context base) {
    super.attachBaseContext(Ourpalm_LocaleUtils.attachBaseContext(base));
}

12.14.4 接口定义

Ourpalm_LocaleUtils.updateLocale(Context, Locale);

12.14.5 接口实例

Ourpalm_LocaleUtils.updateLocale(MainActivity.this,Ourpalm_LocaleUtils.LOCALE_CHINESE);

12.14.6 地域语言参数说明

12.15 欧美隐私协议接口

12.15.1 功能说明

根据google渠道要求，在欧盟及美国发行的游戏新用户首次启动需要弹隐私协议，
只有玩家同意后才能进入游戏。
sdk启动后会自动检测是否需要显示隐私协议。如果玩家已同意过协议，则下次启动不会自动弹出协议界面；
但如果协议内容有更新，则会再次弹出。

12.15.1 隐私协议弹窗接口

本接口暂时保留，目前暂时不可用，用于以后在游戏内需要显示隐私协议时调用。
调用此接口，如果玩家当前ip是欧盟或美国，会拉起隐私协议弹窗。

Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).
    Ourpalm_OpenPrivacyProtocol();

12.15.2 回调接口

隐私弹窗点击“不同意”、“同意”、隐私协议更新或不需要展示隐私协议时，游戏都会收到此回调。
特别注意：必须在调用sdk初始化接口Ourpalm_Init前调用Ourpalm_SetSpreadsCallBack接口。
同时，游戏必须等待协议回调通知，然后才能调用登录和打点等其它SDK功能

// 特殊功能回调接口。
Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
    @Override
    public void Ourpalm_Spreads(String id, String... arg) {
        // TODO Auto-generated method stub
        Logs.i("info", "  Ourpalm_Spreads  id = " + id);
        if (id.equals("OpenPrivacyProtocol")){
            //arg[0] 是否显示隐私弹窗
            Logs.i("info", "arg[0]"+arg[0]);
            Toast.makeText(MainActivity.this, "已调用隐私协议弹窗接口。。。, Toast.LENGTH_LONG).show();
        }
    }
});

public void Ourpalm_NetworkDiagnosis(String checkTargetArray, String extParams, String isDisplay)

String checkTargetArray = "[\n" +
                    "{\"http_url\":\"https:\\/\\/www.baidu.com\",\"host\":\"www.baidu.com\",\"http\":\"1\"},"+
                    "{\"host\":\"www.baidu.com\",\"ping\":\"1\"},"+
                    "{\"host\":\"www.baidu.com\",\"mtr\":\"1\"}"+
                    "]";
String extParams ="{\"reason\":\"serverlist\",\"serverId\":\"10001\",\"userId\":\"0000011101\"}";
Ourpalm_Entry.getInstance(MainActivity.mMainActivity).Ourpalm_NetworkDiagnosis(checkTargetArray, extParams, "0");

Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).
      Ourpalm_Channel_Spreads("ShowAdmobRewardedAd");

// 特殊功能回调接口。
Ourpalm_Entry.getInstance(this).Ourpalm_SetSpreadsCallBack(new Ourpalm_SpreadsCallBack() {
    @Override
    public void Ourpalm_Spreads(String id, String... arg) {
        // TODO Auto-generated method stub
        Logs.i("info", "  Ourpalm_Spreads  id = " + id);
        if (id.equals("Callback_AdmobRewardedAd")){
            //arg[0] Admob广告回调信息，是一个json串
            Logs.i("info", "arg[0]"+arg[0]);
            Toast.makeText(MainActivity.this, "Admob广告回调信息："+arg[0], Toast.LENGTH_LONG).show();
        }
    }
});

{"adState":"PreparedSuccess","adDesc":"广告准备成功"}
{"adState":"PreparedFailed","adDesc":"广告准备失败"}
{"adState":"Show","adDesc":"广告开始展示"}
{"adState":"ShowFailed","adDesc":"广告播放失败"}
{"adState":"Clicked","adDesc":"广告已被点击"}
{"adState":"VideoAdCompleted","adDesc":"广告播放完毕"}
{"adState":"Closed","adDesc":"广告已关闭"}

/**
 * 获取Google商品信息
 * 
 * @param id
 *            SkuDetails 获取Google商品信息固定参数
 * @param value1
 *            JSONArray字符串,商品列表信息
 */
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads("SkuDetails","[\"ubi.heroes.ad60\", \"ubi.heroes.ad60\"]");

if (id.equals("SkuDetails")) {
    Logs.i("info", "SkuDetails sku_list =" + arg[0]);
    if (arg[0].equals("")) {
        // 获取道具列表失败
        Toast.makeText(MainActivity.this, "获取道具信息功能失败", Toast.LENGTH_LONG).show();
    } else {
        // 输出道具列表信息
        Toast.makeText(MainActivity.this, "获取道具信息功能成功", Toast.LENGTH_LONG).show();
        try {
            JSONArray sku_list = new JSONArray(arg[0]);
            for (int i = 0; i < sku_list.length(); i++) {
                JSONObject sku = sku_list.getJSONObject(i);
                                Logs.i("info",
                                        " sku  productId = " + sku.getString("productId") + " price = " + sku.getString("price")
                                                + " title = " + sku.getString("title") + " type = " + sku.getString("type")
                                                + " priceCurrencyCode =" + sku.getString("priceCurrencyCode")
                                                + " description = " + sku.getString("description")
                                                + " priceAmountMicros =" + sku.getLong("priceAmountMicros"));
        } catch (JSONException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        };
    }
}

/**
 * 获取Google订阅计费点商品信息
 * 
 * @param id
 *            SubsSkuDetails 获取Google商品信息固定参数
 * @param value1
 *            JSONArray字符串,商品列表信息
 */
Ourpalm_Entry.getInstance(Ourpalm_Entry_Model.mActivity).Ourpalm_Channel_Spreads("SubsSkuDetails", "[\"ubi.heroes.ad9.99e\"]");

if (id.equals("SubsSkuDetails")) {
    Logs.i("info", "SubsSkuDetails sku_list =" + arg[0]);
    if (arg[0].equals("")) {
        // 获取道具列表失败
        Toast.makeText(MainActivity.this, "获取道具信息功能失败", Toast.LENGTH_LONG).show();
    } else {
        // 输出道具列表信息
        Toast.makeText(MainActivity.this, "获取道具信息功能成功", Toast.LENGTH_LONG).show();
        try {
            JSONArray sku_list = new JSONArray(arg[0]);
            for (int i = 0; i < sku_list.length(); i++) {
                JSONObject sku = sku_list.getJSONObject(i);
                                Logs.i("info",
                                        " sku  productId = " + sku.getString("productId") + " price = " + sku.getString("price")
                                                + " title = " + sku.getString("title") + " type = " + sku.getString("type")
                                                + " priceCurrencyCode =" + sku.getString("priceCurrencyCode")
                                                + " description = " + sku.getString("description")
                                                + " priceAmountMicros =" + sku.getLong("priceAmountMicros"));
        } catch (JSONException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        };
    }
}