SDK呼起及返回

一、 第三方接入京东APP回呼功能说明

开普勒支持第三方APP通过京东sdk呼起的方式呼起京东APP，在跳转至京东APP后会出现一个返回第三方APP的按钮，提升APP间跳转的体验；

二、 接入呼起流程说明

1、客户接入SDK呼起使用方法：

客户调用SDK V2.2.1版本的呼起服务，即可实现呼起京东APP，在京东APP中下单可分佣。若本地无京东APP，则会打开SDK，用户在SDK内进行购物。【若用户需要在京东APP中展示返回按钮，则在调用SDK呼起服务时，需传入keplerID参数；若不需要展示返回按钮，则无需传入该参数】；

安卓参考文档：http://kepler.jd.com/console/docCenterCatalog/docContent?channelId=45

KeplerGlobalParameter.getSingleton().setJDappBackTagID(id);

iOS 参考文档：http://kepler.jd.com/console/docCenterCatalog/docContent?channelId=46

/**
 *  打开京东后显示的返回按钮的tagID
 **/
@property (nonatomic, copy) NSString *JDappBackTagID;

**注意事项：

• 非京东域名链接不支持呼起；

• 若客户无需京东APP展示返回按钮，则直接使用SDK呼起方法即可，无需开普勒分配keplerID（用于展示返回按钮）；

• 若客户需要京东APP展示返回按钮（仅V6.0及以上京东APP支持显示），则使用SDK呼起方法之前，需要按照以下2-4步流程申请开普勒分配keplerID，并将该参数作为使用SDK呼起方法的入参。

• 仅实物商品呼起京东APP下单，可支持分佣（走原生结算页），与联盟在京东APP的分佣方法保持一致。

• 呼起协议schema参数为写死的格式，禁止修改

2、申请返回参数（keplerID，针对第三方应用的返回）

第三方APP呼起后展示返回键，属于增值功能，仅支持SDK已上线且订单量稳定的渠道申请使用；

**注意：京东APP IOS版需要首先校验包名的正确性，之后选择呼起协议回呼，因此需要保证包名的正确性；

三、 Android版呼起京东APP进行相关操作

设置打开APP的事件回调：

OpenAppAction mOpenAppAction = new OpenAppAction() {

@Override

public void onStatus(final int status) {

mHandler.post(new Runnable() {

@Override

public void run() {

if (status == OpenAppAction.OpenAppAction_start) {//开始状态未必一定执行，

dialogShow();

} else {

mKelperTask=null;

dialogDiss();

}

}

});

}

};

打开主APP会产生一个KelperTask

任务可以取消：

mKelperTask.setCancel(true);

timeOut：（打开APP之前，向服务端同步计费信息，这个过程超时，或者出错，H5页面会被打开）

呼起APP 任意URL

mKelperTask= KeplerApiManager.getWebViewService().openJDUrlPage(url, customerInfo,mContext,mOpenAppAction,timeOut);

呼起APP 单品SKU

此方法是唤起京东APP的商品详情页。

mKelperTask=  KeplerApiManager.getWebViewService()

.openItemDetailsPage(sku,

customerInfo,mContext,mOpenAppAction,timeOut);

唤起京喜APP或京东APP单品详情页（3.0.0版本新增）

mKelperTask = KeplerApiManager
        .getWebViewService()
        .openProductDetailPage(skuId, 

                customerInfo, this, mOpenAppAction, timeOut);

此方法依据商品类型，按照不同优先级唤起APP。具体如下：

一、如果商品是京喜优选商品或者京东商品，按照1）～3）依次判断：

1） 安装京东APP前提下，唤京东APP。

2） 如果未安装京东APP，安装京喜APP，唤起京喜APP。

3） 如果既未安装京东APP，也未安装京喜APP，则通过WebView方式打开。

二、京喜非优选商品：

安装京喜APP前提下，唤起京喜APP，未安装京喜，WebView方式打开。

如果希望唤起京喜APP展示返回键，需要您配置返回键参数，若不设置，则唤起京喜不展示返回键。

京喜APP配置返回键（3.0.0版本新增）

配置方法可通过KeplerAttachParameter提供的putKeplerAttachParameter方法传递键值对的方式传递。

需要对key为appName，appSchema和appBundleId分别配置key-value键值对。

配置的key保证字母拼写正确、区分大小写、不能有空格等，否则可能出现配置了返回键不生效。

其中，参数含义如下：

appName是返回键名称；

appSchema是返回协议，默认为“sdkback”+用户的appKey组成；

appBundleId 是应用包名。

呼起APP导航页面

mKelperTask= KeplerApiManager.getWebViewService().openNavigationPage(

customerInfo,mContext,mOpenAppAction,timeOut);

呼起APP 打开购物车

mKelperTask=KeplerApiManager.getWebViewService().openCartPage(

customerInfo,mContext,mOpenAppAction,timeOut);

呼起APP 用户订单页面

mKelperTask= KeplerApiManager.getWebViewService().openOrderListPage(

customerInfo,mContext,mOpenAppAction,timeOut);

呼起APP 打开搜索关键词页面

mKelperTask=KeplerApiManager.getWebViewService().openSearchPage(

searchkey, customerInfo,mContext,mOpenAppAction,timeOut);

传递返回 JDappBackTagID

KeplerGlobalParameter.getSingleton().setJDappBackTagID(id);