All Products
Search
Document Center

SuperApp:Deteksi lingkungan perangkat

Last Updated:Apr 23, 2026

Dokumen ini menjelaskan API JavaScript dari kelas WVNativeDetector, yang dapat Anda gunakan saat mengembangkan aplikasi H5 atau mini program. API ini mengambil informasi terkait perangkat, seperti model perangkat, penggunaan CPU, dan penggunaan memori.

WVNativeDetector.isSimulator

Memeriksa apakah lingkungan saat ini merupakan simulator.

Parameter input

Metode ini tidak menerima parameter input.

Parameter callback

Jika status simulator berhasil diambil, callback success dipanggil dengan hasilnya. Jika gagal, callback failure dipanggil.

  • [boolean] isSimulator: true jika lingkungan saat ini adalah simulator; selain itu, false.

window.WindVane.call('WVNativeDetector', 'isSimulator', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVNativeDetector.getCurrentUsage

Mengambil penggunaan CPU dan memori saat ini.

Catatan

Pemanggilan API ini menimbulkan beban kinerja. Gunakan hanya jika diperlukan.

Parameter input

Metode ini tidak menerima parameter input.

Parameter callback

Jika informasi penggunaan berhasil diambil, callback success dipanggil dengan hasilnya. Jika gagal, callback failure dipanggil.

  • [number] cpuUsage: Penggunaan CPU saat ini.

  • [number] memoryUsage: Penggunaan memori saat ini. Nilainya dihitung sebagai usedMemory / totalMemory.

  • [number] usedMemory: Total memori yang sedang digunakan pada perangkat, termasuk memori yang digunakan oleh aplikasi saat ini dan aplikasi lain yang terbuka. Satuan: MB.

  • [number] totalMemory: Total memori perangkat. Satuan: MB.

window.WindVane.call('WVNativeDetector', 'getCurrentUsage', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVNativeDetector.getDeviceYear

Mengambil tahun rilis perangkat, yang membantu memperkirakan kinerjanya. Pada iOS, metode ini secara akurat menentukan tahun rilis. Pada Android, metode ini memberikan perkiraan.

Secara umum, perangkat yang dirilis pada tahun 2012 atau setelahnya memenuhi sebagian besar persyaratan kinerja.

Parameter input

Metode ini tidak menerima parameter input.

Parameter callback

Jika tahun rilis perangkat berhasil diambil, callback success dipanggil dengan hasilnya. Jika gagal, callback failure dipanggil.

  • [number] deviceYear: Tahun rilis perangkat, seperti 2012.

window.WindVane.call('WVNativeDetector', 'getDeviceYear', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVNativeDetector.getModelInfo

Mengambil informasi perangkat, seperti modelnya.

Parameter input

Metode ini tidak menerima parameter input.

Parameter callback

Jika informasi perangkat berhasil diambil, callback success dipanggil dengan hasilnya. Jika gagal, callback failure dipanggil.

  • [string] brand: Merek perangkat, seperti "Apple" atau "Google".

  • [string] model: Model perangkat, seperti "iPhone", "iPod touch", atau "Nexus 5".

  • [string] platform: Identifier platform perangkat, seperti "iPhone5,2". Tersedia hanya pada VER.WindVane iOS.

  • [string] platformName: Versi yang mudah dibaca dari identifier platform, seperti "iPhone 5 (CDMA)". Tersedia hanya pada VER.WindVane iOS.

window.WindVane.call('WVNativeDetector', 'getModelInfo', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVNativeDetector.getSafeAreaInsets

Catatan

API ini tersedia hanya pada WindVane iOS.

Mengambil inset area aman untuk halaman saat ini. API ini hanya berlaku untuk halaman layar penuh dan digunakan untuk memastikan kompatibilitas dengan iOS 11 dan iPhone X.

Parameter input

Metode ini tidak menerima parameter input.

Parameter callback

Jika informasi area aman berhasil diambil, callback success dipanggil dengan hasilnya. Jika gagal, callback failure dipanggil.

  • [number] top: Inset atas area aman.

  • [number] left: Inset kiri area aman.

  • [number] bottom: Inset bawah area aman.

  • [number] right: Inset kanan area aman.

  • [boolean] cssAvaliable: Parameter ini bernilai true jika fungsi CSS constant(safe-area-inset-*) tersedia. Ini setara dengan memeriksa apakah sistem operasi adalah VER.iOS 11 atau lebih baru dan aplikasi client dibuat dengan Xcode.

window.WindVane.call('WVNativeDetector', 'getSafeAreaInsets', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});