全部产品
Search
文档中心

SuperApp:Tangkapan Layar

更新时间:Jun 28, 2025

Topik ini menjelaskan API JavaScript dari WVScreenCapture. Anda dapat merujuk ke topik ini saat membuat aplikasi HTML5 atau Miniapps. Gunakan API JavaScript dari WVScreenCapture untuk mengambil tangkapan layar.

WVScreenCapture.capture

Catatan
  • API ini hanya tersedia di Windvane Android 1.0.3.4 atau versi lebih baru.

  • Di Windvane Android 1.0.3.3 dan versi sebelumnya, gunakan WVScreen.capture. Parameter input dan callback dari WVScreen.capture sama dengan WVScreenCapture.capture.

Mengambil tangkapan layar dari jendela tampilan WebView saat ini.

Penting

Di iOS 11, tambahkan kunci "NSPhotoLibraryAddUsageDescription" ke Info.plist. Kunci ini digunakan untuk menjelaskan alasan aplikasi meminta akses ke album pengguna.

Parameter Input

  • [String] inAlbum: menentukan apakah akan menyimpan tangkapan layar sebagai file gambar di album. 'true' menyimpan tangkapan layar sebagai file gambar di album, sedangkan 'false' tidak menyimpan tangkapan layar. Nilai default: 'false'.

  • [String] type: jenis tangkapan layar. 'view' mengambil tangkapan layar dari jendela tampilan WebView saat ini. 'app' mengambil tangkapan layar dari jendela aplikasi. Nilai default: 'view'. Jika nilai parameter ditetapkan ke 'app', tangkapan layar mencakup bilah status. Pada beberapa model Android dengan keyboard lunak (misalnya Smartbar), bagian keyboard lunak akan dirender sebagai latar belakang hitam dalam tangkapan layar.

Parameter Callback

Parameter callback dilewatkan menggunakan metode callback. Jika tangkapan layar berhasil diambil, callback success dipanggil. Jika gagal, callback failure dipanggil.

  • [string] url: URL akses. URL halaman diisi di properti src dari img untuk pratinjau tangkapan layar.

    Catatan

    URL ini bukan URL Content Delivery Network (CDN) yang sebenarnya dan tidak dapat diakses dari browser.

  • [string] localPath: jalur lokal tangkapan layar. Jalur ini dapat digunakan saat memanggil WVCamera.confirmUploadPhoto untuk mengunggah foto ke CDN.

var params = {
        // Tentukan apakah akan menyimpan tangkapan layar sebagai file gambar di album.
        inAlbum: 'true'
};
window.WindVane.call('WVScreenCapture', 'capture', params, function(e) {
        alert('sukses: ' + JSON.stringify(e));
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
});