全部產品
Search
文件中心

SuperApp:螢幕

更新時間:Oct 29, 2024

本文介紹螢幕類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));
});