加载中…
个人资料
网络小精灵
网络小精灵
  • 博客等级:
  • 博客积分:0
  • 博客访问:31,938
  • 关注人气:26
  • 获赠金笔:0支
  • 赠出金笔:0支
  • 荣誉徽章:
相关博文
推荐博文
谁看过这篇博文
加载中…
正文 字体大小:

AppCan平台API使用_网络小精灵_沈阳网络小精灵_沈阳网站建设_沈阳网站制作____

(2013-08-14 10:40:56)
标签:

手机网站制作

网络小精灵

网站建设

网站制作

it

分类: HTML5

一、API概述


Appcan平台封装了手机本地功能的JS调用API。开发者使用Appcan平台的时候,直接可以在网页JS中调用。需要说明的是,不管是ios,android还是symbain版本里,都不需要再html页面中引入API的JS。开发者直接在html中使用即可。在Appcan IDE中也可以直接调试这些API。下面具体说明下,如何使用Appcan平台API。



         Appcan平台API都是以uex开头,以对象的形式出现,比如说,“uexAudio”封装了关于音频的所有操作,若要打开一个音频文件,在JS中可以直接使用uexAudio.open(inPath),传入音频文件路径。网络小精灵


二、window.uexOnload



         文档中给出的例子,我们经常能看见一个方法:“window. uexOnload”,在进行Appcan平台API调用时,平台会进行API初始化,这个初始化只需几十毫秒,但为了确保在使用这些API时,API已经初始化完毕,避免在使用过程中出错,就可以把API调用对象写在window.uexOnload中。开发者经常会使用如下场景:在网页一加载时,就做一些操作,通常的做法是利用body的onload事件,或者window.onload事件。那么,如果你用了Appcan平台API,可以用window.uexOnload来代替window.onload。网络小精灵



         另外,由于为了兼容IOS,Android系统,大部分的API调用都采取回调的方式实现,即比如获取设配信息接口:“uexDevice.getInfo(inInfoID)”,其值需在回调方法:“uexDevice.cbGetInfo(opId,dataType,data)”中获取。这个场景需要注意的一点是,uexDevice.cbGetInfo需在uexDevice.getInfo方法之前定义。即回调方法需在调用方法之前定义。这样,在硬件比较快速的平台上,操作会在几毫秒内完成,立刻就会调用回调方法,而有可能DOM解析还没解析到此回调方法,那么,就有可能会报错。这点需要特别注意。



三、uexWidgetOne.cbError


         在文档的例子中,我们也能经常看到 uexWidgetOne.cbError这个方法,此方法是用来接收调用API时出错抛出的异常,错误类型请参看“错误代码释义”。网络小精灵



四、API使用注意事项



4.1 文件路径

         开发者开发应用时,经常会碰到访问本地路径的问题。在Appcan平台中,我们需要了解三个路径:绝对路径,wgt://路径,res://路径。



 绝对路径:是指手机的物理路径

 wgt://路径:定位到当前应用的根目录

 res://路径:定位到当前应用下的wgtRes文件目录



这三个路径有什么区别,或者在什么情况下使用者三个路径呢?首先,绝对路径的情况:在有关平台设备返回的路径都是绝对路径,比如调用摄像头拍照或视频后返回的照片/视频路径都是绝对路径。其次,wgt://路径用于访问当前应用下的文件,由于跨平台特性,在ios和android上,应用安装的物理路径都不相同,那么就需要一个相对路径用来统一定位到当前应用目录。最后说下,res://路径的用处,由于很多应用需要预置一些资源,比如图片,文本内容,类似做一个静态的电子书,就需要把电子书文本文件预置进客户端里。然而,在打包后的安装包安装到手机上后,由于安全问题,手机上的应用沙盒会拒绝随意访问文件目录,但有提供可访问某一文件夹。res://表示当前应用的wgtRes文件夹,此文件夹关联到刚才说的可访问的文件夹。(如此描述可能不太专业,但原理是如此)。网络小精灵



4.2 平台支持问题


         在文档中,我们能看到一些接口对symbian并没有支持,这是由于symbain系统不好做扩展,所以Appcan放弃了symbain的一些接口。



五、关于一些优化建议



         由于网页的DOM解析是阻塞解析的,即开始解析

,然后里的内容。而所有的页面效果都是在中书写的,一般的开发者又习惯把

         与服务器通信的数据格式建议采用JSON格式,而非XML格式,这样传输的数据会很小。比较快速,省流量。



另外:DEV文档中关于API使用的代码仅供参考,采用最简单的方式去阐释如何抒写API 网络小精灵


0

阅读 评论 收藏 禁止转载 喜欢 打印举报/Report
  • 评论加载中,请稍候...
发评论

    发评论

    以上网友发言只代表其个人观点,不代表新浪网的观点或立场。

      

    新浪BLOG意见反馈留言板 电话:4000520066 提示音后按1键(按当地市话标准计费) 欢迎批评指正

    新浪简介 | About Sina | 广告服务 | 联系我们 | 招聘信息 | 网站律师 | SINA English | 会员注册 | 产品答疑

    新浪公司 版权所有