#SJSB android-javascript 通讯框架

本框架适用于hybird开发。为js提供各种原生支持api.

当前版本v2.0 email:71752352@qq.com author:awen

@2014-12-26将sjsb修改为库工程，对应使用demo地址：https://github.com/cczw2010/sjsbdemo

##------------------API

####基础部分

• 获取启动次数

    SJSB.getAppCounter();
  

• 获取应用版本号

    SJSB.getAppVersion();
  

• 打印android调试日志

    SJSB.log(tag,message);
  

• 设置当前页当菜单键按下时的js回调函数，如果为空则执行系统的原生操作

    /**
    *@param string callback  回调js函数名
    */
    SJSB.setMenuBtnFn(callback);
  

• 设置当前页当返回键按下时的js回调函数，如果为空则执行系统的原生操作

    /**
    *@param string callback  回调js函数名
    */
    SJSB.setBackBtnFn(callback);
  

• 设置下拉控件的状态

    /**
    * 设置当前页下拉控件的状态，初始为ENABLE
    * @param String mode  DISABLED 禁用，ENABLE启用（启用后如果不设置下拉回调方法默认为刷新当前网页`）
    */
    SJSB.setSwipeMode(mode);
  

• 停止当前的下拉动画

    SJSB.clearSwipeAnim()
  

• 设置下拉刷新的回调方法，前提是当前模式支持下拉刷新

    SJSB.setSwipeRefreshFn(callback)
  

• 显示loading

    SJSB.showProgress(showstr);
  

• 隐藏loading

    SJSB.disProgress();
  

• 获取webview高

    SJSB.getWebHeight();
  

• 获取webview宽

    SJSB.getWebWidth();
  

• 显示小tip(toast)

    /**
    * @param String str 提示信息
    * @param int pos 位置 	0居中(默认)  1底部中间，2顶部中间，3左边中间，4右边中间
    * @param int inteval 显示时长 0短(默认) 1长
    */
    SJSB.toast(str,pos,inteval)
  

• 检查是否有网络连接

    SJSB.onLine();
  

• 获取网络类型

    /**
    * @return 0 无 ;1 wifi ; 2 gprs cmwap
    */
    SJSB.netType();
  

• 获取设备信息，返回json字符串。其中uuid是根据手机一些设备信息自己生成

    SJSB.getDeviceInfo();
  

• 清空浏览器缓存

    SJSB.clearWebCache();
  

• 清空应用所有的缓存和数据(包括浏览器)

    SJSB.clearAppCache();
  

• 退出APP

    SJSB.exitApp();
  

• 抓取当前网页截图

    /**
    * @param int quantity 质量 0~100
    *return String 本地文件路径（注意网页缓存）
    */
    SJSB.getSnapshot(quantity);
  

####重载部分

• window的alert方法，去除了url显示

    alert(message);
  

• window的confirm方法，去除了url显示

    confirm(message);
  

• window的prompt方法

    prompt(message);
  

####应用变量处理

这些变量与网页无关，将在整个应用中一直保存，不管退出与否.另外不建议在此处存储大数据

• 设置应用级变量,不随应用退出而退出,但不建议大量使用

    SJSB.setAppProp(key,val)
  

• 获取应用级变量

   SJSB.getAppProp(key);
  

• 删除应用级变量

    SJSB.removeAppProp(key);
  

• 清空应用级变量

    SJSB.clearAppProp();
  

####相机部分

• js相机

    /**
    * @param int  type   返回原图还是缩略图   0  原图  1 缩略图
    * @param int save   0 不保存（其实所有的不保存图片公用一个文件缓存）  1保存（每次生成新的）
    * @param String callback  回调的js方法，传入一个本地文件地址，或者空（失败或者取消）作为参数
    */
    SJSB.camera(type,save,callback);
  

• 二维码扫描解析

    /**
    *@param string callback  回调js函数名,传入解析结果作为参数
    */
    SJSB.qrcodeCamera(callback)
  

####地理信息

• 获取地理信息

    /**
    * 获取地理信息，（同步阻塞,想异步请在js中处理）
    * return jsonstring (longitude精度latitude维度，accuracy精度。。省，市，区。。。)
    */
    SJSB.getLocation()
  

####感应器

• 开始震动

    /**
    * @param int continues 持续时间 毫秒
    * @param int betweens 间隔时间 毫秒
    * @param int times  震动循环次数，-1表示不循环 0 循环
    */
    SJSB.vibrator(continues,betweens ,times);
  

• 停止震动

    SJSB.stopVibrator();
  

####窗口开发

• 新开窗口

    /**新开页面
    *@param String ptype 页面类型  web:纯webview  native:纯原生空白页面（原生控件自定义生成,暂未实现）
    *@param String config 配置文件  ptype=web时：url；ptype=native时：json配置字符串
    */
    SJSB.openView(ptype,config)
  

• 外部浏览器吊起应用

    在web中写入如下url:
    sjsb://cn.cczw(包名) ，
    即可吊起应用，schame是建立程序时设定的消息头。
    详细的交互命令暂不实现，优先级放在上下拉控件低版本bug优化之后