Display

检索主显示屏属性的类。请注意，此turbomodule仅支持主显示屏。

构造函数

new Display()

new Display(): Display

返回值

Display

方法

addDisplayListener()

static addDisplayListener(listener): ISubscription

添加显示屏侦听器对象IDisplayListener，以在显示屏属性更改时接收回调。它返回一个ISubscription对象，可以使用该对象通过 () 取消订阅侦听器，不再接收事件。

参数

listener

IDisplayListener

IDisplayListener接口

返回值

ISubscription

与此侦听器相关的ISubscription对象

参见

DisplayListenerSubscription

---

addDisplayListener2()

static addDisplayListener2(listener): ISubscription

添加显示屏侦听器对象IDisplayListener，以在显示屏属性更改时接收回调。它返回一个ISubscription对象，可以使用该对象通过 () 取消订阅侦听器，不再接收事件。

参数

listener

IDisplayListener

IDisplayListener接口

返回值

ISubscription

与此侦听器相关的ISubscription对象

参见

DisplayListenerSubscription

---

getAllowedColorDepths()

static getAllowedColorDepths(colorSpace): ColorDepth[]

查询给定颜色空间的允许色深，基于连接的显示屏/电视功能和设备功能获取。如果分辨率、刷新率或HDR设置发生变化，则客户端应重新调用此API以获得更新后的允许色深。

参数

colorSpace

ColorSpace

查询允许色深的颜色空间。

返回值

ColorDepth[]

一个数组（ColorDepth值），可用于指定的颜色空间DisplayManager.setColorDepth()

---

getAllowedColorSpaces()

static getAllowedColorSpaces(): ColorSpace[]

查询允许的颜色空间，基于连接的显示屏/电视功能和设备功能获取。如果分辨率、刷新率或HDR设置发生变化，则客户端应重新调用此API以获得更新后的允许的颜色空间。

返回值

ColorSpace[]

一个数组（ColorSpace值），代表允许的颜色空间DisplayManager.setColorSpace()

---

getAllSupportedConfigs()

static getAllSupportedConfigs(): IDisplayConfig[]

查询此显示屏支持的所有配置清单。

返回值

IDisplayConfig[]

返回此显示屏支持的所有配置清单。

---

getColorDepth()

static getColorDepth(): ColorDepth

获取当前色深。

返回值

ColorDepth

色深。

---

getColorSpace()

static getColorSpace(): ColorSpace

获取当前颜色空间。

返回值

ColorSpace

颜色空间。

---

getCurrentConfig()

static getCurrentConfig(): IDisplayConfig

查询此显示屏的当前配置。

返回值

IDisplayConfig

返回当前配置

参见

IDisplayConfig

---

getCurrentHdcpLevel()

static getCurrentHdcpLevel(): HdcpLevel

查询此显示屏的当前HDCP（高带宽数字内容保护）级别。

返回值

HdcpLevel

返回此显示屏的当前HDCP级别

参见

HdcpLevel

---

getCurrentRefreshRateInMillihertz()

static getCurrentRefreshRateInMillihertz(): number

查询此显示屏的当前垂直刷新率（单位：mHz，毫赫兹）

返回值

number

返回此显示屏的当前刷新率（单位：mHz）。如果当前刷新率发生变化，将调用IDisplayListener.onRefreshRateChange。

---

getHdrMode()

static getHdrMode(): HdrMode

获取当前HDR模式。

返回值

HdrMode

HDR模式。

---

getLowLatencyModeState()

static getLowLatencyModeState(): LlmState

查询显示屏的当前低延迟模式状态。

返回值

LlmState

显示屏使用的低延迟模式状态。

---

getName()

static getName(): string

查询显示屏连接器的名称。

返回值

string

显示屏连接器的名称（不是面板名称）。

---

getOverscanBorder()

static getOverscanBorder(): IOverscanBorder

返回显示屏的当前过扫描边框值。边框值（左、上、右和下）表示显示屏宽度和高度的一定比例，这部分区域用作显示屏可见范围的四周留白。

返回值

IOverscanBorder

当前的过扫描边框配置。

抛出

DeviceError：如果显示设备未处于活动状态

参见

IOverscanBorder

---

getTransferFunctions()

static getTransferFunctions(): TransferFunction[]

查询显示屏支持的传递函数。

返回值

TransferFunction[]

---

isAutoConfigSwitchEnabled()

static isAutoConfigSwitchEnabled(): boolean

查询是否启用了自动配置切换。

返回值

boolean

如果启用了自动配置切换，则为true，否则为false

参见

IDisplayConfig

---

isBT2020ColorimetrySupported()

static isBT2020ColorimetrySupported(): boolean

检查显示屏是否支持BT.2020/Rec.2020色度标准。

返回值

boolean

---

isHDRSupported()

static isHDRSupported(): boolean

检查显示屏是否支持HDR（高动态范围）。

返回值

boolean

---

isLowLatencyModeSupported()

static isLowLatencyModeSupported(): boolean

查询此显示屏是否支持任何类型的显示屏低延迟模式。

返回值

boolean

如果支持则为true，否则为false

---

isMultipleRefreshRateEnabled()

static isMultipleRefreshRateEnabled(): boolean

查询此显示屏的多重刷新率 (MRR) 状态。它允许客户端请求替代刷新率，这可能更适合其内容。

返回值

boolean

显示屏使用的MRR状态。

---

isSinkActive()

static isSinkActive(): boolean

检查此显示信号源设备连接的显示接收端口是否处于工作状态。显示接受端（例如电视或监视器）可能有多个显示端口。连接此信号源设备的端口可能未处于工作状态，即使此时显示信号源（此设备）已开启。

返回值

boolean

如果显示接收端处于工作状态，则返回true。

---

Last updated: 2025年10月2日