Pendeteksian Lingkungan Perangkat - SuperApp

Topik ini menjelaskan API JavaScript dari WVNativeDetector. Anda dapat merujuk pada topik ini saat membuat aplikasi HTML5 atau MiniApps. Gunakan API JavaScript dari WVNativeDetector untuk mendapatkan informasi perangkat seperti model, penggunaan CPU, dan memori.

WVNativeDetector.isSimulator

Memeriksa apakah perangkat disimulasikan.

Parameter Masukan

Tidak ada parameter masukan.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika informasi yang diminta berhasil diperoleh, success callback dipanggil. Sebaliknya, failure callback dipanggil.

[boolean] isSimulator: true menunjukkan bahwa perangkat disimulasikan; jika tidak, nilainya adalah false.

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

WVNativeDetector.getCurrentUsage

Mendapatkan penggunaan CPU dan memori saat ini.

Catatan

Operasi API ini dapat menyebabkan penurunan performa. Panggil API ini hanya jika diperlukan.

Parameter Masukan

Tidak ada parameter masukan.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika penggunaan CPU dan memori berhasil diperoleh, success callback dipanggil. Sebaliknya, failure callback dipanggil.

[number] cpuUsage: Penggunaan CPU saat ini.
[number] memoryUsage: Penggunaan memori saat ini, dihitung dengan rumus berikut: usedMemory/totalMemory.
[number] usedMemory: Total memori yang dikonsumsi oleh perangkat, termasuk konsumsi memori aplikasi saat ini dan aplikasi lain yang sedang berjalan. Satuan: MB.
[number] totalMemory: Ukuran total memori perangkat saat ini. Satuan: MB.

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

WVNativeDetector.getDeviceYear

Mendapatkan tahun rilis perangkat. Informasi ini membantu mengevaluasi performa perangkat berdasarkan tahun rilisnya. Model perangkat iOS dapat diidentifikasi dengan mudah, dan performanya dapat ditentukan berdasarkan tahun rilis.

Untuk perangkat Android, perangkat yang dirilis pada 2012 atau setelahnya dianggap memiliki performa memadai.

Parameter Masukan

Tidak ada parameter masukan.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika tahun rilis berhasil diperoleh, success callback dipanggil. Sebaliknya, failure callback dipanggil.

[number] deviceYear: Tahun rilis perangkat, misalnya 2012.

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

WVNativeDetector.getModelInfo

Mendapatkan informasi perangkat, seperti model perangkat.

Parameter Masukan

Tidak ada parameter masukan.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika informasi perangkat berhasil diperoleh, success callback dipanggil. Sebaliknya, failure callback dipanggil.

[string] brand: Merek perangkat, misalnya "Apple" dan "Google".
[string] model: Model perangkat, misalnya "iPhone", "iPod touch", dan "Nexus 5".
[string] platform: Platform perangkat, misalnya "iPhone5,2". Parameter ini hanya tersedia saat menggunakan WindVane iOS.
[string] platformName: Nama platform perangkat, misalnya "iPhone 5 (CDMA)". Parameter ini lebih mudah dipahami dibandingkan dengan platform. Parameter ini hanya tersedia saat menggunakan 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 hanya tersedia di WindVane iOS.

Mendapatkan informasi area aman dari tampilan saat ini. API ini hanya tersedia untuk halaman layar penuh di iOS 11 dan iPhone X atau yang lebih baru.

Parameter Masukan

Tidak ada parameter masukan.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika informasi area aman berhasil diperoleh, success callback dipanggil. Sebaliknya, failure callback dipanggil.

[Number] top: Nilai inset tepi atas area aman.
[Number] left: Nilai inset tepi kiri area aman.
[Number] bottom: Nilai inset tepi bawah area aman.
[Number] right: Nilai inset tepi kanan area aman.
[Boolean] cssAvaliable: Menentukan apakah Cascading Style Sheets (CSS) tersedia, yaitu apakah sistem operasi adalah iOS 11 atau yang lebih baru dan apakah Xcode digunakan untuk mengembangkan aplikasi atau MiniApp. Anda juga dapat menggunakan constant(safe-area-inset-*) untuk memeriksa ketersediaan CSS.

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