本文介绍屏幕类WVScreen相关的JS API,供您在通过跨平台DevOps创建H5端应用或者小程序时参考。屏幕类WVScreen的JS API提供设置、返回当前Activity/ViewController的显示方向(横屏/竖屏)、设置屏幕亮度、获取屏幕亮度的能力。
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:要设置的Activity显示方向,取值范围为:'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只在Windvane Android 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只在Windvane Android 1.0.3.4以上版本有效。
获取屏幕亮度。
输入参数
无输入参数。
回调参数
[
string
]brightness:屏幕亮度。
window.WindVane.call('WVScreen', 'getScreenBrightness', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});