应用信息

本文介绍应用信息类WVApplication相关的JS API,供您在通过跨平台DevOps创建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));
});