本文介紹應用資訊類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));
});