org.studio.crusoe.mobile.android alpha 0.2 扩展web js API

标准函数扩展

 alert()

重载js标准的alert函数，系统使用本地的AlertDialog实现alert的提示功能。

 confirm()

重载js标准的confirm函数，系统使用本地的AlertDialog实现confirm的功能。

 

windowDialog对象

openWindow()

API:  windowDialog.openWindow(/*String*/ url)

功能：当前页面跳转到对应url。可以用GET方式将参数附加在URL上提交，主要用于页面跳转而非功能提交。

示例：windowDialog.openWindow("/sm/newPage.jsp");

toastMsg()

API:   windowDialog.toastMsg(/*String*/ msg)

功能：通过Android系统的toast提供方式（即：浮动气泡窗口提示），进行消息提供。区别于alert，此方法在显示一段时间（5s左右）后会自动消息，并且不会进行截断操作。后续js会继续执行。

示例： windowDialog.toastMsg("浮动消息测试");

 

 phone对象

call()

API:   phone.call(/*String*/ telNum)

功能： 主页面切换，跳转到当前系统的拨号页面，准备拨叫号码为telNum。等待确认进行拨出操作。

示例：phone.call("18601251107");

sms()

API：  phone.sms(/*String*/ telNum, /*String*/ msg)

功能： 主页面切换，跳转到当前系统的短信发送页面，短信目标号码为telNum，短信内容为msg。等待确认进行发送操作。

示例： phone.sms("18601251107", "测试短信内容");

 

camera对象

take()

API:   camera.take(/*String*/ callBackUrl)

功能： 页面切换到拍照功能组件，选择进行拍照操作，如果拍照并保存成功，浏览器页面会跳转到callBackUrl上。callBackUrl必须存在。照片保存为默认文件名：BV_TMP.jpg。

API：  camera.take(/*String*/ picName, /*String*/ callBackUrl)

功能：页面切换到拍照功能组件，选择进行拍照操作，如果拍照并保存成功，浏览器页面会跳转到callBackUrl上。callBackUrl必须存在。照片保存文件名为picName。

示例： camera.take("test.pic", "sm/testAction.do?method=login");

 view()

API:    camera.view(/*String*/ picName)

功能：  页面切换到拍照功能组件，预览指定名称的图片文件。该图片必须存在。

示例： camera.view("test.pic");

edit()

API：   camera.edit(/*String*/ picName, /*String*/ callBackUrl)

功能：  页面切换到拍照功能组件，预览指定名称的图片文件。该图片必须存在。同时允许进行重新拍照。如果拍照并保存成功，浏览器页面会跳转到callBackUrl上。callBackUrl必须存在。照片保存文件名为picName。会覆盖原有的本地文件。

示例： camera.edit("test.pic", "sm/testAction.do?method=login");

 

httpRequest对象

request()

API    httpRequest.request(String url, String jsonObjStr, String sucessCallBack)

功能：  客户端根据url地址请求端，请求方式为post，参数值以jsonObjStr提供，请求参数为简单JSON对象（如：{"username": "Hello, World"; 'pwd': '123456' }），请求发送完成后，会回调当前页面名为sucessCallBack的js方法，参数为服务器返回的html报文体。

示例： httpRequest.request("sm/testAction.do?method=requestMethod", "{'username': 'Hello, World'; 'pwd': '123456'}", "getResponse");

注：alpha 0.2将是最后一个公开的测试版本。此版本将可能作为公司开发此客户端的核心版本进行二次开发，由于涉及知识产权原因，后续不再更新API的文档。大家有什么扩展的应用场景，欢迎留言或者来信交流。