接口调用说明

接口调用方法很简单,只需一行代码,即可调用您所需的功能。

接口调用步骤:

第一步:下载js-sdk文件,并在页面中引用

<script type="text/javascript" src="js/DtCloud.js"></script>

第二步:初始化js对象

var dtcloud = new DTCLOUD();

第三步:调取相应的方法

dtcloud.wxInstalledFlag('自定义函数');

APP界面控制类

返回顶级页面

适用设备:Android IOS dtcloud.GoTopUrl();此方法会加载您进入APP的第一个页面,并清空历史浏览记录.

返回上级页面

适用设备:Android IOS dtcloud.GoBackUrl();此方法会返回H5上级页面,如您有拉起新的原生页面,也会返回到上一个原生页面

拉起新的原生页面

适用设备:Android IOS 此方法不需要您主动调用,您只需要在URL最后加如#n即可,比如您的URL为http://www.abc.com/index,只需要设置为http://www.abc.com/index#n即可拉起原生页面,再配合返回上级GoBackUrl()方法用以解决列表跳转详情时返回无法在当前位置的问题

APP系统功能类

获取设备信息

适用设备:Android IOS dtcloud.GetUuid("callback"); callback 获取成功后的回调函数,APP会把设备识别码以参数的形式传入此回调函数

清理缓存

适用设备:Android IOS dtcloud.clearCache();

IOS使用TouchID

适用设备:IOS dtcloud.PullTouchID(callback, anotherAuthUrl, authTitle, anotherAuthTip); callback 回调函数名,在TouchID验证通过后会执行此回调函数,并给函数赋一个参数,0为验证失败,1为验证通过 anotherAuthUrl 验证失败一次后提供其他验证方式的URL地址 authTitle 指纹验证提示文字 anotherAuthTip 验证失败后,其他验证方式的按钮的文字,默认为输入密码

获取地理位置

适用设备:Android IOS dtcloud.GetGeo(callback); callback 获取成功后的回调函数,APP会在定位成功后将定位结果以参数形式传入此回调函数,参数共有三个,第一个为经度,第二个为纬度,第三个为详细地址,请自行处理后续工作.eg:callback(lon,lat,address)

智能语音识别接口

适用设备:Android IOS dtcloud.VoiceRec(callback); callback 获取成功后的回调函数,APP会在识别技术将识别结果以参数形式传入此回调函数,请自行处理.

扫一扫,无返回值

适用设备:Android IOS dtcloud.vScan(); 此方法无返回值,扫描后APP会自行处理.

扫一扫,有返回值

适用设备:Android IOS dtcloud.Scan(callback); callback 回调函数,扫描结果会以参数形式传递到回调函数

用浏览器打开

适用设备:Android IOS dtcloud.openWithBrowser(); 系统会自动调用浏览器打开当前页面

APP插件类

微信登录接口

适用设备:Android IOS dtcloud.wxLogin(auth_type, redirectUrl); auth_type int(1) 此参数可用值为0和1,为0时只返回openid,为1时会返回用户的信息,比如,头像,地址等. redirectUrl varchar(255) 此参数为APP拉起微信登录授权后回调跳转的地址,auth_type为0时,App会在授权后加载此地址并在地址后加上openid和sign参数(sign规则为md5(openid + secret_key)),auth_type为1时,除了会通过get方式加载redirectUrl之外,APP还会通过POST方式向redirectUrl发送用户的微信授权信息,发送内容为一个json字符串,其中有三个参数,分别为openid,result,sign,其中result为用户的微信授权内容,如头像等,sign为md5(openid + result + secret_key),secret_key为您在管理应用-配置功能里的安全码设置处获取,请在redirectUrl页面的get和post请求一定先判断sign签名是否符合后再进行操作,以免受到不必要的非法请求.注意:post请求是先于get请求的,因此建议在接收到post请求时先进行保存操作,然后再拿get请求中的openid和post中的做对比获取到正确的用户信息,请注意,get和post请求中的sign参数是不同的.

IOS判断微信是否安装

适用设备:IOS dtcloud.wxInstalledFlag(callback); callback 回调函数名,APP会在获取到微信是否安装结果以参数形式传入此回调函数,,1为已安装微信,0为未安装,请自行判断后进行处理.注意:此API只在IOS有效,因此,请先用js的navigator.userAgent获取到头部信息,我们为您的IOS应用加入了fromIOS头,请一定先判断头部信息是否包含fromIOS再执行此API,否则会发生致命错误.

微信支付

适用设备:Android IOS dtcloud.SetWxPay(product_name, out_trade_no, total_fee); product_name 商品名称,显示给用户 out_trade_no 订单号,用户自定义,32个字符内、可包含字母 total_fee 订单总金额,单位为分,比如订单金额为100元,传输值请写100*100=10000分 请注意:此API需要您在应用的扩展JS-API处配置好您的微支付信息,否则会拉不起微信,成功支付后,微信会将支付结果异步回调到notify_url,同时,APP在判断支付成功后,会主动加载return_url,请在return_url处展示支付成功页面即可,请注意,return_url只用来展示支付结果即可,一定不要依靠APP的判断,具体的更改订单状态的业务逻辑请务必以notify_url接收到的异步通知为准

APP自定义分享

适用设备:Android IOS dtcloud.Share(title, desc, imgUrl, link); title 分享的标题 desc 分享的简介 imgUrl 分享的图片路径 link 分享要连接到的地址 请注意:此API需要您先在管理应用-配置功能的分享设置处配置好您的AppID和AppSecret信息,同时在扩展JS-API中打开自定义分享开关

QQ登录接口

适用设备:Android IOS dtcloud.qqLogin(redirectUrl); redirectUrl varchar(255) 此参数为APP拉起QQ登录授权后回调跳转的地址,App会在授权后加载此地址并在地址后加上openid,userinfo(json字符串)和sign参数(sign规则为md5(openid + userinfo + secret_key)),secret_key为您在应用管理-配置功能-常用应用管理里的安全码设置处获取,请在redirectUrl中务必先判断获取到的sign签名,以避免不必要的非法请求造成数据损失.

支付宝支付

适用设备:Android IOS dtcloud.SetAlipay(product_name, out_trade_no, total_fee); product_name 商品名称,显示给用户 out_trade_no 订单号,用户自定义,32个字符内、可包含字母 total_fee 订单总金额,单位为元 请注意:此API需要您在应用管理-配置功能的扩展API处配置好您的支付宝需要的patnerid,sellerid,RSA私钥,支付宝公钥,异步回调地址和同步通知地址,支付成功后,支付宝会将支付信息异步通知到您配置的notify_url处,同时APP在判断支付成功后会主动加载return_url,您只需要在return_url处展示支付成功信息即可,具体更改订单状态的业务逻辑请一定以支付宝的异步通知为准,以避免不必要的损失.
Copyright © 2012-2017 河南网中网计算机科技有限公司 版权所有 豫ICP备16028087号-1