全部產品
Search
文件中心

SuperApp:應用資訊

更新時間:Oct 29, 2024

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