文档

屏幕

更新时间:

本文介绍屏幕类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));
});

  • 本页导读 (0)
文档反馈