This commit is contained in:
尹吉欢
2018-03-13 10:16:16 +08:00
parent 10a547fb6b
commit ed180d40a5
155 changed files with 30041 additions and 0 deletions
+35
View File
@@ -0,0 +1,35 @@
# maven ignore
unpackage/
*.apk
target/
*.jar
*.war
*.zip
*.tar
*.tar.gz
# eclipse ignore
.settings/
.project
.classpath
# idea ignore
.idea/
*.ipr
*.iml
*.iws
# temp ignore
*.log
*.cache
*.diff
*.patch
*.tmp
*.java~
*.properties~
*.xml~
# system ignore
.DS_Store
Thumbs.db
+196
View File
@@ -0,0 +1,196 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="js/common.js"></script>
<script type="text/javascript" charset="utf-8">
// H5 plus事件处理
function plusReady(){
var ev=document.getElementById('version');
ev&&(ev.innerText=plus.runtime.version);
plus.webview.currentWebview().show('zoom-fade-out');
// 更新分享按钮
plus.share.getServices(function(s){
for(var i in s){
shares[s[i].id]=s[i];
}
var ss=shares['weixin'];
ss&&ss.nativeClient&&(shareBts.push({title:'微信朋友圈',s:ss,x:'WXSceneTimeline'}),
shareBts.push({title:'微信好友',s:ss,x:'WXSceneSession'}));
ss=shares['sinaweibo'];
ss&&shareBts.push({title:'新浪微博',s:ss});
ss=shares['qq'];
ss&&ss.nativeClient&&shareBts.push({title:'QQ',s:ss});
shareBts.push({title:'更多'});
},function(e){
console.log('updateShare failed: '+JSON.stringify(e));
});
// 在流应用环境下显示“创建桌面图标”
if(navigator.userAgent.indexOf('StreamApp')>=0){
shortcut.style.display='block';
}
// 设置窗口优化隐藏
dragHide();
}
document.addEventListener("plusready",plusReady,false);
// 判断是否为流应用环境
var bStream = navigator.userAgent.indexOf('StreamApp')>=0;
// 分享应用
var shares={},shareBts=[];
function share(){
(shareBts.length>1)||('Android'!==plus.os.name&&shareBts.length>0)?plus.nativeUI.actionSheet({title:'分享"HelloH5"应用',cancel:'取消',buttons:shareBts},function(e){
(e.index>0)&&shareAction(shareBts[e.index-1]);
}):(shareBts.length>0?shareWithSystem():plus.nativeUI.alert('当前环境无法支持分享操作!'));
}
function shareAction(sb){
if(!sb.s){
shareWithSystem();
return;
}
var msg={};
msg.href=bStream?'http://m3w.cn/s/HelloH5?url=about&__streamapp':'http://www.dcloud.io/helloh5/';
msg.content='"HelloH5"使用HTML5+技术开发,如果你有流应用引擎还能省流量秒装,快来体验吧';
sb.x&&(msg.extra={scene:sb.x});
msg.thumbs=msg.pictures=['_www/icon.png'];
console.log('share '+sb.title+' : '+JSON.stringify(msg));
sb.s.authenticated?shareMessage(sb.s,msg):sb.s.authorize(function(){
shareMessage(sb.s,msg);
},function(e){
plus.nativeUI.toast('取消分享!');
});
}
function shareMessage(s,m){
s.send(m, function(){
plus.nativeUI.toast('完成分享!');
},function(e){
plus.nativeUI.toast('取消分享!');
});
}
function shareWithSystem(){
plus.share.sendWithSystem?plus.share.sendWithSystem({
content:'"HelloH5"使用HTML5+技术开发,如果你有流应用引擎还能省流量秒装,快来体验吧('+(bStream?'http://m3w.cn/s/HelloH5?__streamapp':'http://www.dcloud.io/streamapp/')+')',
title:'HelloH5',
href:bStream?'http://m3w.cn/s/HelloH5?__streamapp':'http://www.dcloud.io/streamapp/',
pictures:('Android'==plus.os.name)?null:['_www/icon.png']
}):shareWithSystemNativeJS();
}
function shareWithSystemNativeJS(){
var main = plus.android.runtimeMainActivity(),
Intent = plus.android.importClass('android.content.Intent'),
File = plus.android.importClass('java.io.File'),
Uri = plus.android.importClass('android.net.Uri');
var intent=new Intent(Intent.ACTION_SEND),
p=plus.io.convertLocalFileSystemURL('_www/icon.png'),
f=new File(p),
uri=Uri.fromFile(f);
if(f.exists()&&f.isFile()){
intent.setType('image/*');
intent.putExtra(Intent.EXTRA_STREAM,uri);
}else{
intent.setType('text/plain');
}
intent.putExtra(Intent.EXTRA_SUBJECT,'HelloH5');
intent.putExtra(Intent.EXTRA_TEXT,'"HelloH5"使用HTML5+技术开发,如果你有流应用引擎还能省流量秒装,快来体验吧('+(bStream?'http://m3w.cn/s/HelloH5?__streamapp':'http://www.dcloud.io/streamapp/')+')');
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
main.startActivity(Intent.createChooser(intent,'分享"HelloH5"应用'));
}
function createShortcut(){
plus.navigator.createShortcut({name:'HelloH5',icon:'icon.png'});
}
function dragHide(){
var ws = plus.webview.currentWebview();
// 窗口隐藏时调整到正确位置(drag操作会修改窗口位置),否则可能导致无法调用show方法显示
ws.addEventListener('hide',function(){
ws.setStyle({left:'0px'});
},false);
// 设置拖动关闭当前窗口
ws.drag({direction:'right',moveMode:'followFinger'}, {view:plus.runtime.appid,moveMode:'silent'}, function(e){
if(e.type=='end'&&e.result){
ws.hide();
}
console.log('Drag Event: '+JSON.stringify(e));
});
}
function test() {
plus.runtime.restart()
}
</script>
<link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css">
li {
padding: 2em;
border-bottom: 1px solid #eaeaea;
background: #fafafa;
font-size: 12px;
}
li:active {
background: #f4f4f4;
}
footer {
width: 100%;
text-align: center;
color: #c6c6c6;
font-size: 12px;
}
.ishare {
background:no-repeat center center url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABYCAYAAAADWlKCAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAABx0RVh0U29mdHdhcmUAQWRvYmUgRmlyZXdvcmtzIENTNui8sowAAAAWdEVYdENyZWF0aW9uIFRpbWUAMDIvMDIvMTbTM6q2AAAD8ElEQVR4nO3bS2hcZRiH8edMlJSgFVGw4kbQhRdE5U1QiaJdGduKKG5EvCAKxbqooFZXtmIUqYIFF7pQRMRQ8FaqSF2bVfLGbBTqpS6sxShSvKQYSs5xcRJJptPMN+iZ+c/J+1vmfANveIY53/kmyYqiIOho9HqAsFoEERNBxEQQMRFETAQRE0HERBAxEURMBBETQcREEDERREwEERNBxEQQMRFETAQRE0HERBAxEURMBBETQcREEDERREwEERNBxJzR6wG6ZWZmZrgoij3AFuAX4BXgdTP7o7eTrZathz+2dvf7gT3AxU2XDgCPmtmxrg91GrUP4u5bgE/XWHIQuMfM5rs00ppqfQ+ZnJwcAHa3WXY78Fj106SpdZDBwcFNwEUJS3dVPUuqWgfJsmwDab/juVXPkqq2Qdx9K/AWcF7C8kMVj5OsVtted88ot7VPAdcAGxNedqwoimcqHawDtQji7kPAZmAncBMwuHSpAL4F/qIM1PyJMA88PTw8/GWXRm2rr4O4+0ZgFNgBbG26fKQoiv15nu8dGBiYB54D7gLOBk4CR4EXzOyTbs7cjuxziLufD2wA5szsZNO1s4CbgUeAO5pe+hXwMbDPzH5deWF2dnZocXHxcuB3M/uusuH/A7kg7n4lcB9wHeW7+TDwgZl96O4AdwIPcGqIr4H3gTeUnrw7JRXE3UeACeCSFpffBM4B7m76+RHg7TzPJ0ZGRiTf9Z2QCeLum4DPgasSXzIHvAp8ZGaHKxusy5Ru6rtJi3EU2EcZ4vtKJ+oBpSD3JqyZozwI/KLqYXqltk/q/UopyDsJay4AJtz9CXdvdePve0o39Qspz5TW9U1dJgj8u+19D7i0xeU1t73AhOrDXiekggC4+xWUD4bX0/RgODY2xvj4eDwY9kLC0cktwMN0cHSydAh5GeXRieSWWTZIiuXDxaIodmRZdsrhIrAf2Jvn+YlGo/E8Zbzlw8UfgRfjcLECU1NTQ41GYzPwOHAjq4/fvwFOAFfT+vh9u5m9261Z26lFkGUrvqDaRRkg9QuqbSrfidQqyEruvg14ErgBOLPN8kNmNlb9VO0pPRj+r5buDQ8BvyUsv7XicZLVNghAURR/A3nC0uNVz5Kq1kEWFhZ+Bn5KWPpS1bOkqnWQ0dHRReBZyt3W6RwEXuvORO3VOgiAmX0GPAj80OLyAcptr8Tf9UKNd1nNpqenr82ybBy4jfLfEV6m/HeEP3s72WrrJki/qP1HVr+JIGIiiJgIIiaCiIkgYiKImAgiJoKIiSBiIoiYCCImgoiJIGIiiJgIIiaCiIkgYiKImAgiJoKIiSBiIoiYCCImgoiJIGIiiJh/AOY8KMGvlE3GAAAAAElFTkSuQmCC);
background-size:50px 44px;
}
</style>
</head>
<body>
<header id="header">
<div class="nvbt iback" onclick="back(true)"></div>
<div class="nvtt">关于</div>
<div class="nvbt ishare" onclick="test()"></div>
</header>
<div id="content" class="content">
<div class="logo">
<br/>
<img style="width:64px" src="icon.png"/><br/>
<span style="font-size: 20px;">Hello HTML5+</span><br/>
(v<span id="version">1.0.0</span>)<br/>
<!--<img style="width:100%" src="img/qr.png"/>-->
<div id="shortcut" style="display:none;" class="button" onclick="createShortcut()">创建桌面图标</div>
<br/><br/>
</div>
<p class="des" style="font-size:16px;line-height:30px;margin: 0px .5em;">HTML5中国产业联盟,简称“HTML5+ 联盟”,是为了更好的推进HTML5的商用、更好的为HTML5开发者服务而由产业链主流厂商共同组成的一个联盟。<br/>
   HTML5+规范的愿景:根据开发者需求,为其提供增强的功能、性能扩展规范。方便开发者开发跨平台的app,并接近原生的功能和性能。
</p>
<br/>
<ul style="list-style:none;margin:0;padding:0;text-align:left;">
<li onclick="plus.runtime.openURL('http://weibo.com/html5plus');">
<img style="width:40px;height:40px;vertical-align:middle;" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACgAAAAoCAYAAACM/rhtAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMy8xMySCRBYAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAAC/UlEQVRYhe2Y23HaQBSGP2fyDh1YqcDMnAKMK4g6iFwBpIKQCkIqMK4gdGBRwBmLDkQFgQqchz0aVmJXF5zBfvA/wxjt9dPZs/8uvnp5eeE969NbA3TpA/C1+gB8rT5fYhJVTYACGFnRFsiBpYiUbX0vFcExRziAG2AGFKq6aOt4dSkfVNUMSIAJMKUOvAFSEdk3+10MsClVnQMLvGUXkUmz3aUjCLCuIqWqE2CFW3KAnyKy+C+AqjoGUtxyJbhNEEx6A3n2in6LyNyryzlG8os/xlmbxBK7BB6Ab8AtLunzSJc9cPCeZ6paAIhIgVvqSpnfcRCgqk5UtQR+UE/yStcWkZosIgnw3QO9UdWl1S+98vQsQMuhZ+C6o+k4VCgiewOZejAz80iAdQXu9+tl1Pamsz5tcd6WcMzPCrgEFiJS2A5+sPIUWFr9iToBB8KBy8ObQPktkBr82qD8NAkCti6xLesQOCJwlUbAxGwmxeXkCkBEVsA9cOd3iNqMqk6Bp4FwfXQnInnfxkFA87iC7g2xsb85bpdWn1i/g4gEN1FMsRyct0zyiDsN1pH66vYyx3naqFG3wBn6ybkb0kkELXp/A203QNZ1PQqMtQK+NqoOwNzybjDgHPjVaPcoIlkAYAqUXdCqug5AAtx3QYYAC+o7sQZnUVnijrhKO1x08wjgGGcjzdPnACRtyx2yGR9uh8slf6K8AQcuX5+8U6EmAwjl7Ah3P4yq66hbN94uo93nspa6smOuoLoAm6EfZBENJZHysq1TCPAQKKvUZQ15qNC7Oza1PedH08r7ngXqtpGxHltOiOa5W2kRJTPFfLD0Bgzt4gXH5N7jjDcIp6orTjfVybi9AW3QFPjjD4Yz1l7ub2MkuIjfBqo3IjLtM07bZSGjvjQ7e161gdrLpYSjBj0j1wlok00MqhmFLW5pc3tO7BOKVqUdbhWiZ/hgQA90aqBtHtgG1hn5mAb97Gxc5SeEbzwH3FUtxxl9MRTqbMC30Lv/99sH4Gv17gH/ARiRUOpAHVd0AAAAAElFTkSuQmCC"/>
微博
</li>
<li onclick="plus.runtime.openURL('http://www.html5plus.org');">
<img style="width:40px;height:40px;vertical-align:middle;" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACgAAAAoCAYAAACM/rhtAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMy8xMySCRBYAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAAEbUlEQVRYhc2YT2hcRRzHPzNvE82/TTbWP5DaQy021SgqmYf1DxQRqidvxYOCF+vFiyDiHxDBSxEPih4EEcRL9SJ4KHiwoNUovAlisdKiKQWNf9qkyTZN0k3e2xkP87Zu3r59+3azjfnCg/eb4Tf7YX5/ZvYJay3bWfL/Bmilwlb+mJ6e3mWt/aBqzOMCTnlSvqyUOpblI7YqxIHWTwOvWtgrhRDWWiwsCHgfeNNXKkrz25IQB1ofAj4xxox7Uorb9+yhVCphjRkFXgdeaeZ7zQEDrQeB14y1RFGENYaBgX6kEIRh6MasfVFPTz+S5t+Qg4HWB4AqILrAdxnYb62dGOzvp9DTgwDCKGJ4ZAQhJdYYFhYWitVq9R3g7paAwOdAqQtwV2WMoVgcolgsEoYhxhhGSyVGSyUqlQrlcpkwiu5K800D/Bp4gi6G3/M85ubmOX/+AoWeAvv2jvPH7CwX5+cRQlA1Bs/zjqf5pkH8BITdgqsprFZZW18nCiMKBY8wDFleWaGytgYwK6V8Pi/gGWC924BSCAqFAkIKFsuXiKKI3t5ePM8DeENNTp5J80sL8W/AKjAU25buFAxSSoyxzJw9i5QSKeVp4D1fqY+a+aQBzgJLwM11Y28DX9JZXhrgEHC4NuB53j/AC8C3vlJ/ZjmnAa7FgDUJYMZXKjWJ8yjQejIxdM5X6tM8vmk7EgELibFdnYDVaSxhLwZaX5fHMW0H14GLibEdtZdA61HgWcCjdUM3uIgcSIzPkbMQ0wAjYD4xdmMC9kiexTM07yuV65bSEGJfKWgMcbHufQW40DGaU3L9pmp2H1xM2IOB1n2+UldwgN8A47gQZoU4AvqA3UB9znUdsAgMA1d8pcqB1k8BvTFgltaBO4FjbCyU3BFoBpgskiFgoGb4Sq2TM8kDrS0bUwSgvFnAhhADY4HWf9O6WUvcTtfO8xv471QCqODSZFOAq7j2UMubIvAx7n7XE8+tNvG9HngL+Cy2hxLzl4DlzQKu4MJQO+4krufVdnY3cE/GusN17zelAC6RU83CVQOs1xHgIPAY7n9EM1ngrzp7R2K+3A5gsx1cTgEc9pVaAwi0zqpCwcYQJm/nS7hU2TRgslBuqXs/BXwI3AtM4PJuGfgZ+B74BSDQWtC4g5d9pVq1p2xAX6lqoHXDDtbN/w4cDrQu4nJxDDgHnIybeU0erorrlbvFNAWMlcyTnYHWA75SV1uEr9QScCJjjREabzLnuwU4l7APAicCrb8CjgOngdn6Qz/QuicGmgAejZ99iXWSqdMxYPJG4wH3xc9LuJv3d4HWU8AMcAfwEPAgja3lmgC2ypWdwJPxk1cRjcdoprKOrdzdvg15tFkkWYAngS9w1blZVXFpcBT3tza3Wn5+C7S+Fbgf2A8oYBLX91ppCZgGfgSmgB98pdqq4FyACdgh4DZclT4MPBDbfbiU+BXXqKdwzXzGV6rSLlTHgAlYgetzzwHPAO8CR32l2sqxVtqyL6ydatt/RN/2gP8C7X98gH7rM5EAAAAASUVORK5CYII="/>
http://www.html5plus.org
</li>
<li style="border-bottom:0px;" onclick="window.open('mailto:admin@html5plus.org');">
<img style="width:40px;height:40px;vertical-align:middle;" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACgAAAAoCAYAAACM/rhtAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMy8xMySCRBYAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAABv0lEQVRYhe3X3XGCQBSG4ddM7k0HsQOdOQWEdGAHagWRDpIOYgViB3YgFnBmtIPYgVZgLhYCKK4sixMu+G4c2WV5Ztk/eufzmTbn6b8B99IBfdMBfdMBfdN64LOtUFUHQAAMHmjYAbGIHMsKe7d2ElUdAxHQfxgtywEIROTnssD2ij/JcKfmTYV2X4F5WQUbcJj8fmFe86ExlskeM3S2yf9RWaUqk2QOvCQN7JuQASsRGQFj4M1WsQqwD2ySxgL8kSsRmapqBCzvVbbO4oukjQVATDYEXJLHTarc4LoOLoFx8npWjveGrjiot1AvVTUSkSnVkTMgUtWdCw7q7yQTB+QMWFNzWPhsdXlkWFJ+At59cOA2ScoyUdURZuIcySbSKbkGZit7rfsA38PCFtMzMaanZhRxMQbnOqH+4gMMMQs45JAikl6LKe7jszoPqQsMgSnFcTUEvlU14PqQMcH0qjOyDrAMl4dsLGUBjkhXoA1XJc5IF6AvLo0TsiqwKVyaykgbMD1MLmgWlyZFWpcg20K9Thr5aM50lfy+HJVVsPXgnOy0++gsRCQqK7j50dSWtP67uAP6pgP6pgP6pvXAX+59ddMVCTyHAAAAAElFTkSuQmCC"/>
HTML5+规范不够用或有问题?请联系我们
</li>
</ul>
<br/>
<footer>
<span>Powered By DCloud</span>
<br/>
<span>HTML5+规范版权所有HTML5中国产业联盟</span>
<br/>
<!--<span>Copyright ©2012-2015</span>
<br/>
<span>数字天堂(北京)网络技术有限公司</span>-->
</footer>
</div>
</body>
<script type="text/javascript" src="js/immersed.js" ></script>
</html>
Binary file not shown.
Binary file not shown.
+194
View File
@@ -0,0 +1,194 @@
* {
-webkit-user-select: none;
-ms-touch-select: none;
/*
-ms-touch-action: none;
*/
}
html {
width: 100%;
height: 100%;
}
body {
margin: 0;
padding: 0;
width: 100%;
height: 100%;
font-family: Arial;
font-size:16px;
color: #6c6c6c;
-webkit-touch-callout:none;
-webkit-tap-highlight-color:rgba(0,0,0,0);
-webkit-text-size-adjust:none;
}
header {
width: 100%;
height: 44px;
position: fixed;
top: 0;
left: 0;
font-size: 17px;
text-align: center;
line-height: 44px;
background: #D74B28;
/*background: -webkit-linear-gradient(top,rgba(215,75,40,1),rgba(215,75,40,0.8));*/
z-index: 9999;
/*border-bottom: 1px solid rgba(215,75,40,0.8);*/
-ms-touch-action: none;
}
.nvbt {
width:15%;
height:100%;
float:left;
overflow:hidden;
text-overflow:ellipsis;
white-space:nowrap;
}
.nvbt:active {
background-color: rgba(170,170,170,0.1);
}
.nvtt {
width: 70%;
height: 100%;
color: #cccccc;
float: left;
overflow:hidden;
text-overflow:ellipsis;
white-space:nowrap;
}
.content {
text-align: center;
padding-top: 44px;
}
.scontent {
width: 100%;
position: fixed;
top: 44px;
bottom: 0px;
text-align: center;
overflow-y: scroll;
-webkit-overflow-scrolling: touch;
-ms-touch-action: pan-y cross-slide-y;
-ms-scroll-chaining: none;
-ms-scroll-limit: 0 50 0 50;
}
.dcontent {
text-align: center;
padding-top: 44px;
padding-bottom: 80px;
}
.sdcontent {
width: 100%;
position: fixed;
top: 44px;
bottom: 80px;
text-align: center;
overflow-y: scroll;
-webkit-overflow-scrolling: touch;
-ms-touch-action: pan-y cross-slide-y;
-ms-scroll-chaining: none;
-ms-scroll-limit: 0 50 0 50;
}
.heading {
margin:0 1em;
text-align:left;
}
.des {
padding: 0 1em;
text-align:left;
text-indent: 2em;
word-break: break-all;
}
.logo {
width: 100%;
text-align: center;
}
.button {
font-size: 18px;
font-weight: normal;
text-decoration: none;
display: block;
text-align: center;
overflow:hidden;
text-overflow:ellipsis;
white-space:nowrap;
color: #FFF;
background-color: #FFCC33;
border: 1px solid #ECB100;
padding: .5em 0em;
margin: .5em .7em;
-webkit-border-radius: 5px;
border-radius: 5px;
}
.button:active {
outline: 0;
-webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
}
.button-waring {
color: #666;
background-color: #ebebeb;
border-color: #e0e0e0;
}
.button-select {
font-size: 14px;
background-color: #CCCCCC;
border: 0;
-webkit-border-radius: 2px;
border-radius: 2px;
}
.dlist {
padding: 0px;
margin: 1em;
background: #fff;
border: 1px solid #ddd;
-webkit-border-radius: 3px;
border-radius: 3px;
}
.ditem {
overflow: hidden;
list-style-type: none;
font-size: 1em;
padding: 1em;
border-bottom: inset 1px #ebebeb;
vertical-align: middle;
}
.ditem:active {
background: #f4f4f4;
}
.ditem:last-child {
border-bottom: inset 0px #ebebeb;
}
.ditem-empty {
overflow: hidden;
list-style-type: none;
font-size: 1em;
padding: 1em;
vertical-align: middle;
}
#output {
height: 64px;
position: fixed;
left: 0;
right: 0;
bottom: 0;
color: #f00;
background: #FFF;
font-size: 12px;
line-height: 16px;
word-break: break-all;
z-index: 6666;
padding: 8px 16px;
overflow-x: hidden;
overflow-y: scroll;
border-top: 2px solid #AAA;
-webkit-overflow-scrolling: touch;
}
.iback {
background: no-repeat center center url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABYCAYAAAADWlKCAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAKwwAACsMBNCkkqwAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMi8xM5w+I3MAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAACcklEQVR4nO3a0XESURiG4TeO99iBWoGZ+RvADtKBpAPtwBLsANJBrEAs4MyYDmIHSQXkgk0mMLK7ILt8/+F778ici394OGfDsher1Qqn05tTD+A2M4hYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYb089wNCVUq6Ay+blfUQsTjhOZxc1P9tbSlkAX7b+/C0ifpxgnF5Ve2TtwAD4OvIoe1UlSAsGwPsRR9m76kA6MAD+jjTKQVUF0gMD4HaEUQ6umot6T4ybiJgNP83hVbFDasGACnZIT4yfEXE1wjj/Xeod0hPjDpgNPsyRSguyB8Y0Ih6Gn+g4pQSpFQMSgtSMAclAaseARCDngAFJQM4FAxKAnBMGiH8xLKVMgV89ln6MiPthpxkn6R0SEUvgusfSZSnlsnuZftI75LlSygyYdyx7ZH1s/Rl+ouFKAQIvx9ctMGlZlh4lDQhAcywtqRhF+hqyXfMmT1m/6buasL6mzMaY6dilAoENlLuWZRNgnhEl1ZH1ulLKO9bH16eOpdfqz2K9Lt0Oea75EjilfadAsp2SFgQ2UH53LJ2XUr4PPtARSntkbVfL7+rVgEBvlM/NHQDJUh9Z2zWf/puOZbPhJzm8qkDgBaXt/teHcSY5rOpAAJp/c/vclJSrShDYifKI+NPvVV3U/1VzU3LavFyo/25SPUi2qj2ysmYQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsZ4Ak9fPFwUy/HsAAAAASUVORK5CYII=);
background-size: 50px 44px;
}
.idoc {
background: no-repeat center center url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABYCAYAAAADWlKCAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAKwwAACsMBNCkkqwAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMi8xM5w+I3MAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAAC2klEQVR4nO3bMU9TURjG8T9qIpskDjqYUAejm5B3MS4yOJoUNzd0dCJ+Av0IMrrVTSfK5oiT05vAJG64OUp0carDOdBbjLWBYp+W55fckHC5Nyf8c+5pk3Pner0epuPCpAdggxxEjIOIcRAxDiLGQcQ4iBgHEeMgYhxEjIOIcRAxDiLGQcQ4iBgHEeMgYhxEjIOIcRAxDiLGQcQ4iBgHEXNp0gMYVWY+BV4DO0AX2I6InYkO6gzMqe9czMwFSog2JcQqsFBPfwW2gW5EdCcywDGTDpKZS0AH6AGPgW/APeAi8AhYAZYal2zRD7T//0Y6PrJBGo+oTeAFME+ZHdfqnxwA+8AP4EY9t8Lg7Dl8tE3N7JEMkpkdYA14FhGdzGwBT4DLQy77Qgl0FXhICdSq5w6oM4cSaH/8ox4P1UV9DXhLWcABrgCfKf/ghb9cc7seUOI8B34CQZk5q5R1iMzcpQTqqH0wUJ0hzUEdLdz15zywSIlzZ4Tb/QL2KLPnFnCfxuyJiLlxjHlcpiHIcQMLd2YuUsK0gOsj3P4rJdAncJCR/CNI08DCnZnzlMdWi+GPN4BXoBdk2r+pLwLrwGaN+A5YBnYjYgN4A3ygzIipoLqon1SbPxfubkS8r797ObmhjWbWgjTdrcc6IPVYGmbaH1kzx0HEOIgYBxHjIGIcRIyDiHEQMQ4ixkHEOIgYBxHjIGIcRIyDiHEQMQ4ixkHEOIgYBxHjIGJUgyzTfznnXJHcBlQ3QO8A1J3vbfobpsfp+5jvd2qSQZrqqwMb9SAz2/TfBWmd8LZ7lFnoIKcVEVuUDdeHb1gdBloadl3DdkR8PKPhnZrkZuuTqO8iNmfP0UZrtQ3Vw8xMkOMy8wElzmpE3Jz0eEY1s0GmlerH3nPLQcQ4iBgHEeMgYhxEjIOIcRAxDiLGQcQ4iBgHEeMgYhxEjIOIcRAxDiLGQcQ4iBgHEeMgYhxEjIOI+Q2gWbiBmTXKQQAAAABJRU5ErkJggg==);
background-size: 50px 44px;
}
File diff suppressed because it is too large Load Diff
+5
View File
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large Load Diff
+275
View File
@@ -0,0 +1,275 @@
/* CSS Document */
/* === blue layout === */
.theme {
background-color: #18a2ff;
}
.theme .bar{
background-color: #131313;
color: #fff;
}
.theme .bar:after,
.bar.theme:after {
background-color: #333;
}
.theme .title {
color: #fff;
}
.theme .bar-nav,
.bar-nav.theme{
background-color: #18a2ff;
color: #fff;
}
.theme .bar-nav:before,
.bar-nav.theme:before,
background-color: #333;
}
.theme .tab-item {
color: #fff;
}
.theme .tab-item.active {
color: #18a2ff;
}
.theme .picker-calendar-week-days {
color: #fff;
background-color: #131313;
}
.theme .picker-modal.picker-modal-inline .picker-center-highlight:before {
background-color: #333;
}
.theme .picker-modal.picker-modal-inline .picker-center-highlight:after {
background-color: #333;
}
.theme .picker-modal.picker-modal-inline .picker-item.picker-selected {
color: #fff;
}
.theme .picker-modal.picker-modal-inline .picker-calendar-week-days {
color: #fff;
}
.theme .picker-modal.picker-modal-inline .picker-calendar-day {
color: #fff;
}
.theme .picker-modal.picker-modal-inline .picker-calendar-day.picker-calendar-day-prev,
.theme .picker-modal.picker-modal-inline .picker-calendar-day.picker-calendar-day-next {
color: #777;
}
.theme .picker-modal.picker-modal-inline .picker-calendar-day.picker-calendar-day-disabled {
color: #555;
}
.theme .picker-modal.picker-modal-inline .picker-calendar-day.picker-calendar-day-today span {
background: #444;
}
.theme .picker-modal.picker-modal-inline .picker-calendar-week-days:after,
.theme .picker-modal.picker-modal-inline .picker-calendar-row:after {
background-color: #333;
}
.theme .picker-modal.picker-modal-inline .toolbar ~ .picker-modal-inner .picker-calendar-months:before,
.theme .picker-modal.picker-modal-inline .picker-calendar-week-days ~ .picker-calendar-months:before {
background-color: #333;
}
.theme .photo-browser .navbar,
.photo-browser.theme .navbar,
.theme .view[data-page="photo-browser-slides"] .navbar,
.view[data-page="photo-browser-slides"].theme .navbar,
.theme .photo-browser .toolbar,
.photo-browser.theme .toolbar,
.theme .view[data-page="photo-browser-slides"] .toolbar,
.view[data-page="photo-browser-slides"].theme .toolbar {
background: rgba(19, 19, 19, 0.95);
}
.theme .tabbar a:not(.active) {
color: #fff;
}
.theme .page,
.theme .login-screen-content,
.page.theme,
.theme .panel,
.panel.theme,
.theme .content {
background-color: #222426;
color: #ddd;
}
.theme .content-block-title {
color: #fff;
}
.theme .content-block,
.content-block.theme {
color: #bbb;
}
.theme .content-block-inner {
background: #1c1d1f;
color: #ddd;
}
.theme .content-block-inner:before {
background-color: #393939;
}
.theme .content-block-inner:after {
background-color: #393939;
}
.theme .list-block ul,
.list-block.theme ul {
/* background: #1c1d1f;*/
}
.theme .list-block ul:before,
.list-block.theme ul:before {
background-color: #393939;
}
.theme .list-block ul:after,
.list-block.theme ul:after {
background-color: #393939;
}
.theme .list-block.inset ul,
.list-block.theme.inset ul {
background: #1c1d1f;
}
.theme .list-block.notifications > ul,
.list-block.theme.notifications > ul {
background: none;
}
.theme .list-block .item-title,
.list-block.theme .item-title,
.theme .list-block .item-subtitle,
.list-block.theme .item-subtitle {
color: #bbb;
}
.theme .card {
background: #1c1d1f;
}
.theme .card-header:after {
background-color: #393939;
}
.theme .card-footer {
color: #bbb;
}
.theme .card-footer:before {
background-color: #393939;
}
.theme li.sorting {
background-color: #29292f;
}
.theme .swipeout-actions-left a,
.theme .swipeout-actions-right a {
background-color: #444;
}
.theme .item-inner:after,
.theme .list-block ul ul li:last-child .item-inner:after {
background-color: #393939;
}
.theme .item-after {
color: #bbb;
}
html:not(.watch-active-state) .theme .item-link:active,
html:not(.watch-active-state) .theme label.label-checkbox:active,
html:not(.watch-active-state) .theme label.label-radio:active,
.theme .item-link.active-state,
.theme label.label-checkbox.active-state,
.theme label.label-radio.active-state {
/* background-color: #29292f;*/
}
.theme .item-link.list-button:after {
background-color: #393939;
}
.theme .list-block-label {
color: #bbb;
}
.theme .item-divider,
.theme .list-group-title {
background: #1a1a1a;
color: #bbb;
}
.theme .item-divider:before,
.theme .list-group-title:before {
background-color: #393939;
}
.theme .searchbar {
background: #333;
}
.theme .searchbar:after {
background-color: #333;
}
.theme .list-block input[type="text"],
.list-block.theme input[type="text"],
.theme .list-block input[type="password"],
.list-block.theme input[type="password"],
.theme .list-block input[type="email"],
.list-block.theme input[type="email"],
.theme .list-block input[type="tel"],
.list-block.theme input[type="tel"],
.theme .list-block input[type="url"],
.list-block.theme input[type="url"],
.theme .list-block input[type="date"],
.list-block.theme input[type="date"],
.theme .list-block input[type="datetime-local"],
.list-block.theme input[type="datetime-local"],
.theme .list-block input[type="number"],
.list-block.theme input[type="number"],
.theme .list-block select,
.list-block.theme select,
.theme .list-block textarea,
.list-block.theme textarea {
color: #fff;
}
.theme .label-switch .checkbox {
background-color: #393939;
}
.theme .label-switch .checkbox:before {
background-color: #1c1d1f;
}
.theme .range-slider input[type="range"]:after {
background: #1c1d1f;
}
.theme .buttons-tab {
background: #131313;
}
.theme .buttons-tab .tab-link:not(.active) {
color: #ddd;
}
.button.theme{background:none;border-color:#18a2ff;color:#18a2ff;}
.button.button-fill.theme{background:#18a2ff;color:#fff;}
.bar-nav.theme .button-nav{background:#18a2ff;}
.bar-nav.theme .icon.icon-left{color:#fff;}
.bar .button-link.theme{background:none;color:#18a2ff;}
.bar-tab.theme{background:#f7f7f8;}
.bar-tab.theme .tab-item{color:#999;}
.bar-tab.theme .tab-item.active{color:#18a2ff;}
.bar-tab.theme .tab-item:active{color:#18a2ff;}
.buttons-row.theme{background:none;}
.buttons-row.theme .button{background:#fbfbfb;border-color:#ccc;color:#666;}
.buttons-row.theme .button.active{background:#18a2ff;border-color:#18a2ff;color:#fff;}
.selectBox div.theme{background:none;}
.selectBox div.theme.active{color:#18a2ff;}
.selectBox div.theme.active a{color:#18a2ff;}
.selectContent .list-block ul li .item-title.theme{background:none;}
.selectContent .list-block ul li .item-title.theme.active{color:#18a2ff;}
.buttons-tab.theme{background:#fff;}
.buttons-tab.theme .button.active{border-color:#18a2ff;color:#18a2ff;}
.buttons-tab01.theme .button.active{border-right-color:#e7e7e7;}
.totalValue01.theme{background:none;}
.totalValue01.theme div.addPropertyBox .addProperty{border-color:#18a2ff;color:#18a2ff;}
.list-block .item-after span.sendCode.theme{background:none;border-color:#18a2ff;color:#18a2ff;}
.list-block .item-after span.waiting.theme{background:#18a2ff;border-color:#18a2ff;color:#fff;}
.topic .topicTitle em.theme{background:none;color:#18a2ff;}
.topic .topicTitle > span.inputBox input{background:none;color:#18a2ff;}
.topic .topicTitle > span.inputBox font{background:none;color:#18a2ff;}
.list-block.theme ul{background:#18a2ff;}
.theme .list-block ul:before, .list-block.theme ul:before{height:0;}
.theme .list-block ul:after, .list-block.theme ul:after{height:0;}
.list-block.theme .item-link:active{background:#18a2ff;}
.list-block.theme p{color:#fff;}
.list-block.theme .item-link .item-inner{background-image:#fff;}
input[type=range].theme{background:-webkit-linear-gradient(#18a2ff, #18a2ff) no-repeat;}
+135
View File
@@ -0,0 +1,135 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.accelerometer">accelerometer</a></h1>
<p>Accelerometer模块管理设备加速度传感器,用于获取设备加速度信息,包括x(屏幕水平方向)、y(垂直屏幕水平方向)、z(垂直屏幕平面方向)三个方向的加速度信息。通过plus.accelerometer获取设备加速度传感器管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.accelerometer.getCurrentAcceleration">getCurrentAcceleration</a>: 获取当前设备的加速度信息</li>
<li>
<a href="#plus.accelerometer.watchAcceleration">watchAcceleration</a>: 监听设备加速度变化信息</li>
<li>
<a href="#plus.accelerometer.clearWatch">clearWatch</a>: 关闭监听设备加速度信息</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.accelerometer.Acceleration">Acceleration</a>: 设备加速度信息对象</li>
<li>
<a href="#plus.accelerometer.AccelerometerOption">AccelerometerOption</a>: 监听设备加速度感应器参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.accelerometer.AccelerometerSuccessCallback">AccelerometerSuccessCallback</a>: 获取设备加速度信息成功的回调函数</li>
<li>
<a href="#plus.accelerometer.AccelerometerErrorCallback">AccelerometerErrorCallback</a>: 获取设备加速度信息失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Accelerometer": {
"description": "加速度传感器"
}
}
}
</pre>
<h1><a name="plus.accelerometer.Acceleration">Acceleration</a></h1>
<p>设备加速度信息对象</p>
<pre class="prettyprint linenums">
interface Acceleration {
readonly attribute Number xAxis;
readonly attribute Number yAxis;
readonly attribute Number zAxis;
}
</pre>
<h2>说明:</h2>
<p class="des">
JSON对象,保存获取设备的加速度信息,包括x、y、z三个方向的加速度信息。
</p>
<h2>属性:</h2>
<ul>
<li>xAxis: <em>(<font class="type">Number</font>
类型
)</em>x轴方向的加速度<br><p>获取当前设备x轴方向的加速度,浮点型数据,与物理学中的加速度值一致。</p>
</li>
<li>yAxis: <em>(<font class="type">Number</font>
类型
)</em>y轴方向的加速度<br><p>获取当前设备y轴方向的加速度,浮点型数据,与物理学中的加速度值一致。</p>
</li>
<li>zAxis: <em>(<font class="type">Number</font>
类型
)</em>z轴方向的加速度<br><p>获取当前设备z轴方向的加速度,浮点型数据,与物理学中的加速度值一致。</p>
</li>
</ul>
<h1><a name="plus.accelerometer.AccelerometerOption">AccelerometerOption</a></h1>
<p>监听设备加速度感应器参数</p>
<pre class="prettyprint linenums">
interface Acceleration {
readonly attribute DOMString frequency;
}
</pre>
<h2>说明:</h2>
<p class="des">
JSON对象,用于设置获取设备加速度信息的参数。
</p>
<h2>属性:</h2>
<ul><li>frequency: <em>(<font class="type">Number</font>
类型
)</em>更新加速度信息间隔时间<br><p>监听器获取加速度信息的时间间隔,单位为ms,默认值为500ms</p>
</li></ul>
<h1><a name="plus.accelerometer.AccelerometerSuccessCallback">AccelerometerSuccessCallback</a></h1>
<p>获取设备加速度信息成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( acceleration ) {
// Get acceleration code.
}
</pre>
<h2>参数:</h2>
<ul><li>acceleration:
<em>(
<a href="#plus.accelerometer.Acceleration">Acceleration</a>
)
必选 </em>设备的加速度信息<br>
Acceleration类型对象,用于获取各方向的详细加速度值。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.accelerometer.AccelerometerErrorCallback">AccelerometerErrorCallback</a></h1>
<p>获取设备加速度信息失败的回调函数</p>
<pre class="prettyprint linenums">
function void onAccelerometerError( Exception error ) {
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>获取加速度操作的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+101
View File
@@ -0,0 +1,101 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.android">android</a></h1>
<p>Native.js for Android封装一条通过JS语法直接调用Native Java接口通道,通过plus.android可调用几乎所有的系统API。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.android.importClass">importClass</a>: 导入Java类对象</li>
<li>
<a href="#plus.android.newObject">newObject</a>: 创建实例对象</li>
<li>
<a href="#plus.android.getAttribute">getAttribute</a>: 获取对象(类对象/实例对象)的属性值</li>
<li>
<a href="#plus.android.setAttribute">setAttribute</a>: 设置对象(类对象/实例对象)的属性值</li>
<li>
<a href="#plus.android.invoke">invoke</a>: 调用对象(类对象/实例对象)的方法</li>
<li>
<a href="#plus.android.implements">implements</a>: 实现Interface的方法</li>
<li>
<a href="#plus.android.runtimeMainActivity">runtimeMainActivity</a>: 获取应用主Activity实例对象</li>
<li>
<a href="#plus.android.currentWebview">currentWebview</a>: 获取当前Webview窗口对象的native层实例对象</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.android.ClassObject">ClassObject</a>: Java类对象</li>
<li>
<a href="#plus.android.InstanceObject">InstanceObject</a>: Java实例对象</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Invocation": {
"description": "Native.js"
}
}
}
</pre>
<h1><a name="plus.android.ClassObject">ClassObject</a></h1>
<p>Java类对象</p>
<pre class="prettyprint linenums">
interface ClassObject {
// ...
function Object plusGetAttribute( String name );
function Object plusSetAttribute( String name, Object value );
// ...
}
</pre>
<h2>说明:</h2>
<p class="des">
Java类对象,可通过其属性获取类的常量,可通过方法来操作类的静态变量和方法,也通过new方法来创建类的实例对象。
对于类的常量,则直接通过.后面跟随常量名称调用即可。
</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.android.ClassObject.plusGetAttribute">plusGetAttribute</a>: 获取Java类对象的静态属性</li>
<li>
<a href="#plus.android.ClassObject.plusSetAttribute">plusSetAttribute</a>: 设置Java类对象的静态属性</li>
</ul>
<h1><a name="plus.android.InstanceObject">InstanceObject</a></h1>
<p>Java实例对象</p>
<pre class="prettyprint linenums">
interface InstanceObject {
// ...
function Object plusGetAttribute( String name );
function Object plusSetAttribute( String name, Object value );
// ...
}
</pre>
<h2>说明:</h2>
<p class="des">
Java实例对象,可通过其方法来操作实例的变量和方法。
注意:必须通过plusGetAttribute()方法读取实例对象的属性值,通过plusSetAttribute()方法设置实例对象的属性值。
</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.android.InstanceObject.plusGetAttribute">plusGetAttribute</a>: 获取Java实例对象的属性</li>
<li>
<a href="#plus.android.InstanceObject.plusSetAttribute">plusSetAttribute</a>: 设置Java实例对象的属性</li>
</ul>
<br><br>
</div></body>
</html>
+196
View File
@@ -0,0 +1,196 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.audio">audio</a></h1>
<p>Audio模块用于提供音频的录制和播放功能,可调用系统的麦克风设备进行录音操作,也可调用系统的扬声器设备播放音频文件。通过plus.audio获取音频管理对象。</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.audio.ROUTE_SPEAKER">ROUTE_SPEAKER</a>: 设备的扬声器音频输出线路</li>
<li>
<a href="#plus.audio.ROUTE_EARPIECE">ROUTE_EARPIECE</a>: 设备听筒音频输出线路</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.audio.getRecorder">getRecorder</a>: 获取当前设备的录音对象</li>
<li>
<a href="#plus.audio.createPlayer">createPlayer</a>: 创建音频播放对象</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.audio.AudioRecorder">AudioRecorder</a>: 录音对象</li>
<li>
<a href="#plus.audio.AudioPlayer">AudioPlayer</a>: 音频播放对象</li>
<li>
<a href="#plus.audio.RecordOption">RecordOption</a>: JSON对象,调用麦克风设备进行录音的参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.audio.RecordSuccessCallback">RecordSuccessCallback</a>: 录音操作成功回调</li>
<li>
<a href="#plus.audio.PlaySuccessCallback">PlaySuccessCallback</a>: 播放音频文件操作成功回调</li>
<li>
<a href="#plus.audio.AudioErrorCallback">AudioErrorCallback</a>: 音频操作失败回调</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Audio": {
"description": "音频"
}
}
}
</pre>
<h1><a name="plus.audio.AudioRecorder">AudioRecorder</a></h1>
<p>录音对象</p>
<pre class="prettyprint linenums">
interface AudioRecorder {
readonly attribute String[] supportedSamplerates;
readonly attribute String[] supportedFormats;
function record( option, successCB, errorCB );
function stop();
}
</pre>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.audio.AudioRecorder.supportedSamplerates">supportedSamplerates</a>: 数组,设备录音支持的采用率</li>
<li>
<a href="#plus.audio.AudioRecorder.supportedFormats">supportedFormats</a>: 数组,设备录音支持的文件格式</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.audio.AudioRecorder.record">record</a>: 调用设备麦克风进行录音操作</li>
<li>
<a href="#plus.audio.AudioRecorder.stop">stop</a>: 结束录音操作</li>
</ul>
<h1><a name="plus.audio.AudioPlayer">AudioPlayer</a></h1>
<p>音频播放对象</p>
<pre class="prettyprint linenums">
interface AudioPlayer {
function void play( successCB, errorCB );
function void pause();
function void resume();
function void stop();
function void seekTo( position );
function Number getDuration();
function Number getPosition();
function void setRoute( route );
}
</pre>
<h2>说明:</h2>
<p class="des">
音频播放对象,用于音频文件的播放。不能通过new方法直接创建,只能通过audio.createPlayer方法创建。
</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.audio.AudioPlayer.play">play</a>: 开始播放音频</li>
<li>
<a href="#plus.audio.AudioPlayer.pause">pause</a>: 暂停播放音频</li>
<li>
<a href="#plus.audio.AudioPlayer.resume">resume</a>: 恢复播放音频</li>
<li>
<a href="#plus.audio.AudioPlayer.stop">stop</a>: 停止播放音频</li>
<li>
<a href="#plus.audio.AudioPlayer.seekTo">seekTo</a>: 跳到指定位置播放音频</li>
<li>
<a href="#plus.audio.AudioPlayer.getDuration">getDuration</a>: 获取音频流的总长度</li>
<li>
<a href="#plus.audio.AudioPlayer.getPosition">getPosition</a>: 获取音频流当前播放的位置</li>
<li>
<a href="#plus.audio.AudioPlayer.setRoute">setRoute</a>: 设置音频输出线路</li>
</ul>
<h1><a name="plus.audio.RecordOption">RecordOption</a></h1>
<p>JSON对象,调用麦克风设备进行录音的参数</p>
<h2>属性:</h2>
<ul>
<li>filename: <em>(<font class="type">String</font>
类型
)</em>保存录音文件的路径<br><p>
可设置具体文件名,也可只设置路径,如果以“/”结尾则表明是路径,文件名由录音程序自动生成。
如未设置则使用默认目录生成随机文件名称,默认目录为应用%APPID%下的documents目录。
</p>
</li>
<li>samplerate: <em>(<font class="type">String</font>
类型
)</em>录音文件的采样率<br><p>
需通过supportedSamplerates属性获取设备支持的采样率,若设置无效的值,则使用系统默认的采样率。</p>
</li>
<li>format: <em>(<font class="type">String</font>
类型
)</em>录音文件的格式<br><p>
需通过supportedFormats属性获取设备支持的录音格式,若设置无效的值,则使用系统默认的录音格式。
</p>
</li>
</ul>
<h1><a name="plus.audio.RecordSuccessCallback">RecordSuccessCallback</a></h1>
<p>录音操作成功回调</p>
<pre class="prettyprint linenums">
void onSuccess( recordFile ) {
// Get record file code.
}
</pre>
<h2>说明:</h2>
<p class="des">麦克风录音操作成功的回调函数,在录音操作完成调用stop()方法时调用。</p>
<h2>参数:</h2>
<ul><li>recordFile:
<em>(
<font class="type">String</font>
)
必选 </em>录音操作保存的音频文件路径<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.audio.PlaySuccessCallback">PlaySuccessCallback</a></h1>
<p>播放音频文件操作成功回调</p>
<pre class="prettyprint linenums">
void onCompleted() {
// Play audio file completed code.
}
</pre>
<h2>说明:</h2>
<p class="des">
音频播放操作成功的回调函数,在音频播放完成或调用stop()方法时触发。
</p>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.audio.AudioErrorCallback">AudioErrorCallback</a></h1>
<p>音频操作失败回调</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Handle audio error
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>音频操作的错误信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+252
View File
@@ -0,0 +1,252 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.barcode">barcode</a></h1>
<p>Barcode模块管理条码扫描,提供常见的条码(二维码及一维码)的扫描识别功能,可调用设备的摄像头对条码图片扫描进行数据输入。通过plus.barcode可获取条码码管理对象。</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.barcode.QR">QR</a>: 条码类型常量,QR二维码,数值为0</li>
<li>
<a href="#plus.barcode.EAN13">EAN13</a>: 条码类型常量,EAN一维条形码码标准版,数值为1</li>
<li>
<a href="#plus.barcode.EAN8">EAN8</a>: 条码类型常量,ENA一维条形码简版,数值为2</li>
<li>
<a href="#plus.barcode.AZTEC">AZTEC</a>: 条码类型常量,Aztec二维码,数值为3</li>
<li>
<a href="#plus.barcode.DATAMATRIX">DATAMATRIX</a>: 条码类型常量,Data Matrix二维码,数值为4</li>
<li>
<a href="#plus.barcode.UPCA">UPCA</a>: 条码类型常量,UPC码标准版,数值为5</li>
<li>
<a href="#plus.barcode.UPCE">UPCE</a>: 条码类型常量,UPC码缩短版,数值为6</li>
<li>
<a href="#plus.barcode.CODABAR">CODABAR</a>: 条码类型常量,Codabar码,数值为7</li>
<li>
<a href="#plus.barcode.CODE39">CODE39</a>: 条码类型常量,Code39一维条形码,数值为8</li>
<li>
<a href="#plus.barcode.CODE93">CODE93</a>: 条码类型常量,Code93码,数值为9</li>
<li>
<a href="#plus.barcode.CODE128">CODE128</a>: 条码类型常量,Code128码,数值为10</li>
<li>
<a href="#plus.barcode.ITF">ITF</a>: 条码类型常量,ITF码,数值为11</li>
<li>
<a href="#plus.barcode.MAXICODE">MAXICODE</a>: 条码类型常量,MaxiCode二维码,数值为12</li>
<li>
<a href="#plus.barcode.PDF417">PDF417</a>: 条码类型常量,PDF 417码,数值为13</li>
<li>
<a href="#plus.barcode.RSS14">RSS14</a>: 条码类型常量,RSS 14组合码,数值为14</li>
<li>
<a href="#plus.barcode.RSSEXPANDED">RSSEXPANDED</a>: 条码类型常量,扩展式RSS组合码,数值为15</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.barcode.scan">scan</a>: 通过图片扫描条码数据</li></ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.barcode.Barcode">Barcode</a>: 条码扫描识别控件对象</li>
<li>
<a href="#plus.barcode.BarcodeStyles">BarcodeStyles</a>: 条码扫描控件样式参数</li>
<li>
<a href="#plus.barcode.BarcodeOptions">BarcodeOptions</a>: 条码识别控件扫描参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.barcode.BarcodeSuccessCallback">BarcodeSuccessCallback</a>: 条码识别成功的回调函数</li>
<li>
<a href="#plus.barcode.BarcodeErrorCallback">BarcodeErrorCallback</a>: 条码识别错误的回调函数</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Barcode": {
"description": "二维码"
}
}
}
</pre>
<h1><a name="plus.barcode.Barcode">Barcode</a></h1>
<p>条码扫描识别控件对象</p>
<pre class="prettyprint linenums">
interface plus.barcode.Barcode {
// Methods
function void start( options );
function void cancel();
function void close();
function void setFlash( open );
// Events
function void onmarked();
function void onerror();
}
</pre>
<h2>说明:</h2>
<p class="des">
Barcode对象表示条码识别控件对象,在窗口中显示条码识别控件,使用此对象可自定义条码识别界面。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.barcode.Barcode.Barcode.constructor(id,filters,styles)">Barcode.constructor(id,filters,styles)</a>: 创建Barcode对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.barcode.Barcode.start">start</a>: 开始条码识别</li>
<li>
<a href="#plus.barcode.Barcode.cancel">cancel</a>: 结束条码识别</li>
<li>
<a href="#plus.barcode.Barcode.close">close</a>: 关闭条码识别控件</li>
<li>
<a href="#plus.barcode.Barcode.setFlash">setFlash</a>: 是否开启闪光灯</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.barcode.Barcode.onmarked">onmarked</a>: 条码识别成功事件</li>
<li>
<a href="#plus.barcode.Barcode.onerror">onerror</a>: 条码识别错误事件</li>
</ul>
<h1><a name="plus.barcode.BarcodeStyles">BarcodeStyles</a></h1>
<p>条码扫描控件样式参数</p>
<pre class="prettyprint linenums">
interface plus.barcode.BarcodeStyles {
attribute String frameColor;
attribute String scanbarColor;
attribute String background;
}
</pre>
<h2>说明:</h2>
<p class="des">
设置条码识别控件的样式,如扫描框、扫描条的颜色等。
</p>
<h2>属性:</h2>
<ul>
<li>frameColor: <em>(<font class="type">String</font>
类型
)</em>扫描框颜色<br><p>
颜色值支持(参考CSS颜色规范):颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值,默认值为红色。
</p>
</li>
<li>scanbarColor: <em>(<font class="type">String</font>
类型
)</em>扫描条颜色<br><p>
颜色值支持(参考CSS颜色规范):颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值,默认值为红色。
</p>
</li>
<li>background: <em>(<font class="type">String</font>
类型
)</em>条码识别控件背景颜色<br><p>
颜色值支持(参考CSS颜色规范):颜色名称(参考CSS Color Names)/十六进制值/rgb值,默认值为红色。
</p>
</li>
</ul>
<h1><a name="plus.barcode.BarcodeOptions">BarcodeOptions</a></h1>
<p>条码识别控件扫描参数</p>
<pre class="prettyprint linenums">
interface plus.barcode.BarcodeOptions {
attribute Boolean conserve;
attribute String filename;
attribute Boolean vibrate;
attribute String sound;
}
</pre>
<h2>说明:</h2>
<p class="des">
设置条码识别控件扫描条码的参数,如是否保存扫描成功时的截图等。
</p>
<h2>属性:</h2>
<ul>
<li>conserve: <em>(<font class="type">Boolean</font>
类型
)</em>是否保存成功扫描到的条码数据时的截图<br><p>
如果设置为true则在成功扫描到条码数据时将图片保存,并通过onmarked回调函数的file参数返回保存文件的路径。默认值为false,不保存图片。
</p>
</li>
<li>filename: <em>(<font class="type">String</font>
类型
)</em>保存成功扫描到的条码数据时的图片路径<br><p>
可通过此参数设置保存截图的路径或名称,如果设置图片文件名称则必须指定文件的后缀名(必须是.png),否则认为是指定目录,文件名称则自动生成。
</p>
</li>
<li>vibrate: <em>(<font class="type">Boolean</font>
类型
)</em>成功扫描到条码数据时是否需要震动提醒<br><p>
如果设置为true则在成功扫描到条码数据时震动设备,false则不震动。默认值为true。
</p>
</li>
<li>sound: <em>(<font class="type">String</font>
类型
)</em>成功扫描到条码数据时播放的提示音类型<br><p>
可取值:
"none" - 不播放提示音;
"default" - 播放默认提示音(5+引擎内置)。
默认值为"default"。
</p>
</li>
</ul>
<h1><a name="plus.barcode.BarcodeSuccessCallback">BarcodeSuccessCallback</a></h1>
<p>条码识别成功的回调函数</p>
<pre class="prettyprint linenums">
void BarcodeSuccessCallback ( type, code, file ) {
// Barcode success code
}
</pre>
<h2>说明:</h2>
<p class="des">当获取条码识别成功时的回调函数,用于返回识别成功的条码数据。</p>
<h2>参数:</h2>
<ul>
<li>type:
<em>(
<font class="type">Number</font>
)
必选 </em>识别到的条码类型<br>Number类型的值,与Barcode对象定义的条码类型常量一致。</li>
<li>code:
<em>(
<font class="type">String</font>
)
必选 </em>识别到的条码数据<br>从条码图片中扫描出的数据内容,字符串采用UTF8编码格式。</li>
<li>file:
<em>(
<font class="type">String</font>
)
可选 </em>识别到的条码图片文件路径<br>识别到的条码数据图片,为png格式文件,为设置为不保存图片,则返回undefined。</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.barcode.BarcodeErrorCallback">BarcodeErrorCallback</a></h1>
<p>条码识别错误的回调函数</p>
<pre class="prettyprint linenums">
void BarcodeErrorCallback(error){
// Error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>条码识别的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+78
View File
@@ -0,0 +1,78 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.cache">cache</a></h1>
<p>Cache模块用于管理应用缓存,通过plus.cache获取缓存管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.cache.clear">clear</a>: 清除应用的缓存数据</li>
<li>
<a href="#plus.cache.calculate">calculate</a>: 计算应用已使用的缓存数据大小</li>
<li>
<a href="#plus.cache.setMaxSize">setMaxSize</a>: 设置应用的可使用的最大缓存大小</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.cache.CacheClearCallback">CacheClearCallback</a>: 清除应用缓存完成回调</li>
<li>
<a href="#plus.cache.CacheCalculateCallback">CacheCalculateCallback</a>: 计算应用使用缓存容量回调</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Cache": {
"description": "应用缓存"
}
}
}
</pre>
<h1><a name="plus.cache.CacheClearCallback">CacheClearCallback</a></h1>
<p>清除应用缓存完成回调</p>
<pre class="prettyprint linenums">
void onCompleted() {
// Clear cache completed code.
}
</pre>
<h2>说明:</h2>
<p class="des">清除应用缓存回调函数,调用plus.cache.clear清除缓存操作时作为参数传入,在清除缓存操作完成时触发回调。</p>
<h2>参数:</h2>
<ul></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.cache.CacheCalculateCallback">CacheCalculateCallback</a></h1>
<p>计算应用使用缓存容量回调</p>
<pre class="prettyprint linenums">
void onCompleted( size ) {
// Calculate cache complete code.
}
</pre>
<h2>说明:</h2>
<p class="des">计算应用当前使用缓存容量回调函数,调用plus.cache.calculate计算缓存容量操作时作为参数传入,在计算缓存容量大小完成时触发回调。</p>
<h2>参数:</h2>
<ul><li>size:
<em>(
<font class="type">Number</font>
)
必选 </em>应用当前使用缓存的大小,单位为byte<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+183
View File
@@ -0,0 +1,183 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.camera">camera</a></h1>
<p>Camera模块管理设备的摄像头,可用于拍照、摄像操作,通过plus.camera获取摄像头管理对象。</p>
<h2>方法:</h2>
<ul><li>
<a href="#plus.camera.getCamera">getCamera</a>: 获取摄像头管理对象</li></ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.camera.Camera">Camera</a>: 摄像头对象</li>
<li>
<a href="#plus.camera.CameraOption">CameraOption</a>: JSON对象,调用摄像头的参数</li>
<li>
<a href="#plus.camera.PopPosition">PopPosition</a>: JSON对象,弹出拍照或摄像界面指示位置</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.camera.CameraSuccessCallback">CameraSuccessCallback</a>: 调用摄像头操作成功回调</li>
<li>
<a href="#plus.camera.CameraErrorCallback">CameraErrorCallback</a>: 摄像头操作失败回调</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Camera": {
"description": "摄像头"
}
}
}
</pre>
<h1><a name="plus.camera.Camera">Camera</a></h1>
<p>摄像头对象</p>
<pre class="prettyprint linenums">
interface Camera {
readonly attribute String[] supportedImageResolutions;
readonly attribute String[] supportedVideoResolutions;
readonly attribute String[] supportedImageFormats;
readonly attribute String[] supportedVideoFormats;
function void captureImage( successCB, errorCB, option );
function void startVideoCapture( successCB, errorCB, option );
function void stopVideoCapture();
}
</pre>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.camera.Camera.supportedImageResolutions">supportedImageResolutions</a>: 字符串数组,摄像头支持的拍照分辨率</li>
<li>
<a href="#plus.camera.Camera.supportedVideoResolutions">supportedVideoResolutions</a>: 字符串数组,摄像头支持的摄像分辨率</li>
<li>
<a href="#plus.camera.Camera.supportedImageFormats">supportedImageFormats</a>: 字符串数组,摄像头支持的拍照文件格式</li>
<li>
<a href="#plus.camera.Camera.supportedVideoFormats">supportedVideoFormats</a>: 字符串数组,摄像头支持的摄像文件格式</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.camera.Camera.captureImage">captureImage</a>: 进行拍照操作</li>
<li>
<a href="#plus.camera.Camera.startVideoCapture">startVideoCapture</a>: 调用摄像头进行摄像操作</li>
<li>
<a href="#plus.camera.Camera.stopVideoCapture">stopVideoCapture</a>: 结束摄像操作</li>
</ul>
<h1><a name="plus.camera.CameraOption">CameraOption</a></h1>
<p>JSON对象,调用摄像头的参数</p>
<pre class="prettyprint linenums">
interface CameraOption {
attribute String filename;
attribute String format;
attribute String index;
attribute PopPosition popover;
}
</pre>
<h2>属性:</h2>
<ul>
<li>filename: <em>(<font class="type">String</font>
类型
)</em>拍照或摄像文件保存的路径<br><p>
可设置具体文件名(如"_doc/camera/a.jpg");也可只设置路径,以"/"结尾则表明是路径(如"_doc/camera/")。如未设置文件名称或设置的文件名冲突则文件名由程序程序自动生成。
</p>
</li>
<li>format: <em>(<font class="type">String</font>
类型
)</em>拍照或摄像的文件格式<br><p>
可通过Camera对象的supportedImageFormats或supportedVideoFormats获取,如果设置的参数无效则使用系统默认值。
</p>
</li>
<li>index: <em>(<font class="type">String</font>
类型
)</em>拍照或摄像默认使用的摄像头<br><p>
拍照或摄像界面默认使用的摄像头编号,1表示主摄像头,2表示辅摄像头。
</p>
</li>
<li>popover: <em>(<a href="#plus.camera.PopPosition">PopPosition</a>
类型
)</em>拍照或摄像界面弹出指示区域<br><p>
对于大屏幕设备如iPad,拍照或摄像界面为弹出窗口,此时可通过此参数设置弹出窗口位置,其为JSON对象,格式如{top:"10px",left:"10px",width:"200px",height:"200px"},默认弹出位置为屏幕居中。
</p>
</li>
</ul>
<h1><a name="plus.camera.PopPosition">PopPosition</a></h1>
<p>JSON对象,弹出拍照或摄像界面指示位置</p>
<h2>属性:</h2>
<ul>
<li>top: <em>(<font class="type">String</font>
类型
)</em>指示区域距离容器顶部的距离<br><p>
弹出拍照或摄像窗口指示区域距离容器顶部的距离,支持像素值(如"100px")和百分比(如"50%")。</p>
</li>
<li>left: <em>(<font class="type">String</font>
类型
)</em>指示区域距离容器左侧的距离<br><p>
弹出拍照或摄像窗口指示区域距离容器左侧的距离,支持像素值(如"100px")和百分比(如"50%")。</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>指示区域的宽度<br><p>
弹出拍照或摄像窗口指示区域的宽度,支持像素值(如"100px")和百分比(如"50%")。</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>指示区域的高度<br><p>
弹出拍照或摄像窗口指示区域的高度,支持像素值(如"100px")和百分比(如"50%")。</p>
</li>
</ul>
<h1><a name="plus.camera.CameraSuccessCallback">CameraSuccessCallback</a></h1>
<p>调用摄像头操作成功回调</p>
<pre class="prettyprint linenums">
void onSuccess( capturedFile ) {
// Caputre image/video file code.
}
</pre>
<h2>说明:</h2>
<p class="des">调用摄像头操作成功的回调函数,在拍照或摄像操作成功时调用,用于返回图片或视频文件的路径。</p>
<h2>参数:</h2>
<ul><li>capturedFile:
<em>(
<font class="type">String</font>
)
必选 </em>拍照或摄像操作保存的文件路径<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.camera.CameraErrorCallback">CameraErrorCallback</a></h1>
<p>摄像头操作失败回调</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Handle camera error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>摄像头操作的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+44
View File
@@ -0,0 +1,44 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.console">console</a></h1>
<p>Console模块用于跟踪调试的API,可根据调试需求输出日志,协助开发人员定位业务逻辑问题。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.console.log">log</a>: 记录用户日志</li>
<li>
<a href="#plus.console.info">info</a>: 记录用户提示信息</li>
<li>
<a href="#plus.console.warn">warn</a>: 记录用户警告信息</li>
<li>
<a href="#plus.console.error">error</a>: 记录用户错误信息</li>
<li>
<a href="#plus.console.assert">assert</a>: 断言操作</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Console": {
"description": "日志,跟踪调试输出日志信息"
}
}
}
</pre>
<br><br>
</div></body>
</html>
+407
View File
@@ -0,0 +1,407 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.contacts">contacts</a></h1>
<p>Contacts模块管理系统通讯录,用于可对系统通讯录进行增、删、改、查等操作。通过plus.contacts获取系统通讯录管理对象。</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.contacts.ADDRESSBOOK_PHONE">ADDRESSBOOK_PHONE</a>: 手机通讯录</li>
<li>
<a href="#plus.contacts.ADDRESSBOOK_SIM">ADDRESSBOOK_SIM</a>: SIM卡通讯录</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.contacts.getAddressBook">getAddressBook</a>: 获取通讯录对象</li></ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.contacts.AddressBook">AddressBook</a>: 通讯录对象</li>
<li>
<a href="#plus.contacts.Contact">Contact</a>: 联系人对象</li>
<li>
<a href="#plus.contacts.ContactField">ContactField</a>: JSON对象,联系人域数据对象</li>
<li>
<a href="#plus.contacts.ContactName">ContactName</a>: JSON对象,联系人名称对象</li>
<li>
<a href="#plus.contacts.ContactAddress">ContactAddress</a>: JSON对象,联系人地址对象</li>
<li>
<a href="#plus.contacts.ContactOrganization">ContactOrganization</a>: JSON对象,联系人所属组织信息</li>
<li>
<a href="#plus.contacts.ContactFindOption">ContactFindOption</a>: JSON对象,查找联系人参数</li>
<li>
<a href="#plus.contacts.ContactFindFilter">ContactFindFilter</a>: JSON对象,联系人查找过滤器</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.contacts.AddressBookSuccessCallback">AddressBookSuccessCallback</a>: 获取通讯录操作成功回调函数</li>
<li>
<a href="#plus.contacts.FindSuccessCallback">FindSuccessCallback</a>: 查找联系人操作成功回调函数</li>
<li>
<a href="#plus.contacts.ContactsSuccessCallback">ContactsSuccessCallback</a>: 联系人操作成功回调函数</li>
<li>
<a href="#plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a>: 联系人操作失败回调</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Contacts": {
"description": "通讯录,访问系统联系人"
}
}
}
</pre>
<h1><a name="plus.contacts.AddressBook">AddressBook</a></h1>
<p>通讯录对象</p>
<pre class="prettyprint linenums">
interface AddressBook {
function Contact create();
function void find( contactFields, successCB, errorCB, findOptions );
}
</pre>
<h2>说明:</h2>
<p class="des">通讯录管理对象,可对系统通讯录进行联系人的增、删、改、查操作。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.contacts.AddressBook.create">create</a>: 创建联系人</li>
<li>
<a href="#plus.contacts.AddressBook.find">find</a>: 在通讯录中查找联系人</li>
</ul>
<h1><a name="plus.contacts.Contact">Contact</a></h1>
<p>联系人对象</p>
<pre class="prettyprint linenums">
interface Contact {
readonly attribute String id;
attribute String displayName;
attribute ContactName name;
attribute String nickname;
attribute ContackField[] phoneNumbers;
attribute ContactField[] emails;
attribute ContactAddress[] addresses;
attribute ContactField[] ims;
attribute ContactOriganization[] organizations;
attribute Date birthday;
attribute String note;
attribute ContactField[] photos;
attribute ContactField[] categories;
attribute ContactField[] urls;
function Contact clone();
function void remove( successCB, errorCB );
function void save( successCB, errorCB );
}
</pre>
<h2>说明:</h2>
<p class="des">联系人对象,包括联系人的各种信息,如名称、电话号码、地址等。也包括新增、删除联系人的操作方法。</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.contacts.Contact.id">id</a>: 联系人的id</li>
<li>
<a href="#plus.contacts.Contact.displayName">displayName</a>: 联系人显示的名字</li>
<li>
<a href="#plus.contacts.Contact.name">name</a>: 联系人的名称</li>
<li>
<a href="#plus.contacts.Contact.nickname">nickname</a>: 联系人的昵称</li>
<li>
<a href="#plus.contacts.Contact.phoneNumbers">phoneNumbers</a>: 数组,联系人的电话</li>
<li>
<a href="#plus.contacts.Contact.emails">emails</a>: 数组,联系人的邮箱</li>
<li>
<a href="#plus.contacts.Contact.addresses">addresses</a>: 数组,联系人的地址</li>
<li>
<a href="#plus.contacts.Contact.ims">ims</a>: 数组,联系人的即时通讯地址</li>
<li>
<a href="#plus.contacts.Contact.organizations">organizations</a>: 数组,联系人所属组织信息</li>
<li>
<a href="#plus.contacts.Contact.birthday">birthday</a>: 联系人的生日</li>
<li>
<a href="#plus.contacts.Contact.note">note</a>: 联系人的备注</li>
<li>
<a href="#plus.contacts.Contact.photos">photos</a>: 数组,联系人的头像</li>
<li>
<a href="#plus.contacts.Contact.categories">categories</a>: 数组,联系人的组名</li>
<li>
<a href="#plus.contacts.Contact.urls">urls</a>: 数组,联系人的网址</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.contacts.Contact.clone">clone</a>: 克隆联系人</li>
<li>
<a href="#plus.contacts.Contact.remove">remove</a>: 删除联系人</li>
<li>
<a href="#plus.contacts.Contact.save">save</a>: 保存联系人</li>
</ul>
<h1><a name="plus.contacts.ContactField">ContactField</a></h1>
<p>JSON对象,联系人域数据对象</p>
<pre class="prettyprint linenums">
interface ContactField {
attribute String type;
attribute String value;
attribute Boolean preferred;
}
</pre>
<h2>说明:</h2>
<p class="des">联系人域数据对象,保存联系人特定域信息。</p>
<h2>属性:</h2>
<ul>
<li>type: <em>(<font class="type">String</font>
类型
)</em>联系人域类型,如电话号码中的“mobile”、“home”、“company”<br>
</li>
<li>value: <em>(<font class="type">String</font>
类型
)</em>联系人域值<br>
</li>
<li>preferred: <em>(<font class="type">Boolean</font>
类型
)</em>是否为首选项<br>
</li>
</ul>
<h1><a name="plus.contacts.ContactName">ContactName</a></h1>
<p>JSON对象,联系人名称对象</p>
<pre class="prettyprint linenums">
interface ContactName {
attribute String formatted;
attribute String familyName;
attribute String givenName;
attribute String middleName;
attribute String honorificPrefix;
attribute String honorificSuffix;
}
</pre>
<h2>说明:</h2>
<p class="des">联系人名称对象,保存联系人名称信息,如姓、名等。</p>
<h2>属性:</h2>
<ul>
<li>formatted: <em>(<font class="type">String</font>
类型
)</em>联系人的完整名称,由其它字段组合生成<br>
</li>
<li>familyName: <em>(<font class="type">String</font>
类型
)</em>联系人的姓<br>
</li>
<li>givenName: <em>(<font class="type">String</font>
类型
)</em>联系人的名<br>
</li>
<li>middleName: <em>(<font class="type">String</font>
类型
)</em>联系人的中间名<br>
</li>
<li>honorificPrefix: <em>(<font class="type">String</font>
类型
)</em>联系人的前缀(如Mr.或Dr.)<br>
</li>
<li>honorificSuffix: <em>(<font class="type">String</font>
类型
)</em>联系人的后缀<br>
</li>
</ul>
<h1><a name="plus.contacts.ContactAddress">ContactAddress</a></h1>
<p>JSON对象,联系人地址对象</p>
<pre class="prettyprint linenums">
interface ContactAddress {
attribute String type;
attribute String formatted;
attribute String streetAddress;
attribute String locality;
attribute String region;
attribute String country;
attribute String postalCode;
attribute Boolean preferred;
}
</pre>
<h2>说明:</h2>
<p class="des">联系人地址对象,保存联系人地址信息,如国家、省份、城市等。</p>
<h2>属性:</h2>
<ul>
<li>type: <em>(<font class="type">String</font>
类型
)</em>联系人地址类型,如“home”表示家庭地址、“company”表示单位地址<br>
</li>
<li>formatted: <em>(<font class="type">String</font>
类型
)</em>完整地址,由其它字段组合而成<br>
</li>
<li>streetAddress: <em>(<font class="type">String</font>
类型
)</em>完整的街道地址<br>
</li>
<li>locality: <em>(<font class="type">String</font>
类型
)</em>城市或地区<br>
</li>
<li>region: <em>(<font class="type">String</font>
类型
)</em>省或地区<br>
</li>
<li>country: <em>(<font class="type">String</font>
类型
)</em>国家<br>
</li>
<li>postalCode: <em>(<font class="type">String</font>
类型
)</em>邮政编码<br>
</li>
<li>preferred: <em>(<font class="type">Boolean</font>
类型
)</em>是否为首选项<br>
</li>
</ul>
<h1><a name="plus.contacts.ContactOrganization">ContactOrganization</a></h1>
<p>JSON对象,联系人所属组织信息</p>
<pre class="prettyprint linenums">
interface ContactOrganization {
attribute String type;
attribute String name;
attribute String department;
attribute String title;
attribute Boolean preferred;
}
</pre>
<h2>属性:</h2>
<ul>
<li>type: <em>(<font class="type">String</font>
类型
)</em>联系人所属组织类型,如"company"<br>
</li>
<li>name: <em>(<font class="type">String</font>
类型
)</em> 联系人所属组织名称<br>
</li>
<li>department: <em>(<font class="type">String</font>
类型
)</em>联系人所属组织部门<br>
</li>
<li>title: <em>(<font class="type">String</font>
类型
)</em>联系人在组织中的职位<br>
</li>
<li>preferred: <em>(<font class="type">Boolean</font>
类型
)</em>是否为首选项<br>
</li>
</ul>
<h1><a name="plus.contacts.ContactFindOption">ContactFindOption</a></h1>
<p>JSON对象,查找联系人参数</p>
<pre class="prettyprint linenums">
interface ContactFindOption {
attribute ContactFindFilte[] filter;
attribute Boolean multiple;
}
</pre>
<h2>属性:</h2>
<ul>
<li>filter: <em>(<a href="#plus.contacts.ContactFindFilter">ContactFindFilter</a>
类型
)</em>数组,查找时的过滤器<br><p>可设置为空,表示不过滤。</p>
</li>
<li>multiple: <em>(<font class="type">Boolean</font>
类型
)</em>是否查找多个联系人,默认值为true<br>
</li>
</ul>
<h1><a name="plus.contacts.ContactFindFilter">ContactFindFilter</a></h1>
<p>JSON对象,联系人查找过滤器</p>
<pre class="prettyprint linenums">
interface ContactFindFilter {
attribute String logic;
attribute String field;
attribute String value;
}
</pre>
<h2>属性:</h2>
<ul>
<li>logic: <em>(<font class="type">String</font>
类型
)</em>区配的逻辑<br><p>可取“and”、“or”、“not”,默认值为“and”。</p>
</li>
<li>field: <em>(<font class="type">String</font>
类型
)</em>区配的联系人域,可取联系人的属性名称<br>
</li>
<li>value: <em>(<font class="type">String</font>
类型
)</em>区配的联系人值,可使用区配符号“?”和“*”<br>
</li>
</ul>
<h1><a name="plus.contacts.AddressBookSuccessCallback">AddressBookSuccessCallback</a></h1>
<p>获取通讯录操作成功回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( addressbook ){
// Code AddressBook here
}
</pre>
<h2>参数:</h2>
<ul><li>addressbook:
<em>(
<a href="#plus.contacts.AddressBook">AddressBook</a>
)
必选 </em>获取到的通讯录对象<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.contacts.FindSuccessCallback">FindSuccessCallback</a></h1>
<p>查找联系人操作成功回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( contacts ){
// Find contact success.
}
</pre>
<h2>参数:</h2>
<ul><li>contacts:
<em>(
<a href="#plus.contacts.Contact">Contact</a>
)
必选 </em>数组,查找到的联系人对象<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.contacts.ContactsSuccessCallback">ContactsSuccessCallback</a></h1>
<p>联系人操作成功回调函数</p>
<pre class="prettyprint linenums">
void onSuccess(){
// Operate success
}
</pre>
<h2>参数:</h2>
<ul></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a></h1>
<p>联系人操作失败回调</p>
<pre class="prettyprint linenums">
void onError( error ){
// Handle the error
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>联系人操作的错误信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+142
View File
@@ -0,0 +1,142 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.device">device</a></h1>
<p>Device模块管理设备信息,用于获取手机设备的相关信息,如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.device.imei">imei</a>: 设备的国际移动设备身份码</li>
<li>
<a href="#plus.device.imsi">imsi</a>: 设备的国际移动用户识别码</li>
<li>
<a href="#plus.device.model">model</a>: 设备的型号</li>
<li>
<a href="#plus.device.vendor">vendor</a>: 设备的生产厂商</li>
<li>
<a href="#plus.device.uuid">uuid</a>: 设备的唯一标识</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.device.dial">dial</a>: 拨打电话</li>
<li>
<a href="#plus.device.beep">beep</a>: 发出蜂鸣声</li>
<li>
<a href="#plus.device.vibrate">vibrate</a>: 设备振动</li>
<li>
<a href="#plus.device.setWakelock">setWakelock</a>: 设置应用是否保持唤醒(屏幕常亮)状态</li>
<li>
<a href="#plus.device.isWakelock">isWakelock</a>: 获取程序是否一直保持唤醒(屏幕常亮)状态</li>
<li>
<a href="#plus.device.setVolume">setVolume</a>: 设置设备的系统音量</li>
<li>
<a href="#plus.device.getVolume">getVolume</a>: 获取设备的系统音量</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.screen">screen</a>: Screen模块管理设备屏幕信息</li>
<li>
<a href="#plus.display">display</a>: Display模块管理应用可使用的显示区域信息</li>
<li>
<a href="#plus.networkinfo">networkinfo</a>: Device模块用于获取网络信息</li>
<li>
<a href="#plus.os">os</a>: OS模块管理操作系统信息</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Device": {
"description": "设备信息"
}
}
}
</pre>
<h1><a name="plus.screen">screen</a></h1>
<p>Screen模块管理设备屏幕信息</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.screen.resolutionHeight">resolutionHeight</a>: 设备屏幕高度分辨率</li>
<li>
<a href="#plus.screen.resolutionWidth">resolutionWidth</a>: 设备屏幕宽度分辨率</li>
<li>
<a href="#plus.screen.scale">scale</a>: 逻辑分辨率与实际分辨率的比例</li>
<li>
<a href="#plus.screen.dpiX">dpiX</a>: 设备屏幕水平方向的密度</li>
<li>
<a href="#plus.screen.dpiY">dpiY</a>: 设备屏幕垂直方向的密度</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.screen.setBrightness">setBrightness</a>: 设置屏幕亮度</li>
<li>
<a href="#plus.screen.getBrightness">getBrightness</a>: 获取屏幕亮度值</li>
<li>
<a href="#plus.screen.lockOrientation">lockOrientation</a>: 锁定屏幕方向</li>
<li>
<a href="#plus.screen.unlockOrientation">unlockOrientation</a>: 解除锁定屏幕方向</li>
</ul>
<h1><a name="plus.display">display</a></h1>
<p>Display模块管理应用可使用的显示区域信息</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.display.resolutionHeight">resolutionHeight</a>: 应用可使用的屏幕高度逻辑分辨率</li>
<li>
<a href="#plus.display.resolutionWidth">resolutionWidth</a>: 应用可使用的屏幕宽度逻辑分辨率</li>
</ul>
<h1><a name="plus.networkinfo">networkinfo</a></h1>
<p>Device模块用于获取网络信息</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.networkinfo.CONNECTION_UNKNOW">CONNECTION_UNKNOW</a>: 网络连接状态未知</li>
<li>
<a href="#plus.networkinfo.CONNECTION_NONE">CONNECTION_NONE</a>: 未连接网络</li>
<li>
<a href="#plus.networkinfo.CONNECTION_ETHERNET">CONNECTION_ETHERNET</a>: 有线网络</li>
<li>
<a href="#plus.networkinfo.CONNECTION_WIFI">CONNECTION_WIFI</a>: 无线WIFI网络</li>
<li>
<a href="#plus.networkinfo.CONNECTION_CELL2G">CONNECTION_CELL2G</a>: 蜂窝移动2G网络</li>
<li>
<a href="#plus.networkinfo.CONNECTION_CELL3G">CONNECTION_CELL3G</a>: 蜂窝移动3G网络</li>
<li>
<a href="#plus.networkinfo.CONNECTION_CELL4G">CONNECTION_CELL4G</a>: 蜂窝移动4G网络</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.networkinfo.getCurrentType">getCurrentType</a>: 获取设备当前连接的网络类型</li></ul>
<h1><a name="plus.os">os</a></h1>
<p>OS模块管理操作系统信息</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.os.language">language</a>: 系统语言信息</li>
<li>
<a href="#plus.os.version">version</a>: 系统版本信息</li>
<li>
<a href="#plus.os.name">name</a>: 系统的名称</li>
<li>
<a href="#plus.os.vendor">vendor</a>: 系统的供应商信息</li>
</ul>
<br><br>
</div></body>
</html>
+310
View File
@@ -0,0 +1,310 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.downloader">downloader</a></h1>
<p>Downloader模块管理网络文件下载任务,用于从服务器下载各种文件,并支持跨域访问操作。通过plus.downloader获取下载管理对象。Downloader下载使用HTTP的GET/POST方式请求下载文件,符合标准HTTP/HTTPS传输协议。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.downloader.createDownload">createDownload</a>: 新建下载任务</li>
<li>
<a href="#plus.downloader.enumerate">enumerate</a>: 枚举下载任务</li>
<li>
<a href="#plus.downloader.clear">clear</a>: 清除下载任务</li>
<li>
<a href="#plus.downloader.startAll">startAll</a>: 开始所有下载任务</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.downloader.Download">Download</a>: Download对象管理一个下载任务</li>
<li>
<a href="#plus.downloader.DownloadEvent">DownloadEvent</a>: 下载任务事件类型</li>
<li>
<a href="#plus.downloader.DownloadState">DownloadState</a>: 下载任务状态</li>
<li>
<a href="#plus.downloader.DownloadOptions">DownloadOptions</a>: 下载任务参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.downloader.DownloadCompletedCallback">DownloadCompletedCallback</a>: 下载任务完成时的回调</li>
<li>
<a href="#plus.downloader.DownloadStateChangedCallback">DownloadStateChangedCallback</a>: 下载任务状态变化回调</li>
<li>
<a href="#plus.downloader.DownloadEnumerateCallback">DownloadEnumerateCallback</a>: 枚举下载任务回调</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Downloader": {
"description": "文件下载,管理文件下载任务"
}
}
}
</pre>
<h1><a name="plus.downloader.Download">Download</a></h1>
<p>Download对象管理一个下载任务</p>
<pre class="prettyprint linenums">
interface Download {
readonly attribute String id;
readonly attribute String url;
readonly attribute Number state;
readonly attribute DownloadOptions options;
readonly attribute String filename;
readonly attribute Number downloadedSize;
readonly attribute Number totalSize;
function void abort();
function void addEventListener( String event, function Callback listener, Boolean capture );
function String getAllResponseHeaders();
function String getResponseHeader( headerName );
function void pause();
function void resume();
function void setRequestHeader( String headerName, String headerValue );
function void start();
}
</pre>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.downloader.Download.id">id</a>: 下载任务的标识</li>
<li>
<a href="#plus.downloader.Download.url">url</a>: 下载文件的地址</li>
<li>
<a href="#plus.downloader.Download.state">state</a>: 任务的状态</li>
<li>
<a href="#plus.downloader.Download.options">options</a>: 下载任务的参数</li>
<li>
<a href="#plus.downloader.Download.filename">filename</a>: 下载的文件名称</li>
<li>
<a href="#plus.downloader.Download.downloadedSize">downloadedSize</a>: 已完成下载文件的大小</li>
<li>
<a href="#plus.downloader.Download.totalSize">totalSize</a>: 下载任务文件的总大小</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.downloader.Download.abort">abort</a>: 取消下载任务</li>
<li>
<a href="#plus.downloader.Download.addEventListener">addEventListener</a>: 添加下载任务事件监听器</li>
<li>
<a href="#plus.downloader.Download.getAllResponseHeaders">getAllResponseHeaders</a>: 获取下载请求HTTP响应头部信息</li>
<li>
<a href="#plus.downloader.Download.getResponseHeader">getResponseHeader</a>: 获取下载请求指定的HTTP响应头部的值</li>
<li>
<a href="#plus.downloader.Download.pause">pause</a>: 暂停下载任务</li>
<li>
<a href="#plus.downloader.Download.resume">resume</a>: 恢复暂停的下载任务</li>
<li>
<a href="#plus.downloader.Download.setRequestHeader">setRequestHeader</a>: 设置下载请求的HTTP头数据</li>
<li>
<a href="#plus.downloader.Download.start">start</a>: 开始下载任务</li>
</ul>
<h1><a name="plus.downloader.DownloadEvent">DownloadEvent</a></h1>
<p>下载任务事件类型</p>
<h2>常量:</h2>
<ul><li>"statechanged": <em>(<font class="type">String</font>
类型
)</em>下载任务状态变化事件<br><p>
当下载任务状态发生变化时触发此事件,事件原型参考DownloadStateChangedCallback。
</p>
</li></ul>
<h1><a name="plus.downloader.DownloadState">DownloadState</a></h1>
<p>下载任务状态</p>
<h2>常量:</h2>
<ul>
<li>undefined: <em>(<font class="type">undefined</font>
类型
)</em>下载任务未开始<br><p>
通过plus.downloader.createDownload()方法创建下载任务后的初始状态,此时可调用其start()方法开始下载。
</p>
</li>
<li>0: <em>(<font class="type">Number</font>
类型
)</em>下载任务开始调度<br><p>
调用下载任务的start()方法之后处于此状态,此时下载任务处于可调度下载状态。
</p>
</li>
<li>1: <em>(<font class="type">Number</font>
类型
)</em>下载任务开始请求<br><p>
下载任务建立网络连接,发送请求到服务器并等待服务器的响应。
</p>
</li>
<li>2: <em>(<font class="type">Number</font>
类型
)</em>下载任务请求已经接收<br><p>
下载任务网络连接已建立,服务器返回响应,准备传输数据内容。
</p>
</li>
<li>3: <em>(<font class="type">Number</font>
类型
)</em>下载任务接收数据<br><p>
下载任务接收数据,监听statechanged事件时可多次触发此状态。
</p>
</li>
<li>4: <em>(<font class="type">Number</font>
类型
)</em>下载任务已完成<br><p>
下载任务完成数据传输并断开连接,下载成功或失败都会设置为此状态。
</p>
</li>
<li>5: <em>(<font class="type">Number</font>
类型
)</em>下载任务已暂停<br><p>
调用下载任务的pause()方法将任务暂停,此时可调用其resume()方法重新开始下载。
</p>
</li>
<li>-1: <em>(<font class="type">Number</font>
类型
)</em>枚举任务状态<br><p>
非下载任务状态,泛指所有下载任务的状态,用于enumerate()和clear()操作时指定作用于所有下载任务。
</p>
</li>
</ul>
<h1><a name="plus.downloader.DownloadOptions">DownloadOptions</a></h1>
<p>下载任务参数</p>
<h2>说明:</h2>
<p class="des">
在创建下载任务时设置的参数,如设置下载任务使用的HTTP协议类型、优先级等。
</p>
<h2>属性:</h2>
<ul>
<li>method: <em>(<font class="type">String</font>
类型
)</em>网络请求类型<br><p>
支持http协议的“GET”、“POST”,默认为“GET”请求。
</p>
</li>
<li>data: <em>(<font class="type">String</font>
类型
)</em>POST请求时提交的数据<br><p>
仅在网络请求类型method设置为"POST"时有效,"GET"请求时忽略此数据。
</p>
</li>
<li>filename: <em>(<font class="type">String</font>
类型
)</em>下载文件保存的路径<br><p>
保存文件路径仅支持以"_downloads/"、"_doc/"、"_documents/"开头的字符串。
文件路径以文件后缀名结尾(如"_doc/download/a.doc")表明指定保存文件目录及名称,以“/”结尾则认为指定保存文件的目录(此时程序自动生成文件名)。
如果指定的文件已经存在,则自动在文件名后面加"(i)",其中i为数字,如果文件名称后面已经是此格式,则数字i递增,如"download(1).doc"。
默认保存目录为("_downloads"),并自动生成文件名称。
</p>
</li>
<li>priority: <em>(<font class="type">Number</font>
类型
)</em>下载任务的优先级<br><p>
数值类型,数值越大优先级越高,默认优先级值为0。
</p>
</li>
<li>timeout: <em>(<font class="type">Number</font>
类型
)</em>下载任务超时时间<br><p>
数值类型,单位为s(秒),默认值为120s。
超时时间为服务器响应请求的时间(不是下载任务完成的总时间),如果设置为0则表示永远不超时。
</p>
</li>
<li>retry: <em>(<font class="type">Number</font>
类型
)</em>下载任务重试次数<br><p>
数值类型,默认为重试3次。
</p>
</li>
<li>retryInterval: <em>(<font class="type">Number</font>
类型
)</em>下载任务重试间隔时间<br><p>
数值类型,单位为s(秒),默认值为30s。
</p>
</li>
</ul>
<h1><a name="plus.downloader.DownloadCompletedCallback">DownloadCompletedCallback</a></h1>
<p>下载任务完成时的回调</p>
<pre class="prettyprint linenums">
vaoid onCompleted( Download download, Number status ) {
// Download file complete code
}
</pre>
<h2>说明:</h2>
<p class="des">
下载任务完成时的回调函数,在下载任务完成时调用。
下载任务失败也将触发此回调。
</p>
<h2>参数:</h2>
<ul>
<li>download :
<em>(
<a href="#plus.downloader.Download">Download</a>
)
必选 </em>下载任务对象<br>
</li>
<li>status:
<em>(
<font class="type">Number</font>
)
必选 </em>下载结果状态码<br>
HTTP传输协议状态码,如果未获取传输状态则其值则为0,如下载成功其值通常为200。
</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.downloader.DownloadStateChangedCallback">DownloadStateChangedCallback</a></h1>
<p>下载任务状态变化回调</p>
<pre class="prettyprint linenums">
void onStateChanged( Download download, status ) {
// Download state changed code.
}
</pre>
<h2>参数:</h2>
<ul>
<li>download :
<em>(
<a href="#plus.downloader.Download">Download</a>
)
必选 </em>下载任务对象<br>
</li>
<li>status:
<em>(
<font class="type">Number</font>
)
必选 </em>下载结果状态码<br>
HTTP传输协议状态码,如果未获取传输状态则其值则为0,如下载成功其值通常为200。
</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.downloader.DownloadEnumerateCallback">DownloadEnumerateCallback</a></h1>
<p>枚举下载任务回调</p>
<pre class="prettyprint linenums">
void onEnumerated( Download[] downloads ) {
// Enumerate success code
}
</pre>
<h2>参数:</h2>
<ul><li>downloads:
<em>(
<font class="type">Array</font>[
<font class="type">Download</font>
]
)
必选 </em>枚举到的下载任务对象数组<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+96
View File
@@ -0,0 +1,96 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.Events">Events</a></h1>
<p>Events模块管理客户端事件,包括系统事件,如扩展API加载完毕、程序前后台切换等。</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.Events.%22plusready%22">"plusready"</a>: 扩展API加载完成事件</li>
<li>
<a href="#plus.Events.%22pause%22">"pause"</a>: 运行环境从前台切换到后台事件</li>
<li>
<a href="#plus.Events.%22resume%22">"resume"</a>: 运行环境从后台切换到前台事件</li>
<li>
<a href="#plus.Events.%22netchange%22">"netchange"</a>: 设备网络状态变化事件</li>
<li>
<a href="#plus.Events.%22newintent%22">"newintent"</a>: 新意图事件</li>
<li>
<a href="#plus.Events.%22plusscrollbottom%22">"plusscrollbottom"</a>: 窗口滚动到底部事件</li>
<li>
<a href="#plus.Events.%22error%22">"error"</a>: 页面加载错误事件</li>
<li>
<a href="#plus.Events.%22background%22">"background"</a>: 应用切换到后台运行事件</li>
<li>
<a href="#plus.Events.%22foreground%22">"foreground"</a>: 应用切换到前台运行事件</li>
<li>
<a href="#plus.Events.%22trimmemory%22">"trimmemory"</a>: 应用需要清理内存事件</li>
<li>
<a href="#plus.Events.%22splashclosed%22">"splashclosed"</a>: 应用启动界面已关闭事件</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.Events.addEventListener">addEventListener</a>: 添加事件监听函数</li></ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.Events.EventTrigCallback">EventTrigCallback</a>: 事件触发回调函数</li>
<li>
<a href="#plus.Events.ErrorEventTrigCallback">ErrorEventTrigCallback</a>: 页面加载错误事件回调函数</li>
</ul>
<h1><a name="plus.Events.EventTrigCallback">EventTrigCallback</a></h1>
<p>事件触发回调函数</p>
<pre class="prettyprint linenums">
void onTrig(){
// Event trig code
}
</pre>
<h2>说明:</h2>
<p class="des">
指定事件触发时的回调函数,在指定的事件已经发生时调用。
</p>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.Events.ErrorEventTrigCallback">ErrorEventTrigCallback</a></h1>
<p>页面加载错误事件回调函数</p>
<pre class="prettyprint linenums">
void onErrorTrig(Event event){
// Event trig code
var url = event.url; // 加载错误的页面路径,API中传入的url值
var href = event.href; // 加载错误的页面完整路径,通常以“file://”开头的路径
}
</pre>
<h2>说明:</h2>
<p class="des">
当Webview窗口加载页面失败后打开错误页面时触发此事件。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>加载页面失败信息<br>
可通过event.url(String类型)获取加载页面的url值,如“./test/html”;
可通过event.href(String类型)加载错误的页面完整路径,包括完整的协议头,如Android平台“file:///storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/www/test.html”,iOS平台“file:///var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/www/test.html”。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+247
View File
@@ -0,0 +1,247 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.gallery">gallery</a></h1>
<p>Gallery模块管理系统相册,支持从相册中选择图片或视频文件、保存图片或视频文件到相册等功能。通过plus.gallery获取相册管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.gallery.pick">pick</a>: 从系统相册选择文件(图片或视频)</li>
<li>
<a href="#plus.gallery.save">save</a>: 保存文件到系统相册中</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.gallery.GalleryOptions">GalleryOptions</a>: JSON对象,从相册中选择文件的参数</li>
<li>
<a href="#plus.gallery.GalleryFilter">GalleryFilter</a>: 相册选择文件过滤类型</li>
<li>
<a href="#plus.gallery.PopPosition">PopPosition</a>: JSON对象,弹出拍照或摄像界面指示位置</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.gallery.GalleryPickSuccessCallback">GalleryPickSuccessCallback</a>: 单选系统相册图片成功的回调</li>
<li>
<a href="#plus.gallery.GalleryMultiplePickSuccessCallback">GalleryMultiplePickSuccessCallback</a>: 多选系统相册图片成功的回调</li>
<li>
<a href="#plus.gallery.GallerySuccessCallback">GallerySuccessCallback</a>: 操作系统相册成功的回调</li>
<li>
<a href="#plus.gallery.GalleryErrorCallback">GalleryErrorCallback</a>: 系统相册操作失败的回调</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Gallery": {
"description": "系统相册"
}
}
}
</pre>
<h1><a name="plus.gallery.GalleryOptions">GalleryOptions</a></h1>
<p>JSON对象,从相册中选择文件的参数</p>
<h2>属性:</h2>
<ul>
<li>animation: <em>(<font class="type">Boolean</font>
类型
)</em>是否显示系统相册文件选择界面的动画<br><p>是否显示系统相册文件选择界面的动画,可取值true、false,默认值为true。</p>
</li>
<li>filename: <em>(<font class="type">String</font>
类型
)</em>选择文件保存的路径<br><p>
某些系统不能直接使用系统相册的路径,这时需要将选择的文件保存到应用可访问的目录中,可通过此参数设置保存文件的路径。
如果路径中包括文件后缀名称,则表明指定文件路径及名称,否则仅指定文件保存目录,文件名称自动生成。
</p>
</li>
<li>filter: <em>(<a href="#plus.gallery.GalleryFilter">GalleryFilter</a>
类型
)</em>相册中选择文件类型过滤器<br><p>
系统相册选择器中可选择的文件类型,可设置为仅选择图片文件(“image”)、视频文件(“video”)或所有文件(“none”),默认值为“image”。
</p>
</li>
<li>maximum: <em>(<font class="type">Number</font>
类型
)</em>最多选择的图片数量<br><p>
仅在支持多选时有效,取值范围为1到Infinity,默认值为Infinity,即不限制选择的图片数。
如果设置的值非法则使用默认值Infinity。
</p>
</li>
<li>multiple: <em>(<font class="type">Boolean</font>
类型
)</em>是否支持多选图片<br><p>
可从系统相册中选择多张图片,选择图片后通过GalleryMultiplePickSuccessCallback回调返回选择的图片。
</p>
</li>
<li>onmaxed: <em>(<font class="type">Function</font>
类型
)</em>超过最多选择图片数量事件<br><p>
使用相册多选图片时,可通过maximum属性设置最多选择的图片数量,当用户操作选择的数量大于此时触发此事件。
</p>
</li>
<li>popover: <em>(<a href="#plus.gallery.PopPosition">PopPosition</a>
类型
)</em>相册选择界面弹出指示区域<br><p>
对于大屏幕设备如iPad,相册选择界面为弹出窗口,此时可通过此参数设置弹出窗口位置。
其为JSON对象,格式如{top:"10px",left:"10px",width:"200px",height:"200px"},所有值为像素值,左上坐标相对于容器的位置,默认弹出位置为屏幕居中。
</p>
</li>
<li>selected: <em>(<font class="type">Array</font>[
<font class="type">String</font>
]
类型
)</em>已选择的图片路径列表<br><p>
仅在多图片选择时生效,相册选择界面将选中指定的图片路径列表。
如果指定的路径无效,则忽略此项;如果指定的路径数超过maximum属性指定的最大选择数目则超出的图片不选中。
</p>
</li>
<li>system: <em>(<font class="type">Boolean</font>
类型
)</em>是否使用系统相册文件选择界面<br><p>
设置为true时,如果系统自带相册选择控件时则优先使用,否则使用5+统一相册选择控件;设置为false则不使用系统自带相册选择控件,直接使用5+统一相册选择界面。
默认值为true。
</p>
</li>
</ul>
<h1><a name="plus.gallery.GalleryFilter">GalleryFilter</a></h1>
<p>相册选择文件过滤类型</p>
<h2>属性:</h2>
<ul>
<li>"image": <em>(<font class="type">String</font>
类型
)</em>仅可选择图片文件<br>
</li>
<li>"video": <em>(<font class="type">String</font>
类型
)</em>仅可选择视频文件<br>
</li>
<li>"none": <em>(<font class="type">String</font>
类型
)</em>不过滤,可选择图片或视频文件<br>
</li>
</ul>
<h1><a name="plus.gallery.PopPosition">PopPosition</a></h1>
<p>JSON对象,弹出拍照或摄像界面指示位置</p>
<h2>属性:</h2>
<ul>
<li>top: <em>(<font class="type">String</font>
类型
)</em>指示区域距离容器顶部的距离<br><p>
弹出拍照或摄像窗口指示区域距离容器顶部的距离,单位支持像素值(如"100px")和百分比(如"50%"),如不写单位则为像素值值。</p>
</li>
<li>left: <em>(<font class="type">String</font>
类型
)</em>指示区域距离容器左侧的距离<br><p>
弹出拍照或摄像窗口指示区域距离容器左侧的距离,单位支持像素值(如"100px")和百分比(如"50%"),如不写单位则为像素值。</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>指示区域的宽度<br><p>
弹出拍照或摄像窗口指示区域的宽度,单位支持像素值(如"100px")和百分比(如"50%"),如不写单位则为像素值。</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>指示区域的高度<br><p>
弹出拍照或摄像窗口指示区域的高度,单位支持像素值(如"100px")和百分比(如"50%"),如不写单位则为像素值。</p>
</li>
</ul>
<h1><a name="plus.gallery.GalleryPickSuccessCallback">GalleryPickSuccessCallback</a></h1>
<p>单选系统相册图片成功的回调</p>
<pre class="prettyprint linenums">
void onSuccess( file ) {
// Success code
}
</pre>
<h2>说明:</h2>
<p class="des">
系统相册中单选图片或视频文件成功的回调函数,在选择文件操作成功时调用。
</p>
<h2>参数:</h2>
<ul><li>file:
<em>(
<font class="type">String</font>
)
必选 </em>选择的图片或视频文件路径<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.gallery.GalleryMultiplePickSuccessCallback">GalleryMultiplePickSuccessCallback</a></h1>
<p>多选系统相册图片成功的回调</p>
<pre class="prettyprint linenums">
void onSuccess( event ) {
// Pick success
var files = event.files; // 保存多选的图片或视频文件路径
}
</pre>
<h2>说明:</h2>
<p class="des">
系统相册中多选图片或视频文件成功的回调函数,在多选择文件操作成功时调用。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>多选系统相册返回数据<br>
Event对象包含以下属性:
files - 字符串数组,保存多选的图片或视频文件路径。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.gallery.GallerySuccessCallback">GallerySuccessCallback</a></h1>
<p>操作系统相册成功的回调</p>
<pre class="prettyprint linenums">
void onSuccess() {
// Success code
}
</pre>
<h2>说明:</h2>
<p class="des">
系统相册操作成功的回调函数,在保存文件到系统相册操作成功时调用。
</p>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.gallery.GalleryErrorCallback">GalleryErrorCallback</a></h1>
<p>系统相册操作失败的回调</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>说明:</h2>
<p class="des">
系统相册操作失败的回调函数,在选择或保存图片操作失败时调用。
</p>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>相册操作失败的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+340
View File
@@ -0,0 +1,340 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.geolocation">geolocation</a></h1>
<p>Geolocation模块管理设备位置信息,用于获取地理位置信息,如经度、纬度等。通过plus.geolocation可获取设备位置管理对象。虽然W3C已经提供标准API获取位置信息,但在某些平台存在差异或未实现,为了保持各平台的统一性,定义此规范接口获取位置信息。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.geolocation.getCurrentPosition">getCurrentPosition</a>: 获取当前设备位置信息</li>
<li>
<a href="#plus.geolocation.watchPosition">watchPosition</a>: 监听设备位置变化信息</li>
<li>
<a href="#plus.geolocation.clearWatch">clearWatch</a>: 关闭监听设备位置信息</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.geolocation.Position">Position</a>: JSON对象,设备位置信息数据</li>
<li>
<a href="#plus.geolocation.Address">Address</a>: JSON对象,地址信息</li>
<li>
<a href="#plus.geolocation.Coordinates">Coordinates</a>: JSON对象,地理坐标信息</li>
<li>
<a href="#plus.geolocation.PositionOptions">PositionOptions</a>: JSON对象,监听设备位置信息参数</li>
<li>
<a href="#plus.geolocation.GeolocationError">GeolocationError</a>: JSON对象,定位错误信息</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.geolocation.GeolocationSuccessCallback">GeolocationSuccessCallback</a>: 获取设备位置信息成功的回调函数</li>
<li>
<a href="#plus.geolocation.GeolocationErrorCallback">GeolocationErrorCallback</a>: 获取设备位置信息失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Geolocation": {
"description": "位置信息"
}
}
}
</pre>
<h1><a name="plus.geolocation.Position">Position</a></h1>
<p>JSON对象,设备位置信息数据</p>
<pre class="prettyprint linenums">
interface Position {
readonly attribute Coordinates coords;
readonly attribute String coordsType;
readonly attribute Number timestamp;
readonly attribute Address address;
readonly attribute String addresses;
}
</pre>
<h2>属性:</h2>
<ul>
<li>coords: <em>(<a href="#plus.geolocation.Coordinates">Coordinates</a>
类型
)</em>地理坐标信息,包括经纬度、海拔、速度等信息<br>
</li>
<li>coordsType: <em>(<font class="type">String</font>
类型
)</em>获取到地理坐标信息的坐标系类型<br><p>
可取以下坐标系类型:
“gps”:表示WGS-84坐标系;
“gcj02”:表示国测局经纬度坐标系;
“bd09”:表示百度墨卡托坐标系;
“bd09ll”:表示百度经纬度坐标系。
</p>
</li>
<li>timestamp: <em>(<font class="type">Number</font>
类型
)</em>获取到地理坐标的时间戳信息<br><p>
时间戳值为从1970年1月1日至今的毫秒数。
</p>
</li>
<li>address: <em>(<a href="#plus.geolocation.Address">Address</a>
类型
)</em>获取到地理位置对应的地址信息<br><p>
获取地址信息需要连接到服务器进行解析,所以会消耗更多的资源,如果不需要获取地址信息可通过设置PositionOptions参数的geocode属性值为false避免获取地址信息。
如果没有获取到地址信息则返回undefined。
</p>
</li>
<li>addresses: <em>(<font class="type">String</font>
类型
)</em>获取完整地址描述信息<br><p>
如果没有获取到地址信息则返回undefined。
</p>
</li>
</ul>
<h1><a name="plus.geolocation.Address">Address</a></h1>
<p>JSON对象,地址信息</p>
<pre class="prettyprint linenums">
interface Address {
readonly attribute String country;
readonly attribute String province;
readonly attribute String city;
readonly attribute String district;
readonly attribute String street;
readonly attribute String streetNum;
readonly attribute String poiName;
readonly attribute String postalCode;
readonly attribute String cityCode;
}
</pre>
<h2>属性:</h2>
<ul>
<li>country: <em>(<font class="type">String</font>
类型
)</em>国家<br><p>
如“中国”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>province: <em>(<font class="type">String</font>
类型
)</em>省份名称<br><p>
如“北京市”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>city: <em>(<font class="type">String</font>
类型
)</em>城市名称<br><p>
如“北京市”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>district: <em>(<font class="type">String</font>
类型
)</em>区(县)名称<br><p>
如“朝阳区”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>street: <em>(<font class="type">String</font>
类型
)</em>街道信息<br><p>
如“酒仙桥路”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>streetNum: <em>(<font class="type">String</font>
类型
)</em>获取街道门牌号信息<br><p>
如“3号”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>poiName: <em>(<font class="type">String</font>
类型
)</em>POI信息<br><p>
如“电子城.国际电子总部”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>postalCode: <em>(<font class="type">String</font>
类型
)</em>邮政编码<br><p>
如“100016”,如果无法获取此信息则返回undefined。
</p>
</li>
<li>cityCode: <em>(<font class="type">String</font>
类型
)</em>城市代码<br><p>
如“010”,如果无法获取此信息则返回undefined。
</p>
</li>
</ul>
<h1><a name="plus.geolocation.Coordinates">Coordinates</a></h1>
<p>JSON对象,地理坐标信息</p>
<pre class="prettyprint linenums">
interface Coordinates {
readonly attribute double latitude;
readonly attribute double longitude;
readonly attribute double altitude;
readonly attribute double accuracy;
readonly attribute double altitudeAccuracy;
readonly attribute double heading;
readonly attribute double speed;
}
</pre>
<h2>属性:</h2>
<ul>
<li>latitude: <em>(<font class="type">Number</font>
类型
)</em>坐标纬度值<br><p>数据类型对象,地理坐标中的纬度值。</p>
</li>
<li>longitude: <em>(<font class="type">Number</font>
类型
)</em>坐标经度值<br><p>数据类型对象,地理坐标中的经度值。</p>
</li>
<li>altitude: <em>(<font class="type">Number</font>
类型
)</em>海拔信息<br><p>数据类型对象,如果无法获取此信息,则此值为空(null)。</p>
</li>
<li>accuracy: <em>(<font class="type">Number</font>
类型
)</em>地理坐标信息的精确度信息<br><p>数据类型对象,单位为米,其有效值必须大于0。</p>
</li>
<li>altitudeAccuracy: <em>(<font class="type">Number</font>
类型
)</em>海拔的精确度信息<br><p>数据类型对象,单位为米,其有效值必须大于0。如果无法获取海拔信息,则此值为空(null)。</p>
</li>
<li>heading: <em>(<font class="type">Number</font>
类型
)</em>表示设备移动的方向<br><p>
数据类型对象,范围为0到360,表示相对于正北方向的角度。如果无法获取此信息,则此值为空(null)。如果设备没有移动则此值为NaN。
</p>
</li>
<li>speed: <em>(<font class="type">Number</font>
类型
)</em>表示设备移动的速度<br><p>
数据类型对象,单位为米每秒(m/s),其有效值必须大于0。如果无法获取速度信息,则此值为空(null)。
</p>
</li>
</ul>
<h1><a name="plus.geolocation.PositionOptions">PositionOptions</a></h1>
<p>JSON对象,监听设备位置信息参数</p>
<h2>属性:</h2>
<ul>
<li>enableHighAccuracy: <em>(<font class="type">Boolean</font>
类型
)</em>是否高精确度获取位置信息<br><p>高精度获取表示需要使用更多的系统资源,默认值为false。</p>
</li>
<li>timeout: <em>(<font class="type">Number</font>
类型
)</em>获取位置信息的超时时间<br><p>单位为毫秒(ms),默认值为不超时。如果在指定的时间内没有获取到位置信息则触发错误回调函数。</p>
</li>
<li>maximumAge: <em>(<font class="type">Number</font>
类型
)</em>获取位置信息的间隔时间<br><p>
单位为毫秒(ms),默认值为5000(即5秒)。调用plus.geolocation.watchPosition时为更新位置信息的间隔时间。
注意:在不同定位模块下支持范围值可能不同,如百度定位模块的间隔范围为大于等于1秒,如果设置的值小于最小值则使用最小值。
</p>
</li>
<li>provider: <em>(<font class="type">String</font>
类型
)</em>优先使用的定位模块<br><p>
可取以下供应者:
"system":表示系统定位模块,支持wgs84坐标系;
"baidu":表示百度定位模块,支持gcj02/bd09/bd09ll坐标系;
"amap":表示高德定位模板,支持gcj02坐标系。
默认值按以下优先顺序获取(amap&gt;baidu&gt;system),若指定的provider不存在或无效则返回错误回调。
注意:百度/高德定位模块需要配置百度/高德地图相关参数才能正常使用。
</p>
</li>
<li>coordsType: <em>(<font class="type">String</font>
类型
)</em>指定获取的定位数据坐标系类型<br><p>
可取以下坐标系类型:
“wgs84”:表示WGS-84坐标系;
“gcj02”:表示国测局经纬度坐标系;
“bd09”:表示百度墨卡托坐标系;
“bd09ll”:表示百度经纬度坐标系;
provider为“system”时,默认使用“wgs84”类型;provider为“baidu”是,默认使用“bd09ll”类型。
如果设置的坐标系类型provider不支持,则返回错误。
</p>
</li>
<li>geocode: <em>(<font class="type">Boolean</font>
类型
)</em>是否解析地址信息<br><p>
解析的地址信息保存到Position对象的address、addresses属性中,true表示解析地址信息,false表示不解析地址信息,返回的Position对象的address、addresses属性值为undefined,默认值为true。
如果解析地址信息失败则返回的Position对象的address、addresses属性值为null。
</p>
</li>
</ul>
<h1><a name="plus.geolocation.GeolocationError">GeolocationError</a></h1>
<p>JSON对象,定位错误信息</p>
<pre class="prettyprint linenums">
interface GeolocationError {
const Number PERMISSION_DENIED = 1;
const Number POSITION_UNAVAILABLE = 2;
const Number TIMEOUT = 3;
const Number UNKNOWN_ERROR = 4;
readonly attribute Number code;
readonly attribute String message;
}
</pre>
<h2>属性:</h2>
<ul>
<li>code: <em>(<font class="type">Number</font>
类型
)</em>错误代码<br><p>
取值范围为GeolocationError对象的常量值。
</p>
</li>
<li>message: <em>(<font class="type">String</font>
类型
)</em>错误描述信息<br><p>
详细错误描述信息。
</p>
</li>
</ul>
<h1><a name="plus.geolocation.GeolocationSuccessCallback">GeolocationSuccessCallback</a></h1>
<p>获取设备位置信息成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( position ) {
// Get Position code.
}
</pre>
<h2>参数:</h2>
<ul><li>position:
<em>(
<a href="#plus.geolocation.Position">Position</a>
)
必选 </em>设备的地理位置信息,参考Position<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.geolocation.GeolocationErrorCallback">GeolocationErrorCallback</a></h1>
<p>获取设备位置信息失败的回调函数</p>
<pre class="prettyprint linenums">
function void onGeolocationError( GeolocationError error ) {
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<a href="#plus.geolocation.GeolocationError">GeolocationError</a>
)
必选 </em>获取位置操作的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
@@ -0,0 +1,24 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.InterfaceOrientation">InterfaceOrientation</a></h1>
<p>获取应用的横竖屏信息</p>
<h2>方法:</h2>
<ul><li>
<a href="#plus.InterfaceOrientation.window.orientation">window.orientation</a>: 获取当前设备横竖屏状态</li></ul>
<h2>事件:</h2>
<ul><li>
<a href="#plus.InterfaceOrientation.orientationchange">orientationchange</a>: 当屏幕旋转时的通知事件</li></ul>
<br><br>
</div></body>
</html>
+567
View File
@@ -0,0 +1,567 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.io">io</a></h1>
<p>IO模块管理本地文件系统,用于对文件系统的目录浏览、文件的读取、文件的写入等操作。通过plus.io可获取文件系统管理对象。</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.io.PRIVATE_WWW">PRIVATE_WWW</a>: 应用运行资源目录常量</li>
<li>
<a href="#plus.io.PRIVATE_DOC">PRIVATE_DOC</a>: 应用私有文档目录常量</li>
<li>
<a href="#plus.io.PUBLIC_DOCUMENTS">PUBLIC_DOCUMENTS</a>: 程序公用文档目录常量</li>
<li>
<a href="#plus.io.PUBLIC_DOWNLOADS">PUBLIC_DOWNLOADS</a>: 程序公用下载目录常量</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.io.requestFileSystem">requestFileSystem</a>: 请求本地文件系统对象</li>
<li>
<a href="#plus.io.resolveLocalFileSystemURL">resolveLocalFileSystemURL</a>: 通过URL参数获取目录对象或文件对象</li>
<li>
<a href="#plus.io.convertLocalFileSystemURL">convertLocalFileSystemURL</a>: 将本地URL路径转换成平台绝对路径</li>
<li>
<a href="#plus.io.convertAbsoluteFileSystem">convertAbsoluteFileSystem</a>: 将平台绝对路径转换成本地URL路径</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.io.DirectoryEntry">DirectoryEntry</a>: 文件系统中的目录对象,用于管理特定的本地目录</li>
<li>
<a href="#plus.io.DirectoryReader">DirectoryReader</a>: 读取目录信息对象,用于获取目录中包含的文件及子目录</li>
<li>
<a href="#plus.io.File">File</a>: 文件系统中的文件数据对象,用于获取文件的数据</li>
<li>
<a href="#plus.io.FileEntry">FileEntry</a>: 文件系统中的文件对象,用于管理特定的本地文件</li>
<li>
<a href="#plus.io.FileReader">FileReader</a>: 文件系统中的读取文件对象,用于获取文件的内容</li>
<li>
<a href="#plus.io.FileWriter">FileWriter</a>: 文件系统中的写文件对象,用于写入文件内容</li>
<li>
<a href="#plus.io.FileSystem">FileSystem</a>: 文件系统对象,用于管理特定本地文件目录</li>
<li>
<a href="#plus.io.Flags">Flags</a>: JSON对象,获取文件操作的参数</li>
<li>
<a href="#plus.io.Metadata">Metadata</a>: JSON对象,保存文件或目录的状态信息对象</li>
<li>
<a href="#plus.io.FileEvent">FileEvent</a>: 文件或目录操作事件对象</li>
<li>
<a href="#plus.io.URLType">URLType</a>: 文件路径类型</li>
<li>
<a href="#plus.io.RelativeURL">RelativeURL</a>: 相对路径URL</li>
<li>
<a href="#plus.io.LocalURL">LocalURL</a>: 本地路径URL</li>
<li>
<a href="#plus.io.RemoteURL">RemoteURL</a>: 网络路径URL</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.io.FileEventCallback">FileEventCallback</a>: 文件事件回调</li>
<li>
<a href="#plus.io.FileSystemSuccessCallback">FileSystemSuccessCallback</a>: 请求文件系统成功的回调函数</li>
<li>
<a href="#plus.io.FileResolveSuccessCallback">FileResolveSuccessCallback</a>: 通过URL参数获取目录或文件对象成功的回调函数</li>
<li>
<a href="#plus.io.MetadataSuccessCallback">MetadataSuccessCallback</a>: 获取文件或目录状态信息成功的回调函数</li>
<li>
<a href="#plus.io.EntrySuccessCallback">EntrySuccessCallback</a>: 操作文件或目录对象成功的回调函数</li>
<li>
<a href="#plus.io.EntrysSuccessCallback">EntrysSuccessCallback</a>: 操作文件或目录对象数组成功的回调函数</li>
<li>
<a href="#plus.io.FileWriterSuccessCallback">FileWriterSuccessCallback</a>: 写文件操作成功的回调函数</li>
<li>
<a href="#plus.io.FileSuccessCallback">FileSuccessCallback</a>: 文件操作成功的回调函数</li>
<li>
<a href="#plus.io.FileErrorCallback">FileErrorCallback</a>: 文件操作失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"File": {
"description": "文件系统"
}
}
}
</pre>
<h1><a name="plus.io.DirectoryEntry">DirectoryEntry</a></h1>
<p>文件系统中的目录对象,用于管理特定的本地目录</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.io.DirectoryEntry.isFile">isFile</a>: 操作对象的是否为文件,DirectoryEntry对象固定其值为false</li>
<li>
<a href="#plus.io.DirectoryEntry.isDirectory">isDirectory</a>: 操作对象是否为目录,DirectoryEntry对象固定其值为true</li>
<li>
<a href="#plus.io.DirectoryEntry.name">name</a>: 目录操作对象的名称,不包括路径</li>
<li>
<a href="#plus.io.DirectoryEntry.fullPath">fullPath</a>: 目录操作对象的完整路径,文件系统的绝对路径</li>
<li>
<a href="#plus.io.DirectoryEntry.fileSystem">fileSystem</a>: 文件操作对象所属的文件系统对象,参考FileSystem</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.io.DirectoryEntry.getMetadata">getMetadata</a>: 获取目录的属性</li>
<li>
<a href="#plus.io.DirectoryEntry.moveTo">moveTo</a>: 移动目录</li>
<li>
<a href="#plus.io.DirectoryEntry.copyTo">copyTo</a>: 拷贝目录</li>
<li>
<a href="#plus.io.DirectoryEntry.toURL">toURL</a>: 获取目录路径转换为URL地址</li>
<li>
<a href="#plus.io.DirectoryEntry.toLocalURL">toLocalURL</a>: 获取目录路径转换为本地路径URL地址</li>
<li>
<a href="#plus.io.DirectoryEntry.toRemoteURL">toRemoteURL</a>: 获取目录路径转换为网络路径URL地址</li>
<li>
<a href="#plus.io.DirectoryEntry.remove">remove</a>: 删除目录</li>
<li>
<a href="#plus.io.DirectoryEntry.getParent">getParent</a>: 获取目录所属的父目录</li>
<li>
<a href="#plus.io.DirectoryEntry.createReader">createReader</a>: 创建目录读取对象</li>
<li>
<a href="#plus.io.DirectoryEntry.getDirectory">getDirectory</a>: 创建或打开子目录</li>
<li>
<a href="#plus.io.DirectoryEntry.getFile">getFile</a>: 创建或打开文件</li>
<li>
<a href="#plus.io.DirectoryEntry.removeRecursively">removeRecursively</a>: 递归删除目录</li>
</ul>
<h1><a name="plus.io.DirectoryReader">DirectoryReader</a></h1>
<p>读取目录信息对象,用于获取目录中包含的文件及子目录</p>
<h2>方法:</h2>
<ul><li>
<a href="#plus.io.DirectoryReader.readEntries">readEntries</a>: 获取当前目录中的所有文件和子目录</li></ul>
<h1><a name="plus.io.File">File</a></h1>
<p>文件系统中的文件数据对象,用于获取文件的数据</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.io.File.size">size</a>: 文件数据对象的数据大小,单位为字节</li>
<li>
<a href="#plus.io.File.type">type</a>: 文件数据对象MIME类型</li>
<li>
<a href="#plus.io.File.name">name</a>: 文件数据对象的名称,不包括路径</li>
<li>
<a href="#plus.io.File.lastModifiedDate">lastModifiedDate</a>: 文件对象的最后修改时间</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.io.File.slice">slice</a>: 获取文件指定的数据内容</li>
<li>
<a href="#plus.io.File.close">close</a>: 关闭文件数据对象</li>
</ul>
<h1><a name="plus.io.FileEntry">FileEntry</a></h1>
<p>文件系统中的文件对象,用于管理特定的本地文件</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.io.FileEntry.isFile">isFile</a>: 文件操作对象的是否为文件,FileEntry对象固定其值为true</li>
<li>
<a href="#plus.io.FileEntry.isDirectory">isDirectory</a>: 文件操作对象是否为目录,FileEntry对象固定其值为false</li>
<li>
<a href="#plus.io.FileEntry.name">name</a>: 文件操作对象的名称,不包括路径</li>
<li>
<a href="#plus.io.FileEntry.fullPath">fullPath</a>: 文件操作对象的完整路径,文件系统的绝对路径</li>
<li>
<a href="#plus.io.FileEntry.fileSystem">fileSystem</a>: 文件操作对象所属的文件系统对象,参考FileSystem</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.io.FileEntry.getMetadata">getMetadata</a>: 获取文件的属性信息</li>
<li>
<a href="#plus.io.FileEntry.moveTo">moveTo</a>: 移动文件</li>
<li>
<a href="#plus.io.FileEntry.copyTo">copyTo</a>: 拷贝文件</li>
<li>
<a href="#plus.io.FileEntry.toURL">toURL</a>: 获取文件路径转换为URL地址</li>
<li>
<a href="#plus.io.FileEntry.toLocalURL">toLocalURL</a>: 获取文件路径转换为本地路径URL地址</li>
<li>
<a href="#plus.io.FileEntry.toRemoteURL">toRemoteURL</a>: 获取文件路径转换为网络路径URL地址</li>
<li>
<a href="#plus.io.FileEntry.remove">remove</a>: 删除文件</li>
<li>
<a href="#plus.io.FileEntry.getParent">getParent</a>: 获取文件所属的父目录</li>
<li>
<a href="#plus.io.FileEntry.createWriter">createWriter</a>: 获取文件关联的写文件操作对象FileWriter</li>
<li>
<a href="#plus.io.FileEntry.file">file</a>: 获取文件数据对象</li>
</ul>
<h1><a name="plus.io.FileReader">FileReader</a></h1>
<p>文件系统中的读取文件对象,用于获取文件的内容</p>
<h2>说明:</h2>
<p class="des">
FileReader对象是从设备文件系统读取文件FileReader对象是从设备文件系统读取文件的一种方式,文件以文本或者Base64编码的字符串形式读出来。
用户注册自己的事件监听器来接收loadstart、progress、load、loadend、error和abort事件。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.io.FileReader.FileReader">FileReader</a>: 创建读取文件对象</li></ul>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.io.FileReader.EMPTY">EMPTY</a>: 值为0,开始读取文件状态</li>
<li>
<a href="#plus.io.FileReader.LOADING">LOADING</a>: 值为1,正在读取文件状态</li>
<li>
<a href="#plus.io.FileReader.DONE">DONE</a>: 值为2,读文件操作完成状态</li>
</ul>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.io.FileReader.readyState">readyState</a>: 当前读取文件所处的状态</li>
<li>
<a href="#plus.io.FileReader.result">result</a>: 已读取文件的内容</li>
<li>
<a href="#plus.io.FileReader.error">error</a>: 文件操作错误代码</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.io.FileReader.abort">abort</a>: 终止文件读取操作</li>
<li>
<a href="#plus.io.FileReader.readAsDataURL">readAsDataURL</a>: 以URL编码格式读取文件数据内容</li>
<li>
<a href="#plus.io.FileReader.readAsText">readAsText</a>: 以文本格式读取文件数据内容</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.io.FileReader.onloadstart">onloadstart</a>: 读取文件开始时的回调函数</li>
<li>
<a href="#plus.io.FileReader.onprogress">onprogress</a>: 读取文件过程中的回调函数</li>
<li>
<a href="#plus.io.FileReader.onload">onload</a>: 读取文件成功完成的回调函数</li>
<li>
<a href="#plus.io.FileReader.onabort">onabort</a>: 取消读取文件时的回调函数</li>
<li>
<a href="#plus.io.FileReader.onerror">onerror</a>: 文件读取操作失败时调用的回调函数</li>
<li>
<a href="#plus.io.FileReader.onloadend">onloadend</a>: 文件读取操作完成时的回调函数</li>
</ul>
<h1><a name="plus.io.FileWriter">FileWriter</a></h1>
<p>文件系统中的写文件对象,用于写入文件内容</p>
<h2>说明:</h2>
<p class="des">
FileWriter对象是从设备文件系统写入文件FileWriter对象是从设备文件系统写入文件的一种方式,用户注册自己的事件监听器来接收writestart、progress、write、writeend、error和abort事件。
一个FileWriter对象是为单个文件的操作而创建。你可以使用该对象多次对相应文件进行写入操作。FileWriter维护该文件的指针位置及长度属性,这样你就可以寻找和写入文件的任何地方。
默认情况下,FileWriter从文件的开头开始写入(将覆盖现有数据)。FileWriter对象的seek方法可设置文件操作指定位置,如fw.seek(fw.length-1)写入操作就会从文件的末尾开始。
</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.io.FileWriter.INIT">INIT</a>: 值为0,写文件初始化状态</li>
<li>
<a href="#plus.io.FileWriter.WRITING">WRITING</a>: 值为1,正在写入文件状态</li>
<li>
<a href="#plus.io.FileWriter.DONE">DONE</a>: 值为2,写文件操作完成状态</li>
</ul>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.io.FileWriter.readyState">readyState</a>: 当前写入文件所处的状态</li>
<li>
<a href="#plus.io.FileWriter.length">length</a>: 文件当前的长度,单位为字节</li>
<li>
<a href="#plus.io.FileWriter.position">position</a>: 文件当前操作的指针位置</li>
<li>
<a href="#plus.io.FileWriter.error">error</a>: 文件写入操作错误代码</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.io.FileWriter.abort">abort</a>: 终止文件写入操作</li>
<li>
<a href="#plus.io.FileWriter.seek">seek</a>: 定位文件操作位置</li>
<li>
<a href="#plus.io.FileWriter.truncate">truncate</a>: 按照指定长度截断文件</li>
<li>
<a href="#plus.io.FileWriter.write">write</a>: 向文件中写入数据</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.io.FileWriter.onwritestart">onwritestart</a>: 写入文件开始时的回调函数</li>
<li>
<a href="#plus.io.FileWriter.onprogress">onprogress</a>: 写入文件过程中的回调函数</li>
<li>
<a href="#plus.io.FileWriter.onwrite">onwrite</a>: 写入文件成功完成的回调函数</li>
<li>
<a href="#plus.io.FileWriter.onabort">onabort</a>: 取消写入文件时的回调函数</li>
<li>
<a href="#plus.io.FileWriter.onerror">onerror</a>: 文件写入操作失败时调用的回调函数</li>
<li>
<a href="#plus.io.FileWriter.onwriteend">onwriteend</a>: 文件写入操作完成时的回调函数</li>
</ul>
<h1><a name="plus.io.FileSystem">FileSystem</a></h1>
<p>文件系统对象,用于管理特定本地文件目录</p>
<h2>说明:</h2>
<p class="des">
文件系统对象表示一个应用可访问的根目录。name属性用于标识此根目录的名称,与LocalFileSystem中的文件系统类型一一对应。root属性为文件目录对象,用于实际操作文件系统,参考DirectoryEntry。
</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.io.FileSystem.name">name</a>: 文件系统的名称</li>
<li>
<a href="#plus.io.FileSystem.root">root</a>: 文件系统的根目录</li>
</ul>
<h1><a name="plus.io.Flags">Flags</a></h1>
<p>JSON对象,获取文件操作的参数</p>
<h2>属性:</h2>
<ul>
<li>create: <em>(<font class="type">Boolean</font>
类型
)</em>是否创建对象标记<br><p>指示如果文件或目录不存在时是否进行创建,默认值为false。</p>
</li>
<li>exclusive: <em>(<font class="type">Boolean</font>
类型
)</em>反向操作标记<br><p>其本身没有任何效果,需与create属性值设置为true时一起使用,如果目标文件或目录已经存在则会导致文件或目录打开失败,默认值为false。</p>
</li>
</ul>
<h1><a name="plus.io.Metadata">Metadata</a></h1>
<p>JSON对象,保存文件或目录的状态信息对象</p>
<h2>说明:</h2>
<p class="des">可通过DirectoryEntry或FileEntry对象的getMetaData方法获取</p>
<h2>属性:</h2>
<ul>
<li>modificationTime: <em>(<font class="type">Date</font>
类型
)</em>文件或目录的最后修改时间<br>
</li>
<li>size: <em>(<font class="type">Number</font>
类型
)</em>文件的大小<br><p>若获取的是目录对象的属性则值为0。</p>
</li>
<li>directoryCount: <em>(<font class="type">Number</font>
类型
)</em>包含的子目录数<br><p>若自身是文件则其值为0。</p>
</li>
<li>fileCount: <em>(<font class="type">Number</font>
类型
)</em>目录的文件数<br><p>若自身是文件则其值为0。</p>
</li>
</ul>
<h1><a name="plus.io.FileEvent">FileEvent</a></h1>
<p>文件或目录操作事件对象</p>
<h2>说明:</h2>
<p class="des">
所有文件或目录操作事件回调函数中都创建该对象的实例。
该对象从DOMEvent继承而来,可通过该其target属性获取事件触发的文件或目录操作对象。
</p>
<h2>属性:</h2>
<ul><li>target: <em>(<a href="#plus.io.DirectoryEntry">DirectoryEntry</a>
类型
)</em>文件或目录操作对象<br><p>在不同的回调中指向的对象不同,可指向的对象包括:FileEntry、DirectoryEntry、FileReader、FileWriter。</p>
</li></ul>
<h1><a name="plus.io.URLType">URLType</a></h1>
<p>文件路径类型</p>
<h2>说明:</h2>
<p class="des">在文件系统中的文件路径需转换成URL格式,已方便runtime快速加载。</p>
<h1><a name="plus.io.RelativeURL">RelativeURL</a></h1>
<p>相对路径URL</p>
<h2>说明:</h2>
<p class="des">只能在扩展API中使用,相对于基座提供的特定目录,以“_”开头。</p>
<h2>常量:</h2>
<ul>
<li>"_www": <em>(<font class="type">DOMString</font>
类型
)</em>应用资源目录<br><p>
保存应用的所有html、css、js等资源文件,与文件系统中根目录PRIVATE_WWW一致,后面加相对路径如“_www/res/icon.png”。
注意:应用资源目录是只读目录,只能读取次目录下的文件,不能修改或新建。
</p>
</li>
<li>"_doc": <em>(<font class="type">DOMString</font>
类型
)</em>应用私有文档目录<br><p>用于保存应用运行期业务逻辑数据,与文件系统中根目录PRIVATE_DOCUMENTS,如“_doc/userdata.xml”。</p>
</li>
<li>"_documents": <em>(<font class="type">DOMString</font>
类型
)</em>程序公用文档目录<br><p>用于保存程序中各应用间可共享文件的目录,与文件系统中根目录PUBLIC_DOCUMENTS,如“_document/share.doc”。</p>
</li>
<li>"_downloads": <em>(<font class="type">DOMString</font>
类型
)</em>程序公用下载目录 <br><p>用于保存程序下载文件的目录,与文件系统中根目录PUBLIC_DOWNLOADS,如“_download/mydoc.doc”。</p>
</li>
</ul>
<h1><a name="plus.io.LocalURL">LocalURL</a></h1>
<p>本地路径URL</p>
<h2>说明:</h2>
<p class="des">
可在html页面中直接访问本地资源,以“file:///”开头,后面跟随系统的绝对路径。
如示例:“file:///D:/res/hello.html”。
</p>
<h1><a name="plus.io.RemoteURL">RemoteURL</a></h1>
<p>网络路径URL</p>
<h2>说明:</h2>
<p class="des">
可在html页面中以网络资源模式访问本地资源,以“http://”开头,后面跟随相对路径。
如示例:“http://localhost:13131/_www/res/icon.png”,其中“_www”字段可支持类型与相对路径URL一致。
</p>
<h1><a name="plus.io.FileEventCallback">FileEventCallback</a></h1>
<p>文件事件回调</p>
<pre class="prettyprint linenums">
void onEvent( event ) {
// Event code.
}
</pre>
<h2>说明:</h2>
<p class="des">
文件或目录操作回调事件。
通常在FileReader和FileWriter对象的事件函数中触发。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<a href="#plus.io.FileEvent">FileEvent</a>
)
必选 </em>文件事件对象<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.FileSystemSuccessCallback">FileSystemSuccessCallback</a></h1>
<p>请求文件系统成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( fs ) {
// File System operate code.
}
</pre>
<h2>参数:</h2>
<ul><li>fs:
<em>(
<a href="#plus.io.FileSystem">FileSystem</a>
)
必选 </em>请求到的文件系统对象<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.FileResolveSuccessCallback">FileResolveSuccessCallback</a></h1>
<p>通过URL参数获取目录或文件对象成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( entry ) {
// File or Direcory entry operate code.
}
</pre>
<h2>参数:</h2>
<ul><li>entry:
<em>(
<a href="#plus.io.DirectoryEntry">DirectoryEntry</a>
)
必选 </em>请求到的目录或文件对象<br>可指向文件或目录对象(DirectoryEntry|FileEntry)。</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.MetadataSuccessCallback">MetadataSuccessCallback</a></h1>
<p>获取文件或目录状态信息成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( metadata ) {
// Metadata code.
}
</pre>
<h2>参数:</h2>
<ul><li>metadata:
<em>(
<a href="#plus.io.Metadata">Metadata</a>
)
必选 </em>文件或目录的状态信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.EntrySuccessCallback">EntrySuccessCallback</a></h1>
<p>操作文件或目录对象成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( entry ) {
// Entry code.
}
</pre>
<h2>参数:</h2>
<ul><li>entry:
<em>(
<a href="#plus.io.DirectoryEntry">DirectoryEntry</a>
)
必选 </em>文件或目录对象的引用<br>可指向文件或目录对象(DirectoryEntry|FileEntry)。</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.EntrysSuccessCallback">EntrysSuccessCallback</a></h1>
<p>操作文件或目录对象数组成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( entrys ) {
// Entrys code.
}
</pre>
<h2>参数:</h2>
<ul><li>entrys:
<em>(
<a href="#plus.io.DirectoryEntry">DirectoryEntry</a>
)
必选 </em>文件或目录对象数组<br>可指向文件或目录对象数组(DirectoryEntry[]|FileEntry[])。</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.FileWriterSuccessCallback">FileWriterSuccessCallback</a></h1>
<p>写文件操作成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( writer ) {
// FileWriter code.
}
</pre>
<h2>参数:</h2>
<ul><li>writer:
<em>(
<a href="#plus.io.FileWriter">FileWriter</a>
)
必选 </em>写文件对象的引用<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.FileSuccessCallback">FileSuccessCallback</a></h1>
<p>文件操作成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( file ) {
// file code.
}
</pre>
<h2>参数:</h2>
<ul><li>file:
<em>(
<font class="type">File</font>
)
必选 </em>文件数据对象的引用<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.io.FileErrorCallback">FileErrorCallback</a></h1>
<p>文件操作失败的回调函数</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Error code.
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>文件操作失败的信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+87
View File
@@ -0,0 +1,87 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.ios">ios</a></h1>
<p>Native.js for iOS封装一条通过JS语法直接调用Native Objective-C接口通道,通过plus.ios可调用几乎所有的系统API。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.ios.importClass">importClass</a>: 导入Objective-C类对象</li>
<li>
<a href="#plus.ios.newObject">newObject</a>: 创建实例对象</li>
<li>
<a href="#plus.ios.deleteObject">deleteObject</a>: 销毁实例对象</li>
<li>
<a href="#plus.ios.invoke">invoke</a>: 调用对象(类对象/示例对象)的方法</li>
<li>
<a href="#plus.ios.implements">implements</a>: 实现代理的方法</li>
<li>
<a href="#plus.ios.currentWebview">currentWebview</a>: 获取当前Webview窗口对象的native层UIWebview实例对象</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.ios.ClassObject">ClassObject</a>: Objective-C类对象</li>
<li>
<a href="#plus.ios.InstanceObject">InstanceObject</a>: Objective-C实例对象</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Invocation": {
"description": "Native.js"
}
}
}
</pre>
<h1><a name="plus.ios.ClassObject">ClassObject</a></h1>
<p>Objective-C类对象</p>
<pre class="prettyprint linenums">
interface ClassObject {
// ...
}
</pre>
<h2>说明:</h2>
<p class="des">
Objective-C类对象,可通过其属性获取类的常量,可通过方法来操作类的静态方法,也通过new方法来创建类的实例对象。
对于类的静态方法,则直接通过.后面跟随方法名称调用。
</p>
<h1><a name="plus.ios.InstanceObject">InstanceObject</a></h1>
<p>Objective-C实例对象</p>
<pre class="prettyprint linenums">
interface InstanceObject {
// ...
function Object plusGetAttribute( String name );
function Object plusSetAttribute( String name, Object value );
// ...
}
</pre>
<h2>说明:</h2>
<p class="des">
Objective-C实例对象,可通过其方法来操作示例的变量和方法。
注意:必须通过plusGetAttribute()方法读取示例对象的属性值,通过plusSetAttribute()方法设置示例对象的属性值。
</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.ios.InstanceObject.plusGetAttribute">plusGetAttribute</a>: 获取Objective-C实例对象的属性</li>
<li>
<a href="#plus.ios.InstanceObject.plusSetAttribute">plusSetAttribute</a>: 设置Objective-C示例对象的属性</li>
</ul>
<br><br>
</div></body>
</html>
+131
View File
@@ -0,0 +1,131 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.key">key</a></h1>
<p>Key管理设备按键事件</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.key.addEventListener">addEventListener</a>: 添加按键事件监听器</li>
<li>
<a href="#plus.key.removeEventListener">removeEventListener</a>: 移除按键事件监听器</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.key.KeyType">KeyType</a>: 按键类型</li>
<li>
<a href="#plus.key.KeyEvent">KeyEvent</a>: 按键事件</li>
</ul>
<h2>回调方法:</h2>
<ul><li>
<a href="#plus.key.KeyEventCallback">KeyEventCallback</a>: 按键事件的回调函数</li></ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Webview": {
"description": "窗口管理"
}
}
}
</pre>
<h1><a name="plus.key.KeyType">KeyType</a></h1>
<p>按键类型</p>
<h2>常量:</h2>
<ul>
<li>"backbutton": <em>(<font class="type">String</font>
类型
)</em>设备“返回”按钮按键事件<br><p>
如果需要改变默认“返回”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"backbutton"事件。
</p>
</li>
<li>"keydown": <em>(<font class="type">String</font>
类型
)</em>键按下事件<br><p>
如果需要改变默认键按下的处理逻辑,则可通过plus.key.addEventListener来注册监听"keydown"事件。
可通过回调函数中KeyEvent对象的keyCode来获取按下的键值。
</p>
</li>
<li>"keyup": <em>(<font class="type">String</font>
类型
)</em>键松开事件<br><p>
如果需要改变默认键松开的处理逻辑,则可通过plus.key.addEventListener来注册监听"keyup"事件。
可通过回调函数中KeyEvent对象的keyCode来获取松开的键值。
</p>
</li>
<li>"longpressed": <em>(<font class="type">String</font>
类型
)</em>长按键事件<br><p>
如果需要改变默认长按键的处理逻辑,则可通过plus.key.addEventListener来注册监听"longpressed"事件。
长按键时会多次触发回调函数,通过回调函数中KeyEvent对象的keyCode来获取长按的键值。
</p>
</li>
<li>"menubutton": <em>(<font class="type">String</font>
类型
)</em>设备“菜单”按钮按键事件<br><p>
如果需要改变默认“菜单”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"menubutton"事件。
</p>
</li>
<li>"searchbutton": <em>(<font class="type">String</font>
类型
)</em>设备“搜索”按钮按键事件<br><p>
如果需要改变默认“搜索”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"searchbutton"事件。
</p>
</li>
<li>"volumeupbutton": <em>(<font class="type">String</font>
类型
)</em>设备“音量+”按钮按键事件<br><p>
如果需要改变默认“音量+”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumeupbutton"事件。
</p>
</li>
<li>"volumedownbutton": <em>(<font class="type">String</font>
类型
)</em>设备“音量-”按钮按键事件<br><p>
如果需要改变默认“音量-”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumedownbutton"事件。
</p>
</li>
</ul>
<h1><a name="plus.key.KeyEvent">KeyEvent</a></h1>
<p>按键事件</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.key.KeyEvent.keyCode">keyCode</a>: 触发按键事件的键值</li>
<li>
<a href="#plus.key.KeyEvent.keyType">keyType</a>: 按键事件类型</li>
</ul>
<h1><a name="plus.key.KeyEventCallback">KeyEventCallback</a></h1>
<p>按键事件的回调函数</p>
<pre class="prettyprint linenums">
void onKeyEvent( KeyEvent event ){
// Event handled code.
var key=event.keyCode; // 用户按键的键值
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<a href="#plus.key.KeyEvent">KeyEvent</a>
)
必选 </em>监听用户按键操作返回的数据<br>
可通过event的keyCode属性(String类型)获取用户按键的类型,参考KeyType类型。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+939
View File
@@ -0,0 +1,939 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.maps">maps</a></h1>
<p>Maps模块管理地图控件,用于在web页面中显示地图控件,提供各种接口操作地图控件,如添加标点、路线等。通过plus.maps可获取地图管理对象。</p>
<h2>方法:</h2>
<ul><li>
<a href="#plus.maps.openSysMap">openSysMap</a>: 调用系统第三方程序进行导航</li></ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.maps.Map">Map</a>: 地图控件对象</li>
<li>
<a href="#plus.maps.MapOptions">MapOptions</a>: 地图对象的参数</li>
<li>
<a href="#plus.maps.GeocodeOptions">GeocodeOptions</a>: 地理编码转换的参数</li>
<li>
<a href="#plus.maps.CoordinateConvertOptions">CoordinateConvertOptions</a>: 地图坐标转换的参数</li>
<li>
<a href="#plus.maps.Point">Point</a>: Point对象用于表示地图元素的坐标</li>
<li>
<a href="#plus.maps.Bounds">Bounds</a>: 地理区域</li>
<li>
<a href="#plus.maps.MapType">MapType</a>: 地图视图类型</li>
<li>
<a href="#plus.maps.Overlay">Overlay</a>: 地图覆盖物基类对象</li>
<li>
<a href="#plus.maps.Marker">Marker</a>: 地图上显示的标点对象</li>
<li>
<a href="#plus.maps.Bubble">Bubble</a>: 地图上显示的气泡对象</li>
<li>
<a href="#plus.maps.Circle">Circle</a>: 地图上显示的圆圈对象</li>
<li>
<a href="#plus.maps.Polyline">Polyline</a>: 地图上显示的折线对象</li>
<li>
<a href="#plus.maps.Polygon">Polygon</a>: 地图上显示的多边形对象</li>
<li>
<a href="#plus.maps.Search">Search</a>: 地图检索对象</li>
<li>
<a href="#plus.maps.SearchPolicy">SearchPolicy</a>: 检索策略类型</li>
<li>
<a href="#plus.maps.SearchPoiResult">SearchPoiResult</a>: 保存位置检索、周边检索和范围检索返回的结果</li>
<li>
<a href="#plus.maps.SearchRouteResult">SearchRouteResult</a>: 保存位置检索、周边检索和范围检索返回的结果</li>
<li>
<a href="#plus.maps.Position">Position</a>: 检索结果的位置点</li>
<li>
<a href="#plus.maps.Route">Route</a>: 地图中的路线对象</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.maps.GeocodeCallback">GeocodeCallback</a>: 地理编码转换成功的回调函数</li>
<li>
<a href="#plus.maps.CoordinateConvertCallback">CoordinateConvertCallback</a>: 坐标转换成功的回调函数</li>
<li>
<a href="#plus.maps.DistanceCalculateCallback">DistanceCalculateCallback</a>: 距离计算成功的回调函数</li>
<li>
<a href="#plus.maps.AreaCalculateCallback">AreaCalculateCallback</a>: 地理区域面积计算成功的回调函数</li>
<li>
<a href="#plus.maps.UserLocationCallback">UserLocationCallback</a>: 获取用户当前位置信息成功回调</li>
<li>
<a href="#plus.maps.ClickEventHandler">ClickEventHandler</a>: 用户点击地图回调事件</li>
<li>
<a href="#plus.maps.StatusChangedEventHandler">StatusChangedEventHandler</a>: 地图状态变化回调事件</li>
<li>
<a href="#plus.maps.OverlayClickEventHandler">OverlayClickEventHandler</a>: 用户点击地图覆盖物回调事件</li>
<li>
<a href="#plus.maps.OverlayDragEventHandler">OverlayDragEventHandler</a>: 用户拖拽覆盖物回调事件</li>
<li>
<a href="#plus.maps.PoiSearchCallback">PoiSearchCallback</a>: 兴趣点检索完成事件</li>
<li>
<a href="#plus.maps.RouteSearchCallback">RouteSearchCallback</a>: 线路检索完成事件</li>
<li>
<a href="#plus.maps.SuccessCallback">SuccessCallback</a>: 地图操作成功回调函数</li>
<li>
<a href="#plus.maps.ErrorCallback">ErrorCallback</a>: 地图操作失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Maps": {
"description": "地图"
}
}
}
</pre>
<h1><a name="plus.maps.Map">Map</a></h1>
<p>地图控件对象</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Map.Map(id,options)">Map(id,options)</a>: 创建Map对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Map.geocode">geocode</a>: 静态方法,地理编码</li>
<li>
<a href="#plus.maps.Map.reverseGeocode">reverseGeocode</a>: 静态方法,反向地理编码</li>
<li>
<a href="#plus.maps.Map.convertCoordinates">convertCoordinates</a>: 静态方法,坐标转换</li>
<li>
<a href="#plus.maps.Map.calculateDistance">calculateDistance</a>: 静态方法,计算距离</li>
<li>
<a href="#plus.maps.Map.calculateArea">calculateArea</a>: 静态方法,计算面积</li>
<li>
<a href="#plus.maps.Map.centerAndZoom">centerAndZoom</a>: 设置地图初始中心点和缩放级别</li>
<li>
<a href="#plus.maps.Map.setCenter">setCenter</a>: 设置地图的中心点</li>
<li>
<a href="#plus.maps.Map.getCenter">getCenter</a>: 获取地图中心点</li>
<li>
<a href="#plus.maps.Map.setZoom">setZoom</a>: 设置地图的缩放级别</li>
<li>
<a href="#plus.maps.Map.getZoom">getZoom</a>: 获取地图的缩放级别</li>
<li>
<a href="#plus.maps.Map.reset">reset</a>: 重置地图</li>
<li>
<a href="#plus.maps.Map.resize">resize</a>: 重设地图控件大小</li>
<li>
<a href="#plus.maps.Map.setMapType">setMapType</a>: 设置地图的视图类型</li>
<li>
<a href="#plus.maps.Map.getMapType">getMapType</a>: 获取地图的显示类型</li>
<li>
<a href="#plus.maps.Map.setTraffic">setTraffic</a>: 是否打开地图交通信息图层</li>
<li>
<a href="#plus.maps.Map.isTraffic">isTraffic</a>: 获取是否打开地图交通信息图层</li>
<li>
<a href="#plus.maps.Map.showUserLocation">showUserLocation</a>: 显示用户位置</li>
<li>
<a href="#plus.maps.Map.isShowUserLocation">isShowUserLocation</a>: 获取是否显示用户位置</li>
<li>
<a href="#plus.maps.Map.showZoomControls">showZoomControls</a>: 设置是否显示地图内置缩放控件</li>
<li>
<a href="#plus.maps.Map.isShowZoomControls">isShowZoomControls</a>: 获取是否显示地图内置缩放控件</li>
<li>
<a href="#plus.maps.Map.addOverlay">addOverlay</a>: 向地图中添加覆盖物</li>
<li>
<a href="#plus.maps.Map.removeOverlay">removeOverlay</a>: 从地图中删除覆盖物对象</li>
<li>
<a href="#plus.maps.Map.clearOverlays">clearOverlays</a>: 清除地图中所有覆盖物对象</li>
<li>
<a href="#plus.maps.Map.getUserLocation">getUserLocation</a>: 获取用户的当前位置信息</li>
<li>
<a href="#plus.maps.Map.getCurrentCenter">getCurrentCenter</a>: 获取当前地图显示的地图中心点位置</li>
<li>
<a href="#plus.maps.Map.getBounds">getBounds</a>: 获取当前地图可视范围的地理区域</li>
<li>
<a href="#plus.maps.Map.show">show</a>: 显示地图控件</li>
<li>
<a href="#plus.maps.Map.hide">hide</a>: 隐藏地图控件</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.maps.Map.onclick">onclick</a>: 用户点击地图事件</li>
<li>
<a href="#plus.maps.Map.onstatuschanged">onstatuschanged</a>: 地图状态改变事件</li>
</ul>
<h1><a name="plus.maps.MapOptions">MapOptions</a></h1>
<p>地图对象的参数</p>
<h2>说明:</h2>
<p class="des">
设置地图对象初始化显示时使用的属性参数。
</p>
<h2>属性:</h2>
<ul>
<li>center: <em>(<a href="#plus.maps.Point">Point</a>
类型
)</em>地图的中心位置<br><p>
未设置则使用地图的默认中心点(由地图供应商确定)。
</p>
</li>
<li>zoom: <em>(<font class="type">Number</font>
类型
)</em>地图的缩放级别<br><p>
有效范围为1-22,默认值为12,设置无效的值则使用默认值。
</p>
</li>
<li>type: <em>(<a href="#plus.maps.MapType">MapType</a>
类型
)</em>地图的视图类型<br><p>
可设置普通街道视图、卫星视图,默认值为普通街道视图。
</p>
</li>
<li>traffic: <em>(<font class="type">Boolean</font>
类型
)</em>地图的是否显示交通信息<br><p>
true表示显示地图的交通信息图层,false则不显示,默认值为false。
</p>
</li>
<li>zoomControls: <em>(<font class="type">Boolean</font>
类型
)</em>是否显示地图的内置缩放控件<br><p>
true表示显示地图的内置缩放控件,false则不显示,默认值为false。
</p>
</li>
<li>position: <em>(<font class="type">String</font>
类型
)</em>地图控件在Webview窗口的布局模式<br><p>
可取值:
"static" - 地图控件在页面中正常布局模式,如果页面存在滚动条则随窗口内容滚动;
"absolute" - 地图控件在页面中绝对布局模式,如果页面存在滚动条不随窗口内容滚动;
默认值为"static"。
注意:布局模式并不影响地图控件在窗口中的位置及大小,如果构造时传入的DOM元素位置及大小发生变化,可通过resize方法更新。
</p>
</li>
</ul>
<h1><a name="plus.maps.GeocodeOptions">GeocodeOptions</a></h1>
<p>地理编码转换的参数</p>
<h2>属性:</h2>
<ul>
<li>coordType: <em>(<font class="type">String</font>
类型
)</em>源数据的坐标系类型<br><p>
仅在反向地理编码转换时生效。
“wgs84”:表示WGS-84坐标系; “gcj02”:表示国测局经纬度坐标系; “bd09”:表示百度墨卡托坐标系; “bd09ll”:表示百度经纬度坐标系;
默认使用wgs84坐标系。
</p>
</li>
<li>city: <em>(<font class="type">String</font>
类型
)</em>源地址所属的城市<br><p>
仅在地理编码转换时生效,如果不指定则在全国范围内区配转换。
</p>
</li>
</ul>
<h1><a name="plus.maps.CoordinateConvertOptions">CoordinateConvertOptions</a></h1>
<p>地图坐标转换的参数</p>
<h2>属性:</h2>
<ul><li>coordType: <em>(<font class="type">String</font>
类型
)</em>源数据的坐标系类型<br><p>
“wgs84”:表示WGS-84坐标系; “gcj02”:表示国测局经纬度坐标系; “bd09”:表示百度墨卡托坐标系; “bd09ll”:表示百度经纬度坐标系;
默认使用wgs84坐标系。
</p>
</li></ul>
<h1><a name="plus.maps.Point">Point</a></h1>
<p>Point对象用于表示地图元素的坐标</p>
<h2>说明:</h2>
<p class="des">常用语对地图上元素进行定位时使用。</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Point.Point(lng,lat)">Point(lng,lat)</a>: 创建Point对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Point.setLng">setLng</a>: 设置坐标点的经度</li>
<li>
<a href="#plus.maps.Point.getLng">getLng</a>: 获取坐标的经度</li>
<li>
<a href="#plus.maps.Point.setLat">setLat</a>: 设置坐标的纬度</li>
<li>
<a href="#plus.maps.Point.getLat">getLat</a>: 获取坐标的纬度</li>
<li>
<a href="#plus.maps.Point.equals">equals</a>: 判断两个坐标点是否相等</li>
</ul>
<h1><a name="plus.maps.Bounds">Bounds</a></h1>
<p>地理区域</p>
<h2>说明:</h2>
<p class="des">
有西南及东北坐标点数据组成的矩形区域。
</p>
<h2>构造:</h2>
<ul>
<li>
<a href="#plus.maps.Bounds.Bounds(northease,southwest)">Bounds(northease,southwest)</a>: 创建Bounds对象</li>
<li>
<a href="#plus.maps.Bounds.Bounds(nelng,nelat,swlng,swlat)">Bounds(nelng,nelat,swlng,swlat)</a>: 创建Bounds对象</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Bounds.setNorthEase">setNorthEase</a>: 设置地理区域的东北坐标点</li>
<li>
<a href="#plus.maps.Bounds.getNorthEase">getNorthEase</a>: 地理区域的东北坐标点</li>
<li>
<a href="#plus.maps.Bounds.setSouthWest">setSouthWest</a>: 设置地理区域的西南坐标点</li>
<li>
<a href="#plus.maps.Bounds.getSouthWest">getSouthWest</a>: 地理区域的西南坐标点</li>
<li>
<a href="#plus.maps.Bounds.contains">contains</a>: 判断制定的坐标是否在地理区域中</li>
<li>
<a href="#plus.maps.Bounds.equals">equals</a>: 判断两个地理区域是否相等</li>
<li>
<a href="#plus.maps.Bounds.getCenter">getCenter</a>: 获取地理区域的中心点坐标</li>
</ul>
<h1><a name="plus.maps.MapType">MapType</a></h1>
<p>地图视图类型</p>
<h2>常量:</h2>
<ul>
<li>MAPTYPE_NORMAL: <em>(<font class="type">Number</font>
类型
)</em>普通街道视图类型<br><p>地图视图类型常量,普通街道视图。</p>
</li>
<li>MAPTYPE_SATELLITE: <em>(<font class="type">Number</font>
类型
)</em>卫星视图<br><p>地图视图类型常量,卫星视图。</p>
</li>
</ul>
<h1><a name="plus.maps.Overlay">Overlay</a></h1>
<p>地图覆盖物基类对象</p>
<pre class="prettyprint linenums">
interface Overlay {
function Boolean isVisible();
function void show();
function void hide();
}
</pre>
<h2>说明:</h2>
<p class="des">
Overlay是地图上显示元素的基类,用于抽象地图元素,不用于实例化。
</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Overlay.isVisible">isVisible</a>: 判断地图覆盖物是否可见</li>
<li>
<a href="#plus.maps.Overlay.show">show</a>: 显示地图上的覆盖物</li>
<li>
<a href="#plus.maps.Overlay.hide">hide</a>: 隐藏地图上的覆盖物</li>
</ul>
<h1><a name="plus.maps.Marker">Marker</a></h1>
<p>地图上显示的标点对象</p>
<h2>说明:</h2>
<p class="des">从Overlay对象继承而来,可通过Map对象的addOverlay()方法将对象添加地图中。</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Marker.Marker(%20point%20)">Marker( point )</a>: 创建地图标点Marker对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Marker.bringToTop">bringToTop</a>: 覆盖物显示到最上层</li>
<li>
<a href="#plus.maps.Marker.setPoint">setPoint</a>: 设置标点对象的坐标</li>
<li>
<a href="#plus.maps.Marker.getPoint">getPoint</a>: 获取标点的坐标</li>
<li>
<a href="#plus.maps.Marker.setIcon">setIcon</a>: 设置标点上显示的图标</li>
<li>
<a href="#plus.maps.Marker.setIcons">setIcons</a>: 设置标点上显示的图标数组</li>
<li>
<a href="#plus.maps.Marker.setLabel">setLabel</a>: 设置标点上显示的文本标注</li>
<li>
<a href="#plus.maps.Marker.getLabel">getLabel</a>: 获取标点上显示的文本标注</li>
<li>
<a href="#plus.maps.Marker.setBubble">setBubble</a>: 设置标点的气泡内容</li>
<li>
<a href="#plus.maps.Marker.getBubble">getBubble</a>: 获取标点上显示的文本标注</li>
<li>
<a href="#plus.maps.Marker.hideBubble">hideBubble</a>: 隐藏标点上显示的气泡</li>
<li>
<a href="#plus.maps.Marker.setDraggable">setDraggable</a>: 设置标点的是否允许拖拽</li>
<li>
<a href="#plus.maps.Marker.isDraggable">isDraggable</a>: 获取标点是否允许拖拽</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.maps.Marker.onclick">onclick</a>: 用户点击地图标点事件</li>
<li>
<a href="#plus.maps.Marker.onDrag">onDrag</a>: 用户拖拽标点事件</li>
</ul>
<h1><a name="plus.maps.Bubble">Bubble</a></h1>
<p>地图上显示的气泡对象</p>
<h2>说明:</h2>
<p class="des">
此对象不能直接添加到地图上显示,只可关联到地图标点覆盖物上,用户点击标点时弹出显示。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Bubble.Bubble(%20label%20)">Bubble( label )</a>: 创建气泡对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Bubble.setIcon">setIcon</a>: 设置气泡上显示的图标</li>
<li>
<a href="#plus.maps.Bubble.setLabel">setLabel</a>: 设置气泡上显示的文字内容</li>
<li>
<a href="#plus.maps.Bubble.getLabel">getLabel</a>: 获取气泡上显示的文字内容</li>
<li>
<a href="#plus.maps.Bubble.belongMarker">belongMarker</a>: 获取气泡所属的标点对象</li>
<li>
<a href="#plus.maps.Bubble.loadImage">loadImage</a>: 从图片加载气泡显示的内容</li>
<li>
<a href="#plus.maps.Bubble.loadImageDataURL">loadImageDataURL</a>: 从图片数据加载气泡显示的内容</li>
</ul>
<h2>事件:</h2>
<ul><li>
<a href="#plus.maps.Bubble.onclick">onclick</a>: 用户点击气泡事件</li></ul>
<h1><a name="plus.maps.Circle">Circle</a></h1>
<p>地图上显示的圆圈对象</p>
<h2>说明:</h2>
<p class="des">从Overlay对象继承而来,可通过Map对象的addOverlay()方法将对象添加地图中。</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Circle.Circle(%20center,%20radius%20)">Circle( center, radius )</a>: 创建Circle对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Circle.setCenter">setCenter</a>: 设置圆圈中心点的经纬度坐标</li>
<li>
<a href="#plus.maps.Circle.getCenter">getCenter</a>: 获取圆圈中心点的坐标</li>
<li>
<a href="#plus.maps.Circle.setRadius">setRadius</a>: 设置圆圈的半径,单位为米</li>
<li>
<a href="#plus.maps.Circle.getRadius">getRadius</a>: 获取圆圈的半径</li>
<li>
<a href="#plus.maps.Circle.setStrokeColor">setStrokeColor</a>: 设置圆圈的边框颜色</li>
<li>
<a href="#plus.maps.Circle.getStrokeColor">getStrokeColor</a>: 获取圆圈的边框颜色</li>
<li>
<a href="#plus.maps.Circle.setStrokeOpacity">setStrokeOpacity</a>: 设置圆圈的边框颜色</li>
<li>
<a href="#plus.maps.Circle.getStrokeOpacity">getStrokeOpacity</a>: 获取圆圈边框的透明度</li>
<li>
<a href="#plus.maps.Circle.setFillColor">setFillColor</a>: 设置圆圈的填充颜色</li>
<li>
<a href="#plus.maps.Circle.getFillColor">getFillColor</a>: 获取圆圈的填充颜色</li>
<li>
<a href="#plus.maps.Circle.setFillOpacity">setFillOpacity</a>: 设置圆圈填充颜色的透明度</li>
<li>
<a href="#plus.maps.Circle.getFillOpacity">getFillOpacity</a>: 获取圆圈填充色的透明度</li>
<li>
<a href="#plus.maps.Circle.setLineWidth">setLineWidth</a>: 设置圆圈边框的线条宽度</li>
<li>
<a href="#plus.maps.Circle.getLineWidth">getLineWidth</a>: 获取圆圈边框的线条宽度</li>
</ul>
<h1><a name="plus.maps.Polyline">Polyline</a></h1>
<p>地图上显示的折线对象</p>
<h2>说明:</h2>
<p class="des">从Overlay对象继承而来,可通过Map对象的addOverlay()方法将对象添加地图中。</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Polyline.Polyline(%20points%20)">Polyline( points )</a>: 创建Polyline对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Polyline.setPath">setPath</a>: 设置折线的顶点坐标</li>
<li>
<a href="#plus.maps.Polyline.getPath">getPath</a>: 获取折线的顶点坐标</li>
<li>
<a href="#plus.maps.Polyline.setStrokeColor">setStrokeColor</a>: 设置折线的颜色</li>
<li>
<a href="#plus.maps.Polyline.getStrokeColor">getStrokeColor</a>: 获取折线的颜色</li>
<li>
<a href="#plus.maps.Polyline.setStrokeOpacity">setStrokeOpacity</a>: 设设置折线的透明度</li>
<li>
<a href="#plus.maps.Polyline.getStrokeOpacity">getStrokeOpacity</a>: 获取折线的透明度</li>
<li>
<a href="#plus.maps.Polyline.setLineWidth">setLineWidth</a>: 设置折线的线条宽度</li>
<li>
<a href="#plus.maps.Polyline.getLineWidth">getLineWidth</a>: 获取折线的线条宽度</li>
</ul>
<h1><a name="plus.maps.Polygon">Polygon</a></h1>
<p>地图上显示的多边形对象</p>
<h2>说明:</h2>
<p class="des">从Overlay对象继承而来,可通过Map对象的addOverlay()方法将对象添加地图中。</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Polygon.Polygon(%20points%20)">Polygon( points )</a>: 创建Polygon对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Polygon.setPath">setPath</a>: 设置多边形的顶点坐标</li>
<li>
<a href="#plus.maps.Polygon.getPath">getPath</a>: 获取多边形的顶点坐标</li>
<li>
<a href="#plus.maps.Polygon.setStrokeColor">setStrokeColor</a>: 设置多边形的颜色</li>
<li>
<a href="#plus.maps.Polygon.getStrokeColor">getStrokeColor</a>: 获取多边形边框的颜色</li>
<li>
<a href="#plus.maps.Polygon.setStrokeOpacity">setStrokeOpacity</a>: 设置多边形的透明度</li>
<li>
<a href="#plus.maps.Polygon.getStrokeOpacity">getStrokeOpacity</a>: 获取多边形边框的透明度</li>
<li>
<a href="#plus.maps.Polygon.setFillColor">setFillColor</a>: 设置多边形的填充颜色</li>
<li>
<a href="#plus.maps.Polygon.getFillColor">getFillColor</a>: 获取多边形的填充色</li>
<li>
<a href="#plus.maps.Polygon.setFillOpacity">setFillOpacity</a>: 设置多边形填充色的透明度</li>
<li>
<a href="#plus.maps.Polygon.getFillOpacity">getFillOpacity</a>: 获取多边形填充色的透明度</li>
<li>
<a href="#plus.maps.Polygon.setLineWidth">setLineWidth</a>: 设置多边形的边框宽度</li>
<li>
<a href="#plus.maps.Polygon.getLineWidth">getLineWidth</a>: 获取多边形边框的宽度</li>
</ul>
<h1><a name="plus.maps.Search">Search</a></h1>
<p>地图检索对象</p>
<h2>说明:</h2>
<p class="des">
Search对象用于管理地图上的检索功能,包括位置检索、周边检索和范围检索。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Search.Search(%20map%20)">Search( map )</a>: 创建Search对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.maps.Search.setPageCapacity">setPageCapacity</a>: 设置检索返回结果每页的信息数目</li>
<li>
<a href="#plus.maps.Search.getPageCapacity">getPageCapacity</a>: 获取检索返回结果每页的信息数目</li>
<li>
<a href="#plus.maps.Search.poiSearchInCity">poiSearchInCity</a>: 城市兴趣点检索</li>
<li>
<a href="#plus.maps.Search.poiSearchNearBy">poiSearchNearBy</a>: 周边检索</li>
<li>
<a href="#plus.maps.Search.poiSearchInbounds">poiSearchInbounds</a>: 指定范围检索</li>
<li>
<a href="#plus.maps.Search.setTransitPolicy">setTransitPolicy</a>: 设置公交路线检索策略</li>
<li>
<a href="#plus.maps.Search.transitSearch">transitSearch</a>: 公交路线检索</li>
<li>
<a href="#plus.maps.Search.setDrivingPolicy">setDrivingPolicy</a>: 设置驾车路线检索策略</li>
<li>
<a href="#plus.maps.Search.drivingSearch">drivingSearch</a>: 驾车路线检索</li>
<li>
<a href="#plus.maps.Search.walkingSearch">walkingSearch</a>: 步行路线检索</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.maps.Search.onPoiSearchComplete">onPoiSearchComplete</a>: 兴趣点检索完成事件</li>
<li>
<a href="#plus.maps.Search.onRouteSearchComplete">onRouteSearchComplete</a>: 线路检索完成事件</li>
</ul>
<h1><a name="plus.maps.SearchPolicy">SearchPolicy</a></h1>
<p>检索策略类型</p>
<h2>说明:</h2>
<p class="des">在线路检索时设置检索策略时使用。</p>
<h2>常量:</h2>
<ul>
<li>TRANSIT_TIME_FIRST: <em>(<font class="type">Number</font>
类型
)</em>时间优先<br><p>检索策略类型常量,用于公交检索策略</p>
</li>
<li>TRANSIT_TRANSFER_FIRST: <em>(<font class="type">Number</font>
类型
)</em>最少换乘优先<br><p>检索策略类型常量,用于公交检索策略</p>
</li>
<li>TRANSIT_WALK_FIRST: <em>(<font class="type">Number</font>
类型
)</em>最少步行距离优先<br><p>检索策略类型常量,用于公交检索策略</p>
</li>
<li>TRANSIT_FEE_FIRST: <em>(<font class="type">Number</font>
类型
)</em>选择车票花销最少优先<br><p>检索策略类型常量,用于公交检索策略</p>
</li>
<li>DRIVING_DIS_FIRST: <em>(<font class="type">Number</font>
类型
)</em>最短距离优先<br><p>检索策略类型常量,用于驾车检索策略</p>
</li>
<li>DRIVING_NO_EXPRESSWAY: <em>(<font class="type">Number</font>
类型
)</em>无高速公路线路<br><p>检索策略类型常量,用于驾车检索策略</p>
</li>
<li>DRIVING_FEE_FIRST: <em>(<font class="type">Number</font>
类型
)</em>最少费用优先<br><p>检索策略类型常量,用于驾车检索策略</p>
</li>
</ul>
<h1><a name="plus.maps.SearchPoiResult">SearchPoiResult</a></h1>
<p>保存位置检索、周边检索和范围检索返回的结果</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.maps.SearchPoiResult.totalNumber">totalNumber</a>: POI检索总结果数</li>
<li>
<a href="#plus.maps.SearchPoiResult.currentNumber">currentNumber</a>: 当前页的POI检索结果数</li>
<li>
<a href="#plus.maps.SearchPoiResult.pageNumber">pageNumber</a>: 本次POI检索的总页数</li>
<li>
<a href="#plus.maps.SearchPoiResult.pageIndex">pageIndex</a>: 获取当前页的索引</li>
<li>
<a href="#plus.maps.SearchPoiResult.poiList">poiList</a>: 本次POI检索结果数组</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.maps.SearchPoiResult.getPosition">getPosition</a>: 获取指定索引的检索结果</li></ul>
<h1><a name="plus.maps.SearchRouteResult">SearchRouteResult</a></h1>
<p>保存位置检索、周边检索和范围检索返回的结果</p>
<h2>说明:</h2>
<p class="des">
不可通过new操作符创建SearchRouteResult对象,在触发onRouteSearchComplete()时自动创建。
</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.maps.SearchRouteResult.startPosition">startPosition</a>: 线路的起点位置</li>
<li>
<a href="#plus.maps.SearchRouteResult.endPosition">endPosition</a>: 线路的终点位置</li>
<li>
<a href="#plus.maps.SearchRouteResult.routeNumber">routeNumber</a>: 本次线路检索的总方案数</li>
<li>
<a href="#plus.maps.SearchRouteResult.routeList">routeList</a>: 线路检索结果数组</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.maps.SearchRouteResult.getRoute">getRoute</a>: 获取指定索引的线路方案</li></ul>
<h1><a name="plus.maps.Position">Position</a></h1>
<p>检索结果的位置点</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Position.Position(%20point%20)">Position( point )</a>: 创建Position对象</li></ul>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.maps.Position.point">point</a>: 位置点的经纬度坐标</li>
<li>
<a href="#plus.maps.Position.address">address</a>: 位置点的地址信息</li>
<li>
<a href="#plus.maps.Position.city">city</a>: 位置点的所属城市信息</li>
<li>
<a href="#plus.maps.Position.name">name</a>: 位置点的名称</li>
<li>
<a href="#plus.maps.Position.phone">phone</a>: 位置点的电话信息</li>
<li>
<a href="#plus.maps.Position.postcode">postcode</a>: 位置点的邮编信息</li>
</ul>
<h1><a name="plus.maps.Route">Route</a></h1>
<p>地图中的路线对象</p>
<h2>说明:</h2>
<p class="des">
从Overlay对象继承而来,可通过Map对象的addOverlay()方法将对象添加地图中。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.maps.Route.Route(%20ptStart,%20ptEnd%20)">Route( ptStart, ptEnd )</a>: 创建Route对象</li></ul>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.maps.Route.startPoint">startPoint</a>: 路线起点地理坐标点</li>
<li>
<a href="#plus.maps.Route.endPoint">endPoint</a>: 路线终点地理坐标点</li>
<li>
<a href="#plus.maps.Route.pointCount">pointCount</a>: 路线坐标点段数</li>
<li>
<a href="#plus.maps.Route.pointList">pointList</a>: 路线的地理坐标点数组</li>
<li>
<a href="#plus.maps.Route.distance">distance</a>: 路线总距离</li>
<li>
<a href="#plus.maps.Route.routeTip">routeTip</a>: 线路的提示信息</li>
</ul>
<h1><a name="plus.maps.GeocodeCallback">GeocodeCallback</a></h1>
<p>地理编码转换成功的回调函数</p>
<pre class="prettyprint linenums">
void onGeocodeSuccess( Event event ) {
// JS code.
var address = event.address; // 转换后的地理位置
var point = event.coord; // 转换后的坐标信息
var coordType = event.coordType; // 转换后的坐标系类型
}
</pre>
<h2>说明:</h2>
<p class="des">
在地理编码转换成功触发,并返回转换结果。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>转换后的坐标信息<br>
可通过event.coord(Point类型)获取转换后的坐标值。
可通过event.coordType(String类型)获取转换后的坐标系类型,“wgs84”:表示WGS-84坐标系; “gcj02”:表示国测局经纬度坐标系; “bd09”:表示百度墨卡托坐标系; “bd09ll”:表示百度经纬度坐标系。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.CoordinateConvertCallback">CoordinateConvertCallback</a></h1>
<p>坐标转换成功的回调函数</p>
<pre class="prettyprint linenums">
void onConvertSuccess( Event event ) {
// JS code.
var point = event.coord; // 转换后的坐标值
var coordType = event.coordType; // 转换后的坐标系类型
}
</pre>
<h2>说明:</h2>
<p class="des">
在坐标转换成功触发,并返回转换结果。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>转换后的坐标信息<br>
可通过event.coord(Point类型)获取转换后的坐标值。
可通过event.coordType(String类型)获取转换后的坐标系类型,“wgs84”:表示WGS-84坐标系; “gcj02”:表示国测局经纬度坐标系; “bd09”:表示百度墨卡托坐标系; “bd09ll”:表示百度经纬度坐标系。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.DistanceCalculateCallback">DistanceCalculateCallback</a></h1>
<p>距离计算成功的回调函数</p>
<pre class="prettyprint linenums">
void onCalculateSuccess( Event event ) {
// JS code.
var distance = event.distance; // 转换后的距离值
}
</pre>
<h2>说明:</h2>
<p class="des">
在距离计算成功触发,并返回计算结果。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>距离计算后的信息<br>
可通过event.distance(Number类型)获取计算后的距离值,单位为米(m)。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.AreaCalculateCallback">AreaCalculateCallback</a></h1>
<p>地理区域面积计算成功的回调函数</p>
<pre class="prettyprint linenums">
void onCalculateSuccess( Event event ) {
// JS code.
var area = event.area; // 计算后的面积值
}
</pre>
<h2>说明:</h2>
<p class="des">
在地理区域面积计算成功触发,并返回计算结果。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>地理区域面积计算后的信息<br>
可通过event.area(Number类型)获取计算后的面积值,单位为平方米。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.UserLocationCallback">UserLocationCallback</a></h1>
<p>获取用户当前位置信息成功回调</p>
<pre class="prettyprint linenums">
void onSuccess( state, point ) {
// Get location code
}
</pre>
<h2>参数:</h2>
<ul>
<li>state:
<em>(
<font class="type">Number</font>
)
必选 </em>获取用户位置操作状态码,0表示成功,其它为错误码<br>
</li>
<li>point:
<em>(
<a href="#plus.maps.Point">Point</a>
)
必选 </em>位置经纬度坐标,如果获取操作失败则为null对象<br>
</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.ClickEventHandler">ClickEventHandler</a></h1>
<p>用户点击地图回调事件</p>
<pre class="prettyprint linenums">
void onClick( point ) {
// Click code
}
</pre>
<h2>参数:</h2>
<ul><li>point:
<em>(
<a href="#plus.maps.Point">Point</a>
)
必选 </em>用户在地图上点击的坐标点<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.StatusChangedEventHandler">StatusChangedEventHandler</a></h1>
<p>地图状态变化回调事件</p>
<pre class="prettyprint linenums">
void onStatusChanged( event ) {
// Click code
var target = event.target; // 状态变化的地图对象(plus.maps.Map)
var bounds = event.bounds; // 地图的可视地理区域(plus.maps.Bounds)
var center = event.center; // 地图的中心点坐标(plus.maps.Point)
var zoom = event.zoom; // 地图的缩放级别(Number)
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>地图状态变化对象<br>
可通过event.target(plus.maps.Map类型)获取状态变化的地图对象;
可通过event.bounds(plus.maps.Bounds类型)获取地图当前的可视区域;
可通过event.center(plus.maps.Point类型)获取地图当前的中心点坐标;
可通过event.zoom(Number类型)获取地图当前的缩放级别。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.OverlayClickEventHandler">OverlayClickEventHandler</a></h1>
<p>用户点击地图覆盖物回调事件</p>
<pre class="prettyprint linenums">
void onClick( overlay ) {
// Click code
}
</pre>
<h2>参数:</h2>
<ul><li>overlay:
<em>(
<a href="#plus.maps.Overlay">Overlay</a>
)
必选 </em>用户在地图上点击的覆盖物对象<br>
overlay可以是Marker、Bubble、Circle、Polyline、Polygon对象的引用。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.OverlayDragEventHandler">OverlayDragEventHandler</a></h1>
<p>用户拖拽覆盖物回调事件</p>
<pre class="prettyprint linenums">
void onDrag( target ) {
// Click code
var marker = target; // 拖拽的覆盖物对象
}
</pre>
<h2>参数:</h2>
<ul><li>target:
<em>(
<font class="type">Event</font>
)
必选 </em>拖拽事件对象<br>
可通过target(Overlay类型)获取拖拽的覆盖物对象,target可以是Marker、Bubble、Circle、Polyline、Polygon对象的引用。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.PoiSearchCallback">PoiSearchCallback</a></h1>
<p>兴趣点检索完成事件</p>
<pre class="prettyprint linenums">
void onPoiSearchComplete( state, result ) {
// JS code.
}
</pre>
<h2>说明:</h2>
<p class="des">
在兴趣点检索完成时触发,并返回检索结果。
</p>
<h2>参数:</h2>
<ul>
<li>state:
<em>(
<font class="type">Number</font>
)
必选 </em>检索结果状态号<br>0表示检索正确并返回结果,其它表示检索错误。</li>
<li>result:
<em>(
<a href="#plus.maps.SearchPoiResult">SearchPoiResult</a>
)
必选 </em>POI检索结果<br>若检索错误,则为null对象。</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.RouteSearchCallback">RouteSearchCallback</a></h1>
<p>线路检索完成事件</p>
<pre class="prettyprint linenums">
void onRouteSearchComplete( state, result ) {
// JS code.
}
</pre>
<h2>说明:</h2>
<p class="des">
在线路检索完成时触发,并返回检索结果。
</p>
<h2>参数:</h2>
<ul>
<li>state:
<em>(
<font class="type">Number</font>
)
必选 </em>检索结果状态号<br>0表示检索正确并返回结果,其它表示检索错误。</li>
<li>result:
<em>(
<a href="#plus.maps.SearchRouteResult">SearchRouteResult</a>
)
必选 </em>线路检索结果<br>若检索错误,则为null对象。</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.SuccessCallback">SuccessCallback</a></h1>
<p>地图操作成功回调函数</p>
<pre class="prettyprint linenums">
void onSuccess(){
// Success code.
}
</pre>
<h2>说明:</h2>
<p class="des">
地图操作成功后触发回调函数。
</p>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.maps.ErrorCallback">ErrorCallback</a></h1>
<p>地图操作失败的回调函数</p>
<pre class="prettyprint linenums">
function void onError( error ) {
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>地图操作的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+114
View File
@@ -0,0 +1,114 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.messaging">messaging</a></h1>
<p>Messaging模块管理设备通讯功能,可用于短信、彩信、邮件发送等。通过plus.messaging可获取设备通讯管理对象。另外也可以直接通过html中的href直接快速发送短信、拨打电话、发送邮件等。</p>
<h2>常量:</h2>
<ul>
<li>
<a href="#plus.messaging.TYPE_SMS">TYPE_SMS</a>: 简单短信类型常量</li>
<li>
<a href="#plus.messaging.TYPE_MMS">TYPE_MMS</a>: 彩信类型常量</li>
<li>
<a href="#plus.messaging.TYPE_EMAIL">TYPE_EMAIL</a>: 邮件类型常量</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.messaging.createMessage">createMessage</a>: 创建消息对象</li>
<li>
<a href="#plus.messaging.sendMessage">sendMessage</a>: 发送消息</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.messaging.Message">Message</a>: 消息对象</li>
<li>
<a href="#plus.messaging.BodyType">BodyType</a>: 消息体内容类型</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.messaging.MessageSendSuccessCallback">MessageSendSuccessCallback</a>: 消息发送成功的回调函数</li>
<li>
<a href="#plus.messaging.MessageErrorCallback">MessageErrorCallback</a>: 消息发送失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Messaging": {
"description": "短信彩信邮件消息"
}
}
}
</pre>
<h1><a name="plus.messaging.Message">Message</a></h1>
<p>消息对象</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.messaging.Message.to">to</a>: 收件人信息</li>
<li>
<a href="#plus.messaging.Message.cc">cc</a>: 抄送人信息</li>
<li>
<a href="#plus.messaging.Message.bcc">bcc</a>: 暗送人信息</li>
<li>
<a href="#plus.messaging.Message.subject">subject</a>: 发送消息主题</li>
<li>
<a href="#plus.messaging.Message.body">body</a>: 发送消息内容</li>
<li>
<a href="#plus.messaging.Message.bodyType">bodyType</a>: 发送消息内容类型</li>
<li>
<a href="#plus.messaging.Message.silent">silent</a>: 是否采用静默方式发送消息</li>
</ul>
<h2>方法:</h2>
<ul><li>
<a href="#plus.messaging.Message.addAttachment">addAttachment</a>: 添加附件</li></ul>
<h1><a name="plus.messaging.BodyType">BodyType</a></h1>
<p>消息体内容类型</p>
<h2>说明:</h2>
<p class="des">用于设定消息的消息体内容。</p>
<h1><a name="plus.messaging.MessageSendSuccessCallback">MessageSendSuccessCallback</a></h1>
<p>消息发送成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess() {
// Send message success code.
}
</pre>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.messaging.MessageErrorCallback">MessageErrorCallback</a></h1>
<p>消息发送失败的回调函数</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Error code.
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>失败信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+30
View File
@@ -0,0 +1,30 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script>
<script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body>
<div id="content" class="content">
<h1><a>Native.js</a></h1>
<p>Native.JS一种把操作系统的原生对象转义,映射为JS对象,在JS里编写原生代码的技术。可通过plus.android.*和plus.ios.*提供的API分别调用Android和iOS平台的Native API。</p>
<ul style="list-style:none;font-size:1.5em;margin:0;padding:0;text-align:center;">
<li style="padding:0.5em 0;">
<a href="ios.html">iOS</a>
</li>
<li style="padding:0.5em 0;">
<a href="android.html">Android</a>
</li>
<li style="padding:0.5em 0;">
<a onclick="plus.runtime.openURL('http://ask.dcloud.net.cn/article/88')">入门教程</a>
</li>
</ul>
</div>
</body>
</html>
+497
View File
@@ -0,0 +1,497 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.nativeUI">nativeUI</a></h1>
<p>nativeUI管理系统原生界面,可用于弹出系统原生提示对话框窗口、时间日期选择对话框、等待对话框等。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.nativeUI.actionSheet">actionSheet</a>: 弹出系统选择按钮框</li>
<li>
<a href="#plus.nativeUI.alert">alert</a>: 弹出系统提示对话框</li>
<li>
<a href="#plus.nativeUI.confirm">confirm</a>: 弹出系统确认对话框</li>
<li>
<a href="#plus.nativeUI.closeWaiting">closeWaiting</a>: 关闭系统等待对话框</li>
<li>
<a href="#plus.nativeUI.showWaiting">showWaiting</a>: 显示系统等待对话框</li>
<li>
<a href="#plus.nativeUI.pickDate">pickDate</a>: 弹出系统日期选择对话框</li>
<li>
<a href="#plus.nativeUI.pickTime">pickTime</a>: 弹出系统时间选择对话框</li>
<li>
<a href="#plus.nativeUI.prompt">prompt</a>: 弹出系统输入对话框</li>
<li>
<a href="#plus.nativeUI.toast">toast</a>: 显示自动消失的提示消息</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.nativeUI.ActionButtonStyles">ActionButtonStyles</a>: JSON对象,原生选择按钮框上按钮的样式参数</li>
<li>
<a href="#plus.nativeUI.ActionSheetStyles">ActionSheetStyles</a>: JSON对象,原生选择按钮框的样式参数</li>
<li>
<a href="#plus.nativeUI.PickDateOption">PickDateOption</a>: JSON对象,日期选择对话框的参数</li>
<li>
<a href="#plus.nativeUI.PickTimeOption">PickTimeOption</a>: JSON对象,时间选择对话框的参数</li>
<li>
<a href="#plus.nativeUI.NativeUIObj">NativeUIObj</a>: 系统原生界面基类对象</li>
<li>
<a href="#plus.nativeUI.WaitingObj">WaitingObj</a>: 系统等待对话框对象</li>
<li>
<a href="#plus.nativeUI.WaitingOptions">WaitingOptions</a>: JSON对象,原生等待对话框的参数</li>
<li>
<a href="#plus.nativeUI.WaitingLoadingOptions">WaitingLoadingOptions</a>: JSON对象,原生等待对话框上loading图标自定义样式</li>
<li>
<a href="#plus.nativeUI.ToastOptions">ToastOptions</a>: JSON对象,系统提示消息框要设置的参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.nativeUI.ActionSheetCallback">ActionSheetCallback</a>: 系统选择按钮框的回调函数</li>
<li>
<a href="#plus.nativeUI.AlertCallback">AlertCallback</a>: 系统提示框确认的回调函数</li>
<li>
<a href="#plus.nativeUI.ConfirmCallback">ConfirmCallback</a>: 关闭确认对话框的回调函数</li>
<li>
<a href="#plus.nativeUI.PromptCallback">PromptCallback</a>: 系统输入对话框关闭后的回调函数</li>
<li>
<a href="#plus.nativeUI.PickDatetimeSuccessCallback">PickDatetimeSuccessCallback</a>: 选择日期或时间操作成功的回调函数</li>
<li>
<a href="#plus.nativeUI.PickDatetimeErrorCallback">PickDatetimeErrorCallback</a>: 选择日期或时间操作取消或失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"NativeUI": {
"description": "原生UI控件"
}
}
}
</pre>
<h1><a name="plus.nativeUI.ActionButtonStyles">ActionButtonStyles</a></h1>
<p>JSON对象,原生选择按钮框上按钮的样式参数</p>
<h2>属性:</h2>
<ul>
<li>color: <em>(<font class="type">String</font>
类型
)</em>按钮上显示的文字颜色<br><p>
可取值:
"#RRGGBB"格式字符串,如"#FF0000"表示文字颜色为红色;
"rgba(R,G,B,A)",其中R/G/B分别代表红色值/绿色值/蓝色值,正整数类型,取值范围为0-255,A为透明度,浮点数类型,取值范围为0-1(0为全透明,1为不透明),如"rgba(255,0,0,0.5)",表示红色半透明。
</p>
</li>
<li>title: <em>(<font class="type">String</font>
类型
)</em>按钮上显示的文字内容<br>
</li>
<li>style: <em>(<font class="type">String</font>
类型
)</em>按钮的样式<br><p>
可取值:
"destructive" - 表示警示按钮样式,默认文字颜色为红色;
"default" - 表示默认按钮样式。
默认值为"default"。
</p>
</li>
</ul>
<h1><a name="plus.nativeUI.ActionSheetStyles">ActionSheetStyles</a></h1>
<p>JSON对象,原生选择按钮框的样式参数</p>
<h2>属性:</h2>
<ul>
<li>title: <em>(<font class="type">String</font>
类型
)</em>选择按钮框的标题<br>
</li>
<li>cancel: <em>(<font class="type">String</font>
类型
)</em>取消按钮上显示的文字内容<br><p>
不设置此属性,则不显示取消按钮。
</p>
</li>
<li>buttons: <em>(<font class="type">Array</font>[
<a href="#plus.nativeUI.ActionButtonStyles">ActionButtonStyles</a>
]
类型
)</em>选择框上的按钮,ActionButtonStyles对象数组<br>
</li>
</ul>
<h1><a name="plus.nativeUI.PickDateOption">PickDateOption</a></h1>
<p>JSON对象,日期选择对话框的参数</p>
<h2>属性:</h2>
<ul>
<li>title: <em>(<font class="type">String</font>
类型
)</em>日期选择对话框显示的标题<br><p>
如果未设置标题,则默认显示标题为当前选择的日期。
</p>
</li>
<li>date: <em>(<font class="type">Date</font>
类型
)</em>日期选择对话框默认显示的日期<br><p>
如果未设置默认显示的日期,则显示当前的日期。
</p>
</li>
<li>minDate: <em>(<font class="type">Date</font>
类型
)</em>日期选择对话框可选择的最小日期<br><p>
Date类型对象,如果未设置可选择的最小日期,则使用系统默认可选择的最小日期值。
</p>
</li>
<li>maxDate: <em>(<font class="type">Date</font>
类型
)</em>日期选择对话框可选择的最大日期<br><p>
Date类型对象,如果未设置可选择的最大日期,则使用系统默认可选择的最大日期值。
其值必须大于minDate设置的值,否则使用系统默认可选择的最大日期值。
</p>
</li>
<li>popover: <em>(<font class="type">JSON</font>
类型
)</em>时间选择对话框弹出指示区域<br><p>
JSON类型对象,格式如{top:10;left:10;width:200;height:200;},所有值为像素值,其值为相对于容器Webview的位置。
如未设置此值,默认在屏幕居中显示。仅在iPad上有效,其它设备忽略此值。
</p>
</li>
</ul>
<h1><a name="plus.nativeUI.PickTimeOption">PickTimeOption</a></h1>
<p>JSON对象,时间选择对话框的参数</p>
<h2>属性:</h2>
<ul>
<li>time: <em>(<font class="type">Date</font>
类型
)</em>时间选择对话框默认显示的时间<br><p>
如果未设置标题,则默认显示标题为当前选择的时间。
</p>
</li>
<li>title: <em>(<font class="type">String</font>
类型
)</em>时间选择对话框显示的标题<br><p>
如果未设置标题,则默认显示标题为当前选择的时间。
</p>
</li>
<li>is24Hour: <em>(<font class="type">Boolean</font>
类型
)</em>是否24小时制模式<br><p>
true表示使用24小时制模式显示,fale表示使用12小时制模式显示,默认值为true。
</p>
</li>
<li>popover: <em>(<font class="type">JSON</font>
类型
)</em>日期选择对话框弹出指示区域<br><p>
JSON类型对象,格式如{top:10;left:10;width:200;height:200;},所有值为像素值,其值相对于容器webview的位置。
如未设置此值,默认在屏幕居中显示。仅在iPad上有效,其它设备忽略此值。
</p>
</li>
</ul>
<h1><a name="plus.nativeUI.NativeUIObj">NativeUIObj</a></h1>
<p>系统原生界面基类对象</p>
<pre class="prettyprint linenums">
interface NativeUIObj{
function void close();
}
</pre>
<h2>方法:</h2>
<ul><li>
<a href="#plus.nativeUI.NativeUIObj.close">close</a>: 关闭显示的系统原生界面</li></ul>
<h1><a name="plus.nativeUI.WaitingObj">WaitingObj</a></h1>
<p>系统等待对话框对象</p>
<h2>说明:</h2>
<p class="des">
从NativeUIObj对象继承而来,通过plus.nativeUI.showWaiting方法创建时返回。
用于控制系统样式等待对话框的操作,如关闭、设置标题内容等。
</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.nativeUI.WaitingObj.setTitle">setTitle</a>: 设置等待对话框上显示的文字内容</li>
<li>
<a href="#plus.nativeUI.WaitingObj.close">close</a>: 关闭显示的系统等待对话框</li>
</ul>
<h2>事件:</h2>
<ul><li>
<a href="#plus.nativeUI.WaitingObj.onclose">onclose</a>: 等待对话框关闭事件</li></ul>
<h1><a name="plus.nativeUI.WaitingOptions">WaitingOptions</a></h1>
<p>JSON对象,原生等待对话框的参数</p>
<h2>属性:</h2>
<ul>
<li>width: <em>(<font class="type">String</font>
类型
)</em>等待框背景区域的宽度<br><p>
值支持像素值("500px")或百分比("50%"),百分比相对于屏幕的宽计算,如果不设置则根据内容自动计算合适的宽度。
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>等待框背景区域的高度<br><p>
值支持像素绝对值("500px")或百分比("50%"),如果不设置则根据内容自动计算合适的高度。
</p>
</li>
<li>color: <em>(<font class="type">String</font>
类型
)</em>等待框中文字的颜色<br><p>
颜色值支持(参考CSS颜色规范):颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值,默认值为白色。
</p>
</li>
<li>size: <em>(<font class="type">String</font>
类型
)</em>等待框中文字的字体大小<br><p>
如"14px"表示使用14像素高的文字,未设置则使用系统默认字体大小。
</p>
</li>
<li>textalign: <em>(<font class="type">String</font>
类型
)</em>等待对话框中标题文字的水平对齐方式<br><p>
对齐方式可选值包括:"left":水平居左对齐显示,"center":水平居中对齐显示,"right":水平居右对齐显示。默认值为水平居中对齐显示,即"center"。
</p>
</li>
<li>padding: <em>(<font class="type">String</font>
类型
)</em>等待对话框的内边距<br><p>
值支持像素值("10px")和百分比("5%"),百分比相对于屏幕的宽计算,默认值为"3%"。
</p>
</li>
<li>background: <em>(<font class="type">String</font>
类型
)</em>等待对话框显示区域的背景色<br><p>
背景色的值支持(参考CSS颜色规范):颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值,默认值为rgba(0,0,0,0.8)。
</p>
</li>
<li>style: <em>(<font class="type">String</font>
类型
)</em>等待对话框样式<br><p>
可取值"black"、"white",black表示等待框为黑色雪花样式,通常在背景主色为浅色时使用;white表示等待框为白色雪花样式,通常在背景主色为深色时使用。
仅在iOS平台有效,其它平台忽略此值,未设置时默认值为white。
</p>
</li>
<li>modal: <em>(<font class="type">Boolen</font>
类型
)</em>等待框是否模态显示<br><p>
模态显示时用户不可操作直到等待对话框关闭,否则用户在等待对话框显示时也可操作下面的内容,未设置时默认为true。
</p>
</li>
<li>round: <em>(<font class="type">Number</font>
类型
)</em>等待框显示区域的圆角<br><p>
值支持像素值("10px"),未设置时使用默认值"10px"。
</p>
</li>
<li>padlock: <em>(<font class="type">Boolen</font>
类型
)</em>点击等待显示区域是否自动关闭<br><p>
true表示点击等待对话框显示区域时自动关闭,false则不关闭,未设置时默认值为false。
</p>
</li>
<li>back: <em>(<font class="type">String</font>
类型
)</em>返回键处理方式<br><p>
可取值"none"表示截获处理返回键,但不做任何响应;"close"表示截获处理返回键并关闭等待框;"transmit"表示不截获返回键,向后传递给Webview窗口继续处理(与未显示等待框的情况一致)。
</p>
</li>
<li>loading: <em>(<a href="#plus.nativeUI.WaitingLoadingOptions">WaitingLoadingOptions</a>
类型
)</em>自定义等待框上loading图标样式<br>
</li>
</ul>
<h1><a name="plus.nativeUI.WaitingLoadingOptions">WaitingLoadingOptions</a></h1>
<p>JSON对象,原生等待对话框上loading图标自定义样式</p>
<h2>属性:</h2>
<ul>
<li>display: <em>(<font class="type">String</font>
类型
)</em>loading图标显示样式<br><p>
可取值:
"block"表示图标与文字分开两行显示,上面显示loading图标,下面显示文字;
"inline"表示loading图标与文字在同一行显示,左边显示loading图标,右边显示文字;
"none"表示不显示loading图标;
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>loading图标高度<br><p>
设置loading图标的高度(宽度等比率缩放),取值类型:像素值,如"14px"表示14像素高。
</p>
</li>
<li>icon: <em>(<font class="type">String</font>
类型
)</em>loading图标路径<br><p>
自定义loading图标的路径,png格式,并且必须是本地资源地址;
loading图要求宽是高的整数倍,显示等待框时按照图片的高横向截取每帧刷新。
</p>
</li>
<li>interval: <em>(<font class="type">Number</font>
类型
)</em>loading图每帧刷新间隔<br><p>
单位为ms(毫秒),默认值为100ms。
</p>
</li>
</ul>
<h1><a name="plus.nativeUI.ToastOptions">ToastOptions</a></h1>
<p>JSON对象,系统提示消息框要设置的参数</p>
<h2>属性:</h2>
<ul>
<li>icon: <em>(<font class="type">String</font>
类型
)</em>提示消息框上显示的图标<br>
</li>
<li>style: <em>(<font class="type">String</font>
类型
)</em>提示消息框上显示的样式<br><p>
可取值:
"block"表示图标与文字分两行显示,上面显示图标,下面显示文字;
"inline"表示图标与文字在同一行显示,左边显示图标,右边显示文字。
默认值为"block"。
</p>
</li>
<li>duration: <em>(<font class="type">String</font>
类型
)</em>提示消息框显示的时间<br><p>
可选值为"long"、"short",值为"long"时显示时间约为3.5s,值为"short"时显示时间约为2s,未设置时默认值为"short"。
</p>
</li>
<li>align: <em>(<font class="type">String</font>
类型
)</em>提示消息框在屏幕中的水平位置<br><p>
可选值为"left"、"center"、"right",分别为水平居左、居中、居右,未设置时默认值为"center"。
</p>
</li>
<li>verticalAlign: <em>(<font class="type">String</font>
类型
)</em>提示消息在屏幕中的垂直位置<br><p>
可选值为"top"、"center"、"bottom",分别为垂直居顶、居中、居底,未设置时默认值为"bottom"。
</p>
</li>
</ul>
<h1><a name="plus.nativeUI.ActionSheetCallback">ActionSheetCallback</a></h1>
<p>系统选择按钮框的回调函数</p>
<pre class="prettyprint linenums">
void onActioned( Event event ){
// actionsheet handled code.
var index=event.index; // 用户关闭时点击按钮的索引值
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>用户操作选择按钮框关闭后返回的数据<br>
可通过event.index(Number类型)获取用户关闭时点击按钮的索引值,索引值从0开始;
0表示用户点击取消按钮,大于0值表示用户点击ActionSheetStyles中buttons属性定义的按钮,索引值从1开始(即1表示点击buttons中定义的第一个按钮)。
通过API(close()方法)关闭,则回调函数中event的index属性值为-1。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeUI.AlertCallback">AlertCallback</a></h1>
<p>系统提示框确认的回调函数</p>
<pre class="prettyprint linenums">
void onAlerted( Event event ){
// Alert handled code.
var index=event.index; // 用户关闭提示对话框点击按钮的索引值
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>用户操作确认对话框关闭后返回的数据<br>
可通过event.index(Number类型)获取用户关闭确认对话框点击按钮的索引值,点击确认键的索引值为0。
Android平台上通过返回按钮关闭时索引值为-1。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeUI.ConfirmCallback">ConfirmCallback</a></h1>
<p>关闭确认对话框的回调函数</p>
<pre class="prettyprint linenums">
void onConfirmed( Event event ) {
// Confirm handled code.
var index=event.index; // 用户关闭确认对话框点击按钮的索引值
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>用户操作确认对话框关闭后返回的数据<br>
可通过event.index(Number类型)获取用户关闭确认对话框点击按钮的索引值,索引值从0开始;
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeUI.PromptCallback">PromptCallback</a></h1>
<p>系统输入对话框关闭后的回调函数</p>
<pre class="prettyprint linenums">
function void onPrompted( Event event ) {
// Prompt handled code.
var index=event.index; // 用户关闭输入对话框点击按钮的索引值
var value=event.value; // 用户输入的内容
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>用户操作输入对话框关闭后返回的数据<br>
可通过event.index(Number类型)获取用户关闭输入对话框点击按钮的索引值,索引值从0开始;
通过event.value(String类型)获取用户输入的内容,如果没有输入则返回空字符串。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeUI.PickDatetimeSuccessCallback">PickDatetimeSuccessCallback</a></h1>
<p>选择日期或时间操作成功的回调函数</p>
<pre class="prettyprint linenums">
function void onPickSuccess( Event event ) {
// Date picked code.
var date = event.date;// 用户选择的日期或时间
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>用户完成选择日期或时间后返回的数据<br>
可通过event.date(Date类型)获取选择的日期或时间值。
若调用的是日期选择操作则仅年、月、日信息有效,若调用的是时间选择操作则仅时、分信息有效。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeUI.PickDatetimeErrorCallback">PickDatetimeErrorCallback</a></h1>
<p>选择日期或时间操作取消或失败的回调函数</p>
<pre class="prettyprint linenums">
function void onPickError( Exception error ) {
// Date picked error.
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>用户选择操作失败信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+840
View File
@@ -0,0 +1,840 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.nativeObj">nativeObj</a></h1>
<p>nativeObj管理系统原生对象。</p>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.nativeObj.Bitmap">Bitmap</a>: 原生图片对象</li>
<li>
<a href="#plus.nativeObj.BitmapSaveOptions">BitmapSaveOptions</a>: JSON对象,保存图片的参数</li>
<li>
<a href="#plus.nativeObj.View">View</a>: 原生控件对象</li>
<li>
<a href="#plus.nativeObj.AnimationOptions">AnimationOptions</a>: 原生动画参数</li>
<li>
<a href="#plus.nativeObj.AnimationViewStyles">AnimationViewStyles</a>: 原生动画窗口样式</li>
<li>
<a href="#plus.nativeObj.Rect">Rect</a>: 区域信息对象</li>
<li>
<a href="#plus.nativeObj.Position">Position</a>: 区域信息对象</li>
<li>
<a href="#plus.nativeObj.TextStyles">TextStyles</a>: 文本样式对象</li>
<li>
<a href="#plus.nativeObj.ViewAnimationOptions">ViewAnimationOptions</a>: View控件动画参数</li>
<li>
<a href="#plus.nativeObj.ViewDrawTagStyles">ViewDrawTagStyles</a>: View控件绘制元素参数</li>
<li>
<a href="#plus.nativeObj.ViewEvents">ViewEvents</a>: View控件事件</li>
<li>
<a href="#plus.nativeObj.ViewStatusbarStyles">ViewStatusbarStyles</a>: JSON对象,View控件的系统状态栏区域样式</li>
<li>
<a href="#plus.nativeObj.ViewStyles">ViewStyles</a>: View控件样式</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.nativeObj.BitmapSaveSuccessCallback">BitmapSaveSuccessCallback</a>: 图片保存操作成功回调接口</li>
<li>
<a href="#plus.nativeObj.TouchEventCallback">TouchEventCallback</a>: 触屏事件的回调函数</li>
<li>
<a href="#plus.nativeObj.NativeObjSuccessCallback">NativeObjSuccessCallback</a>: 操作成功回调函数接口</li>
<li>
<a href="#plus.nativeObj.NativeObjErrorCallback">NativeObjErrorCallback</a>: 操作错误回调函数接口</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"NativeObj": {
"description": "原生对象"
}
}
}
</pre>
<h1><a name="plus.nativeObj.Bitmap">Bitmap</a></h1>
<p>原生图片对象</p>
<pre class="prettyprint linenums">
interface Bitmap {
readonly attribute String id;
static function Array[Bitmap] getItems();
static function Bitmap getBitmapById( id );
function void clear();
function void load( path, successCallback, errorCallback );
function void loadBase64Data( data, successCallback, errorCallback );
function void save( path, options, successCallback, errorCallback );
function String toBase64Data();
} </pre>
<h2>说明:</h2>
<p class="des">
原生图片对象会占用较大的内存资源,在使用时需谨慎管理,当图片不再使用时应该及时调用clear方法进行销毁。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.nativeObj.Bitmap.Bitmap(id,%20path)">Bitmap(id, path)</a>: 创建Bitmap对象</li></ul>
<h2>属性:</h2>
<ul><li>
<a href="#plus.nativeObj.Bitmap.id">id</a>: Bitmap对象的标识</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.nativeObj.Bitmap.getItems">getItems</a>: 静态方法,获取所有Bitmap图片对象</li>
<li>
<a href="#plus.nativeObj.Bitmap.getBitmapById">getBitmapById</a>: 静态方法,获取指定标识的Bitmap图片对象</li>
<li>
<a href="#plus.nativeObj.Bitmap.clear">clear</a>: 销毁Bitmap图片</li>
<li>
<a href="#plus.nativeObj.Bitmap.load">load</a>: 加载Bitmap图片</li>
<li>
<a href="#plus.nativeObj.Bitmap.loadBase64Data">loadBase64Data</a>: 加载Base64编码格式图片到Bitmap对象</li>
<li>
<a href="#plus.nativeObj.Bitmap.recycle">recycle</a>: 回收Bitmap图片内存</li>
<li>
<a href="#plus.nativeObj.Bitmap.save">save</a>: 保存图片</li>
<li>
<a href="#plus.nativeObj.Bitmap.toBase64Data">toBase64Data</a>: 获取图片的Base64编码数据</li>
</ul>
<h1><a name="plus.nativeObj.BitmapSaveOptions">BitmapSaveOptions</a></h1>
<p>JSON对象,保存图片的参数</p>
<pre class="prettyprint linenums">
interface BitmapSaveOptions {
attribute Boolean overwrite;
attribute String format;
attribute Number quality;
attribute Rect clip;
} </pre>
<h2>属性:</h2>
<ul>
<li>overwrite: <em>(<font class="type">Boolean</font>
类型
)</em>覆盖保存图片文件<br><p>
仅在保存的图片路径文件存在时有效:
true表示覆盖存在的文件;
false表示不覆盖,如果文件存在,则返回失败。
默认值为false。
</p>
</li>
<li>format: <em>(<font class="type">String</font>
类型
)</em>保存图片的格式<br><p>
支持"jpg"、"png",如果未指定则默认使用指定的保存路径后缀对应的文件格式,如果后缀文件格式无效则使用jpg格式。
</p>
</li>
<li>quality: <em>(<font class="type">Number</font>
类型
)</em>保存图片的质量<br><p>
取值范围为1-100,1表示使用最低的图片质量(保存后的图片文件最小)、100表示使用最高的图片质量(保存后的图片文件最大);
默认值为50。
</p>
</li>
<li>clip: <em>(<a href="#plus.nativeObj.Rect">Rect</a>
类型
)</em>指定裁剪区域保存图片<br><p>
相对于图片的区域信息,默认值为{top:'0px',left:'0px',width:'100%',height:'100%'}。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.View">View</a></h1>
<p>原生控件对象</p>
<pre class="prettyprint linenums">
interface View {
readonly attribute String id;
static function void startAnimation(options, view, otherview, callback);
static function void clearAnimation(type);
static function View getViewById(id);
function void addEventListener(event, listener, capture);
function void animate(options, callback);
function void close();
function void clearRect(position, id);
function void draw(tags);
function void drawBitmap(src, sprite, position, id);
function void drawRect(color, position, id);
function void drawText(text, position, styles, id);
function void reset();
function void restore();
function void show();
function void setStyle(styles);
function void setTouchEventRect(rect);
function void hide();
function void interceptTouchEvent(intercept);
function Boolean isVisible();
}
</pre>
<h2>说明:</h2>
<p class="des">
原生控件对象可用于在屏幕上绘制图片或文本内容,当控件不再使用时需要调用clear方法销毁控件。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.nativeObj.View.View(id,%20styles,%20tags)">View(id, styles, tags)</a>: 创建View对象</li></ul>
<h2>属性:</h2>
<ul><li>
<a href="#plus.nativeObj.View.id">id</a>: View对象的标识</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.nativeObj.View.startAnimation">startAnimation</a>: 静态方法,开始原生动画</li>
<li>
<a href="#plus.nativeObj.View.clearAnimation">clearAnimation</a>: 静态方法,关闭原生动画窗口</li>
<li>
<a href="#plus.nativeObj.View.getViewById">getViewById</a>: 静态方法,获取指定标识的View控件对象</li>
<li>
<a href="#plus.nativeObj.View.addEventListener">addEventListener</a>: 添加事件监听器</li>
<li>
<a href="#plus.nativeObj.View.animate">animate</a>: View控件内容动画</li>
<li>
<a href="#plus.nativeObj.View.close">close</a>: 关闭View控件</li>
<li>
<a href="#plus.nativeObj.View.clearRect">clearRect</a>: 清空矩形区域</li>
<li>
<a href="#plus.nativeObj.View.draw">draw</a>: 绘制内容</li>
<li>
<a href="#plus.nativeObj.View.drawBitmap">drawBitmap</a>: 绘制图片</li>
<li>
<a href="#plus.nativeObj.View.drawRect">drawRect</a>: 绘制矩形区域</li>
<li>
<a href="#plus.nativeObj.View.drawText">drawText</a>: 绘制文本</li>
<li>
<a href="#plus.nativeObj.View.reset">reset</a>: 重置view控件显示内容</li>
<li>
<a href="#plus.nativeObj.View.restore">restore</a>: 恢复View控件显示内容</li>
<li>
<a href="#plus.nativeObj.View.show">show</a>: 显示View控件</li>
<li>
<a href="#plus.nativeObj.View.setStyle">setStyle</a>: 设置View控件的样式</li>
<li>
<a href="#plus.nativeObj.View.setTouchEventRect">setTouchEventRect</a>: 指定监听触屏事件区域</li>
<li>
<a href="#plus.nativeObj.View.hide">hide</a>: 隐藏View控件</li>
<li>
<a href="#plus.nativeObj.View.interceptTouchEvent">interceptTouchEvent</a>: 是否拦截View控件的触屏事件</li>
<li>
<a href="#plus.nativeObj.View.isVisible">isVisible</a>: 获取View控件的显示状态</li>
</ul>
<h1><a name="plus.nativeObj.AnimationOptions">AnimationOptions</a></h1>
<p>原生动画参数</p>
<pre class="prettyprint linenums">
interface AnimationOptions {
attribute String type;
attribute Number duration;
} </pre>
<h2>说明:</h2>
<p class="des">
指定动画的类型、持续时间等信息。
</p>
<h2>属性:</h2>
<ul>
<li>type: <em>(<font class="type">String</font>
类型
)</em>动画类型<br><p>
可取值:
"pop-in" - 从右侧平移入栈动画效果(副窗口从右侧向左平移滑出显示,主窗口从当前屏幕区域向左侧平移滑出被遮盖),如果仅传入一个View控件对象则自动降级为slide-in-right动画;
"pop-out" - 从右侧平移出栈动画效果(副窗口从当前屏幕区域向右侧平移出可视区域,主窗口从左侧向右平移滑出显示),如果仅出入一个View控件对象则自动降级为slide-out-right动画;
"slide-in-right" - 从右侧横向滑动效果(主窗口从当前屏幕右侧外向内横向滑动显示);
"slide-out-right - 横向向右侧滑出屏幕动画(主窗口从屏幕中横向向右侧滑动到屏幕外)。
</p>
</li>
<li>duration: <em>(<font class="type">Number</font>
类型
)</em>动画持续时间<br><p>
单位为毫秒,默认值为200ms。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.AnimationViewStyles">AnimationViewStyles</a></h1>
<p>原生动画窗口样式</p>
<pre class="prettyprint linenums">
interface AnimationViewStyles {
attribute Bitmap bitmap;
attribute String text;
} </pre>
<h2>说明:</h2>
<p class="des">
指定动画窗口的样式,如背景图片,绘制的文字等。
</p>
<h2>属性:</h2>
<ul>
<li>bitmap: <em>(<a href="#plus.nativeObj.Bitmap">Bitmap</a>
类型
)</em>动画窗口上绘制的背景图片<br><p>
图片可以通过Webview对象的draw方法截图,也可以通过Bitmap的API从本地文件中加载。
</p>
</li>
<li>text: <em>(<font class="type">String</font>
类型
)</em>动画窗口上绘制的文本内容<br>
</li>
<li>textStyles: <em>(<a href="#plus.nativeObj.TextStyles">TextStyles</a>
类型
)</em>动画窗口上绘制的文本样式<br>
</li>
<li>textRect: <em>(<a href="#plus.nativeObj.Rect">Rect</a>
类型
)</em>动画窗口上绘制的文本区域<br><p>
默认值为{top:'0px',left:'0px',width:'100%',height:'44px'}。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.Rect">Rect</a></h1>
<p>区域信息对象</p>
<pre class="prettyprint linenums">
interface Rect {
attribute String top;
attribute String left;
attribute String width;
attribute String height;
} </pre>
<h2>说明:</h2>
<p class="des">
包括位置、大小等信息。
</p>
<h2>属性:</h2>
<ul>
<li>top: <em>(<font class="type">String</font>
类型
)</em>区域左上角的垂直偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象的高度;自动计算,如"auto",根据height值自动计算,相对于作用对象垂直居中。
</p>
</li>
<li>left: <em>(<font class="type">String</font>
类型
)</em>区域左上角的水平偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象的宽度;自动计算,如"auto",根据width值自动计算,相对于作用对象水平居中。
</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>区域的宽度<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象的宽度。
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>区域的高度<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象的高度。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.Position">Position</a></h1>
<p>区域信息对象</p>
<pre class="prettyprint linenums">
interface Position {
attribute String top;
attribute String left;
attribute String width;
attribute String height;
attribute String bottom;
attribute String right;
} </pre>
<h2>说明:</h2>
<p class="des">
包括位置、大小等信息。
</p>
<h2>属性:</h2>
<ul>
<li>top: <em>(<font class="type">String</font>
类型
)</em>区域顶部相对于作用对象(或容器)向下的偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象(或容器)的高度;
自动计算,如"auto",根据height值自动计算,相对于作用对象(或容器)垂直居中。
</p>
</li>
<li>left: <em>(<font class="type">String</font>
类型
)</em>区域左侧相对于作用对象(或容器)向右的偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象(或容器)的宽度;
自动计算,如"auto",根据width值自动计算,相对于作用对象(或容器)水平居中。
</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>区域的宽度<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象(或容器)的宽度。
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>区域的高度<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象(或容器)的高度。
</p>
</li>
<li>bottom: <em>(<font class="type">String</font>
类型
)</em>区域底部相对于作用对象(或容器)向上的偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象(或容器)的高度。
当设置了top和height值时,忽略此属性值;
当未设置top值时,可通过bottom属性值来确定区域的垂直位置;
当未设置height值时,可通过top和bottom属性值来确定区域的高度。
</p>
</li>
<li>right: <em>(<font class="type">String</font>
类型
)</em>区域右侧相对于作用对象(或容器)向左的偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于作用对象(或容器)的宽度。
当设置了left和width值时,忽略此属性值;
当未设置left值时,可通过right属性值来确定区域的水平位置;
当未设置width值时,可通过left和right属性值来确定区域的宽度。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.TextStyles">TextStyles</a></h1>
<p>文本样式对象</p>
<pre class="prettyprint linenums">
interface Rect {
attribute String color;
attribute String align;
attribute String family;
attribute String size;
attribute String style;
attribute String weight;
attribute String fontSrc;
attribute String overflow;
} </pre>
<h2>说明:</h2>
<p class="des">
用于定义文本的显示样式,如字体大小、字体颜色、字体粗细、字体样式、字体名称等信息。
</p>
<h2>属性:</h2>
<ul>
<li>color: <em>(<font class="type">String</font>
类型
)</em>字体颜色<br><p>
可取值:
"#RRGGBB"格式字符串,如"#FF0000"表示绘制红色区域;
"rgba(R,G,B,A)",其中R/G/B分别代表红色值/绿色值/蓝色值,正整数类型,取值范围为0-255,A为透明度,浮点数类型,取值范围为0-1(0为全透明,1为不透明),如"rgba(255,0,0,0.5)",表示红色半透明。
默认值为"#000000"(黑色)。
</p>
</li>
<li>align: <em>(<font class="type">String</font>
类型
)</em>字体水平对齐方式<br><p>
可取值:
"left"-字体在指定的区域中居左对齐;
"center"-字体在指定的区域中居中对齐;
"right"-字体在指定的区域中居右对齐。
默认值为"center"。
</p>
</li>
<li>family: <em>(<font class="type">String</font>
类型
)</em>字体名称<br><p>
例如"Times New Roman", 如果指定名称的字体不存在,则使用默认字体。
</p>
</li>
<li>margin: <em>(<font class="type">String</font>
类型
)</em>字体的边距<br><p>
用于设置字体在绘制目标区域四个方向(top/right/bottom/left)的边距,可取值:像素值,如"10px";百分比,相对于绘制目标区域,如"5%";
默认值为"0px"。
</p>
</li>
<li>size: <em>(<font class="type">String</font>
类型
)</em>字体大小<br><p>
可取值:字体高度像素值,数字加"px"格式字符串,如"12px"。
默认值为"16px"。
</p>
</li>
<li>style: <em>(<font class="type">String</font>
类型
)</em>字体样式<br><p>
可取值:"normal" - 正常字体样式;"italic" - 斜体样式。默认值为"normal"。
</p>
</li>
<li>weight: <em>(<font class="type">String</font>
类型
)</em>字体粗细<br><p>
可取值:"normal" - 普通字体;"bold" - 粗字体。默认值为"normal"。
</p>
</li>
<li>fontSrc: <em>(<font class="type">String</font>
类型
)</em>字体文件路径<br><p>
加载字体文件路径。
</p>
</li>
<li>overflow: <em>(<font class="type">String</font>
类型
)</em>文本内容超出显示区域时处理方式<br><p>
可取值:
"clip" - 超出显示区域时内容裁剪;
"ellipsis" - 超出显示区域时尾部显示省略标记(...)。
默认值为"clip"。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.ViewAnimationOptions">ViewAnimationOptions</a></h1>
<p>View控件动画参数</p>
<pre class="prettyprint linenums">
interface ViewAnimationOptions {
attribute String type;
attribute Number duration;
attribute Number frames;
attribute Rect region;
} </pre>
<h2>说明:</h2>
<p class="des">
指定动画的类型、持续时间等信息。
</p>
<h2>属性:</h2>
<ul>
<li>type: <em>(<font class="type">String</font>
类型
)</em>动画类型<br><p>
可取值:"shrink" - 从上到下分块收缩清除窗口动画。
</p>
</li>
<li>duration: <em>(<font class="type">Number</font>
类型
)</em>动画持续时间<br><p>
单位为毫秒,默认值为200ms。
</p>
</li>
<li>frames: <em>(<font class="type">Number</font>
类型
)</em>动画帧数<br><p>
必须为大于0的整数,默认值为12。
</p>
</li>
<li>region: <em>(<font class="type">json</font>
类型
)</em>动画作用区域<br><p>
支持以下属性:
top - 区域距离控件顶部的偏移量,属性值可取像素值(如"100px"),百分比(如"10%",相对于控件的高度),默认值为'0px';
bottom - 区域距离控件底部的偏移量,属性值可取像素值(如"100px"),百分比(如"10%",相对于控件的高度),默认值为'0px';
left - 区域距离控件左侧的偏移量,属性值可取像素值(如"100px"),百分比(如"10%",相对于控件的宽度),默认值为'0px';
right - 区域距离控件右侧的偏移量,属性值可取像素值(如"100px"),百分比(如"10%",相对于控件的宽度),默认值为'0px'。
如“{top:'44px',bottom:'48px'}”。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.ViewDrawTagStyles">ViewDrawTagStyles</a></h1>
<p>View控件绘制元素参数</p>
<pre class="prettyprint linenums">
interface ViewDrawTagStyles {
attribute String id;
attribute String tag;
attribute String color;
attribute Position position;
attribute String src;
attribute Position sprite;
attribute String text;
attribute TextStyles textStyles;
} </pre>
<h2>说明:</h2>
<p class="des">
指定绘制图片、矩形区域、文本内容等信息。
</p>
<h2>属性:</h2>
<ul>
<li>id: <em>(<font class="type">String</font>
类型
)</em>绘制操作标识<br><p>
可通过view对象的drawBitmap/drawRect/drawText/clearRect方法进行更新。
</p>
</li>
<li>tag: <em>(<font class="type">String</font>
类型
)</em>绘制操作类型<br><p>
可取值:
"img" - 绘制图片,与drawBitmap操作一致,此时id、src、position、sprite属性值有效;
"rect" - 绘制矩形区域,与drawRect操作一致,此时id、color、position属性值有效;
"font" - 绘制文本内容,与drawText操作一致,此时id、position、text、textStyles属性值有效。
</p>
</li>
<li>color: <em>(<font class="type">String</font>
类型
)</em>矩形区域颜色<br><p>
可取值:
"#RRGGBB"格式字符串,如红色为"#FF0000"。
"rgba(R,G,B,A)",其中R/G/B分别代表红色值/绿色值/蓝色值,正整数类型,取值范围为0-255,A为透明度,浮点数类型,取值范围为0-1(0为全透明,1为不透明),如"rgba(255,0,0,0.5)",表示红色半透明。
当tag属性值为"rect"时有效,用于指定矩形区域颜色,默认值为"#FFFFFF"(白色)。
</p>
</li>
<li>position: <em>(<a href="#plus.nativeObj.Position">Position</a>
类型
)</em>绘制内容区域<br><p>
当tag属性值为"img"时,用于指定绘制图片的目标区域;
当tag属性值为"rect"时,用于指定绘制的矩形区域;
当tag属性值为"font"时,用于指定绘制文本的目标区域。
相对于View控件的区域信息,默认值为{top:'0px',left:'0px',width:'100%',height:'100%'}。
</p>
</li>
<li>src: <em>(<font class="type">String</font>
类型
)</em>绘制的图片资源<br><p>
当tag属性值为"img"时有效,可以是图片资源路径(字符串类型)或者图片对象(plus.nativeObj.Bitmap对象)。
src路径支持gif图片,但设置的图片路径文件使用".gif"后缀时则认为是gif图片,如"_www/loading.gif"。
</p>
</li>
<li>sprite: <em>(<a href="#plus.nativeObj.Position">Position</a>
类型
)</em>图片源的绘制区域<br><p>
当tag属性值为"img"时有效,用于指定图片源的绘制区域,相对于图片的区域信息,默认值为{top:'0px',left:'0px',width:'100%',height:'100%'}。
</p>
</li>
<li>text: <em>(<font class="type">String</font>
类型
)</em>绘制的文本内容<br><p>
当tag属性值为"font"时有效,用于保存绘制的文本内容。
</p>
</li>
<li>textStyles: <em>(<a href="#plus.nativeObj.TextStyles">TextStyles</a>
类型
)</em>绘制文本的样式<br><p>
当tag属性值为"font"时有效,用于指定绘制文本内容的字体大小、字体颜色、字体类型等信息。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.ViewEvents">ViewEvents</a></h1>
<p>View控件事件</p>
<h2>常量:</h2>
<ul>
<li>"doubleclick": <em>(<font class="type">String</font>
类型
)</em>双击事件<br><p>
双击屏幕时触发。
注意:如果将View控件设置为不拦截触屏事件(view.interceptTouchEvent(false))则不会触发此事件。
</p>
</li>
<li>"click": <em>(<font class="type">String</font>
类型
)</em>点击事件<br><p>
当手指点击屏幕时触发。
注意:如果将View控件设置为不拦截触屏事件(view.interceptTouchEvent(false))则不会触发此事件。
</p>
</li>
<li>"touchstart": <em>(<font class="type">String</font>
类型
)</em>开始触屏事件<br><p>
当手指触摸屏幕时候触发。
注意:如果将View控件设置为不拦截触屏事件(view.interceptTouchEvent(false))则不会触发此事件。
</p>
</li>
<li>"touchmove": <em>(<font class="type">String</font>
类型
)</em>触摸滑屏事件<br><p>
当手指在屏幕上滑动的时候连续地触发。
注意:如果将View控件设置为不拦截触屏事件(view.interceptTouchEvent(false))则不会触发此事件。
</p>
</li>
<li>"touchend": <em>(<font class="type">String</font>
类型
)</em>结束触屏事件<br><p>
当手指从屏幕上离开的时候触发。
注意:如果将View控件设置为不拦截触屏事件(view.interceptTouchEvent(false))则不会触发此事件。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.ViewStatusbarStyles">ViewStatusbarStyles</a></h1>
<p>JSON对象,View控件的系统状态栏区域样式</p>
<h2>说明:</h2>
<p class="des">
仅在应用设置为沉浸式状态栏样式下有效,非沉浸式状态栏样式下忽略此属性。
</p>
<h2>属性:</h2>
<ul><li>background: <em>(<font class="type">String</font>
类型
)</em>系统状态栏区域背景颜色<br><p>
颜色值格式为"#RRGGBB",如"#FF0000"表示为红色背景,默认值为应用manifest.json中plus-&gt;statusbar-&gt;background属性配置的值。
</p>
</li></ul>
<h1><a name="plus.nativeObj.ViewStyles">ViewStyles</a></h1>
<p>View控件样式</p>
<pre class="prettyprint linenums">
interface ViewStyles {
attribute String bottom;
attribute String top;
attribute String left;
attribute String width;
attribute String height;
attribute String backgroundColor;
attribute String dock;
attribute String position;
attribute Number opacity;
attribute ViewStatusbarStyles statusbar;
} </pre>
<h2>说明:</h2>
<p class="des">
包括位置、大小等信息,位置信息相对于父容器控件进行计算。
</p>
<h2>属性:</h2>
<ul>
<li>bottom: <em>(<font class="type">String</font>
类型
)</em>View控件垂直向上的偏移量<br><p>
支持百分比、像素值,默认值无值(根据top和height属性值来自动计算)。
当设置了top和height值时,忽略此属性值;
当未设置height值时,可通过top和bottom属性值来确定View控件的高度。
</p>
</li>
<li>top: <em>(<font class="type">String</font>
类型
)</em>View控件左上角的垂直偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于父控件的高度;自动计算,如"auto",根据height值自动计算,相对于父控件垂直居中。
</p>
</li>
<li>left: <em>(<font class="type">String</font>
类型
)</em>区域左上角的水平偏移量<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于父控件的宽度;自动计算,如"auto",根据width值自动计算,相对于父控件水平居中。
</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>区域的宽度<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于父控件的宽度。
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>区域的高度<br><p>
可取值:像素值,如"100px";百分比,如"10%",相对于父控件的高度。
</p>
</li>
<li>backgroundColor: <em>(<font class="type">String</font>
类型
)</em>区域背景颜色<br><p>
颜色值格式为"#RRGGBB",如"#FF0000"为红色,默认值为透明区域。
</p>
</li>
<li>dock: <em>(<font class="type">String</font>
类型
)</em>View控件的停靠方式<br><p>
仅当View控件添加到Webview窗口对象中并且position属性值设置为"dock"时才生效,此时View控件挤压Webview窗口的大小。
可取值:"top",控件停靠则页面顶部;"bottom",控件停靠在页面底部;"right",控件停靠在页面右侧;"left",控件停靠在页面左侧。
</p>
</li>
<li>position: <em>(<font class="type">String</font>
类型
)</em>View控件的排版方式<br><p>
仅当View控件添加到Webview窗口对象中时才生效。
可取值:
"static",View控件在页面中正常定位,如果页面存在滚动条则随窗口内容滚动;
"absolute",Veiw控件在页面中绝对定位,如果页面存在滚动条不随窗口内容滚动;
"dock",View控件在页面中停靠,停靠的位置由dock属性值决定。
默认值为"absolute"。
</p>
</li>
<li>opacity: <em>(<font class="type">Number</font>
类型
)</em>View控件的不透明度<br><p>
取值范围为0-1,0为全透明,1为不透明,默认值为1,即不透明。
</p>
</li>
<li>statusbar: <em>(<a href="#plus.nativeObj.ViewStatusbarStyles">ViewStatusbarStyles</a>
类型
)</em>View控件的状态栏样式<br><p>
仅在应用设置为沉浸式状态栏样式下有效,设置此属性后将自动保留系统状态栏区域不被View控件占用(即View控件非沉浸式样式显示)。
</p>
</li>
</ul>
<h1><a name="plus.nativeObj.BitmapSaveSuccessCallback">BitmapSaveSuccessCallback</a></h1>
<p>图片保存操作成功回调接口</p>
<pre class="prettyprint linenums">
void onSuccess( Event event ){
// Code here
var target = event.target; // 保存后的图片url路径,以"file://"开头
var size = event.size; // 保存后图片的大小,单位为字节(Byte)
var width = event.width; // 保存后图片的实际宽度,单位为px
var height = event.height; // 保存后图片的实际高度,单位为px
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>保存后的图片信息<br>
可通过event.target(String类型)获取保存后的图片url路径,以"file://"开头,可直接在html页面中通过src属性引用,如Android平台"file:///storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/doc/a.jpg",iOS平台"file:///var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png";
可通过event.size(Number类型)获取保存后图片的大小,单位为字节(Byte);
可通过event.width(Number类型)获取保存后的图片的实际宽度,单位为px;
可通过event.height(Number类型)获取保存后的图片的实际高度,单位为px。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeObj.TouchEventCallback">TouchEventCallback</a></h1>
<p>触屏事件的回调函数</p>
<pre class="prettyprint linenums">
void onEvent(Event e){
// Event handled code.
var clientX = e.clientX;
var clientY = e.clientY;
var pageX = e.pageX;
var pageY = e.pageY;
var screenX = e.screenX;
var screenY = e.screenY;
var target = e.target;
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>触屏数据<br>
Event对象包含以下属性:
target:保存触发此事件的对象;
clientX:Number类型,保存触摸目标在View控件中的X坐标;
clientY:Number类型,保存触摸目标在View控件中的Y坐标;
pageX:Number类型,保存触摸目标在当前页面(运行此脚本的窗口)中的X坐标;
pageY:Number类型,保存触摸目标在当前页面(运行此脚本的窗口)中的Y坐标;
screenX:Number类型,保存触摸目标在屏幕中的X坐标;
screenY:Number类型,保存触摸目标在屏幕中的Y坐标。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeObj.NativeObjSuccessCallback">NativeObjSuccessCallback</a></h1>
<p>操作成功回调函数接口</p>
<pre class="prettyprint linenums">
void onSuccess(){
// Code here
}
</pre>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.nativeObj.NativeObjErrorCallback">NativeObjErrorCallback</a></h1>
<p>操作错误回调函数接口</p>
<pre class="prettyprint linenums">
function void onError( Exception error ) {
// Error.
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>用户选择操作失败信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+270
View File
@@ -0,0 +1,270 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.navigator">navigator</a></h1>
<p>navigator用于管理浏览器运行环境信息</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.navigator.checkPermission">checkPermission</a>: 检查运行环境的权限</li>
<li>
<a href="#plus.navigator.closeSplashscreen">closeSplashscreen</a>: 关闭应用启动界面</li>
<li>
<a href="#plus.navigator.hasSplashscreen">hasSplashscreen</a>: 查询应用启动界面是否已关闭</li>
<li>
<a href="#plus.navigator.updateSplashscreen">updateSplashscreen</a>: 更新程序启动界面</li>
<li>
<a href="#plus.navigator.createShortcut">createShortcut</a>: 创建应用快捷方式</li>
<li>
<a href="#plus.navigator.hasShortcut">hasShortcut</a>: 查询是否存在应用快捷方式</li>
<li>
<a href="#plus.navigator.isBackground">isBackground</a>: 判断当前应用是否切换到后台</li>
<li>
<a href="#plus.navigator.isFullscreen">isFullscreen</a>: 判断应用当前是否全屏模式显示</li>
<li>
<a href="#plus.navigator.isLogs">isLogs</a>: 判断应用当前是否输出日志</li>
<li>
<a href="#plus.navigator.setFullscreen">setFullscreen</a>: 设置应用是否全屏显示</li>
<li>
<a href="#plus.navigator.setLogs">setLogs</a>: 设置应用是否输出日志</li>
<li>
<a href="#plus.navigator.setStatusBarBackground">setStatusBarBackground</a>: 设置系统状态栏背景颜色</li>
<li>
<a href="#plus.navigator.getStatusBarBackground">getStatusBarBackground</a>: 获取系统状态栏背景颜色</li>
<li>
<a href="#plus.navigator.setStatusBarStyle">setStatusBarStyle</a>: 设置系统状态栏样式</li>
<li>
<a href="#plus.navigator.getStatusBarStyle">getStatusBarStyle</a>: 获取系统状态栏样式</li>
<li>
<a href="#plus.navigator.getStatusbarHeight">getStatusbarHeight</a>: 获取系统状态栏高度</li>
<li>
<a href="#plus.navigator.isImmersedStatusbar">isImmersedStatusbar</a>: 判断当前是否为沉浸式状态栏模式</li>
<li>
<a href="#plus.navigator.setUserAgent">setUserAgent</a>: 设置userAgent值</li>
<li>
<a href="#plus.navigator.getUserAgent">getUserAgent</a>: 获取userAgent值</li>
<li>
<a href="#plus.navigator.setCookie">setCookie</a>: 设置Cookie值</li>
<li>
<a href="#plus.navigator.getCookie">getCookie</a>: 获取Cookie值</li>
<li>
<a href="#plus.navigator.removeAllCookie">removeAllCookie</a>: 删除应用所有Cookie值</li>
<li>
<a href="#plus.navigator.removeCookie">removeCookie</a>: 删除应用Cookie</li>
<li>
<a href="#plus.navigator.removeSessionCookie">removeSessionCookie</a>: 删除应用所有会话期Cookie值</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.navigator.ShortcutOptions">ShortcutOptions</a>: 创建应用快捷方式要设置的参数</li>
<li>
<a href="#plus.navigator.SplashscreenOptions">SplashscreenOptions</a>: 更新应用启动界面要设置的参数</li>
<li>
<a href="#plus.navigator.PermissionNames">PermissionNames</a>: 运行环境权限类型</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.navigator.ShortcutSuccessCallback">ShortcutSuccessCallback</a>: 创建桌面快捷方式成功的回调函数</li>
<li>
<a href="#plus.navigator.NavigatorErrorCallback">NavigatorErrorCallback</a>: 操作错误回调函数接口</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Navigator": {
"description": "浏览器信息"
}
}
}
</pre>
<h1><a name="plus.navigator.ShortcutOptions">ShortcutOptions</a></h1>
<p>创建应用快捷方式要设置的参数</p>
<h2>属性:</h2>
<ul>
<li>name: <em>(<font class="type">String</font>
类型
)</em>快捷方式名称<br><p>
如果未设置则使用应用的名称,manifest.json中name属性值。
</p>
</li>
<li>icon: <em>(<font class="type">String</font>
类型
)</em>快捷方式的图标<br><p>
如果未设置则优先使用应用中指定的图标(manifest.json中icon节点下对应分辨率的图标),如未区配则使用应用的图标(仅在独立打包时),否则使用runtime提供的默认图标。
</p>
</li>
<li>toast: <em>(<font class="type">String</font>
类型
)</em>创建快捷方式后的提示信息<br><p>
快捷方式创建成功后显示,默认提示内容为“"XXXX"已创建桌面快捷方式”,其中"XXXX"为程序的名称,如果不需要提示则设置此值为空字符串。
</p>
</li>
<li>extra: <em>(<font class="type">JSON</font>
类型
)</em>快捷方式的扩展参数<br><p>
其中key和value值都必须是字符串类型。
</p>
</li>
<li>classname: <em>(<font class="type">String</font>
类型
)</em>要启动Activity类名<br><p>
通常情况下不需要指定此值,仅在5+SDK集成时自定义Activity才用到。
</p>
</li>
<li>force: <em>(<font class="type">Boolean</font>
类型
)</em>是否需要强制创建快捷方式<br><p>
true表示强制创建,false表示不强制创建,默认值为true。
强制创建可能会导致在无法判断快捷方式是否存在的设备上重复创建,如果需要尽可能避免出现重复创建桌面快捷方式则应该设置force属性值为false。
</p>
</li>
</ul>
<h1><a name="plus.navigator.SplashscreenOptions">SplashscreenOptions</a></h1>
<p>更新应用启动界面要设置的参数</p>
<h2>属性:</h2>
<ul>
<li>image: <em>(<font class="type">String</font>
类型
)</em>启动界面的图片路径<br><p>
仅支持本地文件路径,图片必须为png格式。
</p>
</li>
<li>autoclose: <em>(<font class="type">Boolean</font>
类型
)</em>是否自动关闭启动界面<br><p>
true表示应用启动后自动关闭启动界面,false表示应用启动后不自动关闭启动界面,需要在应用调用plus.navigator.closeSplashscreen()方法关闭。
</p>
</li>
<li>autoclose_w2a: <em>(<font class="type">Boolean</font>
类型
)</em>是否自动关闭启动界面(WAP2APP应用)<br><p>
与autoclose属性值作用一致,仅在WAP2APP应用中有效。
不推荐设置此值,如果未设置会自动使用autoclose属性值。
</p>
</li>
<li>delay: <em>(<font class="type">Number</font>
类型
)</em>启动界面延时关闭时间<br><p>
仅在设置为自动关闭启动界面时有效。
</p>
</li>
<li>delay_w2a: <em>(<font class="type">Number</font>
类型
)</em>启动界面延时关闭时间(WAP2APP应用)<br><p>
与delay属性值作用一致,仅在WAP2APP应用中有效。
不推荐设置此值,如果未设置会自动使用delay属性值。
</p>
</li>
</ul>
<h1><a name="plus.navigator.PermissionNames">PermissionNames</a></h1>
<p>运行环境权限类型</p>
<h2>常量:</h2>
<ul>
<li>CAMERA: <em>(<font class="type">String</font>
类型
)</em>访问摄像头权限<br><p>
用于调用摄像头(plus.camera.*/plus.barcode.*)。
</p>
</li>
<li>CONTACTS: <em>(<font class="type">String</font>
类型
)</em>访问系统联系人权限<br><p>
用于访问(读、写)系统通讯录(plus.gallery.*)。
</p>
</li>
<li>GALLERY: <em>(<font class="type">String</font>
类型
)</em>访问系统相册权限<br><p>
用于访问(读、写)系统相册(plus.gallery.*)。
</p>
</li>
<li>LOCATION: <em>(<font class="type">String</font>
类型
)</em>定位权限<br><p>
用于获取当前用户位置信息(plus.geolocation.*)。
</p>
</li>
<li>NOTIFITION: <em>(<font class="type">String</font>
类型
)</em>消息通知权限<br><p>
用于接收系统消息通知(plus.push.*)。
</p>
</li>
<li>RECORD: <em>(<font class="type">String</font>
类型
)</em>录音权限<br><p>
用于进行本地录音操作(plus.audio.AudioRecorder)。
</p>
</li>
<li>SHORTCUT: <em>(<font class="type">String</font>
类型
)</em>创建桌面快捷方式权限<br><p>
用于在系统桌面创建快捷方式图标(plus.navigator.createShortcut)。
</p>
</li>
</ul>
<h1><a name="plus.navigator.ShortcutSuccessCallback">ShortcutSuccessCallback</a></h1>
<p>创建桌面快捷方式成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( Event event ){
var result=event.result; // 快捷方式是否已经存在,调用plus.navigator.hasShortcut方法时有效
var sure=event.sure; // 是否确定创建桌面快捷方式成功,调用plus.navigator.createShortcut方法时有效
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
必选 </em>创建桌面快捷方式返回的数据<br>
此对象包含以下属性值:
event.result - 查询快捷方式是否存在的结果(plus.navigator.hasShortcut),可取值:
existing",快捷方式已存在;
"none",快捷方式不存在(支持创建);
"unsupported",不支持创建桌面快捷方式;
"unknown":不确定快捷方式是否存在。
event.sure - 创建快捷方式的结果(plus.navigator.createShortcut),Boolean类型,可取值:
true,表示在当前环境下确定快捷方式创建成功;
false,表示不确定快捷方式是否已创建。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.navigator.NavigatorErrorCallback">NavigatorErrorCallback</a></h1>
<p>操作错误回调函数接口</p>
<pre class="prettyprint linenums">
function void onError( Exception error ) {
// Error.
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>操作失败信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+347
View File
@@ -0,0 +1,347 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.oauth">oauth</a></h1>
<p>OAuth模块管理客户端的用户登录授权验证功能,允许应用访问第三方平台的资源。</p>
<h2>方法:</h2>
<ul><li>
<a href="#plus.oauth.getServices">getServices</a>: 获取登录授权认证服务列表</li></ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.oauth.AuthService">AuthService</a>: 登录授权认证服务对象</li>
<li>
<a href="#plus.oauth.AuthOptions">AuthOptions</a>: JSON对象,授权认证参数选项</li>
<li>
<a href="#plus.oauth.AuthInfo">AuthInfo</a>: 登录授权认证信息</li>
<li>
<a href="#plus.oauth.UserInfo">UserInfo</a>: 登录授权用户信息</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.oauth.ServicesSuccessCallback">ServicesSuccessCallback</a>: 获取登录授权认证服务成功回调</li>
<li>
<a href="#plus.oauth.AuthLogoutSuccessCallback">AuthLogoutSuccessCallback</a>: 注销登录授权认证操作成功回调函数</li>
<li>
<a href="#plus.oauth.AuthSuccessCallback">AuthSuccessCallback</a>: 登录授权认证服务操作成功回调函数</li>
<li>
<a href="#plus.oauth.AuthErrorCallback">AuthErrorCallback</a>: 登录授权认证服务操作失败回调函数</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"OAuth": {
"description": "登录鉴权"
}
}
}
</pre>
<h1><a name="plus.oauth.AuthService">AuthService</a></h1>
<p>登录授权认证服务对象</p>
<pre class="prettyprint linenums">
interface plus.oauth.AuthService {
// Attributes
attribute String id;
attribute String description;
attribute AuthInfo authResult;
attribute UserInfo userInfo;
attribute JSON extra;
// Methods
function void login( successCallback, errorCallback, options );
function void logout( successCallback, errorCallback );
function void getUserInfo( successCallback, errorCallback );
function void addPhoneNumber( successCallback, errorCallback );
}
</pre>
<h2>说明:</h2>
<p class="des">
AuthService对象用于表示登录授权认证服务,在JS中为对象,用于向系统进行登录授权认证操作。
</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.oauth.AuthService.id">id</a>: 登录授权认证服务标识</li>
<li>
<a href="#plus.oauth.AuthService.description">description</a>: 登录授权认证服务描述</li>
<li>
<a href="#plus.oauth.AuthService.authResult">authResult</a>: 授权认证结果数据</li>
<li>
<a href="#plus.oauth.AuthService.userInfo">userInfo</a>: 登录授权认证用户信息</li>
<li>
<a href="#plus.oauth.AuthService.extra">extra</a>: 登录授权认证扩展信息</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.oauth.AuthService.login">login</a>: 请求登录授权认证操作</li>
<li>
<a href="#plus.oauth.AuthService.logout">logout</a>: 注销登录授权认证</li>
<li>
<a href="#plus.oauth.AuthService.getUserInfo">getUserInfo</a>: 获取登录授权用户信息</li>
<li>
<a href="#plus.oauth.AuthService.addPhoneNumber">addPhoneNumber</a>: 添加用户手机号信息</li>
</ul>
<h1><a name="plus.oauth.AuthOptions">AuthOptions</a></h1>
<p>JSON对象,授权认证参数选项</p>
<pre class="prettyprint linenums">
interface plus.oauth.AuthOptions {
attribute String scope;
attribute String state;
attribute String appid;
attribute String appkey;
attribute String appsecret;
attribute String redirect_uri;
}
</pre>
<h2>说明:</h2>
<p class="des">
此对象支持的属性值由登录授权认证服务定义。
例如“微信”,则可配置以下参数:
scope - 应用授权作用域;
state - 用于保持请求和回调的状态参数。
</p>
<h2>属性:</h2>
<ul>
<li>scope: <em>(<font class="type">String</font>
类型
)</em>申请的权限作用范围<br><p>
如果存在多个权限,则以","符号分割。
</p>
</li>
<li>state: <em>(<font class="type">String</font>
类型
)</em>客户端的当前状态,可以指定任意值,登录认证后原封不动的返回保存到AuthService对象的extra中<br>
</li>
<li>appid: <em>(<font class="type">String</font>
类型
)</em>登录授权认证服务平台申请的appid<br><p>
动态设置登录授权服务中需要使用的appid,仅需要此参数的登录授权服务(如“微信登录”、“QQ登录”)支持。
如果未设置则使用运行环境中内置的appid值(如在HBuilder中可在manifest.json的SDK配置项中进行设置)。
</p>
</li>
<li>appkey: <em>(<font class="type">String</font>
类型
)</em>登录授权认证服务平台申请的appkey<br><p>
动态设置登录授权服务中需要使用的appkey,仅需要此参数的登录授权服务(如“新浪微博登录”、“360登录”)支持。
如果未设置则使用运行环境中内置的appkey值(如在HBuilder中可在manifest.json的SDK配置项中进行设置)。
</p>
</li>
<li>appsecret: <em>(<font class="type">String</font>
类型
)</em>登录授权认证服务平台申请的appsecret<br><p>
动态设置登录授权服务中需要使用的appsecret,仅需要此参数的登录授权服务(如“微信登录”、“新浪微博登录”)支持。
如果未设置则使用运行环境中内置的appkey值(如在HBuilder中可在manifest.json的SDK配置项中进行设置);当开放平台申请的appsecret值涉及到安全问题时,可在应用运行时从服务器获取,然后通过此api动态设置。
</p>
</li>
<li>redirect_url: <em>(<font class="type">String</font>
类型
)</em>登录授权认证服务平台申请的redirect_url<br><p>
动态设置登录授权服务中需要使用的redirect_url,仅需要此参数的登录授权服务(如“新浪微博登录”)支持。
如果未设置则使用运行环境中内置的redirect_url值(如在HBuilder中可在manifest.json的SDK配置项中进行设置)。
</p>
</li>
</ul>
<h1><a name="plus.oauth.AuthInfo">AuthInfo</a></h1>
<p>登录授权认证信息</p>
<pre class="prettyprint linenums">
interface plus.oauth.AuthInfo {
attribute String openid;
attribute String access_token;
attribute String expires_in:
attribute String refresh_token;
attribute String scope;
}
</pre>
<h2>说明:</h2>
<p class="des">
此对象仅定义标准属性,登录授权认证服务可扩展定义。
例如“微信”登录授权服务,则包括以下数据:
unionid - 用户统一标识,针对一个微信开放平台帐号下的应用,同一用户的unionid是唯一的。
</p>
<h2>属性:</h2>
<ul>
<li>access_token: <em>(<font class="type">String</font>
类型
)</em>登录授权的访问令牌<br><p>
如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
<li>openid: <em>(<font class="type">String</font>
类型
)</em>登录授权用户的唯一标识<br><p>
如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
<li>expires_in: <em>(<font class="type">String</font>
类型
)</em>登录授权访问令牌过期时间<br><p>
单位为秒,如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
<li>refresh_token: <em>(<font class="type">String</font>
类型
)</em>登录授权的更新令牌<br><p>
用来获取下一次的访问令牌,如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
<li>scope: <em>(<font class="type">String</font>
类型
)</em>登录授权的权限范围<br><p>
如果存在多个权限,则以","符号分割。
</p>
</li>
</ul>
<h1><a name="plus.oauth.UserInfo">UserInfo</a></h1>
<p>登录授权用户信息</p>
<pre class="prettyprint linenums">
interface plus.oauth.UserInfo {
attribute String openid;
attribute String headimgurl:
attribute String nickname;
}
</pre>
<h2>说明:</h2>
<p class="des">
用于保存登录授权用户的信息。
此对象仅定义标准属性,登录授权认证服务可扩展定义。
例如“微信”登录授权服务,则包括以下数据:
sex - 普通用户性别,1为男性,2为女性;
province - 普通用户个人资料填写的省份;
city - 普通用户个人资料填写的城市;
country - 国家,如中国为CN;
privilege - 用户特权信息,json数组,如微信沃卡用户为(chinaunicom);
unionid - 用户统一标识,针对一个微信开放平台帐号下的应用,同一用户的unionid是唯一的。
</p>
<h2>属性:</h2>
<ul>
<li>openid: <em>(<font class="type">String</font>
类型
)</em>登录授权用户的唯一标识<br><p>
如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
<li>headimgurl: <em>(<font class="type">String</font>
类型
)</em>登录授权用户的头像图片地址<br><p>
要求为"http://"或"https://"开头的地址,如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
<li>nickname: <em>(<font class="type">String</font>
类型
)</em>登录授权用户的昵称<br><p>
如果登录授权服务不支持此属性,则返回"undefined"。
</p>
</li>
</ul>
<h1><a name="plus.oauth.ServicesSuccessCallback">ServicesSuccessCallback</a></h1>
<p>获取登录授权认证服务成功回调</p>
<pre class="prettyprint linenums">
void ServicesSuccessCallback( services ) {
// Get oauth services success code
}
</pre>
<h2>说明:</h2>
<p class="des">
当获取登录授权认证服务列表成功时触发,并通过services参数返回运行环境支持的登录授权认证服务列表。
</p>
<h2>参数:</h2>
<ul><li>services:
<em>(
<font class="type">Array</font>[
<a href="#plus.oauth.AuthService">AuthService</a>
]
)
必选 </em>运行环境支持的登录授权认证服务列表<br>
运行环境支持的登录授权认证服务列表数组,可通过services.length获取服务列表的数目。
如果当前运行环境没有支持的登录授权认证服务,则返回空数组。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.oauth.AuthLogoutSuccessCallback">AuthLogoutSuccessCallback</a></h1>
<p>注销登录授权认证操作成功回调函数</p>
<pre class="prettyprint linenums">
void AuthLogoutSuccessCallback( event ) {
  // logout code
}
</pre>
<h2>说明:</h2>
<p class="des">
注销登录授权认证成功时触发,并返回操作结果。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">JSON</font>
)
必选 </em>注销登录授权认证操作回调事件参数<br>
包括以下参数:
event.target - 表示登录授权认证服务对象;
其它属性可保存注销登录授权的扩展数据。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.oauth.AuthSuccessCallback">AuthSuccessCallback</a></h1>
<p>登录授权认证服务操作成功回调函数</p>
<pre class="prettyprint linenums">
void AuthSuccessCallback( event ) {
  // auth code
}
</pre>
<h2>说明:</h2>
<p class="des">
登录授权认证服务操作如请求登录授权认证、获取登录授权用户信息成功时触发,并返回操作结果。
</p>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">JSON</font>
)
必选 </em>登录授权认证服务操作回调事件参数<br>
包括以下参数:
event.target - 表示登录授权认证服务对象,可以通过此对象的authResult、userInfo属性来获取操作结果信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.oauth.AuthErrorCallback">AuthErrorCallback</a></h1>
<p>登录授权认证服务操作失败回调函数</p>
<pre class="prettyprint linenums">
void AuthErrorCallback(error){
// Error code
}
</pre>
<h2>说明:</h2>
<p class="des">
登录授权认证服务操作如请求登录授权认证、注销登录授权认证、获取登录授权用户信息失败时触发,并返回错误信息。
</p>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
必选 </em>操作失败错误信息<br>
包括以下参数:
error.code - 表示错误代码;
error.message - 错误描述信息;
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+132
View File
@@ -0,0 +1,132 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.orientation">orientation</a></h1>
<p>Orientation模块管理设备的方向信息,包括alpha、beta、gamma三个方向信息,通过plus.orientation可获取设备方向管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.orientation.getCurrentOrientation">getCurrentOrientation</a>: 获取当前设备的方向信息,包括alpha、beta、gamma三个方向信息</li>
<li>
<a href="#plus.orientation.watchOrientation">watchOrientation</a>: 监听设备方向信息的变化</li>
<li>
<a href="#plus.orientation.clearWatch">clearWatch</a>: 关闭监听设备方向信息</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.orientation.OrientationOption">OrientationOption</a>: JSON对象,监听设备方向感应器参数</li>
<li>
<a href="#plus.orientation.Rotation">Rotation</a>: JSON对象,设备方向信息数据</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.orientation.OrientationSuccessCallback">OrientationSuccessCallback</a>: 获取设备方向信息成功的回调函数</li>
<li>
<a href="#plus.orientation.OrientationErrorCallback">OrientationErrorCallback</a>: 获取设备方向信息失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Orientation": {
"description": "方向传感器"
}
}
}
</pre>
<h1><a name="plus.orientation.OrientationOption">OrientationOption</a></h1>
<p>JSON对象,监听设备方向感应器参数</p>
<h2>属性:</h2>
<ul><li>frequency: <em>(<font class="type">Number</font>
类型
)</em>更新方向信息的时间间隔<br><p>数值类型,单位为ms,默认值为500ms。</p>
</li></ul>
<h1><a name="plus.orientation.Rotation">Rotation</a></h1>
<p>JSON对象,设备方向信息数据</p>
<pre class="prettyprint linenums">
interface Rotation {
readonly attribute float alpha;
readonly attribute float beta;
readonly attribute float gamma;
readonly attribute float magneticHeading;
readonly attribute float trueHeading;
readonly attribute float headingAccuracy;
}
</pre>
<h2>属性:</h2>
<ul>
<li>alpha: <em>(<font class="type">float</font>
类型
)</em>以z方向为轴心的旋转角度<br><p>浮点数类型,只读属性,取值范围为0到360(不等于360)。</p>
</li>
<li>beta: <em>(<font class="type">float</font>
类型
)</em>以x方向为轴心的旋转角度<br><p>浮点数类型,只读属性,取值范围为-180到180(不等于180)。</p>
</li>
<li>gamma: <em>(<font class="type">float</font>
类型
)</em>以y方向为轴心的旋转角度<br><p>浮点数类型,只读属性,取值范围为-180到180(不等于180)。</p>
</li>
<li>magneticHeading: <em>(<font class="type">float</font>
类型
)</em>设备方向与地球磁场北极方向的角度<br><p>浮点数类型,只读属性,取值范围为0到360(不等于360)。</p>
</li>
<li>trueHeading: <em>(<font class="type">float</font>
类型
)</em>设备方向与地球真实北极方向的角度<br><p>浮点数类型,只读属性,取值范围为0到360(不等于360)。</p>
</li>
<li>headingAccuracy: <em>(<font class="type">float</font>
类型
)</em>设备方向值的误差值<br><p>浮点数类型,只读属性,取值范围为0到360(不等于360)。</p>
</li>
</ul>
<h1><a name="plus.orientation.OrientationSuccessCallback">OrientationSuccessCallback</a></h1>
<p>获取设备方向信息成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( rotation ){
// Get orientation success code.
}
</pre>
<h2>参数:</h2>
<ul><li>rotation:
<em>(
<font class="type">DOMString</font>
)
必选 </em>设备的方向信息Rotation<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.orientation.OrientationErrorCallback">OrientationErrorCallback</a></h1>
<p>获取设备方向信息失败的回调函数</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Get orientation error code.
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>失败信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+407
View File
@@ -0,0 +1,407 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.payment">payment</a></h1>
<p>Payment模块管理支付功能,用于提供网页安全支付能力,支持通过Web接口进行支付操作。通过plus.payment可获取支付管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.payment.getChannels">getChannels</a>: 获取支付通道</li>
<li>
<a href="#plus.payment.request">request</a>: 请求支付操作</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.payment.PaymentChannel">PaymentChannel</a>: 支付通道对象</li>
<li>
<a href="#plus.payment.OrderStatementIAP">OrderStatementIAP</a>: IAP订单数据对象</li>
<li>
<a href="#plus.payment.PaymentResult">PaymentResult</a>: 支付操作结果对象</li>
<li>
<a href="#plus.payment.IAPProduct">IAPProduct</a>: IAP商品对象</li>
<li>
<a href="#plus.payment.IAPProductInfo">IAPProductInfo</a>: 购买IAP商品对象</li>
<li>
<a href="#plus.payment.IAPTransaction">IAPTransaction</a>: 购买IAP商品交易信息对象</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.payment.ChannelsSuccessCallback">ChannelsSuccessCallback</a>: 获取支付通道成功回调</li>
<li>
<a href="#plus.payment.IapRequestOrderSuccessCallback">IapRequestOrderSuccessCallback</a>: 请求支付商品列表回调方法</li>
<li>
<a href="#plus.payment.IapRestoreComplateRequestCallback">IapRestoreComplateRequestCallback</a>: 请求已经购买的非消耗性商品和订阅商品回调方法</li>
<li>
<a href="#plus.payment.PaymentSuccessCallback">PaymentSuccessCallback</a>: 支付操作成功回调</li>
<li>
<a href="#plus.payment.PaymentErrorCallback">PaymentErrorCallback</a>: 支付操作失败回调</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Payment": {
"description": "支付"
}
}
}
</pre>
<h1><a name="plus.payment.PaymentChannel">PaymentChannel</a></h1>
<p>支付通道对象</p>
<pre class="prettyprint linenums">
interface plus.payment.PaymentChannel{
attribute String id;
attribute String description;
attribute Boolean serviceReady;
function void installService();
// iOS iAP
function void requestOrder(ids, successCB, errorCB);
function void restoreComplateRequest(options, successCB);
}
</pre>
<h2>说明:</h2>
<p class="des">
PaymentChannel对象表示特定的支付通道,用于向系统请求支付操作。
</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.payment.PaymentChannel.id">id</a>: 支付通道标识</li>
<li>
<a href="#plus.payment.PaymentChannel.description">description</a>: 支付通道描述</li>
<li>
<a href="#plus.payment.PaymentChannel.serviceReady">serviceReady</a>: 支付通道服务是否安装</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.payment.PaymentChannel.installService">installService</a>: 安装支付通道依赖的服务</li>
<li>
<a href="#plus.payment.PaymentChannel.requestOrder">requestOrder</a>: 向IAP服务器请求支付订单</li>
<li>
<a href="#plus.payment.PaymentChannel.restoreComplateRequest">restoreComplateRequest</a>: 向IAP服务器请求已经购买的非消耗性商品和订阅商品</li>
</ul>
<h1><a name="plus.payment.OrderStatementIAP">OrderStatementIAP</a></h1>
<p>IAP订单数据对象</p>
<pre class="prettyprint linenums">
interface plus.payment.OrderStatementIAP {
attribute String productid;
attribute String username;
attribute String quantity;
}
</pre>
<h2>说明:</h2>
<p class="des">
描述IAP商品订单信息,如标识、数量等。
</p>
<h2>属性:</h2>
<ul>
<li>productid: <em>(<font class="type">String</font>
类型
)</em>商品的标识<br>
</li>
<li>username: <em>(<font class="type">String</font>
类型
)</em>购买用户名称<br>
</li>
<li>quantity: <em>(<font class="type">String</font>
类型
)</em>商品数量<br>
</li>
</ul>
<h1><a name="plus.payment.PaymentResult">PaymentResult</a></h1>
<p>支付操作结果对象</p>
<pre class="prettyprint linenums">
interface plus.payment.PaymentResult {
attribute PaymentChannel channel;
attribute String tradeno;
attribute String description;
attribute String url;
attribute String signature;
attribute String rawdata;
}
</pre>
<h2>说明:</h2>
<p class="des">
PaymentResult对象表示支付操作返回结果,用于确认支付操作成功。
</p>
<h2>属性:</h2>
<ul>
<li>channel: <em>(<a href="#plus.payment.PaymentChannel">PaymentChannel</a>
类型
)</em>支付通道对象<br><p>
用于发起支付操作的支付通道对象。
</p>
</li>
<li>tradeno: <em>(<font class="type">String</font>
类型
)</em>交易编号信息<br><p>
如果支付平台不支持此数据则返回undefined。
</p>
</li>
<li>description: <em>(<font class="type">Boolean</font>
类型
)</em>交易描述信息<br><p>
如果支付平台不支持此数据则返回undefined。
</p>
</li>
<li>url: <em>(<font class="type">Boolean</font>
类型
)</em>查找支付交易信息地址<br><p>
用于向支付平台查询交易信息,如果支付平台不支持此数据则返回undefined。
</p>
</li>
<li>signature: <em>(<font class="type">String</font>
类型
)</em>支付操作指纹信息<br><p>
用于向支付平台查询支付订单信息,如果支付平台不支持此数据则返回undefined。
</p>
</li>
<li>rawdata: <em>(<font class="type">String</font>
类型
)</em>支付平台返回的原始数据<br><p>
如果支付平台返回key-value类型字符串,则组合成符合JSON格式的字符串。
</p>
</li>
</ul>
<h1><a name="plus.payment.IAPProduct">IAPProduct</a></h1>
<p>IAP商品对象</p>
<pre class="prettyprint linenums">
interface plus.payment.IAPProduct {
attribute String productid;
attribute String price;
attribute String title;
attribute String description;
}
</pre>
<h2>说明:</h2>
<p class="des">
描述IAP商品详细信息,如标识、价格、标题、描述信息等。
</p>
<h2>属性:</h2>
<ul>
<li>productid: <em>(<font class="type">String</font>
类型
)</em>商品的标识<br>
</li>
<li>price: <em>(<font class="type">String</font>
类型
)</em>商品的价格<br>
</li>
<li>title: <em>(<font class="type">String</font>
类型
)</em>商品标题<br>
</li>
<li>description: <em>(<font class="type">String</font>
类型
)</em>商品的描述信息<br>
</li>
</ul>
<h1><a name="plus.payment.IAPProductInfo">IAPProductInfo</a></h1>
<p>购买IAP商品对象</p>
<pre class="prettyprint linenums">
interface plus.payment.IAPProductInfo {
attribute String productIdentifier;
attribute String quantity;
}
</pre>
<h2>说明:</h2>
<p class="des">
描述购买的IAP商品详细信息,如标识、数量等。
</p>
<h2>属性:</h2>
<ul>
<li>productIdentifier: <em>(<font class="type">String</font>
类型
)</em>商品的标识<br>
</li>
<li>quantity: <em>(<font class="type">String</font>
类型
)</em>商品的数量<br>
</li>
</ul>
<h1><a name="plus.payment.IAPTransaction">IAPTransaction</a></h1>
<p>购买IAP商品交易信息对象</p>
<pre class="prettyprint linenums">
interface plus.payment.IAPTransaction {
attribute IAPProductInfo payment;
attribute String transactionDate;
attribute String transactionIdentifier;
attribute String transactionReceipt;
attribute String transactionState;
}
</pre>
<h2>说明:</h2>
<p class="des">
描述购买的IAP商品交易详细信息,如购买商品信息、交易日期、订单标识等。
</p>
<h2>属性:</h2>
<ul>
<li>payment: <em>(<font class="type">String</font>
类型
)</em>购买商品的信息<br>
</li>
<li>transactionDate: <em>(<font class="type">String</font>
类型
)</em>购买商品的交易日期<br>
</li>
<li>transactionIdentifier: <em>(<font class="type">String</font>
类型
)</em>购买商品的交易订单标识<br>
</li>
<li>transactionReceipt: <em>(<font class="type">String</font>
类型
)</em>购买商品的交易收据<br><p>
base64编码格式字符串数据。
</p>
</li>
<li>transactionState: <em>(<font class="type">String</font>
类型
)</em>购买商品的交易状态<br><p>
可取值:"1"为支付成功;"2"为支付失败;"3"为支付已恢复。
</p>
</li>
</ul>
<h1><a name="plus.payment.ChannelsSuccessCallback">ChannelsSuccessCallback</a></h1>
<p>获取支付通道成功回调</p>
<pre class="prettyprint linenums">
void ChannelsSuccessCallback( channels ) {
// Get payment channels success code
}
</pre>
<h2>说明:</h2>
<p class="des">
当获取支付通道列表成功时的回调函数,用于返回终端支持的支付通道列表。
</p>
<h2>参数:</h2>
<ul><li>channels:
<em>(
<font class="type">Array</font>
)
必选 </em>数组,系统支持的支付通道PaymentChannel列表<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.payment.IapRequestOrderSuccessCallback">IapRequestOrderSuccessCallback</a></h1>
<p>请求支付商品列表回调方法</p>
<pre class="prettyprint linenums">
void onsuccess( results ) {
// Payment success code
}
</pre>
<h2>说明:</h2>
<p class="des">
获取IAP商品列表信息成功时的回调函数,返回商品详细信息。
</p>
<h2>参数:</h2>
<ul><li>results:
<em>(
<font class="type">Array</font>[
<a href="#plus.payment.IAPProduct">IAPProduct</a>
]
)
必选 </em>商品信息数据<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.payment.IapRestoreComplateRequestCallback">IapRestoreComplateRequestCallback</a></h1>
<p>请求已经购买的非消耗性商品和订阅商品回调方法</p>
<pre class="prettyprint linenums">
void onsuccess( results ) {
// Payment success code
}
</pre>
<h2>说明:</h2>
<p class="des">
获取IAP商品列表信息成功时的回调函数,返回商品详细信息。
</p>
<h2>参数:</h2>
<ul><li>results:
<em>(
<font class="type">Array</font>[
<a href="#plus.payment.IAPTransaction">IAPTransaction</a>
]
)
必选 </em>已购买的非消耗性商品和订阅商品交易信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.payment.PaymentSuccessCallback">PaymentSuccessCallback</a></h1>
<p>支付操作成功回调</p>
<pre class="prettyprint linenums">
void PaymentSuccessCallback ( result ) {
// Payment success code
}
</pre>
<h2>说明:</h2>
<p class="des">
当支付操作成功时的回调函数,用于返回支付操作的成功信息。
</p>
<h2>参数:</h2>
<ul><li>result :
<em>(
<a href="#plus.payment.PaymentResult">PaymentResult</a>
|
<a href="#plus.payment.IAPTransaction">IAPTransaction</a>
)
必选 </em>支付操作成功的信息<br>
iOS平台使用IAP支付返回的数据类型为IAPTransaction。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.payment.PaymentErrorCallback">PaymentErrorCallback</a></h1>
<p>支付操作失败回调</p>
<pre class="prettyprint linenums">
void PaymentErrorCallback(error){
// Payment error code
}
</pre>
<h2>说明:</h2>
<p class="des">当支付操作失败时的回调函数,用于返回支付操作失败的错误信息。</p>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>支付操作失败错误信息,可通过error.code获取错误代码,具体错误码有各支付通道定义<br>
支付宝支付错误代码如下:
62000,客户端未安装支付通道依赖的服务;
62001,用户取消支付操作;
62002,此设备不支持支付;
62003,数据格式错误;
62004,支付账号状态错误;
62005,订单信息错误;
62006,支付操作内部错误;
62007,支付服务器错误;
62008,网络问题引起的错误;
62009,其它未定义的错误。
微信支付错误代码如下:
-1,一般错误;
-2,用户取消;
-3,发送失败;
-4,认证被否决;
-5,不支持错误。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+78
View File
@@ -0,0 +1,78 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.proximity">proximity</a></h1>
<p>Proximity模块管理设备距离传感器,可获取当前设备的接近距离信息,通过plus.proximity可获取设备距离传感管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.proximity.getCurrentProximity">getCurrentProximity</a>: 获取当前设备的接近距离信息</li>
<li>
<a href="#plus.proximity.watchProximity">watchProximity</a>: 监听设备接近距离的变化</li>
<li>
<a href="#plus.proximity.clearWatch">clearWatch</a>: 关闭监听设备接近距离变化</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.proximity.ProximitySuccessCallback">ProximitySuccessCallback</a>: 获取设备接近距离信息成功的回调函数</li>
<li>
<a href="#plus.proximity.ProximityErrorCallback">ProximityErrorCallback</a>: 获取设备接近距离信息失败的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Proximity": {
"description": "距离感应器"
}
}
}
</pre>
<h1><a name="plus.proximity.ProximitySuccessCallback">ProximitySuccessCallback</a></h1>
<p>获取设备接近距离信息成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( distance ) {
// Get distance success code.
}
</pre>
<h2>参数:</h2>
<ul><li>distance:
<em>(
<font class="type">Number</font>
)
必选 </em>设备接近距离<br>设备接近距离传感器获取的距离值,单位为厘米。如果感应器无法获取准确的距离值,则在接近设备时返回0,否则返回Infinity。</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.proximity.ProximityErrorCallback">ProximityErrorCallback</a></h1>
<p>获取设备接近距离信息失败的回调函数</p>
<pre class="prettyprint linenums">
void onError( error ) {
// Get distance error code.
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>失败信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+198
View File
@@ -0,0 +1,198 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.push">push</a></h1>
<p>Push模块管理推送消息功能,可以实现在线、离线的消息推送,通过plus.push可获取推送消息管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.push.addEventListener">addEventListener</a>: 添加推送消息事件监听器</li>
<li>
<a href="#plus.push.clear">clear</a>: 清空所有推送消息</li>
<li>
<a href="#plus.push.createMessage">createMessage</a>: 创建本地消息</li>
<li>
<a href="#plus.push.getAllMessage">getAllMessage</a>: 获取所有推送消息</li>
<li>
<a href="#plus.push.getClientInfo">getClientInfo</a>: 获取客户端推送标识信息</li>
<li>
<a href="#plus.push.setAutoNotification">setAutoNotification</a>: 设置程序是否将消息显示在系统消息中心</li>
<li>
<a href="#plus.push.remove">remove</a>: 删除推送消息</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.push.ClientInfo">ClientInfo</a>: JSON对象,获取的客户端标识信息</li>
<li>
<a href="#plus.push.PushMessage">PushMessage</a>: JSON对象,推送消息对象</li>
<li>
<a href="#plus.push.MessageOptions">MessageOptions</a>: JSON对象,获客户端创建本地消息的参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.push.PushReceiveCallback">PushReceiveCallback</a>: 客户端接收到推动消息的回调函数</li>
<li>
<a href="#plus.push.PushClickCallback">PushClickCallback</a>: 用户点击推送消息事件的回调函数</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Push": {
"description": "消息推送"
}
}
}
</pre>
属性:
<ul><li>cover: 设定显示推送消息的模式<br><p>
可取值true或false,true表示推送消息覆盖模式显示,即仅显示最后接收到的推送消息;false表示在系统消息中心显示多条消息。
默认值为ture。
</p>
<h3>平台支持</h3>
<ul>
<li>Android - 2.2+ (支持)</li>
<li>iOS - 4.3+ (不支持):
不支持覆盖消息,每条信息都在系统消息中心,忽略cover属性值。
</li>
</ul>
</li></ul>
<h1><a name="plus.push.ClientInfo">ClientInfo</a></h1>
<p>JSON对象,获取的客户端标识信息</p>
<h2>属性:</h2>
<ul>
<li>token: <em>(<font class="type">String</font>
类型
)</em>设备令牌(iOS设备唯一标识),用于APNS服务推送中标识设备的身份<br>
</li>
<li>clientid: <em>(<font class="type">String</font>
类型
)</em>推送服务令牌(设备唯一标识),用于标识推送信息接收者身份<br><p>
第三方推送服务器管理的设备唯一标识,在iOS平台此值通常与token不同;在其它平台此值通常与token值一致。
此值与设备及应用都相关,即不同的apk/ipa安装到同一台设备上的值都不相同。
</p>
</li>
<li>appid: <em>(<font class="type">String</font>
类型
)</em>第三方推送服务的应用标识<br><p>第三方推送服务器管理的应用标识,通常需要在第三方推送服务器平台进行注册获取。</p>
</li>
<li>appkey: <em>(<font class="type">String</font>
类型
)</em>第三方推送服务器的应用键值<br><p>第三方推送服务器管理的应用键值,通常需要在第三方推送服务器平台进行注册获取。</p>
</li>
</ul>
<h1><a name="plus.push.PushMessage">PushMessage</a></h1>
<p>JSON对象,推送消息对象</p>
<h2>属性:</h2>
<ul>
<li>title: <em>(<font class="type">String</font>
类型
)</em>推送消息显示的标题<br>
</li>
<li>content: <em>(<font class="type">String</font>
类型
)</em>推送消息显示的内容<br>
</li>
<li>payload: <em>(<font class="type">JSON</font>
类型
)</em>推送消息承载的数据<br><p>如果推送消息中传输的数据不符合JSON格式,则作为String类型数据保存。</p>
</li>
<li>aps: <em>(<font class="type">JSON</font>
类型
)</em>Apple APNS推送协议数据<br>
</li>
</ul>
<h1><a name="plus.push.MessageOptions">MessageOptions</a></h1>
<p>JSON对象,获客户端创建本地消息的参数</p>
<h2>属性:</h2>
<ul>
<li>appid: <em>(<font class="type">String</font>
类型
)</em>要启动流应用的appid<br><p>
默认值为当前流应用的appid。
</p>
</li>
<li>title: <em>(<font class="type">String</font>
类型
)</em>推送消息的标题<br><p>
在系统消息中心显示的通知消息标题,默认值为程序的名称。
</p>
</li>
<li>sound: <em>(<font class="type">String</font>
类型
)</em>推送消息的提示音<br><p>
显示消息时的播放的提示音,可取值:
“system”-表示使用系统通知提示音;
“none”-表示不使用提示音;
默认值为“system”。
</p>
</li>
<li>cover: <em>(<font class="type">Boolean</font>
类型
)</em>是否覆盖上一次提示的消息<br><p>
可取值true或false,true为覆盖,false不覆盖,默认为permission中设置的cover值。
</p>
</li>
<li>when: <em>(<font class="type">Date</font>
类型
)</em>消息上显示的提示时间<br><p>
默认为当前时间,如果延迟显示则使用延时后显示消息的时间。
</p>
</li>
<li>delay: <em>(<font class="type">Number</font>
类型
)</em>提示消息延迟显示的时间<br><p>
当设备接收到推送消息后,可不立即显示,而是延迟一段时间显示,延迟时间单位为s,默认为0s,立即显示。
</p>
</li>
</ul>
<h1><a name="plus.push.PushReceiveCallback">PushReceiveCallback</a></h1>
<p>客户端接收到推动消息的回调函数</p>
<pre class="prettyprint linenums">
void onReceive( msg ) {
// Recieved push message code.
}
</pre>
<h2>参数:</h2>
<ul><li>msg:
<em>(
<font class="type">String</font>
)
必选 </em>接收到的推送信息msg<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.push.PushClickCallback">PushClickCallback</a></h1>
<p>用户点击推送消息事件的回调函数</p>
<pre class="prettyprint linenums">
void onClick( msg ) {
// Clicked push message code.
}
</pre>
<h2>参数:</h2>
<ul><li>msg:
<em>(
<font class="type">String</font>
)
必选 </em>用户点击的推送信息msg<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+61
View File
@@ -0,0 +1,61 @@
* {
-webkit-user-select: none;
-ms-touch-select: none;
/*
-ms-touch-action: none;
*/
}
html {
width: 100%;
height: 100%;
}
body {
color:#333;
font-family: Verdana, Arial, Helvetica , "Microsoft YaHei" , sans-serif;
font-size:14px;
word-break: break-all;
-webkit-touch-callout:none;
-webkit-tap-highlight-color:rgba(0,0,0,0);
-webkit-text-size-adjust:none;
}
.content {
padding: 0 0.5em;
}
h1 {
border-bottom:2px solid;
font-size:1.6em;
font-weight:bold;
margin:2em 0px 0.5em 0px;
}
h2 {
font-size:1.2em;
font-weight:bold;
margin:1em 0px 0.5em 0px;
text-shadow:#FFFFFF 0px 1px 1px;
}
h3 {
font-size:1.1em;
font-weight:bold;
margin:0.8em 0px 0.5em 0px;
text-shadow:#FFFFFF 0px 1px 1px;
}
em {
font-size: 0.8em;
color: #999;
}
ul {
margin: 0;
padding: 0 0 0 2em;
}
a {
color:#D84C29;
text-decoration:none;
}
.des {
text-indent: 2em;
margin: 0;
}
.type{
color:#0A0;text-decoration:none;-webkit-tap-highlight-color:rgba(0,0,0,0);
}
+14
View File
@@ -0,0 +1,14 @@
(function(w){
// 空函数
function shield(){
return false;
}
//取消浏览器的所有事件,使得active的样式在手机上正常生效
document.addEventListener('touchstart',shield,false);
document.oncontextmenu=shield;
// DOMContentLoaded事件处理
document.addEventListener('DOMContentLoaded',function(){
document.body.onselectstart=shield;
prettyPrint();
},false);
})(window);
File diff suppressed because it is too large Load Diff
+124
View File
@@ -0,0 +1,124 @@
/*
* Derived from einaros's Sons of Obsidian theme at
* http://studiostyl.es/schemes/son-of-obsidian by
* Alex Ford of CodeTunnel:
* http://CodeTunnel.com/blog/post/71/google-code-prettify-obsidian-theme
*/
.str
{
color: #EC7600;
}
.kwd
{
color: #93C763;
}
.com
{
color: #66747B;
}
.typ
{
color: #678CB1;
}
.lit
{
color: #FACD22;
}
.pun
{
color: #F1F2F3;
}
.pln
{
color: #F1F2F3;
}
.tag
{
color: #8AC763;
}
.atn
{
color: #E0E2E4;
}
.atv
{
color: #EC7600;
}
.dec
{
color: purple;
}
pre.prettyprint
{
border: 0px solid #888;
}
ol.linenums
{
margin-top: 0;
margin-bottom: 0;
}
.prettyprint {
background: #000;
border-radius: 3px;
padding: 1em 0;
overflow-x: scroll;
-webkit-overflow-scrolling: touch;
/*white-space: pre-wrap;*//*css-3*/
/*word-wrap: break-word;*//*Internet Explorer 5.5+*/
}
li.L0, li.L1, li.L2, li.L3, li.L4, li.L5, li.L6, li.L7, li.L8, li.L9
{
color: #555;
list-style-type: decimal;
}
/*li.L1, li.L3, li.L5, li.L7, li.L9 {
background: #222;
}*/
@media print
{
.str
{
color: #060;
}
.kwd
{
color: #006;
font-weight: bold;
}
.com
{
color: #600;
font-style: italic;
}
.typ
{
color: #404;
font-weight: bold;
}
.lit
{
color: #044;
}
.pun
{
color: #440;
}
.pln
{
color: #000;
}
.tag
{
color: #006;
font-weight: bold;
}
.atn
{
color: #404;
}
.atv
{
color: #060;
}
}
+262
View File
@@ -0,0 +1,262 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.runtime">runtime</a></h1>
<p>Runtime模块管理运行环境,可用于获取当前运行环境信息、与其它程序进行通讯等。通过plus.runtime可获取运行环境管理对象。</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.runtime.appid">appid</a>: 当前应用的APPID</li>
<li>
<a href="#plus.runtime.arguments">arguments</a>: 第三方程序调用时传递给程序的参数</li>
<li>
<a href="#plus.runtime.channel">channel</a>: 应用的市场推广渠道标识</li>
<li>
<a href="#plus.runtime.launcher">launcher</a>: 应用启动来源</li>
<li>
<a href="#plus.runtime.origin">origin</a>: 应用安装来源</li>
<li>
<a href="#plus.runtime.version">version</a>: 客户端的版本号</li>
<li>
<a href="#plus.runtime.innerVersion">innerVersion</a>: 客户端5+运行环境的版本号</li>
<li>
<a href="#plus.runtime.launchLoadedTime">launchLoadedTime</a>: 获取当前应用首页加载的时间</li>
<li>
<a href="#plus.runtime.processId">processId</a>: 获取当前应用的进程标识</li>
<li>
<a href="#plus.runtime.startupTime">startupTime</a>: 获取当前应用的启动时间</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.runtime.getProperty">getProperty</a>: 获取指定APPID对应的应用信息</li>
<li>
<a href="#plus.runtime.install">install</a>: 安装应用</li>
<li>
<a href="#plus.runtime.quit">quit</a>: 退出客户端程序</li>
<li>
<a href="#plus.runtime.restart">restart</a>: 重启当前的应用</li>
<li>
<a href="#plus.runtime.setBadgeNumber">setBadgeNumber</a>: 设置程序快捷方式上显示的提示数字</li>
<li>
<a href="#plus.runtime.openURL">openURL</a>: 调用第三方程序打开指定的URL</li>
<li>
<a href="#plus.runtime.openFile">openFile</a>: 调用第三方程序打开指定的文件</li>
<li>
<a href="#plus.runtime.launchApplication">launchApplication</a>: 调用第三方程序</li>
<li>
<a href="#plus.runtime.isApplicationExist">isApplicationExist</a>: 判断第三方程序是否已存在</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.runtime.WidgetOptions">WidgetOptions</a>: JSON对象,应用安装参数</li>
<li>
<a href="#plus.runtime.WidgetInfo">WidgetInfo</a>: JSON对象,应用信息</li>
<li>
<a href="#plus.runtime.OpenFileOptions">OpenFileOptions</a>: JSON对象,打开文件参数</li>
<li>
<a href="#plus.runtime.ApplicationInf">ApplicationInf</a>: JSON对象,打开第三方程序参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.runtime.InstallSuccessCallback">InstallSuccessCallback</a>: 安装应用成功回调函数</li>
<li>
<a href="#plus.runtime.InstallErrorCallback">InstallErrorCallback</a>: 安装应用失败回调函数</li>
<li>
<a href="#plus.runtime.GetPropertyCallBack">GetPropertyCallBack</a>: 获取应用属性成功回调函数</li>
<li>
<a href="#plus.runtime.OpenErrorCallback">OpenErrorCallback</a>: 打开本地文件或URL失败回调函数</li>
<li>
<a href="#plus.runtime.LaunchErrorCallback">LaunchErrorCallback</a>: 调用第三方程序失败回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Runtime": {
"description": "运行环境"
}
}
}
</pre>
<h1><a name="plus.runtime.WidgetOptions">WidgetOptions</a></h1>
<p>JSON对象,应用安装参数</p>
<h2>说明:</h2>
<p class="des">可通过对象设置安装的应用是否进行appid校验、版本号校验等。</p>
<h2>属性:</h2>
<ul><li>force: <em>(<font class="type">Boolean</font>
类型
)</em>是否强制安装<br><p>
true表示强制安装,不进行版本号的校验;false则需要版本号校验,如果将要安装应用的版本号不高于现有应用的版本号则终止安装,并返回安装失败。
仅安装wgt和wgtu时生效,默认值 false。
</p>
</li></ul>
<h1><a name="plus.runtime.WidgetInfo">WidgetInfo</a></h1>
<p>JSON对象,应用信息</p>
<h2>属性:</h2>
<ul>
<li>appid: <em>(<font class="type">String</font>
类型
)</em>应用的APPID<br>
</li>
<li>version: <em>(<font class="type">String</font>
类型
)</em>应用的版本号<br>
</li>
<li>name: <em>(<font class="type">String</font>
类型
)</em>应用的名称<br>
</li>
<li>description: <em>(<font class="type">String</font>
类型
)</em>应用描述信息<br>
</li>
<li>author: <em>(<font class="type">String</font>
类型
)</em>应用描述信息<br>
</li>
<li>email: <em>(<font class="type">String</font>
类型
)</em>开发者邮箱地址<br>
</li>
<li>license: <em>(<font class="type">String</font>
类型
)</em>应用授权描述信息<br>
</li>
<li>licensehref: <em>(<font class="type">String</font>
类型
)</em>应用授权说明链接地址<br>
</li>
<li>features: <em>(<font class="type">String[]</font>
类型
)</em>应用许可特性列表<br>
</li>
</ul>
<h1><a name="plus.runtime.OpenFileOptions">OpenFileOptions</a></h1>
<p>JSON对象,打开文件参数</p>
<h2>属性:</h2>
<ul>
<li>pname: <em>(<font class="type">String</font>
类型
)</em>优先使用的程序包名<br><p>
如果指定包名的程序已经安装,则调用其打开文件,若程序不支持打开文件则触发错误回调。
如果指定包名的程序未安装,则弹出系统支持打开此文件的列表,由用户选择程序打开。
</p>
</li>
<li>popover: <em>(<font class="type">json</font>
类型
)</em>弹出系统选择程序界面指示区域<br><p>
JSON对象,格式如{top:10;left:10;width:200;height:200;},所有值为像素值,左上坐标相对于容器webview的位置。仅在iPad设备平台有效。
</p>
</li>
</ul>
<h1><a name="plus.runtime.ApplicationInf">ApplicationInf</a></h1>
<p>JSON对象,打开第三方程序参数</p>
<h2>属性:</h2>
<ul>
<li>pname: <em>(<font class="type">String</font>
类型
)</em>第三方程序包名<br><p>仅Android平台支持,表示程序的包名,其它平台忽略此属性值。</p>
</li>
<li>action: <em>(<font class="type">String</font>
类型
)</em>程序的操作行为<br><p>Android平台上与系统的action值一致;iOS平台为要调用程序的URLScheme格式字符串。</p>
</li>
<li>extra: <em>(<font class="type">JSON</font>
类型
)</em>调用程序的参数<br><p>仅Android平台支持,为JSON格式,用于传递给要调用程序的参数,如extra:{url:"http://www.html5plus.org"}。</p>
</li>
</ul>
<h1><a name="plus.runtime.InstallSuccessCallback">InstallSuccessCallback</a></h1>
<p>安装应用成功回调函数</p>
<pre class="prettyprint linenums">
void onSuccess(widgetInfo){
// Code here
}
</pre>
<h2>参数:</h2>
<ul><li>widgetInfo:
<em>(
<font class="type">WidgetInfo</font>
)
必选 </em><br>应用信息,参见:WidgetInfo</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.runtime.InstallErrorCallback">InstallErrorCallback</a></h1>
<p>安装应用失败回调函数</p>
<pre class="prettyprint linenums">
void onError(error){
// Handle the error
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em><br>安装失败的错误信息</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.runtime.GetPropertyCallBack">GetPropertyCallBack</a></h1>
<p>获取应用属性成功回调函数</p>
<pre class="prettyprint linenums">
void onGetPropertyCB(widgetInfo){
// Code here
}
</pre>
<h2>参数:</h2>
<ul><li>widgetInfo:
<em>(
<a href="#plus.runtime.WidgetInfo">WidgetInfo</a>
)
必选 </em><br>应用信息,参见:WidgetInfo</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.runtime.OpenErrorCallback">OpenErrorCallback</a></h1>
<p>打开本地文件或URL失败回调函数</p>
<pre class="prettyprint linenums">
void onError(error){
// Handle the error
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em><br>打开操作失败的错误信息</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.runtime.LaunchErrorCallback">LaunchErrorCallback</a></h1>
<p>调用第三方程序失败回调函数</p>
<pre class="prettyprint linenums">
void onError(error){
// Handle the error
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em><br>操作失败的错误信息</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+368
View File
@@ -0,0 +1,368 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.share">share</a></h1>
<p>Share模块管理客户端的社交分享功能,提供调用终端社交软件的分享能力。通过plus.share可获取社交分享管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.share.getServices">getServices</a>: 获取分享服务</li>
<li>
<a href="#plus.share.sendWithSystem">sendWithSystem</a>: 使用系统组件发送分享</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.share.ShareService">ShareService</a>: 分享服务对象</li>
<li>
<a href="#plus.share.ShareServerIdentity">ShareServerIdentity</a>: 分享服务标识</li>
<li>
<a href="#plus.share.ShareMessage">ShareMessage</a>: JSON对象,分享消息对象</li>
<li>
<a href="#plus.share.GeoPosition">GeoPosition</a>: JSON对象,用户位置信息</li>
<li>
<a href="#plus.share.ShareMessageExtra">ShareMessageExtra</a>: JSON对象,保存分享消息扩展信息</li>
<li>
<a href="#plus.share.Authorize">Authorize</a>: 分享授权控件对象</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.share.ServicesSuccessCallback">ServicesSuccessCallback</a>: 获取分享服务成功回调</li>
<li>
<a href="#plus.share.AuthorizeSuccessCallback">AuthorizeSuccessCallback</a>: 分享授权认证成功回调</li>
<li>
<a href="#plus.share.ShareSuccessCallback">ShareSuccessCallback</a>: 分享操作成功回调</li>
<li>
<a href="#plus.share.ShareErrorCallback">ShareErrorCallback</a>: 分享操作失败回调</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Share": {
"description": "分享"
}
}
}
</pre>
<h1><a name="plus.share.ShareService">ShareService</a></h1>
<p>分享服务对象</p>
<pre class="prettyprint linenums">
interface plus.share.ShareService {
// Attributes
attribute DOMString id;
attribute DOMString description;
attribute Boolean authenticated;
attribute DOMString accessToken;
attribute Boolean nativeClient;
// Methods
function void authorize( successCallback, errorCallback );
function void forbid();
function void send( message );
}
</pre>
<h2>说明:</h2>
<p class="des">
ShareService对象用于表示分享服务,在JS中为对象,用于向系统请求分享操作。
</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.share.ShareService.id">id</a>: 分享服务标识</li>
<li>
<a href="#plus.share.ShareService.description">description</a>: 分享服务描述</li>
<li>
<a href="#plus.share.ShareService.authenticated">authenticated</a>: 是否授权认证</li>
<li>
<a href="#plus.share.ShareService.accessToken">accessToken</a>: 授权认证信息</li>
<li>
<a href="#plus.share.ShareService.nativeClient">nativeClient</a>: 是否存在对应的分享客户端</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.share.ShareService.authorize">authorize</a>: 授权认证操作</li>
<li>
<a href="#plus.share.ShareService.forbid">forbid</a>: 取消授权认证</li>
<li>
<a href="#plus.share.ShareService.send">send</a>: 发送分享</li>
</ul>
<h1><a name="plus.share.ShareServerIdentity">ShareServerIdentity</a></h1>
<p>分享服务标识</p>
<h2>常量:</h2>
<ul>
<li>"sinaweibo": <em>(<font class="type">DOMString</font>
类型
)</em>新浪微博<br>
</li>
<li>"tencentweibo": <em>(<font class="type">DOMString</font>
类型
)</em>腾讯微博<br>
</li>
<li>"weixin": <em>(<font class="type">DOMString</font>
类型
)</em>微信<br>
</li>
</ul>
<h1><a name="plus.share.ShareMessage">ShareMessage</a></h1>
<p>JSON对象,分享消息对象</p>
<pre class="prettyprint linenums">
interface plus.share.ShareMessage {
attribute String content;
attribute String[] thumbs;
attribute String[] pictures;
attribute String href;
attribute String title;
attribute JSON extra;
attribute GEOPosition geo;
attribute ShareMessageExtra extra;
attribute String interface;
}
</pre>
<h2>说明:</h2>
<p class="des">ShareMessage对象用于表示分享消息内容,在JS中为JSON对象,用于向系统发送分享信息操作。</p>
<h2>属性:</h2>
<ul>
<li>content: <em>(<font class="type">String</font>
类型
)</em>分享消息的文字内容<br>
</li>
<li>pictures: <em>(<font class="type">Array</font>[
<font class="type">String</font>
]
类型
)</em>分享消息的图片<br><p>
分享消息中包含的图片路径,仅支持本地路径。
若分享平台仅支持提交一张图片,传入多张图片则仅提交第一张图片。
如果不能同时支持其它内容信息,优先级顺序为:pictures&gt;content。
</p>
</li>
<li>thumbs: <em>(<font class="type">Array</font>[
<font class="type">Stromg</font>
]
类型
)</em>分享消息的缩略图<br><p>
分享消息中包含的缩略图路径;
若分享平台仅支持提交一张图片,传入多张图片则仅提交第一张图片;
如果分享平台的信息不支持缩略图,若没有设置消息的图片(pictures)则使用缩略图,否则忽略其属性值。
注意:图片有大小限制,推荐图片小于20Kb。
</p>
</li>
<li>href: <em>(<font class="type">String</font>
类型
)</em>分享独立的链接<br><p>
分享独立链接地址,仅支持网络地址(以http://或https://开头)。
如果不能同时支持其它内容信息,优先级顺序为:href&gt;pictures&gt;content。
</p>
</li>
<li>title: <em>(<font class="type">String</font>
类型
)</em>分享消息的标题<br><p>
目前仅微信分享独立链接消息时支持。
</p>
</li>
<li>geo: <em>(<a href="#plus.share.GeoPosition">GeoPosition</a>
类型
)</em>分享消息中包含的用户地理信息数据<br>
</li>
<li>extra: <em>(<a href="#plus.share.ShareMessageExtra">ShareMessageExtra</a>
类型
)</em>分享消息扩展参数<br>
</li>
<li>interface: <em>(<font class="type">String</font>
类型
)</em>分享消息的模式<br><p>
可取值:
"auto" - 自动选择,如果已经安装微博客户端则采用编辑界面进行分享,否则采用无界面分享;
"slient" - 静默分享,采用无界面模式进行分享;
"editable" - 进入编辑界面,用户确认分享内容后发送,如果当前未安装微博客户端则触发错误回调。
默认值为"auto"。
(仅新浪微博分享时生效)
</p>
</li>
</ul>
<h1><a name="plus.share.GeoPosition">GeoPosition</a></h1>
<p>JSON对象,用户位置信息</p>
<pre class="prettyprint linenums">
interface plus.share.GeoPosition {
attribute Number latitude;
attribute Number longitude;
}
</pre>
<h2>说明:</h2>
<p class="des">
GeoPosition对象用于表示用户分享消息时的位置信息。用于标识分享操作时用户的位置信息。
</p>
<h2>属性:</h2>
<ul>
<li>latitude: <em>(<font class="type">Number</font>
类型
)</em>用户位置的纬度坐标信息<br>
</li>
<li>longitude: <em>(<font class="type">Number</font>
类型
)</em>用户位置的经度坐标信息<br>
</li>
</ul>
<h1><a name="plus.share.ShareMessageExtra">ShareMessageExtra</a></h1>
<p>JSON对象,保存分享消息扩展信息</p>
<pre class="prettyprint linenums">
interface plus.share.ShareMessageExtra {
attribute String scene;
}
</pre>
<h2>说明:</h2>
<p class="des">
ShareMessageExtra对象用于保存各分享平台扩展的参数,用于自定义分享功能。
</p>
<h2>属性:</h2>
<ul><li>scene: <em>(<font class="type">String</font>
类型
)</em>微信分享场景,仅微信分享平台有效<br><p>
可取值:
"WXSceneSession"分享到微信的“我的好友”;
"WXSceneTimeline"分享到微信的“朋友圈”中;
"WXSceneFavorite"分享到微信的“我的收藏”中。
默认值为"WXSceneSession"。
</p>
</li></ul>
<h1><a name="plus.share.Authorize">Authorize</a></h1>
<p>分享授权控件对象</p>
<pre class="prettyprint linenums">
interface plus.share.Authorize {
// Methods
function void load( id );
function void setVisible( visible );
// Events
function void onloaded();
function void onauthenticated();
function void onerror();
}
</pre>
<h2>说明:</h2>
<p class="des">
Authorize对象表示分享控件对象,用于在窗口中显示分享控件,使用此对象可自定义分享授权界面。
</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.share.Authorize.Authorize(id,display)">Authorize(id,display)</a>: 创建分享授权控件对象</li></ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.share.Authorize.load">load</a>: 加载分享授权页面</li>
<li>
<a href="#plus.share.Authorize.setVisible">setVisible</a>: 设置分享授权控件是否可见</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.share.Authorize.onloaded">onloaded</a>: 分享控件加载完成事件</li>
<li>
<a href="#plus.share.Authorize.onauthenticated">onauthenticated</a>: 分享授权认证成功事件</li>
<li>
<a href="#plus.share.Authorize.onerror">onerror</a>: 分享授权认证失败事件</li>
</ul>
<h1><a name="plus.share.ServicesSuccessCallback">ServicesSuccessCallback</a></h1>
<p>获取分享服务成功回调</p>
<pre class="prettyprint linenums">
void ServicesSuccessCallback( services ) {
// Get share services success code
}
</pre>
<h2>说明:</h2>
<p class="des">
当获取分享服务列表成功时的回调函数,用于返回终端支持的分享服务列表。
</p>
<h2>参数:</h2>
<ul><li>services:
<em>(
<font class="type">Array</font>[
<a href="#plus.share.ShareService">ShareService</a>
]
)
必选 </em>数组,运行环境支持的分享服务列表<br>
运行环境支持的分享服务列表数组,可通过services.length获取分享服务列表的数目。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.share.AuthorizeSuccessCallback">AuthorizeSuccessCallback</a></h1>
<p>分享授权认证成功回调</p>
<pre class="prettyprint linenums">
void AuthorizeSuccessCallback(services){
  // Authorize success code
}
</pre>
<h2>说明:</h2>
<p class="des">
分享服务授权认证操作成功时调用。
</p>
<h2>参数:</h2>
<ul><li>service:
<em>(
<a href="#plus.share.ShareService">ShareService</a>
)
必选 </em>授权认证操作的分享服务对象<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.share.ShareSuccessCallback">ShareSuccessCallback</a></h1>
<p>分享操作成功回调</p>
<pre class="prettyprint linenums">
void ShareSuccessCallback () {
// Share success code
}
</pre>
<h2>说明:</h2>
<p class="des">
分享操作成功回调函数,当分享操作成功时调用。
</p>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.share.ShareErrorCallback">ShareErrorCallback</a></h1>
<p>分享操作失败回调</p>
<pre class="prettyprint linenums">
void ShareErrorCallback ( error ) {
// Error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>说明:</h2>
<p class="des">
当分享操作失败时的回调函数,用于返回分享相关操作失败的错误信息。
</p>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>分享操作失败错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+181
View File
@@ -0,0 +1,181 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.speech">speech</a></h1>
<p>Speech模块管理语音输入功能,提供语音识别功能,可支持用户通过麦克风设备进行语音输入内容。通过plus.speech可获取语音输入管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.speech.startRecognize">startRecognize</a>: 启动语音识别</li>
<li>
<a href="#plus.speech.stopRecognize">stopRecognize</a>: 停止语音识别</li>
</ul>
<h2>对象:</h2>
<ul><li>
<a href="#plus.speech.SpeechRecognizeOption">SpeechRecognizeOption</a>: JSON对象,语音识别参数</li></ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.speech.RecognitionSuccessCallback">RecognitionSuccessCallback</a>: 语音识别成功回调</li>
<li>
<a href="#plus.speech.RecognitionErrorCallback%20">RecognitionErrorCallback </a>: 语音识别失败回调</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Speech": {
"description": "语音输入"
}
}
}
</pre>
<h1><a name="plus.speech.SpeechRecognizeOption">SpeechRecognizeOption</a></h1>
<p>JSON对象,语音识别参数</p>
<pre class="prettyprint linenums">
interface plus.speech.SpeechRecognizeOption {
attribute String engine;
attribute String service;
attribute Number timeout;
attribute String lang;
attribute String punctuation;
attribute Boolean continue;
attribute Number nbest;
attribute Boolean userInterface;
attribute EventHandler onstart;
attribute EventHandler onend;
attribute EventHandler onaudiostart;
attribute EventHandler onaudioend;
attribute EventHandler onrecognizestart;
attribute EventHandler onrecognizeend;
}
</pre>
<h2>说明:</h2>
<p class="des">
控制语音识别引擎内部参数,在JS中为JSON对象,在启动语音识别时使用。
</p>
<h2>属性:</h2>
<ul>
<li>engine: <em>(<font class="type">String</font>
类型
)</em>语音识别引擎标识<br><p>用于兼容多语音识别引擎的浏览器,建议使用语音识别厂商的产品名称,如未设置或设置不正确则使用浏览器默认的语音识别引擎。</p>
</li>
<li>service: <em>(<font class="type">String</font>
类型
)</em>语音识别引擎服务器地址<br><p>可使用url地址或ip地址,如service:192.168.1.99指定定制的语音识别引擎服务器。默认值为浏览器内置服务器地址。</p>
</li>
<li>timeout: <em>(<font class="type">Number</font>
类型
)</em>语音识别超时时间<br><p>语音识别超时的时间,单位为ms,如timeout:60000,默认值为10s。</p>
</li>
<li>lang: <em>(<font class="type">String</font>
类型
)</em>语音识别引擎的语言<br><p>
用于定义语音识别引擎的语言,其取值需符合W3C的Language codes规范。
目前讯飞语音支持以下语言:
"zh-cn" - 中文,普通话;
"en-us" - 英语;
"zh-cantonese" - 中文,粤语;
"zh-henanese" - 中文,河南话。
默认值为“zh-cn”。
</p>
</li>
<li>punctuation: <em>(<font class="type">Boolean</font>
类型
)</em>识别结果中是否包含标点符号<br><p>
true表示识别结果文本中包含标点符号,false表示识别结果文本中不包含标点符号。
默认值为true。
</p>
</li>
<li>continue: <em>(<font class="type">Boolean</font>
类型
)</em>语音识别是否采用持续模式<br><p>设置为true表示语音引擎不会根据语音输入自动结束,识别到文本内容将多次调用successCallback函数返回,如果需要结束语音识别则必须调用stopRecognize接口,默认值为false。</p>
</li>
<li>nbest: <em>(<font class="type">Number</font>
类型
)</em>指定识别结果识别包括多候选结果<br><p>用于指定识别结果识别包括多候选结果。如nbest:3,识别返回3个候选结果,默认值为1。</p>
</li>
<li>userInterface: <em>(<font class="type">Boolean</font>
类型
)</em>识别时是否显示用户界面<br><p>用于指定识别时是否显示用户界面,设置为true表示显示浏览器内置语音识别界面;设置为false表示不显示浏览器内置语音识别界面。默认值为true。</p>
</li>
<li>onstart: <em>(<font class="type">EventHandler</font>
类型
)</em>语音识别开始事件<br><p>事件函数,语音识别开始启动,在调用startRecognize方法后触发,与onend事件成对触发。</p>
</li>
<li>onend: <em>(<font class="type">EventHandler</font>
类型
)</em>语音识别结束事件<br><p>事件函数,语音识别结束,在调用stopRecognize方法后触发,或者在引擎内部自动完成语音识别后触发,与onstart事件成对触发。</p>
</li>
<li>onaudiostart: <em>(<font class="type">EventHandler</font>
类型
)</em>录音开始事件<br><p>事件函数,录音开始事件,启动语音识别后,调用设备麦克风设备开始一段语音录音时触发,与onaudioend事件成对触发。</p>
</li>
<li>onaudioend: <em>(<font class="type">EventHandler</font>
类型
)</em>录音结束事件<br><p>事件函数,录音结束事件,调用麦克风完成一段语音录音时触发,与onaudiostart事件成对触发。</p>
</li>
<li>onrecognizestart: <em>(<font class="type">EventHandler</font>
类型
)</em>录音识别开始事件<br><p>事件函数,录音识别开始事件,开始对语音录音数据分析识别,与onrecognizeend事件成对触发。</p>
</li>
<li>onrecognizeend: <em>(<font class="type">EventHandler</font>
类型
)</em>录音识别结束事件<br><p>事件函数,录音识别结束事件,开始对语音录音数据分析识别完成,与onrecognizestart事件成对触发。</p>
</li>
</ul>
<h1><a name="plus.speech.RecognitionSuccessCallback">RecognitionSuccessCallback</a></h1>
<p>语音识别成功回调</p>
<pre class="prettyprint linenums">
void RecognitionSuccessCallback ( results ) {
// Recognition success code
}
</pre>
<h2>说明:</h2>
<p class="des">当语音识别成功时的回调函数,用于返回语音识别出的文本内容。</p>
<h2>参数:</h2>
<ul><li>results:
<em>(
<font class="type">Array</font>[
<font class="type">String</font>
]
)
必选 </em>语音识别出的文本内容数组<br>语音识别出的候选文本内容,区配度高的在数组的前面,通过其length属性可获取总的候选内容的长度</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.speech.RecognitionErrorCallback%20">RecognitionErrorCallback </a></h1>
<p>语音识别失败回调</p>
<pre class="prettyprint linenums">
void RecognitionErrorCallback ( error ) {
// Recognition error code
}
</pre>
<h2>说明:</h2>
<p class="des">当语音识别失败时的回调函数,用于返回语音识别失败的错误信息。</p>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">DOMException</font>
)
必选 </em>语音识别失败的错误信息<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+58
View File
@@ -0,0 +1,58 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.navigator">navigator</a></h1>
<p>Splashscreen管理程序启动界面</p>
<h2>方法:</h2>
<ul><li>
<a href="#plus.navigator.closeSplashscreen">closeSplashscreen</a>: 关闭程序启动界面</li></ul>
<h2>权限:</h2>
<p>
5+功能模块(permissions)。
在plus节点下配置splashscreen节点信息设置程序启动界面参数。
</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Navigator": {
"description": "浏览器信息"
}
}
// ...
"plus":{
// ...
"splashscreen": {
"autoclose": "true", // 首页加载完成后自动关闭splash界面
"delay": ""
}
}
}
</pre>
属性:
<ul>
<li>autoclose: 是否自动关闭程序启动界面<br>
</li>
<li>delay: 启动界面延迟关闭时间<br><p>
仅在autioclose属性设置为"true"时有效,用于定义程序启动界面在应用的首界面加载完毕后延迟关闭的时间,单位为ms,默认值为0。
</p>
</li>
<li>waiting: 启动界面是否显示系统等待框<br><p>
系统等待框使用的是系统雪花控件,各平台效果存在差异。
</p>
</li>
</ul>
<br><br>
</div></body>
</html>
+42
View File
@@ -0,0 +1,42 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.statistic">statistic</a></h1>
<p>Statistic模块管理统计功能,用于提供应用内统计的能力,支持统计和分析用户属性和用户行为数据。通过plus.statistic可获取统计管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.statistic.eventTrig">eventTrig</a>: 触发事件</li>
<li>
<a href="#plus.statistic.eventDuration">eventDuration</a>: 精确持续事件</li>
<li>
<a href="#plus.statistic.eventStart">eventStart</a>: 开始持续事件(过期API,不推荐使用)</li>
<li>
<a href="#plus.statistic.eventEnd">eventEnd</a>: 结束持续事件(过期API,不推荐使用)</li>
</ul>
<h2>权限:</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Statistic": {
"description": "统计"
}
}
}
</pre>
<br><br>
</div></body>
</html>
+46
View File
@@ -0,0 +1,46 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.storage">storage</a></h1>
<p>Storage模块管理应用本地数据存储区,用于应用数据的保存和读取。应用本地数据与localStorage、sessionStorage的区别在于数据有效域不同,前者可在应用内跨域操作,数据存储期是持久化的,并且没有容量限制。通过plus.storage可获取应用本地数据管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.storage.getLength">getLength</a>: 获取应用存储区中保存的键值对的个数</li>
<li>
<a href="#plus.storage.getItem">getItem</a>: 通过键(key)检索获取应用存储的值</li>
<li>
<a href="#plus.storage.setItem">setItem</a>: 修改或添加键值(key-value)对数据到应用数据存储中</li>
<li>
<a href="#plus.storage.removeItem">removeItem</a>: 通过key值删除键值对存储的数据</li>
<li>
<a href="#plus.storage.clear">clear</a>: 清除应用所有的键值对存储数据</li>
<li>
<a href="#plus.storage.key">key</a>: 获取键值对中指定索引值的key值</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Storage": {
"description": "本地存储,访问应用本地存储数据"
}
}
}
</pre>
<br><br>
</div></body>
</html>
+311
View File
@@ -0,0 +1,311 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.uploader">uploader</a></h1>
<p>Uploader模块管理网络上传任务,用于从本地上传各种文件到服务器,并支持跨域访问操作。通过plus.uploader可获取上传管理对象。Uploader上传使用HTTP的POST方式提交数据,数据格式符合Multipart/form-data规范,即rfc1867(Form-based File Upload in HTML)协议。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.uploader.createUpload">createUpload</a>: 新建上传任务</li>
<li>
<a href="#plus.uploader.enumerate">enumerate</a>: 枚举上传任务</li>
<li>
<a href="#plus.uploader.clear">clear</a>: 清除上传任务</li>
<li>
<a href="#plus.uploader.startAll">startAll</a>: 开始所有上传任务</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.uploader.Upload">Upload</a>: Upload对象管理一个上传任务</li>
<li>
<a href="#plus.uploader.UploadEvent">UploadEvent</a>: 上传任务事件类型</li>
<li>
<a href="#plus.uploader.UploadState">UploadState</a>: 上传任务的状态,Number类型</li>
<li>
<a href="#plus.uploader.UploadOptions">UploadOptions</a>: JSON对象,创建上传任务的参数</li>
<li>
<a href="#plus.uploader.UploadFileOptions">UploadFileOptions</a>: JSON对象,添加上传文件的参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.uploader.UploadCompletedCallback">UploadCompletedCallback</a>: 上传任务完成时的回调函数</li>
<li>
<a href="#plus.uploader.UploadStateChangedCallback">UploadStateChangedCallback</a>: 上传任务状态变化回调函数,在上传任务状态发生变化时调用</li>
<li>
<a href="#plus.uploader.UploadEnumerateCallback">UploadEnumerateCallback</a>: 枚举上传任务回调函数,在枚举上传任务完成时时调用</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Uploader": {
"description": "文件上传,管理文件上传任务"
}
}
} </pre>
<h1><a name="plus.uploader.Upload">Upload</a></h1>
<p>Upload对象管理一个上传任务</p>
<pre class="prettyprint linenums">
interface Upload {
readonly attribute String url;
readonly attribute Number state;
readonly attribute UploadOptions options;
readonly attribute String responseText;
readonly attribute Number uploadedSize;
readonly attribute Number totalSize;
function void abort();
function Boolean addData( String key, String value );
function void addEventListener( String event, function Callback listener, Boolean capture );
function Boolean addFile( String path, UploadFileOptions options );
function String getAllResponseHeaders();
function String getResponseHeader( headerName );
function void pause();
function void resume();
function void setRequestHeader( String headerName, String headerValue );
function void start();
}
</pre>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.uploader.Upload.id">id</a>: 上传任务的标识</li>
<li>
<a href="#plus.uploader.Upload.url">url</a>: 上传文件的服务器地址</li>
<li>
<a href="#plus.uploader.Upload.state">state</a>: 任务的状态</li>
<li>
<a href="#plus.uploader.Upload.options">options</a>: 上传任务的参数</li>
<li>
<a href="#plus.uploader.Upload.responseText">responseText</a>: 上传任务完成后服务器返回的数据</li>
<li>
<a href="#plus.uploader.Upload.uploadedSize">uploadedSize</a>: 已完成上传数据的大小)</li>
<li>
<a href="#plus.uploader.Upload.totalSize">totalSize</a>: 上传数据的总大小</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.uploader.Upload.addFile">addFile</a>: 添加上传文件</li>
<li>
<a href="#plus.uploader.Upload.addData">addData</a>: 添加上传数据</li>
<li>
<a href="#plus.uploader.Upload.start">start</a>: 开始上传任务</li>
<li>
<a href="#plus.uploader.Upload.pause">pause</a>: 暂停上传任务</li>
<li>
<a href="#plus.uploader.Upload.resume">resume</a>: 恢复暂停的上传任务</li>
<li>
<a href="#plus.uploader.Upload.abort">abort</a>: 取消上传任务</li>
<li>
<a href="#plus.uploader.Upload.addEventListener">addEventListener</a>: 添加上传任务事件监听器</li>
<li>
<a href="#plus.uploader.Upload.getAllResponseHeaders">getAllResponseHeaders</a>: 获取上传请求HTTP响应头部信息</li>
<li>
<a href="#plus.uploader.Upload.getResponseHeader">getResponseHeader</a>: 获取上传请求指定的HTTP响应头部的值</li>
<li>
<a href="#plus.uploader.Upload.setRequestHeader">setRequestHeader</a>: 设置上传请求的HTTP头数据</li>
</ul>
<h1><a name="plus.uploader.UploadEvent">UploadEvent</a></h1>
<p>上传任务事件类型</p>
<h2>常量:</h2>
<ul><li>"statechanged": <em>(<font class="type">String</font>
类型
)</em>上传任务状态变化事件<br><p>
当上传任务状态发生变化时触发此事件,事件原型参考UploadStateChangedCallback。
</p>
</li></ul>
<h1><a name="plus.uploader.UploadState">UploadState</a></h1>
<p>上传任务的状态,Number类型</p>
<h2>常量:</h2>
<ul>
<li>undefined: <em>(<font class="type">undefined</font>
类型
)</em>上传任务未开始<br><p>
通过plus.uploader.createUpload()方法创建上传任务后的初始状态,此时可调用其start()方法开始上传。
</p>
</li>
<li>0: <em>(<font class="type">number</font>
类型
)</em>上传任务开始调度<br><p>
调用上传任务的start()方法之后处于此状态,此时上传任务处于可调度上传状态。
</p>
</li>
<li>1: <em>(<font class="type">number</font>
类型
)</em>上传任务开始请求<br><p>
上传任务建立网络连接,发送请求到服务器并等待服务器的响应。
</p>
</li>
<li>2: <em>(<font class="type">number</font>
类型
)</em>上传任务请求已经建立<br><p>
上传任务网络连接已建立,服务器返回响应,准备传输数据内容。
</p>
</li>
<li>3: <em>(<font class="type">number</font>
类型
)</em>上传任务提交数据<br><p>
上传任务提交数据,监听statechanged事件时可多次触发此状态。
</p>
</li>
<li>4: <em>(<font class="type">number</font>
类型
)</em>上传任务已完成<br><p>
上传任务完成数据提交并断开连接,上传成功或失败都会设置为此状态。
</p>
</li>
<li>5: <em>(<font class="type">number</font>
类型
)</em>上传任务已暂停<br><p>
调用上传任务的pause()方法将任务暂停,此时可调用其resume()方法重新开始上传。
</p>
</li>
<li>-1: <em>(<font class="type">number</font>
类型
)</em>枚举任务状态<br><p>
非上传任务状态,泛指所有上传任务的状态,用于enumerate()和clear()操作时指定作用于所有上传任务。
</p>
</li>
</ul>
<h1><a name="plus.uploader.UploadOptions">UploadOptions</a></h1>
<p>JSON对象,创建上传任务的参数</p>
<h2>属性:</h2>
<ul>
<li>method: <em>(<font class="type">String</font>
类型
)</em>网络请求类型<br><p>
仅支持http协议的“POST”请求。
</p>
</li>
<li>blocksize: <em>(<font class="type">number</font>
类型
)</em>上传任务每次上传的文件块大小(仅在支持断点续传的服务有效)<br><p>
数值类型,单位为Byte(字节),默认值为102400,若设置值小于等于0则表示不分块上传。
</p>
</li>
<li>priority: <em>(<font class="type">number</font>
类型
)</em>上传任务的优先级<br><p>
数值类型,数值越大优先级越高,默认优先级值为0。
</p>
</li>
<li>timeout: <em>(<font class="type">number</font>
类型
)</em>上传任务超时时间<br><p>
数值类型,单位为s(秒),默认值为120s。
超时时间为服务器响应请求的时间(不是上传任务完成的总时间),如果设置为0则表示永远不超时。
</p>
</li>
<li>retry: <em>(<font class="type">number</font>
类型
)</em>上传任务重试次数<br><p>
数值类型,默认为重试3次。
</p>
</li>
<li>retryInterval: <em>(<font class="type">Number</font>
类型
)</em>上传任务重试间隔时间<br><p>
数值类型,单位为s(秒),默认值为30s。
</p>
</li>
</ul>
<h1><a name="plus.uploader.UploadFileOptions">UploadFileOptions</a></h1>
<p>JSON对象,添加上传文件的参数</p>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.uploader.UploadFileOptions.key">key</a>: 文件键名</li>
<li>
<a href="#plus.uploader.UploadFileOptions.name">name</a>: 文件名称</li>
<li>
<a href="#plus.uploader.UploadFileOptions.mime">mime</a>: 文件类型</li>
</ul>
<h1><a name="plus.uploader.UploadCompletedCallback">UploadCompletedCallback</a></h1>
<p>上传任务完成时的回调函数</p>
<pre class="prettyprint linenums">
void uploadCompleted( Upload upload, Number status ) {
// File upload completed code.
}
</pre>
<h2>说明:</h2>
<p class="des">在上传任务完成时调用,上传任务失败也将触发此回调。</p>
<h2>参数:</h2>
<ul>
<li>upload:
<em>(
<a href="#plus.uploader.Upload">Upload</a>
)
必选 </em>上传任务对象<br>
</li>
<li>status:
<em>(
<font class="type">Number</font>
)
必选 </em>上传结果状态码<br>
HTTP传输协议状态码,如果未获取传输状态则其值则为0,如上传成功其值通常为200。
</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.uploader.UploadStateChangedCallback">UploadStateChangedCallback</a></h1>
<p>上传任务状态变化回调函数,在上传任务状态发生变化时调用</p>
<pre class="prettyprint linenums">
void onStateChanged( Upload upload, status ) {
// Upload state changed code.
}
</pre>
<h2>参数:</h2>
<ul>
<li>upload:
<em>(
<a href="#plus.uploader.Upload">Upload</a>
)
必选 </em>上传任务对象<br>
</li>
<li>status:
<em>(
<font class="type">Number</font>
)
必选 </em>上传结果状态码<br>
HTTP传输协议状态码,如果未获取传输状态则其值则为0,如上传成功其值通常为200。
</li>
</ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.uploader.UploadEnumerateCallback">UploadEnumerateCallback</a></h1>
<p>枚举上传任务回调函数,在枚举上传任务完成时时调用</p>
<pre class="prettyprint linenums">
void onEnumerated( Upload[] uploads ) {
// Upload enumerate completed code.
}
</pre>
<h2>参数:</h2>
<ul><li>uploads:
<em>(
<font class="type">Array</font>[
<a href="#plus.uploader.Upload">Upload</a>
]
)
必选 </em>枚举到的上传任务对象数组<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
File diff suppressed because it is too large Load Diff
+172
View File
@@ -0,0 +1,172 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.net">net</a></h1>
<p>XMLHttpRequest模块管理网络请求,与标准HTML中的XMLHttpRequest用途一致,差别在于前者可以进行跨域访问。通过plus.net可获取网络请求管理对象。</p>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.net.XMLHttpRequest">XMLHttpRequest</a>: 跨域网络请求对象</li>
<li>
<a href="#plus.net.ProgressEvent">ProgressEvent</a>: HTTP请求进度事件</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.net.XhrStateChangeCallback">XhrStateChangeCallback</a>: 网络请求状态变化的回调函数</li>
<li>
<a href="#plus.net.XhrProgressEventCallback">XhrProgressEventCallback</a>: 网络请求进度事件的回调函数</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"XMLHttpRequest": {
"description": "跨域网络连接"
}
}
}
</pre>
<h1><a name="plus.net.XMLHttpRequest">XMLHttpRequest</a></h1>
<p>跨域网络请求对象</p>
<h2>构造:</h2>
<ul><li>
<a href="#plus.net.XMLHttpRequest.XMLHttpRequest()">XMLHttpRequest()</a>: 创建一个XMLHttpRequest 对象,对象创建时不触发任何时间和网络请求,需和open,send方法配合使用。</li></ul>
<h2>属性:</h2>
<ul>
<li>
<a href="#plus.net.XMLHttpRequest.readyState">readyState</a>: HTTP 请求的状态</li>
<li>
<a href="#plus.net.XMLHttpRequest.response">response</a>: 请求从服务器接收到的响应数据</li>
<li>
<a href="#plus.net.XMLHttpRequest.responseText">responseText</a>: 请求从服务器接收到的响应数据(字符串数据)</li>
<li>
<a href="#plus.net.XMLHttpRequest.responseType">responseType</a>: 请求响应数据response的类型</li>
<li>
<a href="#plus.net.XMLHttpRequest.responseXML">responseXML</a>: 请求响应的Document对象</li>
<li>
<a href="#plus.net.XMLHttpRequest.status">status</a>: 服务器返回的HTTP状态代码</li>
<li>
<a href="#plus.net.XMLHttpRequest.statusText">statusText</a>: 服务器返回的HTTP状态描述</li>
<li>
<a href="#plus.net.XMLHttpRequest.timeout">timeout</a>: 请求服务器的超时时间,单位为毫秒(ms)</li>
<li>
<a href="#plus.net.XMLHttpRequest.withCredentials">withCredentials</a>: 是否支持跨域请求</li>
</ul>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.net.XMLHttpRequest.abort">abort</a>: 取消当前响应,关闭连接并且结束任何未决的网络活动</li>
<li>
<a href="#plus.net.XMLHttpRequest.getAllResponseHeaders">getAllResponseHeaders</a>: 获取HTTP响应头部信息</li>
<li>
<a href="#plus.net.XMLHttpRequest.getResponseHeader">getResponseHeader</a>: 获取指定的HTTP响应头部的值</li>
<li>
<a href="#plus.net.XMLHttpRequest.open">open</a>: 初始化HTTP请求参数,例如URL和HTTP方法,但是并不发送请求</li>
<li>
<a href="#plus.net.XMLHttpRequest.overrideMimeType">overrideMimeType</a>: 重写服务器返回的MIME类型</li>
<li>
<a href="#plus.net.XMLHttpRequest.send">send</a>: 发送HTTP请求</li>
<li>
<a href="#plus.net.XMLHttpRequest.setRequestHeader">setRequestHeader</a>: 指定一个HTTP请求的Header</li>
</ul>
<h2>事件:</h2>
<ul>
<li>
<a href="#plus.net.XMLHttpRequest.onreadystatechange">onreadystatechange</a>: 网络请求状态发生变化事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.onloadstart">onloadstart</a>: 网络请求开始事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.onprogress">onprogress</a>: 网络请求传输数据事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.onabort">onabort</a>: 网络请求取消事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.onerror">onerror</a>: 网络请求错误事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.onload">onload</a>: 网络请求成功事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.ontimeout">ontimeout</a>: 网络请求超时事件</li>
<li>
<a href="#plus.net.XMLHttpRequest.onloadend">onloadend</a>: 网络请求结束事件</li>
</ul>
<h1><a name="plus.net.ProgressEvent">ProgressEvent</a></h1>
<p>HTTP请求进度事件</p>
<pre class="prettyprint linenums">
interface ProgressEvent : Event {
readonly attribute XMLHttpRequest target;
readonly attribute Boolean lengthComputable;
readonly attribute Number loaded;
readonly attribute Number total;
};
</pre>
<h2>属性:</h2>
<ul>
<li>target: <em>(<a href="#plus.net.XMLHttpRequest">XMLHttpRequest</a>
类型
)</em>事件的目标对象<br><p>
通知HTTP请求进度事件的XMLHttpRequest对象。
</p>
</li>
<li>lengthComputable: <em>(<font class="type">Number</font>
类型
)</em>进度信息是否可计算<br><p>
HTTP请求进度信息是否有效,如果HTTP请求头中包含Content-Length头信息则为true,否则为false。
</p>
</li>
<li>loaded: <em>(<font class="type">XMLHttpRequest</font>
类型
)</em>当前已经接收到的数据长度<br><p>
HTTP请求接收到的数据长度,单位为字节。
</p>
</li>
<li>total: <em>(<font class="type">XMLHttpRequest</font>
类型
)</em>总数据长度<br><p>
HTTP请求返回的总数据长度,单位为字节。
如果无法获取则设置为0。
</p>
</li>
</ul>
<h1><a name="plus.net.XhrStateChangeCallback">XhrStateChangeCallback</a></h1>
<p>网络请求状态变化的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess() {
// State changed code.
}
</pre>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.net.XhrProgressEventCallback">XhrProgressEventCallback</a></h1>
<p>网络请求进度事件的回调函数</p>
<pre class="prettyprint linenums">
void onProgressEvent( ProgressEvent event ) {
// Progress changed code.
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<a href="#plus.net.ProgressEvent">ProgressEvent</a>
)
必选 </em>HTTP请求进度事件<br>
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+227
View File
@@ -0,0 +1,227 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.zip">zip</a></h1>
<p>Zip模块管理文件压缩和解压,通过plus.zip可获取压缩管理对象。</p>
<h2>方法:</h2>
<ul>
<li>
<a href="#plus.zip.compress">compress</a>: 压缩生成Zip文件</li>
<li>
<a href="#plus.zip.decompress">decompress</a>: 解压缩Zip文件</li>
<li>
<a href="#plus.zip.compressImage">compressImage</a>: 图片压缩转换</li>
</ul>
<h2>对象:</h2>
<ul>
<li>
<a href="#plus.zip.CompressImageOptions">CompressImageOptions</a>: JSON对象,配置图片压缩转换的参数</li>
<li>
<a href="#plus.zip.ClipImageOptions">ClipImageOptions</a>: JSON对象,图片裁剪区域的参数</li>
</ul>
<h2>回调方法:</h2>
<ul>
<li>
<a href="#plus.zip.CompressImageSuccessCallback">CompressImageSuccessCallback</a>: 图片压缩转换操作成功回调接口</li>
<li>
<a href="#plus.zip.ZipSuccessCallback">ZipSuccessCallback</a>: 操作成功回调函数接口,在解压Zip文件或压缩成Zip文件成功时调用</li>
<li>
<a href="#plus.zip.ZipErrorCallback">ZipErrorCallback</a>: 操作错误回调函数接口,在解压Zip文件或压缩成Zip文件失败时调用</li>
</ul>
<h2>权限:</h2>
<p>5+功能模块(permissions)</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
// ...
"Zip": {
"description": "压缩与解压"
}
}
}
</pre>
<h1><a name="plus.zip.CompressImageOptions">CompressImageOptions</a></h1>
<p>JSON对象,配置图片压缩转换的参数</p>
<h2>说明:</h2>
<p class="des">
设置width/height属性则表示需对图片进行缩放转换操作;
设置rotate属性则表示需对图片进行旋转转换操作;
设置clip属性则表示需对图片进行裁剪转换操作;
如同时设置了多个转换操作,则按缩放、旋转、裁剪顺序进行操作。
</p>
<h2>属性:</h2>
<ul>
<li>src: <em>(<font class="type">String</font>
类型
)</em>压缩转换原始图片的路径<br><p>
支持以下图片路径:
相对路径 - 相对于当前页面的host位置,如"a.jpg",注意当前页面为网络地址则不支持;
绝对路径 - 系统绝对路径,如Android平台"/storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/www/a.jpg",iOS平台"/var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/www/a.png";
相对路径URL(RelativeURL) - 以"_"开头的相对路径,如"_www/a.jpg"、"_doc/b.jpg"、"_documents/c.jpg"、"_downloads/d.jpg";
本地路径URL - 以“file://”开头,后面跟随系统绝对路径。
</p>
</li>
<li>dst: <em>(<font class="type">String</font>
类型
)</em>压缩转换目标图片的路径<br><p>
支持以下图片路径:
绝对路径 - 系统绝对路径,如Android平台"/storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/doc/a.jpg",iOS平台"/var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png";
相对路径URL(RelativeURL) - 以"_"开头的相对路径,如"_doc/b.jpg"、"_documents/c.jpg"、"_downloads/d.jpg",注意不支持"_www"开头的路径;
本地路径URL - 以“file://”开头,后面跟随系统绝对路径。
注意:如果设置的路径无权限访问,则返回失败。
</p>
</li>
<li>overwrite: <em>(<font class="type">Boolean</font>
类型
)</em>覆盖生成新文件<br><p>
仅在dst制定的路径文件存在时有效:
true表示覆盖存在的文件;
false表示不覆盖,如果文件存在,则返回失败。
默认值为false。
</p>
</li>
<li>format: <em>(<font class="type">String</font>
类型
)</em>压缩转换后的图片格式<br><p>
支持"jpg"、"png",如果未指定则使用源图片的格式。
</p>
</li>
<li>quality: <em>(<font class="type">Number</font>
类型
)</em>压缩图片的质量<br><p>
取值范围为1-100,1表示使用最低的图片质量(转换后的图片文件最小)、100表示使用最高的图片质量(转换后的图片文件最大);
默认值为50。
</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>缩放图片的宽度<br><p>
支持像素值(如"100px")、百分比(如"50%")、自动计算(如"auto",即根据height与源图高的缩放比例计算,若未设置height则使用源图高度);
默认值为"auto"。
注意:若设置了width属性值不合法(如"0px"),则不对图片进行缩放操作。
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>缩放图片的高度<br><p>
支持像素值(如"100px")、百分比(如"50%")、自动计算(如"auto",即根据width与源图宽的缩放比例计算,若未设置width则使用源图高度);
默认值为"auto"。
注意:若设置了height属性值不合法(如"0px"),则不对图片进行缩放操作。
</p>
</li>
<li>rotate: <em>(<font class="type">Number</font>
类型
)</em>旋转图片的角度<br><p>
支持值:90-表示旋转90度;180-表示旋转180度;270-表示旋转270度。
注意:若设置rotate属性值不合法,则不对图片进行旋转操作。
</p>
</li>
<li>clip: <em>(<a href="#plus.zip.ClipImageOptions">ClipImageOptions</a>
类型
)</em>裁剪图片的区域<br><p>
值参考ClipImageOptions定义,若设置clip属性值不合法,则不对图片进行裁剪操作。
</p>
</li>
</ul>
<h1><a name="plus.zip.ClipImageOptions">ClipImageOptions</a></h1>
<p>JSON对象,图片裁剪区域的参数</p>
<h2>属性:</h2>
<ul>
<li>top: <em>(<font class="type">String</font>
类型
)</em>图片裁剪区域与原图片上边界的偏移距离<br><p>
支持像素值(如"10px")、百分比(如"10%");默认值为"0px"。
注意:如果top值超出原图片高度,则图片裁剪失败。
</p>
</li>
<li>left: <em>(<font class="type">Stirng</font>
类型
)</em>图片裁剪区域与原图片左边界的偏移距离<br><p>
支持像素值(如"10px")、百分比(如"10%");默认值为"0px"。
注意:如果left值超出原图片宽度,则图片裁剪失败。
</p>
</li>
<li>width: <em>(<font class="type">String</font>
类型
)</em>图片裁剪区域的宽度<br><p>
支持像素值(如"100px")、百分比(如"50%")、自动计算(如"auto",即从left位置到图片右边界的宽度);默认值为"auto"。
注意:如果left值加width值超出原图片宽度,则使用"auto"值进行裁剪。
</p>
</li>
<li>height: <em>(<font class="type">String</font>
类型
)</em>图片裁剪区域的高度<br><p>
支持像素值(如"100px")、百分比(如"50%")、自动计算(如"auto",即从top位置到图片下边界的高度);默认值为"auto"。
注意:如果top值加height值超出原图片高度,则使用"auto"值进行裁剪。
</p>
</li>
</ul>
<h1><a name="plus.zip.CompressImageSuccessCallback">CompressImageSuccessCallback</a></h1>
<p>图片压缩转换操作成功回调接口</p>
<pre class="prettyprint linenums">
void onSuccess( Event event ){
// Code here
var target = event.target; // 压缩转换后的图片url路径,以"file://"开头
var size = event.size; // 压缩转换后图片的大小,单位为字节(Byte)
var width = event.width; // 压缩转换后图片的实际宽度,单位为px
var height = event.height; // 压缩转换后图片的实际高度,单位为px
}
</pre>
<h2>参数:</h2>
<ul><li>event:
<em>(
<font class="type">Event</font>
)
可选 </em>图片压缩转换后的图片信息<br>
可通过event.target(String类型)获取压缩转换后的图片url路径,以"file://"开头,可直接在html页面中通过src属性引用,如Android平台"file:///storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/doc/a.jpg",iOS平台"file:///var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png";
可通过event.size(Number类型)获取压缩转换后图片的大小,单位为字节(Byte);
可通过event.width(Number类型)获取压缩转换后的图片的实际宽度,单位为px;
可通过event.height(Number类型)获取压缩转换后的图片的实际高度,单位为px。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.zip.ZipSuccessCallback">ZipSuccessCallback</a></h1>
<p>操作成功回调函数接口,在解压Zip文件或压缩成Zip文件成功时调用</p>
<pre class="prettyprint linenums">
void onSuccess(){
// Code here
}
</pre>
<h2>参数:</h2>
<p>无</p>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<h1><a name="plus.zip.ZipErrorCallback">ZipErrorCallback</a></h1>
<p>操作错误回调函数接口,在解压Zip文件或压缩成Zip文件失败时调用</p>
<pre class="prettyprint linenums">
void onError(error){
// Handle the error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</pre>
<h2>参数:</h2>
<ul><li>error:
<em>(
<font class="type">Exception</font>
)
可选 </em>Zip操作的错误信息<br>
可通过error.code(Number类型)获取错误编码;
可通过error.message(String类型)获取错误描述信息。
</li></ul>
<h2>返回值:</h2>
<font class="type">void</font>
: 无<br><br>
</div></body>
</html>
+65
View File
@@ -0,0 +1,65 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title></title>
<meta name="viewport" content="initial-scale=1, maximum-scale=1">
<link rel="shortcut icon" href="/favicon.ico">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<link rel="stylesheet" href="css/sm.css">
<link rel="stylesheet" href="css/main.css">
<link rel="stylesheet" href="css/theme-blue.css">
<style>
.contentError img{width:20%;margin-bottom:1.5rem;}
.contentError em{font-size:1rem;color:#8890a4;margin-bottom:0.5rem;}
.contentError p{color:#bac0ce;}
.contentError a{width:50%;margin:0 auto;margin-top:2rem;text-decoration:none;}
.iback {
background: no-repeat center center url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABYCAYAAAADWlKCAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAKwwAACsMBNCkkqwAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMi8xM5w+I3MAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAACcklEQVR4nO3a0XESURiG4TeO99iBWoGZ+RvADtKBpAPtwBLsANJBrEAs4MyYDmIHSQXkgk0mMLK7ILt8/+F778ici394OGfDsher1Qqn05tTD+A2M4hYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYb089wNCVUq6Ay+blfUQsTjhOZxc1P9tbSlkAX7b+/C0ifpxgnF5Ve2TtwAD4OvIoe1UlSAsGwPsRR9m76kA6MAD+jjTKQVUF0gMD4HaEUQ6umot6T4ybiJgNP83hVbFDasGACnZIT4yfEXE1wjj/Xeod0hPjDpgNPsyRSguyB8Y0Ih6Gn+g4pQSpFQMSgtSMAclAaseARCDngAFJQM4FAxKAnBMGiH8xLKVMgV89ln6MiPthpxkn6R0SEUvgusfSZSnlsnuZftI75LlSygyYdyx7ZH1s/Rl+ouFKAQIvx9ctMGlZlh4lDQhAcywtqRhF+hqyXfMmT1m/6buasL6mzMaY6dilAoENlLuWZRNgnhEl1ZH1ulLKO9bH16eOpdfqz2K9Lt0Oea75EjilfadAsp2SFgQ2UH53LJ2XUr4PPtARSntkbVfL7+rVgEBvlM/NHQDJUh9Z2zWf/puOZbPhJzm8qkDgBaXt/teHcSY5rOpAAJp/c/vclJSrShDYifKI+NPvVV3U/1VzU3LavFyo/25SPUi2qj2ysmYQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsQwilkHEMohYBhHLIGIZRCyDiGUQsZ4Ak9fPFwUy/HsAAAAASUVORK5CYII=);
background-size: 50px 44px;
}
header {
background: #D74B28;
/*background: -webkit-linear-gradient(top,rgba(215,75,40,1),rgba(215,75,40,0.8));*/
z-index: 9999;
/*border-bottom: 1px solid rgba(215,75,40,0.8);*/
-ms-touch-action: none;
}
.nvbt {
width:5%;
height:100%;
float:left;
overflow:hidden;
text-overflow:ellipsis;
white-space:nowrap;
}
</style>
</head>
<body>
<div class="page-group">
<div class="page page-current">
<header class="bar bar-nav">
<div class="nvbt iback" onclick="back(),plus.nativeUI.closeWaiting();"></div>
<h1 class="title"></h1>
</header>
<div class="content contentError">
<img src="img/errorInternet.png">
<em>网络加载异常</em>
<p>请返回重试或检查网络设置</p>
<div class="content-block">
<p><a onclick="plus.runtime.restart()" class="button button-big button-round theme">返回重试</a></p>
</div>
</div>
</div>
</div>
<script type="text/javascript" src="js/common.js" ></script>
</body>
</html>
Binary file not shown.

After

Width:  |  Height:  |  Size: 3.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 748 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 959 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 95 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 598 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 715 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 150 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 140 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 143 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.6 KiB

File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
+29
View File
@@ -0,0 +1,29 @@
(function(w){
document.addEventListener('plusready',function(){
console.log("Immersed-UserAgent: "+navigator.userAgent);
},false);
var immersed = 0;
var ms=(/Html5Plus\/.+\s\(.*(Immersed\/(\d+\.?\d*).*)\)/gi).exec(navigator.userAgent);
if(ms&&ms.length>=3){
immersed=parseFloat(ms[2]);
}
w.immersed=immersed;
if(!immersed){
return;
}
var t=document.getElementById('header');
//t&&(t.style.paddingTop=immersed+'px',t.style.background='-webkit-linear-gradient(top,rgba(215,75,40,1),rgba(215,75,40,0.8))',t.style.color='#FFF');
t&&(t.style.paddingTop=immersed+'px',t.style.background='#D74B28',t.style.color='#FFF');
t=document.getElementById('content');
t&&(t.style.marginTop=immersed+'px');
t=document.getElementById('scontent');
t&&(t.style.marginTop=immersed+'px');
t=document.getElementById('dcontent');
t&&(t.style.marginTop=immersed+'px');
t=document.getElementById('map');
t&&(t.style.marginTop=immersed+'px');
})(window);
+9
View File
File diff suppressed because one or more lines are too long
+43
View File
@@ -0,0 +1,43 @@
(function(w){
document.addEventListener('plusready',function(){
checkArguments();
},false);
// 判断启动方式
function checkArguments(){
console.log("Shortcut-plus.runtime.launcher: "+plus.runtime.launcher);
if(plus.runtime.launcher=='shortcut'){
try{
var cmd = JSON.parse(plus.runtime.arguments);
console.log("Shortcut-plus.runtime.arguments: "+plus.runtime.arguments)
var type=cmd&&cmd.type;
switch(type){
case 'share':
openWebview('plus/share.html');
break;
case 'about':
openWebview('about.html','zoom-fade-out',true);
break;
default:
break;
}
}catch(e){
console.log("Shortcut-exception: "+e);
}
}
}
// 打开页面
function openWebview(id,a,s){
if(!_openw||_openw.id!=id){
clicked(id,a,s);
}
}
// 处理从后台恢复
document.addEventListener('newintent',function(){
console.log("Shortcut-newintent");
checkArguments();
},false);
})(window);
+189
View File
@@ -0,0 +1,189 @@
/**
* 判断应用升级模块,从url地址下载升级描述文件到本地local路径
* yanyilin@dcloud.io
*
* 升级文件为JSON格式数据,如下:
{
"appid":"HelloH5",
"iOS":{
"version":"iOS新版本号,如:1.0.0",
"note":"iOS新版本描述信息,多行使用\n分割",
"url":"Appstore路径,如:itms-apps://itunes.apple.com/cn/app/hello-h5+/id682211190?l=zh&mt=8"
},
"Android":{
"version":"Android新版本号,如:1.0.1",
"note":"Android新版本描述信息,多行使用\n分割",
"url":"apk文件下载地址,如:http://www.dcloud.io/helloh5p/HelloH5.apk"
}
}
*
*/
(function(w){
var server="http://www.dcloud.io/helloh5/update.json",//获取升级描述文件服务器地址
localDir="update",localFile="update.json",//本地保存升级描述目录和文件名
keyUpdate="updateCheck",//取消升级键名
keyAbort="updateAbort",//忽略版本键名
checkInterval=604800000,//升级检查间隔,单位为ms,7天为7*24*60*60*1000=604800000, 如果每次启动需要检查设置值为0
dir=null;
/**
* 准备升级操作
* 创建升级文件保存目录
*/
function initUpdate(){
// 在流应用模式下不需要检测升级操作
if(navigator.userAgent.indexOf('StreamApp')>=0){
return;
}
// 打开doc根目录
plus.io.requestFileSystem( plus.io.PRIVATE_DOC, function(fs){
fs.root.getDirectory( localDir, {create:true}, function(entry){
dir = entry;
checkUpdate();
}, function(e){
console.log( "准备升级操作,打开update目录失败:"+e.message );
});
},function(e){
console.log( "准备升级操作,打开doc目录失败:"+e.message );
});
}
/**
* 检测程序升级
*/
function checkUpdate() {
// 判断升级检测是否过期
var lastcheck = plus.storage.getItem( keyUpdate );
if ( lastcheck ) {
var dc = parseInt( lastcheck );
var dn = (new Date()).getTime();
if ( dn-dc < checkInterval ) { // 未超过上次升级检测间隔,不需要进行升级检查
return;
}
// 取消已过期,删除取消标记
plus.storage.removeItem( keyUpdate );
}
// 读取本地升级文件
dir.getFile( localFile, {create:false}, function(fentry){
fentry.file( function(file){
var reader = new plus.io.FileReader();
reader.onloadend = function ( e ) {
fentry.remove();
var data = null;
try{
data=JSON.parse(e.target.result);
}catch(e){
console.log( "读取本地升级文件,数据格式错误!" );
return;
}
checkUpdateData( data );
}
reader.readAsText(file);
}, function(e){
console.log( "读取本地升级文件,获取文件对象失败:"+e.message );
fentry.remove();
} );
}, function(e){
// 失败表示文件不存在,从服务器获取升级数据
getUpdateData();
});
}
/**
* 检查升级数据
*/
function checkUpdateData( j ){
var curVer=plus.runtime.version,
inf = j[plus.os.name];
if ( inf ){
var srvVer = inf.version;
// 判断是否存在忽略版本号
var vabort = plus.storage.getItem( keyAbort );
if ( vabort && srvVer==vabort ) {
// 忽略此版本
return;
}
// 判断是否需要升级
if ( compareVersion(curVer,srvVer) ) {
// 提示用户是否升级
plus.nativeUI.confirm( inf.note, function(i){
if ( 0==i.index ) {
plus.runtime.openURL( inf.url );
} else if ( 1==i.index ) {
plus.storage.setItem( keyAbort, srvVer );
plus.storage.setItem( keyUpdate, (new Date()).getTime().toString() );
} else {
plus.storage.setItem( keyUpdate, (new Date()).getTime().toString() );
}
}, inf.title, ["立即更新","跳过此版本","取  消"] );
}
}
}
/**
* 从服务器获取升级数据
*/
function getUpdateData(){
var xhr = new plus.net.XMLHttpRequest();
xhr.onreadystatechange = function () {
switch ( xhr.readyState ) {
case 4:
if ( xhr.status == 200 ) {
// 保存到本地文件中
dir.getFile( localFile, {create:true}, function(fentry){
fentry.createWriter( function(writer){
writer.onerror = function(){
console.log( "获取升级数据,保存文件失败!" );
}
writer.write( xhr.responseText );
}, function(e){
console.log( "获取升级数据,创建写文件对象失败:"+e.message );
} );
}, function(e){
console.log( "获取升级数据,打开保存文件失败:"+e.message );
});
} else {
console.log( "获取升级数据,联网请求失败:"+xhr.status );
}
break;
default :
break;
}
}
xhr.open( "GET", server );
xhr.send();
}
/**
* 比较版本大小,如果新版本nv大于旧版本ov则返回true,否则返回false
* @param {String} ov
* @param {String} nv
* @return {Boolean}
*/
function compareVersion( ov, nv ){
if ( !ov || !nv || ov=="" || nv=="" ){
return false;
}
var b=false,
ova = ov.split(".",4),
nva = nv.split(".",4);
for ( var i=0; i<ova.length&&i<nva.length; i++ ) {
var so=ova[i],no=parseInt(so),sn=nva[i],nn=parseInt(sn);
if ( nn>no || sn.length>so.length ) {
return true;
} else if ( nn<no ) {
return false;
}
}
if ( nva.length>ova.length && 0==nv.indexOf(ov) ) {
return true;
}
}
if ( w.plus ) {
initUpdate();
} else {
document.addEventListener("plusready", initUpdate, false );
}
})(window);
+15
View File
@@ -0,0 +1,15 @@
{
"appid":"HelloH5",
"iOS":{
"version":"0.7.0",
"title":"Hello H5+(0.7.0)版本更新",
"note":"新增自动升级检测功能\n新增分享功能演示页面\n新增推送功能演示页面\n",
"url":"itms-apps://itunes.apple.com/cn/app/hello-h5+/id682211190?l=zh&mt=8"
},
"Android":{
"version":"0.7.0",
"title":"Hello H5+(0.7.0)版本更新",
"note":"新增自动升级检测功能\n新增分享功能演示页面\n新增推送功能演示页面\n",
"url":"http://d.m3w.cn/helloh5p/HelloH5.apk"
}
}
File diff suppressed because one or more lines are too long
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

File diff suppressed because it is too large Load Diff
+67
View File
@@ -0,0 +1,67 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="misapplication-tap-highlight" content="no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
function getAcc() {
outSet('获取设备当前加速度');
plus.accelerometer.getCurrentAcceleration(function(a){
outLine('X轴:'+a.xAxis+'\nY轴:'+a.yAxis+'\nZ轴:'+a.zAxis);
}, function(e){
outLine('获取失败:'+e.message);
} );
}
var aid = null;
function watchAcc(){
if(aid){
return;
}
outSet('监听设备加速度变化');
aid = plus.accelerometer.watchAcceleration(function(a){
outSet('监听设备加速度变化\n'+'X轴:'+a.xAxis+'\nY轴:'+a.yAxis+'\nZ轴:'+a.zAxis);
}, function(e){
outLine('监听失败:'+e.message);
});
}
function watchStop() {
if(aid){
outSet('停止监听设备加速度变化');
plus.accelerometer.clearWatch(aid);
aid = null;
}else{
outSet('没有监听设备加速度变化');
}
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
</head>
<body>
<header id="header">
<div class="nvbt iback" onclick="back()"></div>
<div class="nvtt">Accelerometer</div>
<div class="nvbt idoc" onclick="openDoc('Accelerometer Document','/doc/accelerometer.html')"></div>
</header>
<div id="dcontent" class="dcontent">
<br/>
<div class="button" onclick="clicked('accelerometer_shake.html',true)">
摇一摇
</div>
<br/>
<ul class="dlist">
<li class="ditem" onclick="getAcc()">获取设备当前加速度</li>
<li class="ditem" onclick="watchAcc()">监听设备加速度变化 </li>
<li class="ditem" onclick="watchStop()">停止监听设备加速度变化</li>
</ul>
</div>
<div id="output">
Accelerometer可获取设备加速度传感器信息,包括x轴(屏幕水平方向)、y轴(垂直屏幕水平方向)、z轴(垂直屏幕平面方向)三个方向的加速度信息。
</div>
</body>
<script type="text/javascript" src="../js/immersed.js"></script>
</html>
+101
View File
@@ -0,0 +1,101 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var p=null;
var iLast=2,MAX=20;
var up=null,down=null,offset=50;
var t=null;
// H5 plus事件处理
function plusReady(){
// 锁定只能竖屏显示
plus.screen.lockOrientation('portrait-primary');
// 监听加速度
plus.accelerometer.watchAcceleration(function(a){
if(!up){
return;
}
if(!p && ( Math.abs(a.xAxis)+Math.abs(a.yAxis)+Math.abs(a.zAxis) > MAX )){
// Play audio
p = plus.audio.createPlayer('_www/audio/shake.wav');
p.play();
setTimeout(function(){
// Change background image
var index = Math.round(Math.random()*3+1);
if ( iLast == index ) {
index++;
if ( index > 4 ) {
index = 1;
}
}
document.body.style.backgroundImage='url(../img/shake/'+index+'.jpg)';
iLast = index;
// Stop play audio
p.stop();
delete p;
p = null;
}, 2000 );
// Animation
offset=up.offsetHeight/2;
up.style.webkitTransform = 'translateY(-'+offset+'px)';
up.style.msTransform = 'translateY(-'+offset+'px)';
down.style.webkitTransform = 'translateY('+offset+'px)';
down.style.msTransform = 'translateY('+offset+'px)';
if(t){
clearTimeout(t);
}
t = setTimeout(function(){
t = null;
up.style.webkitTransform = '';
up.style.msTransform = '';
down.style.webkitTransform = '';
down.style.msTransform = '';
}, 700 );
}
}, function(e){
//outSet('Watch failed: '+e.message);
}, {frequency:100});
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// 监听DOMContentLoaded事件
document.addEventListener('DOMContentLoaded', function(){
up=document.getElementById('up');
down=document.getElementById('down');
offset=up.offsetHeight/2;
},false);
// 解锁并关闭
var _back=window.back;
function unlockback(){
plus.screen.unlockOrientation();
_back();
}
window.back=unlockback;
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
</head>
<body style="background: center center no-repeat url(../img/shake/1.jpg);">
<header id="header">
<div class="nvbt iback" onclick="back()"></div>
<div class="nvtt">摇一摇</div>
</header>
<div style="height:100%;text-align:center;overflow:hidden;">
<div id="up" style="width:100%;height:50%;background:#333;-webkit-transition:all .5s ease-in-out;-ms-transition:all .5s ease-in-out;">
<img style="height:100%;" src="../img/shakeup.png"/>
</div>
<div id="down" style="padding-bottom:20px;width:100%;height:50%;background:#333;-webkit-transition:all .5s ease-in-out;-ms-transition:all .5s ease-in-out;">
<img style="height:100%;" src="../img/shakedown.png"/>
</div>
</div>
</body>
<script type="text/javascript" src="../js/immersed.js" ></script>
</html>
+356
View File
@@ -0,0 +1,356 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+ 2</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var gentry=null,hl=null,le=null;
var er=null,ep=null;
var bUpdated=false; //用于兼容可能提前注入导致DOM未解析完更新的问题
// H5 plus事件处理
function plusReady(){
// 获取音频目录对象
plus.io.resolveLocalFileSystemURL('_doc/', function(entry){
entry.getDirectory('audio', {create:true}, function(dir){
gentry = dir;
updateHistory();
}, function(e){
outSet('Get directory "audio" failed: '+e.message);
});
}, function(e){
outSet('Resolve "_doc/" failed: '+e.message);
} );
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// DOMContentLoaded事件处理
document.addEventListener('DOMContentLoaded', function(){
// 获取DOM元素对象
hl = document.getElementById('history');
le = document.getElementById('empty');
er = document.getElementById('record');
rt = document.getElementById('rtime');
ep = document.getElementById('play');
pt = document.getElementById('ptime');
pp = document.getElementById('progress')
ps = document.getElementById('schedule');
updateHistory();
},false);
// 添加播放项
function createItem( entry ) {
var li = document.createElement('li');
li.className = 'ditem';
li.innerHTML = '<span class="iplay"><font class="aname"></font><br/><font class="ainf"></font></span>';
li.setAttribute('onclick', 'playAudio(this)');
hl.insertBefore(li, le.nextSibling);
li.querySelector('.aname').innerText = entry.name;
li.querySelector('.ainf').innerText = '...';
li.entry = entry;
updateInformation(li);
// 设置空项不可见
le.style.display = 'none';
}
// 开始录音
var r=null,t=0,ri=null,rt=null;
function startRecord(){
outSet('开始录音:');
r = plus.audio.getRecorder();
if ( r == null ) {
outLine('录音对象未获取');
return;
}
r.record({filename:'_doc/audio/'}, function(p){
outLine('录音完成:'+p);
plus.io.resolveLocalFileSystemURL(p, function(entry){
createItem(entry);
}, function(e){
outLine('读取录音文件错误:'+e.message);
});
}, function(e){
outLine('录音失败:'+e.message);
} );
er.style.display = 'block';
t = 0;
ri = setInterval(function(){
t++;
rt.innerText = timeToStr(t);
}, 1000);
}
// 停止录音
function stopRecord(){
er.style.display = 'none';
rt.innerText = '00:00:00';
clearInterval(ri);
ri = null;
r.stop();
w = null;
r = null;
t = 0;
}
// 清除历史记录
function cleanHistory(){
hl.innerHTML = '<li id="empty" class="ditem-empty">无历史记录</li>';
le = document.getElementById('empty');
// 删除音频文件
outSet('清空录音历史记录:');
gentry.removeRecursively(function(){
// Success
outLine('操作成功!');
}, function(e){
ouline('操作失败:'+e.message);
});
}
// 获取录音历史列表
function updateHistory(){
if(bUpdated||!gentry||!document.body){//兼容可能提前注入导致DOM未解析完更新的问题
return;
}
var reader = gentry.createReader();
reader.readEntries(function(entries){
for(var i in entries){
if(entries[i].isFile){
createItem(entries[i]);
}
}
}, function(e){
outLine('读取录音列表失败:'+e.message);
});
bUpdated = true;
}
// 获取录音文件信息
function updateInformation(li){
if(!li || !li.entry){
return;
}
var entry = li.entry;
entry.getMetadata(function(metadata){
li.querySelector('.ainf').innerText = dateToStr(metadata.modificationTime);
}, function(e){
outLine('获取文件"'+entry.name+'"信息失败:'+e.message);
} );
}
// 播放音频文件
function playAudio(li){
if(!li || !li.entry){
ouSet('无效的音频文件');
return;
}
outSet('播放音频文件:'+li.entry.name);
startPlay('_doc/audio/'+li.entry.name);
}
// 播放文件相关对象
var p=null,pt=null,pp=null,ps=null,pi=null;
// 开始播放
function startPlay(url){
ep.style.display = 'block';
var L = pp.clientWidth;
p = plus.audio.createPlayer(url);
p.play(function(){
outLine('播放完成!');
// 播放完成
pt.innerText = timeToStr(d)+'/'+timeToStr(d);
ps.style.webkitTransition = 'all 0.3s linear';
ps.style.width = L+'px';
stopPlay();
}, function(e){
outLine('播放音频文件"'+url+'"失败:'+e.message);
});
// 获取总时长
var d = p.getDuration();
if(!d){
pt.innerText = '00:00:00/'+timeToStr(d);
}
pi = setInterval(function(){
if(!d){ // 兼容无法及时获取总时长的情况
d = p.getDuration();
}
var c = p.getPosition();
if(!c){ // 兼容无法及时获取当前播放位置的情况
return;
}
pt.innerText = timeToStr(c)+'/'+timeToStr(d);
var pct = Math.round(L*c/d);
if(pct < 8){
pct = 8;
}
ps.style.width = pct+'px';
}, 1000);
}
// 停止播放
function stopPlay(){
clearInterval(pi);
pi=null;
setTimeout(resetPlay, 500);
// 操作播放对象
if(p){
p.stop();
p=null;
}
}
// 重置播放页面内容
function resetPlay(){
ep.style.display = 'none';
ps.style.width = '8px';
ps.style.webkitTransition = 'all 1s linear';
pt.innerText = '00:00:00/00:00:00';
}
// 重写关闭
var _back=window.back;
function resetback(){
// 停止播放
if(ep.style.display == 'block'){
stopPlay();
}else if(er.style.display == 'block'){
stopRecord();
}else{
_back();
}
}
window.back=resetback;
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css">
.rp {
width: 100%;
height: 100%;
display: none;
text-align: center;
position: fixed;
top: 0;
background: rgba(0,0,0,0.8);
z-index: 9999;
overflow: hidden;
}
.aname {
font-size: 16px;
}
.ainf {
font-size: 12px;
}
.rtime {
font-size: 22px;
color: #FF0000;
}
.ptime {
margin-top: 40%;
font-size: 22px;
color: #FFFFFF;
}
.rprogress {
background: url(../img/arecord.png) no-repeat center center;
background-size: 32px 32px;
}
.rschedule {
background-color: rgba(0,0,0,0);
border: 5px solid rgba(0,183,229,0.9);
opacity: .9;
border-left: 5px solid rgba(0,0,0,0);
border-right: 5px solid rgba(0,0,0,0);
border-radius: 50px;
box-shadow: 0 0 15px #2187e7;
width: 36px;
height: 36px;
margin: 0 auto;
-webkit-animation: spin 1s infinite linear;
animation: spin 1s infinite linear;
}
@-webkit-keyframes spin {
0% {
-webkit-transform: rotate(0deg);
}
100% {
-webkit-transform: rotate(360deg);
}
}
@keyframes spin {
0% {
transform: rotate(0deg);
}
100% {
transform: rotate(360deg);
}
}
.progress {
width: 90%;
background-color: #666;
margin: 0 5%;
border: 1px solid #222;
-webkit-border-radius: 5px;
border-radius: 5px;
}
.schedule {
width: 8px;
height: 8px;
margin: 1px 0;
background-color: #FFCC33;
-webkit-border-radius: 4px;
border-radius: 4px;
-webkit-transition: all 1s linear;
transition: all 1s linear;
}
.stop {
width: 72px;
height: 72px;
background: url(../img/astop.png) center center;
background-size: 72px 72px;
margin: auto;
-webkit-border-radius: 72px;
border-radius: 72px;
}
.stop:active{
-webkit-box-shadow: 0 3px 8px rgba(0, 0, 0, 0.5) inset;
box-shadow: 0 3px 8px rgba(0, 0, 0, 0.5) inset;
}
.iplay {
display: block;
background: no-repeat right center url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABYCAYAAAADWlKCAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAKwwAACsMBNCkkqwAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMi8xM5w+I3MAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAAD9UlEQVR4nO2b3XETMRRGDwzvoYOkg5hRAVkqiKmAdIA7wHSQVECoALsC1gXciV0BTge4gvCwgnHk9d/+WF8m97ztxrlXs8fS1Urym6enJxwd3uZugPMcFyKGCxHDhYjhQsRwIWK4EDFciBguRAwXIoYLEcOFiOFCxHAhYrgQMVyIGC5EDBcihgsRw4WI4ULEcCFiuBAx3uVuwDGY2XtgCBTAALjc8tEFMAdKYBJC+HOK9nXBm5dwUM7MCmAEXDcMMQVuQwhlV23qC2khZjYAboGrjkLOgFEIYd5RvM6RrSFmdgs80J0MYqyHGFsSuR4S60TJ9vrwCEziZ+YhhGXy/xdU9aWgqjfnW+IsgEKtvkgJiUPUPfUyZsD42DoQ68+Y+p62AG6UhjAZITt6xopq3L9vGf+Gqh6dJX+S6ilKNaRkU8YCGLSVARBjDGLMdS5jbgkkhMQiWyejSGtEG2KsghopKoU++5AV68ZDcrvXYWTH8Pghdz1R6CHpN3MFDPsc02PsYcy1qy0nJ6uQOANKZz+jfcOUmd3H6W1jYo5RcvsqtikbuXtI+kBmBxbwz8DczMZtksdcsz1tOinZhMRxPF2bGh8R4gz4amZLMxu2aEqa8zq2LQs5e0j6EB8bLv6dAz/NrGwyjMWcj3vadjJyCimS60nLeFfAbzO7bfANT3MXLdvSmJxCBsl12VHcL8AyvpkfSpo7bdvJyCkkfQfocv5/Bnw3s/mBs6Y097aFzd7JPcv6T5dv5GtcAr/2TZN7yt0IGSE908k0+RS8FiEvhhd1yKEFUw5YAVBApoe0XQrZwgL4GEIY7pLRU+5G5OwhC57PZgbAsqPYK6rdxUMXC9Npbro8fzJy9pB0qll0FPcOuDhCRl3ubEvwOYWUyXXb5YoZ1X7GqMHSfZq7bNmWxuQUki5XnDdc+n4EPoUQiiabSzFnejKl7TJOY7IJid/iaXJ7fESIFfCNas+9zQNMc05zHnjIPctKx/mrA9egflCJGLd5eDFXukGWdddQYU+95PlDWVE97GXPeS+oivf6saBZCKHoM+8+cvcQ2NyhOwMmfW4SxdgTNs9oZd0tBAEhsRDfJbcvgbIPKTtOnNzlPnECAkPWP8xsTv3ZrJ1v2UfmuKDqGRt5QgjZ9kDWyd5D1iioP1U4P3KzqZYYY5v0om38rpDpIeCHrUFMCPjPEeSE/COetf3SU/i7EEL2GVUdSjXkGfGBfWDzIFsb/q93dRizU2R7yDr+o09R/GfRzsmRrSGvFRcihgsRw4WI4ULEcCFiuBAxXIgYLkQMFyKGCxHDhYjhQsRwIWK4EDFciBguRAwXIoYLEcOFiOFCxHAhYrgQMf4CVuqCm+17t3sAAAAASUVORK5CYII=);
background-size: 50px 44px;
-ms-touch-action: auto;
}
</style>
</head>
<body>
<header id="header">
<div class="nvbt iback" onclick="back()"></div>
<div class="nvtt">Audio</div>
<div class="nvbt idoc" onclick="openDoc('Audio Document','/doc/audio.html')"></div>
</header>
<div id="dcontent" class="dcontent">
<br/>
<div class="button" onclick="startRecord()">开始录音</div>
<div class="button" onclick="startPlay('_www/audio/friendship.mp3')">播放音乐</div>
<br/>
<!-- History list -->
<ul id="history" class="dlist" style="text-align:left;">
<li id="empty" class="ditem-empty">无历史记录</li>
</ul>
<br/>
<div class="button button-waring" onclick="cleanHistory()">清空历史记录</div>
<br/>
</div>
<div id="output">
Audio用于管理音频设备,可调用麦克风录制音频文件,也可播放音频文件。
</div>
<div id="play" class="rp">
<div id="ptime" class="ptime">00:00:00/00:00:00</div><br/>
<div id="progress" class="progress"><div id="schedule" class="schedule"></div></div>
<br/>
<div class="stop" onclick="stopPlay(),outSet('停止播放!')"></div>
</div>
<div id="record" class="rp">
<div style="width:100%;height:20%;"></div>
<div class="rprogress"><div class="rschedule"></div></div>
<br/>
<div id="rtime" class="rtime">00:00:00</div><br/>
<div class="stop" onclick="stopRecord()"></div>
</div>
</body>
<script type="text/javascript" src="../js/immersed.js" ></script>
</html>
+122
View File
@@ -0,0 +1,122 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var img = null;
var blist = [];
function scaned(t, r, f){
var d = new Date();
var h=d.getHours(),m=d.getMinutes(),s=d.getSeconds(),ms=d.getMilliseconds();
if(h < 10){ h='0'+h; }
if(m < 10){ m='0'+m; }
if(s < 10){ s='0'+s; }
if(ms < 10){ ms='00'+ms; }
else if(ms < 100){ ms='0'+ms; }
var ts = '['+h+':'+m+':'+s+'.'+ms+']';
var li=null,hl = document.getElementById('history');
if(blist.length > 0){
li = document.createElement('li');
li.className = 'ditem';
hl.insertBefore(li, hl.childNodes[0]);
} else{
li = document.getElementById('nohistory');
}
li.id = blist.length;
var html = '['+h+':'+m+':'+s+'.'+ms+']'+'  '+t+'码<div class="hdata">';
html += r;
html += '</div>';
li.innerHTML = html;
li.setAttribute('onclick', 'selected(id)');
blist[blist.length] = {type:t,result:r,file:f};
update(t, r, f);
}
function selected(id){
var h = blist[id];
update( h.type, h.result, h.file );
if(h.result.indexOf('http://')==0 || h.result.indexOf('https://')==0){
plus.nativeUI.confirm(h.result, function(i){
if(i.index == 0){
plus.runtime.openURL(h.result);
}
}, '', ['打开', '取消']);
} else{
plus.nativeUI.alert(h.result);
}
}
function update(t, r, f){
outSet('扫描成功:');
outLine(t);
outLine(r);
outLine('\n图片地址:'+f);
if(!f || f=='null'){
img.src = '../img/barcode.png';
} else{
plus.io.resolveLocalFileSystemURL(f, function(entry){
img.src=entry.toLocalURL();
});
//img.src = 'http://localhost:13131/'+f;
}
}
function onempty(){
if(window.plus){
plus.nativeUI.alert('无扫描记录');
} else {
alert('无扫描记录');
}
}
function cleanHistroy(){
if(blist.length > 0){
var hl = document.getElementById('history');
hl.innerHTML = '<li id="nohistory" class="ditem" onclick="onempty();">无历史记录 </li>';
}
plus.io.resolveLocalFileSystemURL('_doc/barcode/', function(entry){
entry.removeRecursively(function(){
// Success
}, function(e){
//alert( "failed"+e.message );
});
});
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css" media="screen">
.hdata {
color: #e1673e;
font-size: 14px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
</style>
</head>
<body onload="img=document.getElementById('bimg')">
<header id="header">
<div class="nvbt iback" onclick="back()"></div>
<div class="nvtt">Barcode</div>
<div class="nvbt idoc" onclick="openDoc('Barcode Document','/doc/barcode.html')"></div>
</header>
<div id="dcontent" class="dcontent">
<br/>
<img style="width:40%" id="bimg" src="../img/barcode.png"/>
<br/>
<div class="button" onclick="clicked('barcode_scan.html',true,true)">扫一扫</div>
<div class="button" onclick="clicked('barcode_scan2.html',true,true)">扫一扫(自定义)</div>
<br/>
<ul id="history" class="dlist" style="text-align:left;">
<li id="nohistory" class="ditem" onclick="onempty()">无历史记录 </li>
</ul>
<br/>
<div class="button button-waring" onclick="cleanHistroy()">清空历史记录</div>
</div>
<div id="output">
Barcode提供二维码扫描识别功能,支持调用摄像头即时扫描二维码,也可直接输入图片进行扫描识别。
</div>
</body>
<script type="text/javascript" src="../js/immersed.js" ></script>
</html>
+117
View File
@@ -0,0 +1,117 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var ws=null,wo=null;
var scan=null,domready=false;
// H5 plus事件处理
function plusReady(){
if(ws||!window.plus||!domready){
return;
}
// 获取窗口对象
ws=plus.webview.currentWebview();
wo=ws.opener();
// 开始扫描
ws.addEventListener('show', function(){
scan=new plus.barcode.Barcode('bcid');
scan.onmarked=onmarked;
scan.start({conserve:true,filename:'_doc/barcode/'});
}, false);
// 显示页面并关闭等待框
ws.show('pop-in');
wo.evalJS('closeWaiting()');
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// 监听DOMContentLoaded事件
document.addEventListener('DOMContentLoaded', function(){
domready=true;
plusReady();
}, false);
// 二维码扫描成功
function onmarked(type, result, file){
switch(type){
case plus.barcode.QR:
type = 'QR';
break;
case plus.barcode.EAN13:
type = 'EAN13';
break;
case plus.barcode.EAN8:
type = 'EAN8';
break;
default:
type = '其它'+type;
break;
}
result = result.replace(/\n/g, '');
wo.evalJS("scaned('"+ type +"','"+ result +"','"+ file +"');");
back();
}
// 从相册中选择二维码图片
function scanPicture(){
plus.gallery.pick(function(path){
plus.barcode.scan(path,onmarked,function(error){
plus.nativeUI.alert('无法识别此图片');
});
}, function(err){
console.log('Failed: '+err.message);
});
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css">
#bcid {
width: 100%;
position: absolute;
top: 0px;
bottom: 44px;
text-align: center;
}
.tip {
color: #FFFFFF;
font-weight: bold;
text-shadow: 0px -1px #103E5C;
}
footer {
width: 100%;
height: 44px;
position: absolute;
bottom: 0px;
line-height: 44px;
text-align: center;
color: #FFF;
}
.fbt {
width: 50%;
height: 100%;
background-color: #FFCC33;
float: left;
}
.fbt:active {
-webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.5);
box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.5);
}
</style>
</head>
<body style="background-color: #000000;">
<div id="bcid">
<div style="height:40%"></div>
<p class="tip">...载入中...</p>
</div>
<footer>
<div class="fbt" onclick="back()">取  消</div>
<div class="fbt" onclick="scanPicture()">从相册选择二维码</div>
</footer>
</body>
</html>
+118
View File
@@ -0,0 +1,118 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var ws=null,wo=null;
var scan=null,domready=false,bCancel=false;
// H5 plus事件处理
function plusReady(){
if(ws||!window.plus||!domready){
return;
}
// 获取窗口对象
ws=plus.webview.currentWebview();
wo=ws.opener();
// 开始扫描
ws.addEventListener('show',function(){
scan=new plus.barcode.Barcode('bcid',[plus.barcode.QR,plus.barcode.EAN8,plus.barcode.EAN13],{frameColor:'#00FF00',scanbarColor:'#00FF00'});
scan.onmarked=onmarked;
scan.start({conserve:true,filename:'_doc/barcode/'});
});
// 显示页面并关闭等待框
ws.show('pop-in');
wo.evalJS('closeWaiting()');
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// 监听DOMContentLoaded事件
document.addEventListener('DOMContentLoaded', function(){
domready=true;
plusReady();
}, false);
// 二维码扫描成功
function onmarked(type, result, file){
switch(type){
case plus.barcode.QR:
type = 'QR';
break;
case plus.barcode.EAN13:
type = 'EAN13';
break;
case plus.barcode.EAN8:
type = 'EAN8';
break;
default:
type = '其它'+type;
break;
}
result = result.replace(/\n/g, '');
wo.evalJS("scaned('"+ type +"','"+ result +"','"+ file +"');");
back();
}
// 从相册中选择二维码图片
function scanSwitch() {
if(bCancel){
scan.start({conserve:true,filename:'_doc/barcode/'});
btCancel&&(btCancel.innerText='暂 停');
}else{
scan.cancel();
btCancel&&(btCancel.innerText='开 始');
}
bCancel=!bCancel;
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css">
#bcid {
width: 100%;
position: absolute;
top: 0px;
bottom: 44px;
text-align: center;
}
.tip {
color: #FFFFFF;
font-weight: bold;
text-shadow: 0px -1px #103E5C;
}
footer {
width: 100%;
height: 44px;
position: absolute;
bottom: 0px;
line-height: 44px;
text-align: center;
color: #FFF;
}
.fbt {
width: 50%;
height: 100%;
background-color: #FFCC33;
float: left;
}
.fbt:active {
-webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.5);
box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.5);
}
</style>
</head>
<body style="background-color: #000000;">
<div id="bcid">
<div style="height:40%"></div>
<p class="tip">...载入中...</p>
</div>
<footer>
<div class="fbt" onclick="back()">取 消</div>
<div id="btCancel" class="fbt" onclick="scanSwitch()">暂 停</div>
</footer>
</body>
</html>
+219
View File
@@ -0,0 +1,219 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var i=1,gentry=null,w=null;
var hl=null,le=null,de=null,ie=null;
var unv=true;
var bUpdated=false; //用于兼容可能提前注入导致DOM未解析完更新的问题
// H5 plus事件处理
function plusReady(){
// 获取摄像头目录对象
plus.io.resolveLocalFileSystemURL('_doc/', function(entry){
entry.getDirectory('camera', {create:true}, function(dir){
gentry = dir;
updateHistory();
}, function(e){
outSet('Get directory "camera" failed: '+e.message);
} );
}, function(e){
outSet('Resolve "_doc/" failed: '+e.message);
});
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// 监听DOMContentLoaded事件
document.addEventListener('DOMContentLoaded', function(){
// 获取DOM元素对象
hl=document.getElementById('history');
le=document.getElementById('empty');
de=document.getElementById('display');
if(ie=document.getElementById('index')){
ie.onchange=indexChanged;
}
// 判断是否支持video标签
unv=!document.createElement('video').canPlayType;
updateHistory();
},false );
function changeIndex(){
outSet('选择摄像头:');
ie.focus();
}
function indexChanged(){
de.innerText = ie.options[ie.selectedIndex].innerText;
i = parseInt(ie.value);
outLine(de.innerText);
}
// 拍照
function getImage(){
outSet('开始拍照:');
var cmr = plus.camera.getCamera();
cmr.captureImage(function(p){
outLine('成功:'+p);
plus.io.resolveLocalFileSystemURL(p, function(entry){
createItem(entry);
}, function(e){
outLine('读取拍照文件错误:'+e.message);
});
}, function(e){
outLine('失败:'+e.message);
}, {filename:'_doc/camera/',index:1});
}
// 录像
function getVideo(){
outSet('开始录像:');
var cmr = plus.camera.getCamera();
cmr.startVideoCapture(function(p){
outLine('成功:'+p);
plus.io.resolveLocalFileSystemURL(p, function(entry){
createItem(entry);
}, function(e){
outLine('读取录像文件错误:'+e.message);
} );
}, function(e){
outLine('失败:'+e.message);
}, {filename:'_doc/camera/',index:i});
}
// 显示文件
function displayFile(li){
if(w){
outLine('重复点击!');
return;
}
if(!li || !li.entry){
ouSet('无效的媒体文件');
return;
}
var name = li.entry.name;
var suffix = name.substr(name.lastIndexOf('.'));
var url = '';
if(suffix=='.mov' || suffix=='.3gp' || suffix=='.mp4' || suffix=='.avi'){
//if(unv){plus.runtime.openFile('_doc/camera/'+name);return;}
url = '/plus/camera_video.html';
} else {
url = '/plus/camera_image.html';
}
w=plus.webview.create(url,url,{hardwareAccelerated:true,scrollIndicator:'none',scalable:true,bounce:'all'});
w.addEventListener('loaded', function(){
w.evalJS('loadMedia("'+li.entry.toLocalURL()+'")');
//w.evalJS('loadMedia("'+'http://localhost:13131/_doc/camera/'+name+'")');
}, false );
w.addEventListener('close', function(){
w = null;
}, false);
w.show('pop-in');
}
// 添加播放项
function createItem(entry){
var li = document.createElement('li');
li.className = 'ditem';
li.innerHTML = '<span class="iplay"><font class="aname"></font><br/><font class="ainf"></font></span>';
li.setAttribute('onclick', 'displayFile(this)' );
hl.insertBefore( li, le.nextSibling );
li.querySelector('.aname').innerText = entry.name;
li.querySelector('.ainf').innerText = '...';
li.entry = entry;
updateInformation(li);
// 设置空项不可见
le.style.display = 'none';
}
// 获取录音文件信息
function updateInformation(li){
if(!li || !li.entry){
return;
}
var entry = li.entry;
entry.getMetadata(function(metadata){
li.querySelector('.ainf').innerText = dateToStr(metadata.modificationTime);
}, function(e){
outLine('获取文件"'+entry.name+'"信息失败:'+e.message);
} );
}
// 获取录音历史列表
function updateHistory(){
if(bUpdated||!gentry||!document.body){//兼容可能提前注入导致DOM未解析完更新的问题
return;
}
var reader = gentry.createReader();
reader.readEntries(function(entries){
for(var i in entries){
if(entries[i].isFile){
createItem(entries[i]);
}
}
}, function(e){
outLine('读取录音列表失败:'+e.message);
});
bUpdated = true;
}
// 清除历史记录
function cleanHistory(){
hl.innerHTML = '<li id="empty" class="ditem-empty">无历史记录</li>';
le = document.getElementById('empty');
// 删除音频文件
outSet('清空拍照录像历史记录:');
gentry.removeRecursively(function(){
// Success
outLine('成功!');
}, function(e){
outLine('失败:'+e.message);
});
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css">
.aname {
font-size: 16px;
}
.ainf {
font-size: 12px;
}
.iplay {
display: block;
background: no-repeat right center url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABYCAYAAAADWlKCAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAKwwAACsMBNCkkqwAAABZ0RVh0Q3JlYXRpb24gVGltZQAwOS8xMi8xM5w+I3MAAAAcdEVYdFNvZnR3YXJlAEFkb2JlIEZpcmV3b3JrcyBDUzVxteM2AAAD9UlEQVR4nO2b3XETMRRGDwzvoYOkg5hRAVkqiKmAdIA7wHSQVECoALsC1gXciV0BTge4gvCwgnHk9d/+WF8m97ztxrlXs8fS1Urym6enJxwd3uZugPMcFyKGCxHDhYjhQsRwIWK4EDFciBguRAwXIoYLEcOFiOFCxHAhYrgQMVyIGC5EDBcihgsRw4WI4ULEcCFiuBAx3uVuwDGY2XtgCBTAALjc8tEFMAdKYBJC+HOK9nXBm5dwUM7MCmAEXDcMMQVuQwhlV23qC2khZjYAboGrjkLOgFEIYd5RvM6RrSFmdgs80J0MYqyHGFsSuR4S60TJ9vrwCEziZ+YhhGXy/xdU9aWgqjfnW+IsgEKtvkgJiUPUPfUyZsD42DoQ68+Y+p62AG6UhjAZITt6xopq3L9vGf+Gqh6dJX+S6ilKNaRkU8YCGLSVARBjDGLMdS5jbgkkhMQiWyejSGtEG2KsghopKoU++5AV68ZDcrvXYWTH8Pghdz1R6CHpN3MFDPsc02PsYcy1qy0nJ6uQOANKZz+jfcOUmd3H6W1jYo5RcvsqtikbuXtI+kBmBxbwz8DczMZtksdcsz1tOinZhMRxPF2bGh8R4gz4amZLMxu2aEqa8zq2LQs5e0j6EB8bLv6dAz/NrGwyjMWcj3vadjJyCimS60nLeFfAbzO7bfANT3MXLdvSmJxCBsl12VHcL8AyvpkfSpo7bdvJyCkkfQfocv5/Bnw3s/mBs6Y097aFzd7JPcv6T5dv5GtcAr/2TZN7yt0IGSE908k0+RS8FiEvhhd1yKEFUw5YAVBApoe0XQrZwgL4GEIY7pLRU+5G5OwhC57PZgbAsqPYK6rdxUMXC9Npbro8fzJy9pB0qll0FPcOuDhCRl3ubEvwOYWUyXXb5YoZ1X7GqMHSfZq7bNmWxuQUki5XnDdc+n4EPoUQiiabSzFnejKl7TJOY7IJid/iaXJ7fESIFfCNas+9zQNMc05zHnjIPctKx/mrA9egflCJGLd5eDFXukGWdddQYU+95PlDWVE97GXPeS+oivf6saBZCKHoM+8+cvcQ2NyhOwMmfW4SxdgTNs9oZd0tBAEhsRDfJbcvgbIPKTtOnNzlPnECAkPWP8xsTv3ZrJ1v2UfmuKDqGRt5QgjZ9kDWyd5D1iioP1U4P3KzqZYYY5v0om38rpDpIeCHrUFMCPjPEeSE/COetf3SU/i7EEL2GVUdSjXkGfGBfWDzIFsb/q93dRizU2R7yDr+o09R/GfRzsmRrSGvFRcihgsRw4WI4ULEcCFiuBAxXIgYLkQMFyKGCxHDhYjhQsRwIWK4EDFciBguRAwXIoYLEcOFiOFCxHAhYrgQMf4CVuqCm+17t3sAAAAASUVORK5CYII=);
background-size: 50px 44px;
-ms-touch-action: auto;
}
</style>
</head>
<body>
<header id="header">
<div class="nvbt iback" onclick="back()"></div>
<div class="nvtt">Camera</div>
<div class="nvbt idoc" onclick="openDoc('Camera Document','/doc/camera.html')"></div>
</header>
<div id="dcontent" class="dcontent">
<!--<div class="button" onclick="changeIndex();">
选择:<span id="display" style="color:#FF0000">主摄像头</span>
<div style="width:0px;height:0px;overflow:hidden;"><select id="index">
<option value='1' selected="true">主摄像头</option>
<option value='2' >辅摄像头</option>
</select></div>
</div>-->
<div class="button" onclick="getImage()">拍照</div>
<div class="button" onclick="getVideo()">录像</div>
<br/>
<!-- History list -->
<ul id="history" class="dlist" style="text-align:left;">
<li id="empty" class="ditem-empty">无历史记录</li>
</ul>
<br/>
<div class="button button-waring" onclick="cleanHistory()">清空历史记录</div>
<br/>
</div>
<div id="output">
Camera管理摄像头设备,可用于拍摄照片、录制视频文件。
</div>
</body>
<script type="text/javascript" src="../js/immersed.js" ></script>
</html>
+54
View File
@@ -0,0 +1,54 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=3.0, user-scalable=yes"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var w=null;
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
function imgLoaded(){
w&&(w.close(),w=null);
var b = document.body;
var img = document.getElementById('img');
var pb = b.clientHeight/b.clientWidth,
pi = img.clientHeight/img.clientWidth;
if(pb > pi){
img.style.width = '100%';
}else{
img.style.height = '100%';
}
b.style.lineHeight = b.clientHeight+'px';
}
function imgError(){
w&&(w.close(),w=null);
document.getElementById('img').style.display = 'none';
plus.nativeUI.alert('无效的图片资源', function(){
back();
});
}
function loadMedia(src){
document.getElementById('img').src=src;
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
<style type="text/css" media="screen">
img {
vertical-align: middle;
}
</style>
</head>
<body style="text-align:center;background:#000000;">
<img id="img" onclick="back()" onload="imgLoaded()" onerror="imgError()"/>
</body>
</html>
+56
View File
@@ -0,0 +1,56 @@
<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<meta name="HandheldFriendly" content="true"/>
<meta name="MobileOptimized" content="320"/>
<title>Hello H5+</title>
<script type="text/javascript" src="../js/common.js"></script>
<script type="text/javascript">
var v=null;
function loadMedia( src ) {
v.src = src;
v.play();
}
function videoFinished() {
back();
}
function videoError(e) {
switch (e.target.error.code) {
case e.target.error.MEDIA_ERR_ABORTED:
alert('You aborted the video playback.');
break;
case e.target.error.MEDIA_ERR_NETWORK:
alert('A network error caused the video download to fail part-way.');
break;
case e.target.error.MEDIA_ERR_DECODE:
alert('The video playback was aborted due to a corruption problem or because the video used features your browser did not support.');
break;
case e.target.error.MEDIA_ERR_SRC_NOT_SUPPORTED:
alert('The video could not be loaded, either because the server or network failed or because the format is not supported.');
break;
default:
alert('An unknown error occurred.');
break;
}
plus.nativeUI.alert( "无效的视频资源", function(){
back();
} );
}
function init() {
v = document.getElementById("video");
//v.onended = videoFinished;
}
</script>
<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
</head>
<body style="text-align:center;background:#DDDDDD;" onload="init();">
<div style="width:100%;height:100%;display:table;" onclick="back();">
<div style="display:table-cell;vertical-align:middle;">
<video id="video" style="width:100%;" autoplay controls onerror="videoError(event);"></video>
</div>
</div>
</body>
</html>

Some files were not shown because too many files have changed in this diff Show More