screen


简介:

screen模块管理设备屏幕信息

属性:

  • resolutionHeight : 设备屏幕高度分辨率
  • resolutionWidth : 设备屏幕宽度分辨率
  • scale : 逻辑分辨率与实际分辨率的比例
  • dpiX : 设备屏幕水平方向的密度
  • dpiY : 设备屏幕垂直方向的密度

方法:

resolutionHeight


设备屏幕高度分辨率

var resolutionHeight = rd.screen.resolutionHeight;
说明:

只读属性,设备屏幕区域包括系统状态栏显示区域和应用显示区域,screen获取的是设备屏幕总区域的逻辑分辨率,单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。

返回值:

Number 类型

resolutionWidth


设备屏幕宽度分辨率

var resolutionWidth = rd.screen.resolutionWidth;
说明:

只读属性,设备屏幕区域包括系统状态栏显示区域和应用显示区域,screen获取的是设备屏幕总区域的逻辑分辨率,单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。

返回值:

Number 类型

scale


逻辑分辨率与实际分辨率的比例

var scale = rd.screen.scale;
说明:

只读属性,屏幕分辨率分逻辑分辨率和实际分辨率,在html页面中使用的像素值都是相对于逻辑分辨率,此值就是逻辑分辨率和实际分辨率的比例,实际分辨率=逻辑分辨率*比例。

返回值:

Number 类型

dpiX


设备屏幕水平方向的密度

var dpiX = rd.screen.dpiX;
说明:

只读属性,设备屏幕的密度为每英寸所显示的像素点数,密度越高显示清晰度越高,单位为dpi。

返回值:

Number 类型

dpiY


设备屏幕垂直方向的密度

var dpiY = rd.screen.dpiY;
说明:

只读属性,设备屏幕的密度为每英寸所显示的像素点数,密度越高显示清晰度越高,单位为dpi。

返回值:

Number 类型

setBrightness


设置屏幕亮度

rd.screen.setBrightness(0);
说明:

调用此方法调节设备屏幕亮度。

参数:

brightness: ( Number ) 必选 屏幕的亮度值 取值范围为0到1,0表示最低亮度值,1表示最高亮度值。

返回值:

示例:
rd.screen.setBrightness( brightness );

getBrightness


获取屏幕亮度值

var brightness = rd.screen.getBrightness();
说明:

屏幕亮度值范围为0到1,0表示最低亮度值,1表示最高亮度值。

参数:

返回值:

Number : 返回程序的屏幕亮度值

示例:
var brightness = rd.screen.getBrightness();

lockOrientation


锁定屏幕方向,不支持iOS设备.

rd.screen.lockOrientation();
说明:

锁定屏幕方向后屏幕只能按锁定的屏幕方向显示,关闭当前页面后仍然有效。 可再次调用此方法修改屏幕锁定方向或调用unlockOrientation()方法恢复到应用的默认值。

参数:

返回值:

示例:
rd.screen.lockOrientation();

unlockOrientation


解除锁定屏幕方向,不支持iOS设备.

rd.screen.unlockOrientation();
说明:

解除锁定屏幕方向后将恢复应用默认的屏幕显示方向(通常为应用打包发布时设置的方向)。

参数:

返回值:

示例:
rd.screen.unlockOrientation();