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
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.
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 propertisrcdariimguntuk pratinjau tangkapan layar.CatatanURL 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));
});