全部产品
Search
文档中心

SuperApp:Layar

更新时间:Jun 28, 2025

Topik ini menjelaskan API JavaScript dari WVScreen. Anda dapat merujuk pada topik ini saat membuat aplikasi HTML5 atau Miniapps. API JavaScript dari WVScreen menyediakan kemampuan untuk mengatur dan mendapatkan orientasi tampilan (landscape atau portrait) dari aktivitas atau pengontrol tampilan saat ini, serta mengatur dan mendapatkan kecerahan layar.

WVScreen.getOrientation

Mengambil orientasi tampilan (landscape atau portrait) dari aktivitas atau pengontrol tampilan saat ini.

Parameter Input

Tidak ada parameter input yang diperlukan.

Parameter Callback

Parameter callback dilewatkan ke metode callback. Jika orientasi tampilan berhasil diambil, success callback dipanggil. Sebaliknya, failure callback dipanggil.

  • [string]orientation: orientasi tampilan dari aktivitas atau pengontrol tampilan saat ini. Nilai yang valid:

    • 'landscape'

    • 'portrait'

    • 'unknown'

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

WVScreen.setOrientation

Mengatur orientasi tampilan (landscape atau portrait) dari aktivitas atau pengontrol tampilan saat ini. Perhatikan bahwa WVScreen juga mempengaruhi orientasi tampilan halaman-halaman yang diarahkan oleh WebView. Oleh karena itu, orientasi tampilan harus dipulihkan setiap kali WebView mengarahkan ke halaman baru.

Parameter Input

  • [string]orientation: orientasi tampilan aktivitas. Nilai yang valid:

    • 'default': orientasi tampilan default klien.

    • 'landscape': orientasi tampilan landscape. Orientasi tampilan secara otomatis beralih ke mode landscape kiri atau kanan berdasarkan cara perangkat dipegang. Pergantian otomatis ini mungkin tidak didukung di beberapa klien.

    • 'portrait': orientasi tampilan portrait.

    • 'landscapeRight': orientasi landscape kanan, di mana tampilan diputar 90 derajat berlawanan arah jarum jam.

    • 'landscapeLeft': orientasi landscape kiri, di mana tampilan diputar 90 derajat searah jarum jam.

    • 'portraitUpsideDown': orientasi portrait terbalik.

    • 'auto': menentukan untuk secara otomatis beralih orientasi tampilan.

Parameter Callback

Tidak ada parameter callback yang tersedia. Jika orientasi tampilan berhasil diatur, success callback dipanggil. Sebaliknya, failure callback dipanggil.

var params = {
        orientation: 'landscape'
};
window.WindVane.call('WVScreen', 'setOrientation', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVScreen.setScreenBrightness

Catatan

API ini hanya tersedia di WindVane Android 1.0.3.4 atau lebih baru, WindVane iOS 2.1.4 atau lebih baru.

Mengatur kecerahan layar.

Parameter Input

  • [number]brightness: kecerahan layar. Nilai yang valid: 0 hingga 255.

Parameter Callback

Parameter untuk callback sukses:

  • Tidak ada parameter callback yang tersedia.

Parameter untuk callback gagal:

  • [string]msg: pesan kesalahan.

var params = {
       brightness: '100'
};
window.WindVane.call('WVScreen', 'setScreenBrightness', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVScreen.getScreenBrightness

Catatan

API ini hanya tersedia di WindVane Android 1.0.3.4 atau lebih baru, WindVane iOS 2.1.4 atau lebih baru.

Mengambil kecerahan layar.

Parameter Input

  • Tidak ada parameter input yang diperlukan.

Parameter Callback

  • [string]brightness: kecerahan layar.

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