SDK接口调用说明

SDK从3.0.0版本以后，使用百川电商组件提供的AlibcTradeService可以方便的打开交易环节中的各种页面。使用百川SDK的webview打开page，可以实现淘宝账号免登以及电商交易支付流程

• show接口

<br>/**
 * 使用isv自己的webview打开page，可以实现淘宝账号免登以及电商交易支付流程
 *
 * @param parentController            webView所在的view controller.
 * @param webView                     isv自己的webview,请先设置好自己的delegate先调用本接口,否则拦截登陆等逻辑会失效
 * @param page                        想要打开的page
 * @param showParams                  打开方式的一些自定义参数
 * @param taoKeParams                 淘客参数
 * @param trackParam                  链路跟踪参数
 * @param tradeProcessSuccessCallback 交易流程中成功回调(加购成功/发生支付)
 * @param tradeProcessFailedCallback  交易流程中退出或者调用发生错误的回调
 *
 * @return  0:  标识跳转到手淘打开了
            1:  标识用h5打开
           -1:  标识出错
 */
- (NSInteger)           show:(UIViewController * __nonnull)parentController
                     webView:(nullable UIWebView*)webView
                        page:(id<AlibcTradePage> __nonnull)page
                  showParams:(nullable AlibcTradeShowParams*)showParams
                 taoKeParams:(nullable AlibcTradeTaokeParams *)taoKeParams
                  trackParam:(nullable NSDictionary*)trackParam
 tradeProcessSuccessCallback:(nullable void (^)(AlibcTradeResult * __nullable result))onSuccess
  tradeProcessFailedCallback:(nullable void (^)(NSError * __nullable error))onFailure;

*showParams 参数

拉起手淘

p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Consolas; color: #333333; -webkit-text-stroke: #000000; background-color: #ebeeef}span.s1 {font-kerning: none}span.s2 {font-kerning: none; color: #008000; -webkit-text-stroke: 0px #008000}

AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeNative;
showParam.backUrl=@"tbopenXXXXX://";
showParam.isNeedPush=isNeedPush;

拉起天猫

p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Consolas; color: #333333; -webkit-text-stroke: #000000; background-color: #ebeeef}span.s1 {font-kerning: none}span.s2 {font-kerning: none; color: #008000; -webkit-text-stroke: 0px #008000}span.s3 {font-kerning: none; color: #008200; -webkit-text-stroke: 0px #008200}

AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeNative;
showParam.backUrl=@"tbopenXXXXX://";
showParam.isNeedPush=isNeedPush;
showParam.linkKey = @"tmall_scheme";//拉起天猫

*page参数

其中page参数用于指定需要打开的页面,可以使用的页面类型如下表,由AlibcTradePageFactory生成：

p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Consolas; color: #008200; -webkit-text-stroke: #008200; background-color: #ebeeef}p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Consolas; color: #333333; -webkit-text-stroke: #000000; background-color: #ebeeef}p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Consolas; color: #333333; -webkit-text-stroke: #333333; background-color: #ebeeef}p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Consolas; color: #008000; -webkit-text-stroke: #008000; background-color: #ebeeef}span.s1 {font-kerning: none}span.s2 {font-kerning: none; color: #009900; -webkit-text-stroke: 0px #009900}span.s3 {font-kerning: none; color: #008000; -webkit-text-stroke: 0px #008000}span.s4 {font-kerning: none; color: #333333; -webkit-text-stroke: 0px #000000}span.s5 {font-kerning: none; -webkit-text-stroke: 0px #333333}span.s6 {font-kerning: none; color: #008200; -webkit-text-stroke: 0px #008200}

//打开商品详情页
id<AlibcTradePage> page = [AlibcTradePageFactory itemDetailPage: @”123456”];
 
//添加商品到购物车
id<AlibcTradePage> page = [AlibcTradePageFactory addCartPage: @"123456"];
 
//根据链接打开页面
id<AlibcTradePage> page = [AlibcTradePageFactory page: @"http://h5.m.taobao.com/cm/snap/index.html?id=527140984722"];
 
//打开店铺
id<AlibcTradePage> page = [AlibcTradePageFactory shopPage: @”12333333”];
 
//打开我的订单页
id<AlibcTradePage> page = [AlibcTradePageFactory myOrdersPage:0 isAllOrder:YES];
 
//打开我的购物车
id<AlibcTradePage> page = [AlibcTradePageFactory myCartsPage];
 
 
//淘客信息
AlibcTradeTaokeParams *taoKeParams=[[AlibcTradeTaokeParams alloc] init];
taoKeParams.pid=nil; //
//打开方式
AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeAuto;
 
[[AlibcTradeSDK sharedInstance].tradeService show: self.navigationController page:page showParams:showParam taoKeParams: nil trackParam: trackParam tradeProcessSuccessCallback:self.onTradeSuccess tradeProcessFailedCallback:self.onTradeFailure];

使用自己的webview打开商品详情页

<br>id<AlibcTradePage> page = [AlibcTradePageFactory itemDetailPage: @”123456”];
//淘客信息
AlibcTradeTaokeParams *taoKeParams=[[AlibcTradeTaokeParams alloc] init];
taoKeParams.pid= nil;
//打开方式
AlibcTradeShowParams* showParam = [[AlibcTradeShowParams alloc] init];
showParam.openType = AlibcOpenTypeAuto;
 
 
// YourWebViewController类中,webview的delegate设置不能放在viewdidload里面,必须在init的时候,否则函数调用的时候还是nil
  YourTradeWebViewController* myView = [[YourTradeWebViewController alloc] init];
   
 
 NSInteger ret = [[AlibcTradeSDK sharedInstance].tradeService show: myView webView: myView.webView page:page showParams:showParam taoKeParams: taoKeParams trackParam:nil tradeProcessSuccessCallback:self.onTradeSuccess tradeProcessFailedCallback:self.onTradeFailure];
 //返回1,说明h5打开,否则不应该展示页面
 if (ret == 1) {
       [self.navigationController pushViewController:view animated:YES];
 }