Display

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

构造函数

new Display()

new Display(): 显示

返回值

显示屏

方法

addDisplayListener()

static addDisplayListener(listener: IDisplayListener): ISubscription

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

参数

listener

IDisplayListener

IDisplayListener interface 与此侦听器相关的ISubscription对象

返回值

ISubscription

---

addDisplayListener2()

static addDisplayListener2(listener: IDisplayListener): ISubscription

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

参数

listener

IDisplayListener

IDisplayListener interface 与此侦听器相关的ISubscription对象

返回值

ISubscription

---

addDisplayListener3()

static addDisplayListener3(listener: IDisplayListener): ISubscription

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

参数

listener

IDisplayListener

IDisplayListener interface 与此侦听器相关的ISubscription对象

返回值

ISubscription

---

getAisrState()

static getAisrState(): AisrState

查询此显示屏当前的系统级AISR状态。当前AISR状态。

返回值

AisrState

---

getAllowedColorDepths()

static getAllowedColorDepths(colorSpace: ColorSpace): ColorDepth[]

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

参数

colorSpace

ColorSpace

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

返回值

ColorDepth[]

ColorDepth[] 一个数组（ColorDepth值），可用于指定的颜色空间

---

getAllowedColorSpaces()

static getAllowedColorSpaces(): ColorSpace[]

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

返回值

ColorSpace[]

ColorSpace[] 一个数组（ColorSpace值），代表允许的颜色空间

---

getAllSupportedConfigs()

static getAllSupportedConfigs(): IDisplayConfig[]

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

返回值

IDisplayConfig[]

---

getColorDepth()

static getColorDepth(): ColorDepth

获取当前颜色深度。色深。

返回值

ColorDepth

---

getColorSpace()

static getColorSpace(): ColorSpace

获取当前颜色空间。颜色空间。

返回值

ColorSpace

---

getCurrentConfig()

static getCurrentConfig(): IDisplayConfig

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

返回值

IDisplayConfig

---

getCurrentHdcpLevel()

static getCurrentHdcpLevel(): HdcpLevel

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

返回值

HdcpLevel

---

getCurrentRefreshRateInMillihertz()

static getCurrentRefreshRateInMillihertz(): number

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

返回值

number

---

getHdrMode()

static getHdrMode(): HdrMode

获取当前HDR模式。HDR模式。

返回值

HdrMode

---

getLowLatencyModeState()

static getLowLatencyModeState(): LlmState

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

返回值

LlmState

---

getName()

static getName(): string

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

返回值

string

---

getOverscanBorder()

static getOverscanBorder(): IOverscanBorder

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

抛出

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

返回值

IOverscanBorder

---

getSupportedHdrSettings()

static getSupportedHdrSettings(): HdrMode[]

查询支持的HDR模式，基于连接的显示屏/电视功能和设备功能确定。

返回值

HdrMode[]

HdrMode[] 一个数组（HdrMode值），代表支持的HDR模式

---

getTransferFunctions()

static getTransferFunctions(): TransferFunction[]

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

返回值

TransferFunction[]

---

isAisrSupported()

static isAisrSupported(): boolean

查询此显示屏是否支持AI超级分辨率。如果支持AISR，则为true，否则为false。

返回值

boolean

---

isAutoConfigSwitchEnabled()

static isAutoConfigSwitchEnabled(): boolean

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

返回值

boolean

---

isBT2020ColorimetrySupported()

static isBT2020ColorimetrySupported(): boolean

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

返回值

boolean

---

isHDRSupported()

static isHDRSupported(): boolean

以下API仅为包装器API，与原生API之间不存在直接的一一对应关系。

返回值

boolean

---

isLowLatencyModeSupported()

static isLowLatencyModeSupported(): boolean

查询此显示屏是否支持任何类型的显示屏低延迟模式。如果支持则为true，否则为false

返回值

boolean

---

isMultipleRefreshRateEnabled()

static isMultipleRefreshRateEnabled(): boolean

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

返回值

boolean

---

isSinkActive()

static isSinkActive(): boolean

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

返回值

boolean

---

Last updated: 2026年7月22日