Todos os produtos
Search
Central de documentação

SuperApp:Screen

Última atualização: Jun 29, 2026

APIs JS da classe WVScreen para aplicativos H5 e mini programs. Use estas APIs para obter e defina a orientação da tela (paisagem ou retrato) e o brilho.

WVScreen.getOrientation

Retorna a orientação de exibição da activity ou do visualize controller atual.

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Em caso de sucesso, o sistema invoca o callback success com os parâmetros abaixo. Em caso de falha, o sistema invoca o callback failure.

  • [string] orientation: Orientação de exibição atual. Valores válidos:

    • 'landscape': Paisagem.

    • 'portrait': Retrato.

    • 'unknown': Desconhecido.

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

WVScreen.setOrientation

Defina a orientação de exibição da activity ou do visualize controller atual. Nota: Esta JSBridge afeta todas as páginas que o WebView atual carregar após a chamada, não apenas a página corrente. Restaure a orientação antes de navegar para outra página para evitar efeitos colaterais indesejados nas páginas subsequentes.

Parâmetros de entrada

  • [string] orientation: Orientação de exibição a definir. Valores válidos:

    • 'default': Orientação padrão do cliente.

    • 'landscape': Paisagem. No iOS, se o cliente oferecer suporte, a orientação alternará automaticamente entre paisagem esquerda e direita conforme a orientação do dispositivo.

    • 'portrait': Retrato.

    • 'landscapeRight': Paisagem à direita.

    • 'landscapeLeft': Paisagem à esquerda.

    • 'portraitUpsideDown': Retrato invertido.

    • 'auto': Alterna automaticamente conforme a orientação do dispositivo.

Parâmetros de callback

Em caso de sucesso, o sistema invoca o callback success sem parâmetros. Em caso de falha, o sistema invoca o callback failure.

var params = {
        orientation: 'landscape'
};
window.WindVane.call('WVScreen', 'setOrientation', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVScreen.setScreenBrightness

Nota

Esta API está disponível apenas no WindVane para Android 1.0.3.4 e versões posteriores.

Defina o brilho da tela.

Parâmetros de entrada

  • [number] brightness: Nível de brilho da tela. Deve ser um número inteiro de 0 (mais escuro) a 255 (mais claro).

Parâmetros de callback

Parâmetros do callback de sucesso:

  • Nenhum.

Parâmetros do callback de falha:

  • [string] msg: Mensagem de erro que descreve a falha.

var params = {
       brightness: '100'
};
window.WindVane.call('WVScreen', 'setScreenBrightness', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVScreen.getScreenBrightness

Nota

Esta API está disponível apenas no WindVane para Android 1.0.3.4 e versões posteriores.

Retorna o brilho atual da tela.

Parâmetros de entrada

  • Nenhum.

Parâmetros de callback

Em caso de sucesso, o sistema invoca o callback success com os parâmetros abaixo. Em caso de falha, o sistema invoca o callback failure.

  • [number] brightness: Nível atual de brilho da tela (número inteiro de 0 a 255).

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