1.扩展API加载完成事件
const plusReady = (fn) => {
if (window.plus) {
setTimeout(fn, 0)
} else {
document.addEventListener("plusready", fn, false)
}
}
如果plus全局变量已经加载处理，则在下个队列执行plus下的方法
如果没有，监听plusready事件，plus加载完在执行plus方法
2.Webview模块管理应用窗口界面__窗口创建
ws=plus.webview.currentWebview();
// 获取当前窗口
wn=plus.webview.create('http://', {left:'100%',render:'always'});
// 预创建新窗口（显示在可视区域外）
3.Webview模块管理应用窗口界面__窗口样式
let webview = plus.webview.currentWebview();
webview .setStyle({left:'0px'});
4.Device模块管理设备信息__横屏竖屏显示
//仅支持横屏显示
plus.screen.lockOrientation("landscape-primary");
//仅支持横屏反方向显示
plus.screen.lockOrientation('landscape-secondary');
//仅支持竖屏显示
plus.screen.lockOrientation("portrait-primary");
//仅支持竖屏反方向显示
plus.screen.lockOrientation("portrait-secondary");
5.navigator浏览器运行环境信息__系统状态栏前景色
plus.navigator.setStatusBarStyle('dark');
//可取值： "dark"：深色前景色样式（即状态栏前景文字为黑色），
//此时background建议设置为浅颜色； "light"：
//浅色前景色样式（即状态栏前景文字为白色），
/此时background建设设置为深颜色；
6.Device模块管理设备信息__OS系统信息
//获取系统名称
var name = plus.os.name;
//获取系统版本
var version = plus.os.version;
//获取系统供应商
var vendor = plus.os.vendor
//获取系统语言
var language = plus.os.language;
7.navigator浏览器运行环境信息__系统状态栏高度
plus.navigator.getStatusbarHeight();
//不通设备状态栏高度不同，需要做好顶部距离的兼容处理
8.Key管理设备按键事件
plus.key.addEventListener('backbutton', function () {
})
//监听返回按钮
//Android - 2.2+ (支持) :
//默认处理逻辑为退出应用。
//iOS - ALL (支持) :
///标题栏的“返回”按钮点击时触发此事件。 默认不处理此事件。
let webview = plus.webview.currentWebview();
plus.key.addEventListener('backbutton', function () {
webview.canBack(function(e){
//可以则返回
webview.back();
//不可以则做其它操作,比如首次返回提示“再按一次退出应用”
fn()
})
})
// webview.canBack查询Webview窗口是否可后退,一般两个方法联合使用
9.Runtime模块管理运行环境
plus.runtime.quit();
//退出应用
* agreePrivacy用户同意隐私政策
* disagreePrivacy 用户不同意隐私政策
* isAgreePrivacy 查询用户是否同意隐私政策
* quit 退出应用
* restart 重启当前的应用
10.Push模块管理推送消息功能
监听点击消息事件
plus.push.addEventListener("click", function (msg) {
console.log(msg.content)
console.log(msg.payload)
//content: (String 类型 )推送消息显示的内容
//payload: (JSON 类型 )推送消息承载的数据
//如果推送消息中传输的数据不符合JSON格式，则作为String类型数据保存。
})
11.Runtime模块管理运行环境__应用启动来源
plus.runtime.launcher === 'scheme'
//通过urlscheme方式触发启动
补充说明
Android中的Scheme是一种页面跳转协议，和网站通过URL的形式访问一样，APP同样可以通过这种方式进行跳转，它可以很方便的满足我们在一些场景中的需求：
当应用接收到Push，点击通知栏消息跳转到特定页面，比如商品详情等。
通过服务器下发的跳转路径，客户端可以根据路径跳转相应页面。
应用跳转到其他APP指定页面。
H5页面点击锚点，APP端跳转具体页面。
内容引用链接：https://www.jianshu.com/p/8d4445c25338
12.Runtime模块管理运行环境__获取指定APPID对应的应用信息
// 获取应用信息
function getAppInfo() {
plus.runtime.getProperty( plus.runtime.appid, function ( wgtinfo ) {
//appid属性
var wgtStr = "appid:"+wgtinfo.appid;
//version属性
wgtStr += "<br/>version:"+wgtinfo.version;
} );
}
13.Downloader管理下载任务
// 创建下载任务
function createDownload() {
var dtask = plus.downloader.createDownload("http://", {
method:"GET"，
data:{},
filename： "_downloads/"
//保存文件路径仅支持以"_downloads/"、"_doc/"、"_documents/"开头的字符串
}, function(d, status){
// 下载完成
if(status == 200){
console.log("Download success: " + d.filename);
} else {
console.log("Download failed: " + status);
}
});
dtask.start();
}
14.APP包在线更新__热更新
// 获取当前包的版本号
function getAppInfo() {
plus.runtime.getProperty( plus.runtime.appid, function ( wgtinfo ) {
console.log(wgtinfo.version)
} );
}
//然后向后端请求，获取最新版本包，如果不是，进行热更新
//path是wgt后提交到手机可访问的网络地址,升级包的资源地址
this.$plusReady(() => {
plus.downloader.createDownload(path, {filename: "_doc/update/"},
function (d, status) {
if (status == 200) {
console.log("下载wgt成功：" + d.filename);
plus.runtime.install(d.filename,{},
function(){
console.log("应用资源更新完成！")
plus.runtime.restart()
})
}, 1000)
} else {
console.log("下载wgt失败！");
}
}).start();
})
补充说明
5+应用可使用以下方式进行升级
5+应用资源独立升级，相对整包升级有以下优势：
- 无需重新提交应用市场审核更新，降低更新周期；
- 无需用户手动点击操作安装更新，优化用户体验；
- App资源相对整包体积更小，升级速度更快。
