Captura screenshots em um aplicativo HTML5 ou miniapp desenvolvido com Windvane por meio da API JS WVScreenCapture.
WVScreenCapture.capture
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 queWVScreenCapture.capture.
Captura o conteúdo atual do WebView como imagem.
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 atributosrcde um elementoimgpara visualizar o screenshot no aplicativo.NotaEssa 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, comoWVCamera.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));
});