5+App 等待 plusready 模板
// 等待 plusready 后再执行代码
document.addEventListener('plusready', function() {
// 这里写所有需要 plus API 的代码
// 双击退出、提示框、存储等都可以放在这里
});一、核心高频 API(最常用)
| 分类 | API 对象 | 功能说明 | 使用示例 |
|---|---|---|---|
| 窗口管理 | plus.webview | 管理应用窗口,创建、关闭、通信 | plus.webview.currentWebview() |
| 按键事件 | plus.key | 监听物理按键(返回键、音量键等) | plus.key.addEventListener('backbutton', fn) |
| 表格 | 表格 | 表格 | 表格 |
| 表格 | 表格 | 表格 | 表格 |
| 表格 | 表格 | 表格 | 表格 |
| 表格 | 表格 | 表格 | 表格 |
本地存储 plus.storage 轻量级键值对数据存储 plus.storage.setItem('key', 'value')
原生UI plus.nativeUI 原生提示框、对话框、等待框 plus.nativeUI.toast('提示')
运行时 plus.runtime 应用退出、打开外部页面等 plus.runtime.quit()
二、设备信息与系统 API
API 对象 功能说明 使用示例
plus.device 获取设备信息(IMEI、IMSI、UUID等) plus.device.uuid
plus.screen 屏幕信息(分辨率、DPI、亮度) plus.screen.resolutionWidth
plus.networkinfo 网络状态监测(WiFi/蜂窝网络) plus.networkinfo.getCurrentType()
plus.os 操作系统信息(版本、名称) plus.os.name
plus.navigator 浏览器环境信息、状态栏设置 plus.navigator.setStatusBarBackground('#000')
三、文件与数据 API
| 分类 | API 对象 | 功能说明 | 使用示例 |
|---|---|---|---|
| 窗口管理 | plus.webview | 管理应用窗口,创建、关闭、通信 | plus.webview.currentWebview() |
| 表格 | 表格 | 表格 | 表格 |
| 表格 | 表格 | 表格 | 表格 |
API 对象 功能说明 使用示例
plus.io 文件系统读写(目录、文件操作) plus.io.requestFileSystem()
plus.sqlite SQLite 数据库操作 plus.sqlite.openDatabase()
plus.zip 文件压缩和解压 plus.zip.compress()
plus.uploader 文件上传(支持断点续传) plus.uploader.createUpload()
plus.downloader 文件下载 plus.downloader.createDownload()
四、多媒体与传感器 API
API 对象 功能说明 使用示例
plus.camera 摄像头拍照、录像 plus.camera.getCamera()
plus.gallery 相册选择、保存图片/视频 plus.gallery.pick()
plus.audio 音频录制与播放 plus.audio.createRecorder()
plus.video 视频播放控件 plus.video.createLivePlayer()
plus.accelerometer 加速度传感器(重力感应) plus.accelerometer.watchAcceleration()
plus.geolocation GPS 定位(经纬度) plus.geolocation.getCurrentPosition()
plus.orientation 方向传感器(陀螺仪) plus.orientation.watchOrientation()
plus.proximity 距离传感器(手机贴耳检测) plus.proximity.watchProximity()
五、通信与社交 API
API 对象 功能说明 使用示例
plus.net XMLHttpRequest 网络请求 new plus.net.XMLHttpRequest()
plus.share 社交分享(微信、QQ、微博等) plus.share.getServices()
plus.oauth 第三方登录授权 plus.oauth.getServices()
plus.payment 支付功能(微信、支付宝) plus.payment.getChannels()
plus.messaging 发送短信、彩信、邮件 plus.messaging.createMessage()
plus.push 消息推送(在线/离线) plus.push.addEventListener('receive', fn)
六、高级功能 API
API 对象 功能说明 使用示例
plus.barcode 二维码/条码扫描 plus.barcode.create()
plus.speech 语音识别(语音输入) plus.speech.startRecognize()
plus.fingerprint 指纹识别验证 plus.fingerprint.authenticate()
plus.ibeacon iBeacon 设备管理 plus.ibeacon.startBeaconDiscovery()
plus.bluetooth 蓝牙设备连接 plus.bluetooth.openBluetoothAdapter()
plus.maps 地图控件(显示地图) plus.maps.open()
plus.contacts 系统通讯录操作 plus.contacts.getAll()
plus.statistic 应用统计(友盟+) plus.statistic.eventTrig()
七、原生能力扩展 API
API 对象 功能说明 使用示例
plus.nativeObj 原生对象操作(截图、绘图) plus.nativeObj.Bitmap()
plus.nativeUI 原生界面控件 plus.nativeUI.showWaiting()
plus.android 调用 Android 原生 Java API plus.android.importClass('android.content.Intent')
plus.ios 调用 iOS 原生 Objective-C API plus.ios.importClass('UIView')
八、事件与生命周期 API
API 对象 功能说明 使用示例
plus.globalEvent 全局事件监听 plus.globalEvent.addEventListener('newintent', fn)
plus.events 应用事件(前后台切换、网络变化) document.addEventListener('pause', fn)