すべてのプロダクト
Search
ドキュメントセンター

SuperApp:画面

最終更新日:Apr 21, 2026

このドキュメントでは、H5 アプリケーションとミニプログラムを作成するための WVScreen クラスの JS API について説明します。これらの API を使用すると、画面の向き (横向きまたは縦向き) と輝度を取得および設定できます。

WVScreen.getOrientation

現在の Activity/ViewController の向き (横向きまたは縦向き) を返します。

入力パラメーター

なし。

コールバックパラメーター

操作が成功した場合、返されたパラメーターと共に success コールバックが呼び出されます。それ以外の場合は、failure コールバックが呼び出されます。

  • [string] orientation:現在の Activity/ViewController の向き。有効な値は次のとおりです。

    • 'landscape':横向き。

    • 'portrait':縦向き。

    • 'unknown':向きが不明です。

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

WVScreen.setOrientation

現在の ViewController/Activity の向きを設定します。この JSBridge は、現在の WebView が遷移する他のページにも影響することにご注意ください。ページから離れる際には、必ず向きを復元してください。

入力パラメーター

  • [string] orientation:設定する向き。有効な値は次のとおりです。

    • 'default':クライアントのデフォルトの向き。

    • 'landscape':横向き。iOS では、クライアントが対応している場合、デバイスの向きに応じて左右の横向きが自動的に切り替わります。

    • 'portrait':縦向き。

    • 'landscapeRight':右横向き。

    • 'landscapeLeft':左横向き。

    • 'portraitUpsideDown':上下逆の縦向き。

    • 'auto':デバイスの向きに応じて自動的に切り替わります。

コールバックパラメーター

操作が成功した場合、パラメーターなしで success コールバックが呼び出されます。それ以外の場合は、failure コールバックが呼び出されます。

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

説明

この API は、Android 版 WindVane 1.0.3.4 以降でのみ利用可能です。

画面の輝度を設定します。

入力パラメーター

  • [number] brightness:設定したい画面の輝度。値は 0 から 255 までの整数である必要があります。

コールバックパラメーター

成功時のコールバックパラメーター:

  • なし。

失敗時のコールバックパラメーター:

  • [string] msg:エラーメッセージ。

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

WVScreen.getScreenBrightness

説明

この API は、Android 版 WindVane 1.0.3.4 以降でのみ利用可能です。

画面の輝度を取得します。

入力パラメーター

  • なし。

コールバックパラメーター

  • [number] brightness:現在の画面の輝度。

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