文档

截屏

更新时间:

本文介绍截屏类WVScreenCapture相关的JS API,供您在通过跨平台DevOps创建H5端应用或者小程序时参考。截屏类WVScreen的JS API提供截屏相关的能力。

WVScreenCapture.capture

说明
  • 该API只在Windvane Android 1.0.3.4以上版本有效。

  • Android 1.0.3.3及之前的版本请使用WVScreen.capture,输入参数和回调参数都和WVScreenCapture.capture一致。

截取当前WebView显示的部分为图片。

重要

在iOS 11中,要求客户端添加一个新的权限描述NSPhotoLibraryAddUsageDescription,才允许访问相册。

输入参数

  • [String]inAlbum:是否将截屏结果保存一份到相册中,'true'表示保存结果到相册,'false'表示不保存。默认为 'false'

  • [String]type:截屏的类型,设置为'view可以只截取WebView部分,或者'app'来截取应用部分,默认为 'view'。设置为'app'后,会包含状态栏背景(无状态栏文本),一些有软键盘(类似SmartBar)的Android机型上,软键盘部分会留下黑色背景。

回调参数

回调参数将会在回调方法中传递,如果成功截屏,则进入success回调,否则进入failure回调。

  • [string]url:访问URL,页面将此URL填写给imgsrc属性,用于进行截屏结果的预览。

    说明

    该URL非真实的CDN URL,浏览器无法访问。

  • [string]localPath:截屏结果的本地文件路径,该路径可以后续使用。WVCamera.confirmUploadPhoto上传到CDN。

var params = {
        // 是否将截屏结果保存一份到相册中
        inAlbum: 'true'
};
window.WindVane.call('WVScreenCapture', 'capture', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});