本文介绍应用信息类WVApplication相关的JS API,供您创建H5端应用或者小程序时参考。应用信息类WVApplication的JS API提供返回应用状态和打开应用设置页面的能力。
WVApplication.appState
该API仅适用于WindVane iOS。
返回当前应用的状态(是否在前台)。
输入参数
无输入参数。
回调参数
回调参数将会在回调方法中传递,如果成功获取应用状态,则进入success
回调,否则进入failure
回调。
[
string
]state:当前应用的状态,取值范围为:'active'
:应用处于活动状态。'inactive'
:应用处于前台非活动状态,例如正在下拉通知栏、双击Home键的任务管理界面或锁屏等。'background'
:应用处于后台状态。'unknown'
:应用状态未知。
window.WindVane.call('WVApplication', 'appState', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVApplication.getNotificationSettings
该API仅适用于WindVane iOS。
返回当前应用的通知状态。
输入参数
无输入参数。
回调参数
回调参数将会在回调方法中传递,如果成功获取应用的通知状态,则进入success
回调,否则进入failure
回调。
[
string
]status:当前应用的通知状态,取值范围为:'authorized'
:用户已允许应用弹出通知。'denied'
:用户禁止应用弹出通知。'notDetermined'
:用户尚未决定是否允许应用弹出通知,在iOS系统应用尚未请求通知权限前可能返回该值。'unknown'
:应用通知状态未知。
window.WindVane.call('WVApplication', 'getNotificationSettings', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVApplication.openSettings
该API仅适用于WindVane iOS。
打开当前应用的设置页面。
输入参数
[
string
]type:(可选)要打开特定类型的设置页面,未传入则直接打开应用设置页。取值为
'Notification'
:打开当前应用的通知设置页面。iOS系统中仍会显示应用设置页。
回调参数
无回调参数,如果成功打开设置页面,则进入success
回调,否则进入failure
回调。
window.WindVane.call('WVApplication', 'openSettings', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});