【转】app之YdbOnline说明文档

概述

YdbOnline是面向网页开发者提供的网页开发工具包。

通过使用YdbOnline，网页开发者可借助YdbOnline高效地使用语音、位置等手机系统的能力，同时可以直接使用清除缓存、扫一扫等App特有的能力，为用户提供更优质的网页体验。

此文档面向网页开发者介绍YdbOnline如何使用及相关注意事项。

JSSDK使用步骤

步骤一：引入JS文件

在需要调用JS接口的页面引入如下JS文件，（支持https）：http://static.ydbimg.com/API/YdbOnline.js
旧的接口(不建议使用)：http://static.ydbimg.com/API/YdbOnlineBig.js

                    例如，页面head部分插入代码：＜script src="http://static.ydbimg.com/API/YdbOnline.js" type="text/javascript"＞＜／script＞

步骤二：初始化YDB对象

                初始化方法：var YDB = new YDBOBJ();
                //初始化之后才可以调用相应SDK方法，

步骤三：调用YDB的相关方法

                例如：YDB.SetHeadBar(0);
                //设置隐藏头部标题栏的全部属性
                //特别说明：YDB的调用要放到页面尾部，或者放入页面加载完事件中
                //方法一：jquery 中：$(function(){} 括号内写你的内容
                //方法二：使用body的onload属性，onload='someFunctionsWithJssdk()'
                //方法三：window.onload=function(){//someFunctionsDoWithJssdk}//用window的onload事件，窗体加载完毕的时候

接口调用说明

所有接口通过实例YDB来调用，影响页面设置的优先级如下：页面内功能>全局设置>Url配置

全局定义

初始化全局定义

                YDB.SetGlobal(参数1,参数2,参数3,参数4,参数5,参数6,参数7,参数8,参数9,参数10,参数11);
                //参数1（HeadBar） 是否显示标题栏，0为隐藏，1为显示
                //参数2（DragRefresh） 是否开启下拉刷新，0为关闭，1为开启
                //参数3（HeadBarExceptionList） 标识为隐藏顶部导航的例外（相反与HeadBar设置）名单（显示标题栏,参数为URL的字符串，多个URL以逗号分隔）页面列表
                //参数4（DragRefreshExceptionList） 下拉刷新例外(相反与DragRefresh
                //设置)名单（页面执行下拉刷新,参数为URL的字符串，多个URL以逗号分隔）   
                //参数5 (CashTime) 缓存时长,0为不缓存，其他整形数值配合CasgTimeUnit组成缓存时长
                //参数6 (CashTimeUnit) 缓存时间单位,小写字母，m/h/d  分别代表分钟/小时/天 ,字串类型   
                //参数7 (BackKeyUseType) 安卓手机返回键功能，0点击返回上级页面，1点击返回顶级页面
                //参数8 (ShowCloseButton) 是否显示关闭按钮，0隐藏，1显示
                //参数9 (CloseText) 自定义关闭按钮显示文字，''空字串则使用默认的“关闭”
                //参数10(ClearCookie) 关闭应用是否清除cookie，0不清除，1清除
                //参数11(BgColor) 设置App原生底色（App默认底色为#efefef），使用16进制颜色值设置，比如：#ffcc00

备注：全局属性优先级低于局部页面的优先级，所有多状态参数为int类型

APP界面控制类

隐藏/显示顶部标题栏

                    YDB.SetHeadBar(0);
                   //参数说明：显示隐藏当前页的顶部导航菜单，0为隐藏，1为显示

隐藏底部菜单栏

                    YDB.SetMenuBar(0);
                   // 参数说明：显示隐藏底部菜单栏，0为隐藏，1为显示

适用模板：有导航模板

备注：

开启关闭下拉刷新

                    YDB.SetDragRefresh(0);
                    // 参数说明：设置开启关闭下拉刷新功能，0为关闭，1为开启

备注：

隐藏/显示右侧菜单

                    YDB.SetMoreButton(0);
                   // 参数说明：设置是否显示右侧菜单按钮，0为关闭右侧菜单并隐藏右侧菜单按钮，1为显示右侧菜单按钮

备注：

导航菜单动态隐藏

                    YDB.MenuBarAutoHide(0);
                    // 参数说明：设置是否开启菜单动态隐藏，0关闭，1开启
                    // 如果开启此功能，滑动屏幕动态隐藏显示菜单、标题栏

适用模板：有导航模板

备注：

返回前一页面

                    YDB.GoBack();
                    // 返回前一页面

备注：

返回前一页面时执行的操作

                    YDB.IsReloadPreviousPage(operation);
                   //参数说明，  执行返回前一页面时的操作，operation当传值为1时，刷新前一页面，传值为前一页面的js方法名时，执行js方法。
                   //示例：<div  onclick="gobackprevious();">返回前一页面</div>
                   //function gobackprevious() { var YDB = new YDBOBJ();  YDB.IsReloadPreviousPage('javascript:get_user_status();'); YDB.GoBack(); }
                   //其中get_user_status()是您前一个页面的js方法名,返回前一页面时会执行您前一页面中的get_user_status()方法。

备注：此功能仅适用于开启云开发插件的应用。

进入下一页面执行的操作

                    YDB.IsReloadNextPage(operation);
                   //参数说明， 进入到下一页面时， operation当传值为1时，刷新下一页面，传值为下一页面的js方法名时，执行js方法。
                   //示例 ：var YDB = new YDBOBJ();  YDB.IsReloadNextPage('reload_page();');
                   //其中reload_page()是您下一个页面的js方法名,进入下一页面时会执行您下一页面中的reload_page()方法。

备注：此功能仅适用于IOS。

关闭/开启安卓硬件加速

                    YDB.SetHardware(state);
                   //参数说明， state 关闭/开启安卓硬件加速，0为关闭，1为开启。
                   //示例 ：var YDB = new YDBOBJ();  YDB.SetHardware(0);//关闭硬件加速

备注：此功能仅适用于安卓。

返回顶级页面

                    YDB.GoTop();
                    // 返回顶级页面（跳转至此导航节点的起始页面）

备注：

调出右侧菜单

                    YDB.ShowTopRightMenu();
                    // 调出右侧菜单

备注：

单页面设置底色

                    YDB.SetBgColor(BgColor);
                    //设置App原生底色，使用16进制颜色值设置，比如：#ffcc00

备注：

显示/隐藏返回按钮

                    YDB.SetReturnButtonMode(showmode);
                    //参数说明，showmode  int类型，当传值为1时，显示返回按钮，传值为0 则隐藏返回按钮。

备注：

打开新窗口

                     YDB.OpenNewWindow();
                    //等同于a标签中的target="_blank"。
                    //打包之后的应用需使用YDB.OpenNewWindow()方法代替target="_blank"。                    
                    //示例：<a href="new.html" onclick="OpenNewWindow();">新窗口打开</a>
                    //function OpenNewWindow(){var YDB = new YDBOBJ(); YDB.OpenNewWindow();}

备注：

新窗口动画效果

                     YDB.AnimationWay("entranceway","exitway");
                    //参数说明：entranceway：页面入场方式，可选参数：0 从右往左 1 从下往上 exitway：页面出场方式，可选参数：0 从左往右 1 从上往下。
                    //当页面中使用YDB.OpenNewWindow()打开新窗口时，默认动画入场方式为（0）从右往左，出场方式为（0）从左往右。
                      仅支持YDB.AnimationWay("0","0") 和 YDB.AnimationWay("1","1")

备注：此功能需配合打开新窗口使用。

修改IOS状态栏文字颜色

                     YDB.SetStatusBarStyle(fontcolor);
                    //参数说明：fontcolor：文字颜色，可选参数：0 白色 1 黑色 
                    //示例：YDB.SetStatusBarStyle(1);修改IOS状态栏颜色为黑色

备注：此功能仅适用于IOS。

是否固定底部导航

                     YDB.IsFixedBottomMenu(IntState);
                   //此功能为全局功能，仅调用一次即可。
                    //参数说明：IntState：是否固定，可选参数：0 固定（当页面有输入框等调用键盘的操作时，底部导航不会跟随键盘移动） 1 不固定（当页面有输入框等调用键盘的操作时，底部导航会跟随键盘移动），默认效果为不固定。 
                    //示例：YDB.IsFixedBottomMenu(0);设置底部导航不跟随键盘移动

备注：此功能仅适用于安卓。

设置APP字体大小

                     YDB.SetFontSize();
                    //调用此方法可设置APP字体大小，可以选大小有：小号字、中号字、标准字、大号字、特大号字，调用方法之后在APP中直接选择即可。
                    //示例：var YDB = new YDBOBJ();YDB.SetFontSize();

备注：如调用方法没有生效，请重新生成应用后使用。

调整屏幕亮度

                     YDB.SetBrightness(percent);
                    //调用此方法可调整屏幕亮度。
                    //参数说明：percent可选值为0到1，其中0最暗，1最亮。
                    //示例：var YDB = new YDBOBJ();YDB.SetBrightness("0.6");设置屏幕亮度为60%;

备注：如调用方法没有生效，请重新生成应用后使用。

点击全屏时是否横屏

                     YDB.IsShowLandcape(showMode);
                    //参数说明：参数 showMode,类型 int， 0 不横屏，1 横屏。
                    //示例：var YDB = new YDBOBJ();YDB.IsShowLandcape(0);//点击全屏时不横屏

备注：

横屏竖屏模式

                     YDB.ScreenOrientation(showMode);
                    //参数说明：参数 showMode,参数类型 int，0竖屏，1自适应，2横屏。
                    //示例：var YDB = new YDBOBJ();YDB.ScreenOrientation(2);//开启横屏模式

备注：

APP系统功能类

扫一扫

无返回值方法

                    YDB.Scan();
                    // 参数说明：此方法无参数，直接调用扫一扫功能，扫描结果由App自行处理

备注：

有返回值方法

                    YDB.GetScan("你事先准备好的方法名");
                    //参数说明：web处理扫描结果，传入返回值处理方法名，在这个方法中处理扫描字串,
                    //例如，您定义的方法为 function DoWithScan(outValue){}; 
                    //那么，调用SDK可以这样写：YDB.GetScan("DoWithScan");

备注：

                    YDB.Share('标题','简介','图片路径','链接地址','回调方法');
                    // 参数说明：分别传入分享信息的标题、简介、图片路径、URL链接地址、分享回调方法名（接收分享结果的json字串）
                    //示例：var YDB = new YDBOBJ(); YDB.Share("测试分享标题", "测试分享标题内容", "http://static.ydbimg.com/Images/frontimg/logo.png", "http://www.yundabao.cn/","Shareback");
                    //回调方法：function Shareback(state) {alert("分享结果：" + JSON.stringify(state)); } 
                    //分享结果的json数据示例：{"platform":"Wechat","state":"success"},其中platform中的Wechat代表微信好友(其他分享平台分别是WechatMoments(微信朋友圈)、SinaWeibo(新浪微博)、QQ(QQ)、Qzone(QQ空间)、ShortMessage(短信))，state的三种返回结果：success、fail、cancel
                    //提示：如果您使用QQ分享回调的同时开启了QQ登录插件，QQ登录的插件参数APP ID需跟分享设置里的腾讯开放平台APP ID参数保持一致。微信分享回调需在分享设置页面开启微信分享回调才可正常使用。

备注：原YdbOnline方法YDB.Share('标题','简介','图片路径','链接地址')可继续使用。

单个平台分享

                    YDB.SingleShare('标题','简介','图片路径','链接地址','要分享的平台','回调方法');
                    // 参数说明：分别传入分享信息的标题、简介、图片路径、URL链接地址、要分享的平台、分享回调方法名（接收分享结果的json字串）
                                         其中'要分享的平台'可选参数：0、1、2、3、4、5   说明：0微信好友 1微信朋友圈 2新浪微博 3QQ 4QQ空间 5信息
                    //示例：var YDB = new YDBOBJ(); YDB.SingleShare("测试分享标题", "测试分享标题内容", "http://static.ydbimg.com/Images/frontimg/logo.png", "http://www.yundabao.cn/","1","SingleShare");
                    //回调方法：function SingleShareback(state) {alert("分享结果：" + JSON.stringify(state)); }
                    //分享结果的json数据示例：{"platform":"Wechat","state":"success"},其中platform中的Wechat代表微信好友(其他分享平台分别是WechatMoments(微信朋友圈)、SinaWeibo(新浪微博)、QQ(QQ)、Qzone(QQ空间)、ShortMessage(短信))，state的三种返回结果：success、fail、cancel
                    //提示：如果您使用QQ分享回调的同时开启了QQ登录插件，QQ登录的插件参数APP ID需跟分享设置里的腾讯开放平台APP ID参数保持一致。微信分享回调需在分享设置页面开启微信分享回调才可正常使用。

备注：

清理缓存

                    YDB.ClearCache();
                    //不需要参数，调用清理缓存的系统方法

备注：

获取设备信息

                    YDB.GetDeviceInformation("处理返回值的函数名");
                    //参数说明：您需要定义处理返回值函数，例如 function DoWithDeviceInformation(info){/*do something with info*/};
                    //那么，调用SDK可以这样写：YDB. GetDeviceInformation ("DoWithDeviceInformation")

备注：

气泡提醒

                    YDB.PopUp(index,count);
                    //参数说明：index 字符串类型，设定气泡所在导航索引，从0开始，多个索引以逗号分隔; 
                    //count 字符串类型，设定气泡中显示数量的数字，多个数量以逗号分隔，跟索引数量要匹配。
                    //当count设置为零，则表示当前索引不显示气泡！
                    //示例：YDB.PopUp("0","2");//表示在第一个导航处带数字2的气泡提醒

备注：

上传图片、拍照上传功能

                    此功能不需要JS支持，页面中只要包含上传组件即可，在用户点击上传的时候，App会自动启动选取相册中图片文件或者调用拍照功能。

备注：

图片预览

                    YDB.ImageViewState(state);
                    //参数说明：如果要开启图片预览功能，需要在相应页面调用此功能，当state设置为0时关闭图片预览功能；当state设置为1时，开启图片预览功能，
                    //同时，页面中在需要预览功能支持的图片超链接进行如下设置：
                    //需要在图片外层img标签增加属性Is9VImg="true"，当Is9vImg值为true时，点击图片会启动App的图片浏览器。
                    //需要注意的是img的图片路径src必须是可以直接访问的带http/https的网络路径。

备注：

退出安卓APP

                    YDB.ExitApp();          
                    //退出安卓APP

备注：此功能仅适用于安卓。

使用浏览器打开

                    YDB.OpenWithSafari("openurl");          
                    //参数openurl：需要在浏览器中打开的网址  
                    //示例：YDB.OpenWithSafari("http://m.baidu.com");;

备注：此功能适用于安卓和IOS。

获取个推ClientID

                    YDB.GetClientIDOfGetui("doWithCIDFun");          
                    //参数说明：传入返回值处理方法名，在这个方法中处理从个推申请到的cid
                    //例如，您定义的方法为
                    // function doWithCIDFun (cid){/*do something with cid*/}; 
                    //那么，调用SDK可以这样写：YDB.GetClientIDOfGetui("doWithCIDFun");

备注：此功能适用于自有证书，并且在个推后台配置过证书信息，准备自主整合个推接口的用户，尤其适合上传过IOS上架证书的用户（目前站内暂不支持IOS上架证书应用的个推推送）。

检测IOS是否安装微信客户端

                     YDB.isWXAppInstalled("处理返回值的函数名");
                    //参数说明：您需要定义处理返回值函数，例如 function installstate(state){/*state返回的是微信客户端安装状态：0未安装 1已安装*/};
                    //那么，调用SDK可以这样写：YDB.isWXAppInstalled("installstate")

备注：此插件仅适用于IOS

增强型上传图片

                     YDB.UploadImage(receiveUrl, showFun, UserName, Key, IsCut, Width, Height);
                    //参数说明：receiveUrl 接收并处理图片的页面, showFun 处理上传图片返回路径的函数名, UserName 用户唯一标识（UserName可自定义,名称和值之间需用冒号‘：’隔开，例：User:lisi）,
                                Key 用户密码（Key可自定义，名称和值之间需用冒号‘：’隔开，例：PassWd:111111）, IsCut 是否裁剪图片（0关闭裁剪，1开启裁剪）, Width 所需图片宽度, Height 所需图片高度

备注：

APP插件类

语音识别

                   YDB.SpeechRecognition("处理语音识别结果函数名");
                   //参数说明：传入返回值处理方法名，在这个方法中处理扫描字串
                   //例如，您定义的方法为
                   // function DoWithSpeechRecognition (outValue){/*do something with outValue*/}; 
                   //那么，调用SDK可以这样写：YDB.SpeechRecognition("DoWithSpeechRecognition");

备注：此功能需开启语音插件之后才可使用。

地理位置

                   YDB.GetGPS("处理返回坐标信息的方法名");
                   // 您需要定义一个处理函数
                   //例如：function DoWithGPS (la,lo){//dosomething with la,lo }; 
                   //那么，调用SDK可以这样写：YDB.GetGPS(“DoWithGPS”);

备注：开通定位插件并配置相关参数之后，才可使用此功能。

实时地理位置

开启实时定位

                    YDB.OpenGPS(userid);
                    //参数说明：userid 用户唯一身份id，用于传递用户身份信息，
                    //需要在后台系统设置中设置，提交间隔，抓取间隔，接收地址等几项参数，
                    //接收地址用于接收来自应用post提交的数据（post参数名：gps,值示例：[{"userid":"888","time":"2015-05-06    16:10:45","lon":"113.574804","lat":"34.807128"},{"userid":"888","time":"2015-05-06    16:10:50","lon":"113.574804","lat":"34.807128"}]）

备注：开通定位插件并配置相关参数之后，才可使用此功能。

关闭实时定位

                    YDB.CloseGPS();
                    // 不需要参数，调用此方法停止实时定位

备注：开通定位插件并配置相关参数之后，才可使用此功能。

支付宝支付

                    YDB.SetAlipayInfo(ProductName, Desicript, Price, OuttradeNo);
                    //参数说明：ProductName 名称, Desicript 描述, Price 支付金额, OuttradeNo 订单编号(64个字符以内、可包含字母、数字、下划线，需保证在商户端不重复)

备注：开通支付宝支付插件并配置相关参数之后，才可使用此功能。

微信支付

                    YDB.SetWxpayInfo(ProductName, Desicript, Price, OuttradeNo,attach);
                    //参数说明：ProductName 名称, Desicript 描述, Price 支付金额, OuttradeNo 订单编号(32个字符内、可包含字母),attach 附加参数。
                    //支付结果页面中OuttradeNo,attach将以Querstring的方式传递

备注：开通微信支付插件并配置相关参数之后，才可使用此功能。

微信登录

                    YDB.WXLogin(returnDataType, accessUrl);                
                    //参数returnDataType： 返回值类型
                    //参数accessUrl： accessUrl（必须为带http或https的网络路径）接收返回值的url，可附加Url参数，用来判断用户登录状态以及设置用户信息等操作
                    //参数影响：
                    //当returnDataType为0时，accessUrl在post时接收到参数为：token (字符类型)、openid (字符类型)、sign (Md5加密字串)，get时接收到的参数为openid (字符类型)
                    //当returnDataType为1时，accessUrl在post时接收到参数为：token (Json字串)、resault (Json字串)、openid (字符类型)、sign (Md5加密字串)，get时接收到的参数为openid (字符类型)

备注：此插件需要开通微信登录插件并配置相关参数，微信登录整体流程：调用js_sdk方法-->呼出微信登录窗口-->登录验证通过-->手机端post数据给accessUrl（post参数：token，openid，sign等），accessUrl 处理接收到的数据，并标记用户登录状态 --> App跳转到accessUrl（get参数：openid） --> accessUrl根据先前存储的信息处理后续跳转等操作，其中sign为辅助性的安全校验参数，sign=MD5(传递参数&链{SignKey})，SignKey在“服务功能”->"其他功能"->"安全码设置"中配置。
温馨提示：对于iOS应用，考虑到iOS应用商店审核指南中的相关规定，建议开发者接入微信登录时，先检测用户手机是否已安装微信客户端（使用sdk中isWXAppInstalled函数），对未安装的用户隐藏微信登录按钮，只提供其他登录方式（比如手机号注册登录、游客登录等）。

获取Wifi的ssid

                     YDB.GetWifiSsid("处理返回值的函数名");
                    //参数说明：您需要定义处理返回值函数，例如 function DoWithWifiSsid(info){/*info返回的是您当前连接wifi的ssid*/};
                    //那么，调用SDK可以这样写：YDB.GetWifiSsid("DoWithWifiSsid")

备注：开通获取Wifi的ssid插件之后，才可使用此功能。

指纹验证

                     YDB.UseTouchID("DoWithTouchID","LoginUrl","AccessTitle","FallbackTitle");
                    //参数说明：DoWithTouchID：您需要定义处理返回值函数，例如 function DoWithTouchID(info){/*info中返回值 0是验证失败，1是验证成功*/};
                                     LoginUrl：指纹验证失败时，用户提供的带有其他验证方式的url地址。
                                  AccessTitle：提示文字，用来向用户说明使用指纹验证的目的。
                                FallbackTitle：指纹验证失败时，提示框的文字提示，默认提示为“输入密码”。
                    //示例：YDB.UseTouchID("DoWithTouchID","http://你的验证url地址","指纹验证","其他验证方式")

备注：开通指纹验证插件后才可使用此功能，此功能仅适用于IOS。

获取健康步数

                     YDB.GetHealthStep("处理返回值的函数名");
                    //参数说明：您需要定义处理返回值函数，例如 function DoWithHealthStep(info){/*info中返回的是您当前的健康步数*/};
                    //那么，调用SDK可以这样写：YDB.GetHealthStep("DoWithHealthStep")

备注：开通获取健康步数插件后才可使用此功能，此功能适用于安卓和IOS。

QQ登录

                    YDB.QQLogin(accessUrl);          
                    //参数accessUrl： accessUrl（必须为带http或https的网络路径）接收返回值的url，可附加Url参数，用来判断用户登录状态以及设置用户信息等操作
                    //接收参数：
                    //accessUrl接收到参数为：openid（用户唯一标识）字符类型、token 字符类型、userinfo（用户昵称、用户头像等基本信息） Json字串

备注：开通QQ登录插件并配置相关参数之后，才可使用此功能。