Todos os produtos
Search
Central de documentação

SuperApp:Screenshot

Última atualização: Jun 29, 2026

Captura screenshots em um aplicativo HTML5 ou miniapp desenvolvido com Windvane por meio da API JS WVScreenCapture.

WVScreenCapture.capture

Nota
  • Esta API requer o Windvane para Android 1.0.3.4 ou posterior.

  • No Windvane para Android 1.0.3.3 e anteriores, use WVScreen.capture. Esse método aceita os mesmos parâmetros de entrada e callback que WVScreenCapture.capture.

Captura o conteúdo atual do WebView como imagem.

Importante

iOS 11 e posterior: O aplicativo precisa de permissão para acessar o álbum de fotos. Adicione a chave NSPhotoLibraryAddUsageDescription ao arquivo Info.plist e informe uma string de descrição de uso.

Parâmetros de entrada

  • [String] inAlbum: Indica se o screenshot será salvo no álbum de fotos. Defina como 'true' para salvar ou 'false' para ignorar. Padrão: 'false'.

  • [String] type: Escopo da captura. Use 'view' para capturar apenas o conteúdo do WebView ou 'app' para capturar toda a janela do aplicativo. Padrão: 'view'. Se definido como 'app', o screenshot incluirá o plano de fundo da barra de status, mas não o texto. Android: Em alguns dispositivos com teclado virtual, como SmartBar, a área do teclado pode aparecer como um retângulo preto.

Parâmetros de callback

Em caso de sucesso, o callback success retorna o resultado abaixo. Se houver falha, o callback failure retornará um objeto de erro.

  • [string] url: URL interna da imagem capturada. Atribua esse valor ao atributo src de um elemento img para visualizar o screenshot no aplicativo.

    Nota

    Essa URL não tem acesso público e não abre em navegadores.

  • [string] localPath: Caminho local do arquivo de screenshot. Utilize esse caminho em outras APIs, como WVCamera.confirmUploadPhoto, para enviar o arquivo a uma CDN.

var params = {
        // Save the screenshot to the photo album.
        inAlbum: 'true'
};
window.WindVane.call('WVScreenCapture', 'capture', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});