DisplayManager

DisplayManagerには、ディスプレイの構成/設定を変更するためのAPIが用意されています。クライアントがこのクラスのAPIを呼び出すには、アプリケーション権限「com.amazon.graphics.privilege.display.manager」が必要です。

コンストラクタ

new DisplayManager()

new DisplayManager(): DisplayManager

戻り値

DisplayManager

メソッド

addListener()

static addListener(listener: IDisplayManagerListener): ISubscription

ディスプレイマネージャーのプロパティが変更されたときにコールバックを受け取ることができるように、ディスプレイマネージャーリスナーオブジェクトを追加します。戻り値はオブジェクトであり、リスナーのイベント受信を解除するのに使用されます。

パラメーター

listener

IDisplayManagerListener

IDisplayManagerListener：このリスナーに関連するインターフェイスISubscriptionオブジェクト

戻り値

ISubscription

---

commitStates()

static commitStates(): number

ディスプレイマネージャーに、保留中の状態をすべてコミットするようにリクエストします。変更を適用するには、この関数を呼び出す必要があることに注意してください。このAPIは保留状態のみを更新し、最後のcommitStates()呼び出し以降に行われた保留中の状態変更リクエストをすべて実際に適用しようとします。1回のコミット呼び出しの利点は、クライアントがディスプレイハードウェア上で複数の従属状態をまとめて適用できることです。クライアントはコミットリクエストの結果を知ることができます。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。numberとして返されるコミットIDを使用して、コミット状態を追跡できます。

戻り値

number

---

enableAutoConfigSwitch()

static enableAutoConfigSwitch(enable: boolean): void

新しい構成に自動的に切り替わるようにディスプレイにリクエストします。このモードでは、ディスプレイサーバーはさまざまな要因に基づいて最も適切な構成を動的に選択します。構成切り替えが成功してもIDisplayListener.onConfigChangeは引き続き呼び出されます。enableAutoConfigSwitch(true)を呼び出すと、以前のrequestConfigChange()呼び出しがオーバーライドされることに注意してください。デフォルトの状態は「true」です。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

enable

boolean

trueの場合、ディスプレイサブシステムは適切な構成を自動的に選択します。

---

requestConfigChange()

static requestConfigChange(displayConfig: IDisplayConfig, refreshRateInMillihertz: Int32): void

ディスプレイに新しい構成に切り替えるように要求します。正常に完了すると、コールバックが呼び出されます。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

displayConfig

IDisplayConfig

新しくリクエストされたディスプレイ構成。

refreshRateInMillihertz

Int32

---

setAisrState()

static setAisrState(aisrState: AisrState): void

このディスプレイのシステムレベルのAISR状態を設定します。変更は直ちに適用され、再起動後も保持されます。このため、起動するたびに変更する必要はありません。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

aisrState

AisrState

---

setColorDepth()

static setColorDepth(colorDepth: ColorDepth): void

ディスプレイサーバーに特定の色深度への切り替えをリクエストします。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

colorDepth

ColorDepth

リクエストされた新しい色深度。

---

setColorSpace()

static setColorSpace(colorSpace: ColorSpace): void

ディスプレイサーバーに、指定された色空間（RGBやYUVなど）に切り替えるようにリクエストします。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

colorSpace

ColorSpace

リクエストされた新しい色空間。

---

setHdrMode()

static setHdrMode(hdrMode: HdrMode): void

HDRモードを有効または無効にします。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

hdrMode

HdrMode

---

setLowLatencyModeState()

static setLowLatencyModeState(llmState: LlmState): void

低遅延モードを有効または無効にします。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

llmState

LlmState

---

setMultipleRefreshRateState()

static setMultipleRefreshRateState(mrrState: boolean): void

ディスプレイのMRRの状態を設定します。MRRは、クライアントがコンテンツにより適した代替リフレッシュレートをリクエストできるようにする機能です。これはディスプレイのグローバルMRRの状態であり、アプリケーションがディスプレイサーバーに、元のコンテンツのフレームレートとほぼ一致する、サポートされている他のリフレッシュレートのいずれかに切り替えるようにリクエストできるかどうかを制御します。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

mrrState

boolean

---

setOverscanBorder()

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

コンテンツが画面の物理的な境界を越えて失われないように、ディスプレイの表示領域を調整するようディスプレイサーバーにリクエストします。APIは、4つの境界線または余白の幅を、幅または高さに対するパーセンテージとして取ります。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

leftBorderAsPercentageOfWidth

Double

topBorderAsPercentageOfHeight

Double

高さに対するパーセンテージで表した上部の境界線。

rightBorderAsPercentageOfWidth

Double

幅に対するパーセンテージで表した右側の境界線。

bottomBorderAsPercentageOfHeight

Double

高さに対するパーセンテージで表した下部の境界線。

---

Last updated: 2026年7月22日