このドキュメントでは、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));
});