SuperApp:Application information

Descreve as APIs JavaScript da WVApplication para aplicativos H5 e mini programs, incluindo APIs para consultar o estado do ciclo de vida do aplicativo, verificar o status de autorização de notificações e abrir as configurações do sistema.

WVApplication.appState

Retorna o estado atual do ciclo de vida do aplicativo. Use esta API para determinar se o aplicativo está ativo, em segundo plano ou em transição entre estados — por exemplo, para pausar ou retomar tarefas quando o aplicativo perde o foco.

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Em caso de sucesso, o callback success é executado. Em caso de falha, o callback failure é executado.

• state (string): Estado atual do ciclo de vida do aplicativo. Valores válidos:

  • 'active': O aplicativo está em execução no primeiro plano e recebendo eventos.

  • 'inactive': O aplicativo está no primeiro plano, mas não recebe eventos. Isso ocorre durante transições — por exemplo, quando o usuário abre a Central de Notificações, alterna entre aplicativos pelo App Switcher ou recebe uma chamada.

  • 'background': O aplicativo está em execução em segundo plano.

  • 'unknown': Não foi possível determinar o estado do aplicativo.

window.WindVane.call('WVApplication', 'appState', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVApplication.getNotificationSettings

Retorna o status de autorização de notificações do aplicativo atual. Use esta API para verificar se o usuário concedeu permissão para notificações — por exemplo, para ativar ou desativar recursos relacionados a notificações no aplicativo ou solicitar que os usuários atualizem suas configurações quando a permissão for negada.

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Em caso de sucesso, o callback success é executado. Em caso de falha, o callback failure é executado.

• status (string): Status de autorização de notificações. Valores válidos:

  • 'authorized': O usuário concedeu permissão ao aplicativo para exibir notificações.

  • 'denied': O usuário negou permissão ao aplicativo para exibir notificações.

  • 'notDetermined': O usuário ainda não respondeu à solicitação de permissão de notificação. Este valor pode ser retornado no iOS antes que o aplicativo solicite permissões de notificação.

  • 'unknown': Não foi possível determinar o status da notificação.

window.WindVane.call('WVApplication', 'getNotificationSettings', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVApplication.openSettings

Abre a página de configurações do sistema para o aplicativo atual. Use esta API para direcionar os usuários às configurações do aplicativo — por exemplo, após getNotificationSettings retornar 'denied', permitindo que os usuários ativem as notificações.

Parâmetros de entrada

• type (string, opcional): Página de configurações a ser aberta. Valor válido: 'Notification' — abre a página de configurações de notificação. No iOS, o sistema abre a página principal de configurações do aplicativo independentemente deste valor. Se omitido, a página principal de configurações do aplicativo será aberta.

Parâmetros de callback

Este método não retorna valores no callback. Em caso de sucesso, o callback success é executado. Em caso de falha, o callback failure é executado.

window.WindVane.call('WVApplication', 'openSettings', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});