本篇文章介绍com.justep.cordova.plugin.baiduMapBase/com.justep.cordova.plugin.baiduMapSearch插件，以及如何使用它们，来开发一个原生的内嵌百度地图。 插件概述 com.justep.cordova.plugin.baiduMapBase/com.justep.cordova.plugin.baiduMapSearch（以下简称为baiduMapBase/baiduMapSearch）这两个插件分别封装了百度地图SDK的不同模块。其中，baiduMapBase中封装了基础地图的使用，包括定位，图层展示，坐标计算，离线地图等；baiduMapSearch插件则封装了地图的查询模块，主要能力是路线查询，兴趣点查询相关能力，并且，BaiduMapSearch插件依赖于baiduMapBase插件。通过这两个插件，我们可以开发出内嵌于应用的原生的百度地图，相比于js版地图而言，地图更加流畅，会带来更好的用户体验。   插件参数   在使用此插件之前，我们必须申请与之相对应的参数，前往百度地图开放平台，然后将申请好的参数填入打包选项中即可。 请确认参数的准确性，一旦参数错误，会打开一个空白的地图！如下： API目录   基础地图API open                                              close [...]

本文讲解cordova-plugin-ble-central插件以及如何在Wex5中使用该插件。 1.插件概述 低功耗蓝牙插件，将手机作为低功耗蓝牙中心设备，提供手机设备与低功耗蓝牙外设信息传输的能力。 注意： 1.使用该插件之前请尽量了解一些关于蓝牙开发的技术知识，方便对插件能力的理解。 2.要使用此插件，手机端蓝牙必须为低功耗蓝牙，而且需要一个低功耗蓝牙外设与其进行交互。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require("cordova!cordova-plugin-ble-central");”然后即可在js中调用相关API。 ble.scan ble.startScan ble.stopScan ble.connect ble.disconnect ble.read ble.write ble.startNotification ble.stopNotification ble.isEnabled ble.isConnected ble.showBluetoothSettings ble.enable scan 扫描发现BLE外设 ble.scan(services, seconds, success, failure); 此方法可以扫描发现周边的BLE外设。每发现一个可用的外设就会调用该方法的成功回调，并且返回外设的简略信息，扫描会在数秒内停止。返回值类型如下： {     "name": "TI SensorTag",   [...]

本文讲解cordova-plugin-file插件以及如何在Wex5中使用该插件。 目录： 1.插件概述 2.插件使用 <1>配置插件 <2>文件存储位置 <3>系统文件列表 <4>Android注意事项 <5>iOS注意事项 <6>cdvfile协议 <7>错误码 <8>手机应用目录结构 <9>示例代码 1.插件概述 文件管理插件，提供了读写设备文件的API。 2.插件使用 <1>配置插件（可选） 文件系统设置可以配置每个平台，在xml文件中，Android和iOS的平台都识别文件系统安装的标识。默认情况下，可以访问所有的文件根目录，如果我们禁止访问某一目录，可以在下面的配置代码中删除该目录的标识（比如“cache”）。 preference name="iosExtraFilesystems" value="library,library-nosync,documents,documents-nosync,cache,bundle,root" ; preference name="AndroidExtraFilesystems" value="files,files-external,documents,sdcard,cache,cache-external,root" ; <2>文件存储位置 cordova.file.applicationDirectory：只读的应用程序的安装目录。 （iOS，Android，OSX, windows） cordova.file.applicationStorageDirectory：应用程序的根目录的沙盒;在iOS和windows这个位置是只读的(但具体的子目录(iOS上/Documents或windows上/localState)读写)。这其中包含的所有文件都是应用私有的。 （iOS，Android，OSX） cordova.file.dataDirectory：使用内存存储在应用程序的沙箱中，私有的、持久的(在Android上,如果你需要使用外部存储器,用.externalDataDirectory)。在iOS上，该目录是不与iCloud同步的。 [...]

本文讲解com.justep.cordova.plugin.voiceManager插件以及如何在Wex5中使用该插件 1.插件概述 音频控制插件，通过参数设置可以调节手机音频的播放模式为外放模式/听筒模式。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!com.justep.cordova.plugin.voiceManager”);”然后即可在js中调用相关API。 代码如下： //选择听筒模式 Model.prototype.button1_16Click = function(event){ // alert(voiceManager.Mode.CALL); navigator.voiceManager.setPlayMode(voiceManager.Mode.CALL,success,fail); }; //选择外放模式 Model.prototype.button2_16Click = function(event){ // alert(voiceManager.Mode.NORMAL); navigator.voiceManager.setPlayMode(voiceManager.Mode.NORMAL,success,fail); };  

本文讲解com.justep.cordova.plugin.touchid插件以及如何在Wex5中使用该插件。 1.插件概述 iPhone指纹识别的插件。只支持iOS平台，提供了iOS上指纹识别的功能。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!com.justep.cordova.plugin.touchid”);”然后即可在js中调用相关API。 代码如下： //检查是否支持指纹识别,iPhone5s以后的设备支持指纹识别功能 Model.prototype.checkClick = function(event){ navigator.touchid.checkSupport(this.success, this.error); }; //指纹识别，如果指纹匹配则会显示成功，有三次匹配机会，连续三次识别不通过则会终止识别。参数为可选，指纹识别时的提示信息 Model.prototype.authenticateClick = function(event){ navigator.touchid.authenticate(this.success, this.error,"请开始指纹识别：将手指放于home键，核对指纹。"); };  

本文讲解cordova-plugin-screen-orientation插件以及如何在Wex5中使用该插件。 1.插件概述 屏幕方向插件，该插件控制程序的显示方式为横屏/竖屏，要注意的是该插件只是控制当前应用显示的方式，并不改变设备的重力感应相关设置。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!cordova-plugin-screen-orientation”);”然后即可在js中调用相关API。 代码如下： //竖屏模式 Model.prototype.portraitClick = function(event){ cordova.plugins.screenorientation.setOrientation('portrait'); }; //横屏模式 Model.prototype.landscapeClick = function(event){ cordova.plugins.screenorientation.setOrientation('landscape'); }; //屏幕方向解锁 Model.prototype.unlockClick = function(event){ cordova.plugins.screenorientation.setOrientation('unlock'); }; //获取当前屏幕方向 Model.prototype.currentClick = function(event){ setTimeout(function(){ alert("当前屏幕方向: " + JSON.stringify(window.screen.orientation)); }); [...]

本文讲解com.justep.cordova.plugin.scanCard插件以及如何在Wex5中使用该插件。 1.插件概述 名片识别插件，集成了脉可寻的SDK，免去自行录入名片或纠正识别结果的烦恼，开发者需要先申请key和secure才可以使用，本demo使用的是脉可寻提供的测试的一套参数。您只需要打开摄像头，拍取名片的照片，即可识别名片中的信息并将其上传至脉可寻的服务器，提供查询客户信息的接口，方便以后查询使用。脉可寻识别服务的流程为：认证->打开SDK相机页面->拍摄名片->确认上传成功->获取数据。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!com.justep.cordova.plugin.scanCard”);”然后即可在js中调用相关API。 以下是API的使用： //申请授权,根据脉可寻的规范，使用SDK的API之前，我们必须申请授权，除了需要在打包的时候配置key和secure之外，还需要传入用户标识（Android与iOS端的参数名称稍微差异），这些参数均由脉可寻官网申请。 Model.prototype.aouthClick = function(event){ navigator.scanCard.auth("12345",this.success,this.error); }; //检查是否授权，已经授权，则成功回调，如未授权，则失败回调 Model.prototype.checkClick = function(event){ navigator.scanCard.checkAuth(this.success,this.error); }; //清除授权信息 Model.prototype.clearClick = function(event){ navigator.scanCard.clearAuthentication(this.success,this.error); }; //拍照并上传，该API会调用手机摄像头拍取名片的照片，然后会自动上传到脉可寻服务器，上传成功后会返回该图片的UUID，用户可以根据此UUID获取名片中的信息，如果图片上传，则会有上传失败的提示，同样会返回该图片的UUID。 Model.prototype.takePictureClick = function(event){ navigator.scanCard.takePicture(function(result){ UUID = result.UUID; alert(UUID); }, [...]

本文讲解cordova-plugin-insomnia插件以及如何在Wex5中使用该插件。 1.插件概述 息屏插件，控制屏幕常亮或者自动息屏。设置常亮仅在应用前台运行时生效，一旦应用进入后台或者被关掉则不再生效。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!cordova-plugin-insomnia”);”然后即可在js中调用相关API。 由于该插件比较简单，不做过多赘述，下面是API的调用： //保持屏幕常亮 Model.prototype.keepAwakeClick = function(event){ plugins.insomnia.keepAwake(function(){ justep.Util.hint("设置常亮成功"); }, function(){ justep.Util.hint("设置失败"); }); }; //允许息屏 Model.prototype.allowSleepAgainClick = function(event){ plugins.insomnia.allowSleepAgain(function(){ justep.Util.hint("设置自动息屏成功"); }, function(){ justep.Util.hint("设置失败"); }); };

本文讲解com.justep.cordova.plugin.iFlytek插件以及如何在Wex5中使用该插件。 1.插件概述 语音听写/语音合成插件，该插件集成了科大讯飞的SDK，提供了语音听写与语音合成的功能。语音合成：将一段文字转换成语音,可根据需要合成出不同音色、语速和语 调的声音,让机器像人一样开口说话。语音听写：将一段语音转换成文本，并把语音中包含的文字信息提取出来，优先识别用户手机特有的联系人。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!com.justep.cordova.plugin.iFlytek”);”然后即可在js中调用相关API。 该插件提供了详细的接口，下面我们就以代码的形式讲述各个接口的能力。 //开始语音听写，需要访问手机麦克风，用户通过麦克风开始录入语音，当用户长时间不录入语音时，会默认判定语音录入结束，即会返回识别的文本。用户可以传入参数控制语音听写的相关设置，现在插件中已经配置好了相关参数，建议传参数为空。 Model.prototype.startListenningClick = function(event){ alert("请对准麦克风开始说话"); navigator.speech.startListening({}, function(res) { alert("listen:" + JSON.stringify(res)); }); }; //取消听写，将不会返回识别结果 Model.prototype.cancleListenningClick = function(event){ navigator.speech.cancelListening(); }; //停止听写，会将识别的结果返回 Model.prototype.stopListenningClick = function(event){ navigator.speech.stopListening(); }; //开始语音合成，其中第一个参数为必传参数，即需要识别的文本，第二个参数为可选参数，可以通过该参数调节发音人的音量，发音人的音调，语速，以及方言。 Model.prototype.startSpeakingClick [...]

本文讲解cordova-plugin-customurlscheme插件以及如何在Wex5中使用该插件。 1.插件概述 自定义URLScheme插件，开发者可在打包的时候以参数的形式配置应用的URLScheme，这样，我们就可在其它APP、email链接、网页等通过这个URL打开我们的应用。 2.插件使用 首先，我们需要在自己的js文件中引入该插件，即“require(“cordova!cordova-plugin-customurlscheme”);” 该插件以参数的形式实现自定义URL的值，因此，我们需要在打包的时候勾选该插件，并在插件的参数列表中填入自己的自定义的URL的值，现在该插件默认的参数的值为："wex5app"。 接下来我们就可以测试一下该插件是否生效，在此，提供一个非常简单的办法，就是打开手机系统的浏览器，然后在地址栏输入刚才插件打包时的参数即“wex5app://”，看是否可以打开该应用。 当然，我们也可以给该URL添加参数，然后自己在接收了URL后根据参数做不同的处理，在此展示如何在应用内接收URL的参数，至于参数的处理不再做过多的叙述。 var Model = function(){ this.eventName = new Date().getTime() + ""; $(window).on('handleOpenURL.'+this.eventName,this.handleOpenURL); }; Model.prototype.modelUnLoad = function(event){ $(window).off("handleOpenURL." + this.eventName); }; //在此接收URL参数 Model.prototype.handleOpenURL = function(event,url){ justep.Util.hint("接收到URL参数: "+url ); [...]