DisplayManager

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

コンストラクタ

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()呼び出し以降に行われた保留中の状態変更リクエストをすべて実際に適用しようとします。1回のコミット呼び出しの利点は、クライアントがディスプレイハードウェア上で複数の従属状態をまとめて適用できることです。クライアントは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は、4つの境界線または余白の幅を、幅または高さに対するパーセンテージとして取ります。このAPIでは、クライアントに「com.amazon.graphics.privilege.display.manager」アプリケーション権限が必要です。

パラメーター

leftBorderAsPercentageOfWidth

number

topBorderAsPercentageOfHeight

number

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

rightBorderAsPercentageOfWidth

number

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

bottomBorderAsPercentageOfHeight

number

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

戻り値

void

---

Last updated: 2025年10月2日