本文介紹螢幕類WVScreen相關的JS API,供您建立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));
});