全部产品
云市场

截屏 WVScreen

更新时间:2019-01-14 16:37:39

WVScreen.capture

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

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

输入参数

  • [String] inAlbum - 是否将截屏结果保存一份到相册中,'true' 表示保存结果到相册,'false' 表示不保存。默认为 'false'
  • [String] type - 截屏的类型,设置为 'view' 可以只截取 WebView 部分,或者 'app' 来截取应用部分,默认为 'view'。设置为 app 后,会包含状态栏背景(无状态栏文本),一些有软键盘(类似 SmartBar)的 Android 机型上,软键盘部分会留下黑色背景WindVane 8.3.0

回调参数

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

  • [string] url - 访问 URL,页面将此 URL 填写给 imgsrc 属性,用于进行截屏结果的预览。 注意:该 URL 非真实的 CDN URL,浏览器无法访问。
  • [string] localPath - 截屏结果的本地文件路径,该路径可以后续使用 WVCamera.confirmUploadPhoto 上传到 CDN。
  1. var params = {
  2. // 是否将截屏结果保存一份到相册中
  3. inAlbum: 'true'
  4. };
  5. window.WindVane.call('WVScreen', 'capture', params, function(e) {
  6. alert('success: ' + JSON.stringify(e));
  7. }, function(e) {
  8. alert('failure: ' + JSON.stringify(e));
  9. });

WVScreen.getOrientation

返回当前 Activity/ViewController 的显示方向(横屏/竖屏)。

输入参数

无输入参数。

回调参数

回调参数将会在回调方法中传递,如果获取显示方向,则进入 success 回调,否则进入 failure 回调。

  • [string] orientation - 当前 Activity/ViewController 的显示方向,可能的值为:
    • 'landscape' - 横屏。
    • 'portrait' - 竖屏。
    • 'unknown' - 方向未知。
  1. window.WindVane.call('WVScreen', 'getOrientation', {}, function(e) {
  2. alert('success: ' + JSON.stringify(e));
  3. }, function(e) {
  4. alert('failure: ' + JSON.stringify(e));
  5. });

WVScreen.setOrientation

设置当前 ViewController/Activity 的显示方向(横屏/竖屏)。注意此 JSBridge 会影响到当前 WebView 跳转到的其它页面,所以请在页面跳转时主动恢复显示方向。

输入参数

  • [string] orientation - 要设置的 Activity 显示方向,可能的值为:
    • 'default' - 客户端默认显示方向
    • 'landscape' - 横屏,iOS 平台下如果客户端支持,会根据设备方向自动切换左/右横屏
    • 'portrait' - 竖屏
    • 'landscapeRight' - 右横屏 WindVane iOS 8.2.0
    • 'landscapeLeft' - 左横屏 WindVane iOS 8.2.0
    • 'portraitUpsideDown' - 颠倒竖屏 WindVane iOS 8.2.0
    • 'auto' - 根据设备方向自动切换 WindVane iOS 8.2.0

回调参数

无回调参数,如果设置显示方向,则进入 success 回调,否则进入 failure 回调。

  1. var params = {
  2. orientation: 'landscape'
  3. };
  4. window.WindVane.call('WVScreen', 'setOrientation', params, function(e) {
  5. alert('success: ' + JSON.stringify(e));
  6. }, function(e) {
  7. alert('failure: ' + JSON.stringify(e));
  8. });