Todos os produtos
Search
Central de documentação

SuperApp:Detecção de ambiente do dispositivo

Última atualização: Jun 29, 2026

APIs JavaScript da classe WVNativeDetector para aplicações H5 e mini programas. Utilize estas APIs para obter informações do dispositivo, como modelo, uso de CPU e uso de memória.

WVNativeDetector.isSimulator

Verifica se o ambiente atual é um simulador.

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

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Retorna o resultado no callback success em caso de sucesso ou no callback failure em caso de erro.

  • [boolean] isSimulator: true se o ambiente atual for um simulador; false caso contrário.

WVNativeDetector.getCurrentUsage

Obtém o uso atual de CPU e memória.

Nota

A chamada desta API gera sobrecarga de desempenho. Execute-a apenas quando necessário.

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

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Retorna os resultados no callback success em caso de sucesso ou no callback failure em caso de erro.

  • [number] cpuUsage: Uso atual da CPU.

  • [number] memoryUsage: Uso atual da memória, calculado como usedMemory / totalMemory.

  • [number] usedMemory: Memória total em uso no dispositivo, incluindo a memória utilizada pelo aplicativo atual e por outros aplicativos abertos. Unidade: MB.

  • [number] totalMemory: Memória física total do dispositivo. Unidade: MB.

WVNativeDetector.getDeviceYear

Obtém o ano de lançamento do dispositivo para ajudar a estimar sua categoria de desempenho. No iOS, o resultado é exato. No Android, trata-se de uma estimativa.

Dispositivos lançados em 2012 ou posteriormente atendem à maioria dos requisitos de desempenho.

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

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Retorna o resultado no callback success em caso de sucesso ou no callback failure em caso de erro.

  • [number] deviceYear: Ano de lançamento do dispositivo. Exemplo: 2012.

WVNativeDetector.getModelInfo

Obtém a marca e o modelo do dispositivo. Os campos platform e platformName estão disponíveis apenas no WindVane iOS.

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

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Retorna os resultados no callback success em caso de sucesso ou no callback failure em caso de erro.

  • [string] brand: Marca do dispositivo. Exemplos: "Apple", "Google".

  • [string] model: Modelo do dispositivo. Exemplos: "iPhone", "iPod touch", "Nexus 5".

  • [string] platform: Identificador da plataforma de hardware. Exemplo: "iPhone5,2". Disponível apenas no WindVane iOS.

  • [string] platformName: Nome legível da plataforma derivado do identificador platform. Exemplo: "iPhone 5 (CDMA)". Disponível apenas no WindVane iOS.

WVNativeDetector.getSafeAreaInsets

Nota

Esta API está disponível apenas no WindVane iOS.

Obtém as margens da área segura para a página atual em tela cheia. Utilize esta API para posicionar o conteúdo corretamente no iPhone X e em dispositivos posteriores que executam iOS 11 ou superior.

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

Parâmetros de entrada

Nenhum.

Parâmetros de callback

Retorna os resultados no callback success em caso de sucesso ou no callback failure em caso de erro.

  • [number] top: Margem superior da área segura.

  • [number] left: Margem esquerda da área segura.

  • [number] bottom: Margem inferior da área segura.

  • [number] right: Margem direita da área segura.

  • [boolean] cssAvaliable: true se a função CSS constant(safe-area-inset-*) for suportada. Isso indica iOS 11 ou superior e um aplicativo cliente compilado com Xcode.