全部產品
Search
文件中心

SuperApp:截屏

更新時間:Oct 29, 2024

本文介紹截屏類WVScreenCapture相關的JS API,供您建立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));
});