DisplayManager

DisplayManager提供用于更改显示屏配置/设置的API。客户端需要拥有应用程序权限“com.amazon.graphics.privilege.display.manager”才能调用此类的API。

构造函数

new DisplayManager()

new DisplayManager(): DisplayManager

返回值

DisplayManager

方法

addListener()

static addListener(listener): ISubscription

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

参数

listener

IDisplayManagerListener

IDisplayManagerListener接口

返回值

ISubscription

与此侦听器相关的ISubscription对象

参见

DisplayManagerListenerSubscription

---

commitStates()

static commitStates(): number

向显示屏管理器发送请求，以提交所有待处理状态。请注意，任何更改都必须调用此函数才能生效。此API只会更新待处理状态，它实际上会尝试应用自上次commitStates() 调用以来提交的所有处于待处理状态的更改请求。使用单个提交函数的好处是，客户端可以在显示屏硬件上同时应用多个相互依赖的状态。客户端可以通过IDisplayManagerListener获得提交请求的结果。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

返回值

number

提交ID，可用于跟踪提交状态。

---

enableAutoConfigSwitch()

static enableAutoConfigSwitch(enable): void

请求显示屏自动切换到新配置。在此模式下，显示服务器会根据各种因素动态选择最合适的配置。成功切换配置后仍会调用IDisplayListener.onConfigChange。请注意，调用enableAutoConfigSwitch(true) 将覆盖之前的requestConfigChange() 调用。默认状态为“true”。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

enable

boolean

如果为true，则显示屏子系统将自动选择合适的配置。

返回值

void

---

requestConfigChange()

static requestConfigChange(displayConfig, refreshRateInMillihertz): void

请求显示屏切换到新配置。成功完成后将调用IDisplayListener.onConfigChange。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

displayConfig

IDisplayConfig

新请求的显示屏配置。

refreshRateInMillihertz

number

返回值

void

---

setColorDepth()

static setColorDepth(colorDepth): void

向显示服务器发送请求，以切换到特定的色深。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

colorDepth

ColorDepth

已请求的新色深。

返回值

void

---

setColorSpace()

static setColorSpace(colorSpace): void

向显示服务器发送请求，以切换到提供的颜色空间，例如RGB或YUV等。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

colorSpace

ColorSpace

已请求的新颜色空间。

返回值

void

---

setHdrMode()

static setHdrMode(hdrMode): void

启用或禁用HDR模式。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

hdrMode

HdrMode

返回值

void

---

setLowLatencyModeState()

static setLowLatencyModeState(llmState): void

启用或禁用低延迟模式。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

llmState

LlmState

返回值

void

---

setMultipleRefreshRateState()

static setMultipleRefreshRateState(mrrState): void

设置显示屏的MRR状态。MRR是一项功能，它允许客户端请求替代刷新率，这可能更适合其内容。这是显示屏的全局MRR状态，它控制应用程序是否可以向显示服务器发送请求，以切换到其他支持的刷新率之一，该刷新率与原始内容帧速率高度匹配。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

mrrState

boolean

返回值

void

---

setOverscanBorder()

static setOverscanBorder(leftBorderAsPercentageOfWidth, topBorderAsPercentageOfHeight, rightBorderAsPercentageOfWidth, bottomBorderAsPercentageOfHeight): void

向显示服务器发送请求，以调整显示屏的可见区域，来确保内容不会溢出到屏幕的物理边界之外。API接受四个边框（或边距）的宽度值，这些值以屏幕宽度或高度的百分比来表示。此API要求客户端拥有“com.amazon.graphics.privilege.display.manager”应用权限。

参数

leftBorderAsPercentageOfWidth

number

topBorderAsPercentageOfHeight

number

顶部边框（高度百分比）。

rightBorderAsPercentageOfWidth

number

右侧边框（宽度百分比）。

bottomBorderAsPercentageOfHeight

number

底部边框（高度百分比）。

返回值

void

---

Last updated: 2025年10月2日