All Products
Search
Document Center

SuperApp:Tangkapan Layar

Last Updated:Apr 23, 2026

Topik ini menjelaskan API JS WVScreenCapture untuk menambahkan kemampuan tangkapan layar ke aplikasi HTML5 atau program mini Anda.

WVScreenCapture.capture

Catatan
  • API ini hanya tersedia di Windvane untuk Android versi 1.0.3.4 dan yang lebih baru.

  • Untuk Windvane untuk Android versi 1.0.3.3 dan yang lebih lama, gunakan WVScreen.capture. API ini menggunakan parameter input dan callback yang sama dengan WVScreenCapture.capture.

Menangkap konten WebView saat ini sebagai gambar.

Penting

Pada iOS 11 dan yang lebih baru, aplikasi Anda memerlukan izin untuk mengakses album foto. Untuk mengaktifkannya, tambahkan kunci NSPhotoLibraryAddUsageDescription ke file Info.plist Anda dan berikan deskripsi penggunaan yang sesuai.

Parameter input

  • [String] inAlbum: Menentukan apakah tangkapan layar disimpan ke album foto. Atur ke 'true' untuk menyimpan atau 'false' untuk tidak menyimpan. Nilai default-nya adalah 'false'.

  • [String] type: Jenis tangkapan layar. Atur ke 'view' untuk hanya menangkap konten WebView atau 'app' untuk menangkap seluruh jendela aplikasi. Nilai default-nya adalah 'view'. Saat diatur ke 'app', tangkapan layar mencakup latar belakang status bar tetapi tidak mencakup teksnya. Pada beberapa perangkat Android yang memiliki keyboard lunak, seperti SmartBar, area keyboard akan ditangkap sebagai persegi panjang hitam.

Parameter callback

Jika proses tangkapan berhasil, callback success dipanggil dengan hasilnya. Jika gagal, callback failure dipanggil.

  • [string] url: URL gambar yang ditangkap. Tetapkan URL ini ke atribut src elemen img untuk melihat pratinjaunya.

    Catatan

    Ini bukan URL CDN publik dan tidak dapat diakses melalui browser.

  • [string] localPath: Jalur lokal file tangkapan layar. Gunakan jalur ini dengan API lain, seperti WVCamera.confirmUploadPhoto, untuk mengunggah file ke CDN.

var params = {
        // Simpan tangkapan layar ke album foto.
        inAlbum: 'true'
};
window.WindVane.call('WVScreenCapture', 'capture', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});