fuchsia.ui.display.Singleton

新增：12

通訊協定

DisplayPower

定義於 fuchsia.ui.display.singleton/power.fidl

控制預設顯示裝置的電源狀態。

新增：HEAD

SetPowerMode

將預設外接顯示裝置的電源狀態設為 power_mode。

錯誤：

  • ZX_ERR_NOT_FOUND：未連接任何螢幕。
  • ZX_ERR_NOT_SUPPORTED：預設連接的顯示器驅動程式庫或硬體不支援要求的電源模式。
  • ZX_ERR_INTERNAL：因其他原因導致作業失敗。

要求

名稱類型
power_mode PowerMode

回應

名稱類型
payload DisplayPower_SetPowerMode_Result

資訊

定義於 fuchsia.ui.display.singleton/info.fidl

取得 Scenic 主要螢幕的資訊。

GetMetrics

要求

<EMPTY>

回應

名稱類型
info Metrics

VsyncSource

定義於 fuchsia.ui.display.singleton/vsync_source.fidl

新增：NEXT

OnVsync

通知用戶端發生 vsync 事件。

回應

名稱類型
timestamp zx/Time

SetVsyncEnabled

啟用或停用指定螢幕的 OnVsync 接收功能。

只有在使用 enabled=true 呼叫這個函式時，用戶端才會收到 OnVsync 回呼。使用 enabled=false 呼叫此方法會停止產生回呼。請注意，伺服器收到這項資訊時可能會發生競爭情況，並可能收到額外的 OnVsync。

根據預設，系統會假設事件監聽器已呼叫 enabled=false。

要求

名稱類型
enabled bool

STRUCTS

DisplayPower_SetPowerMode_Response

定義於 fuchsia.ui.display.singleton/power.fidl

<EMPTY>

ENUMS

PowerMode 彈性

類型：uint32

定義於 fuchsia.ui.display.singleton/power.fidl

顯示硬體的電源模式。

新增：HEAD

名稱值說明
0

螢幕已關閉。硬體不會套用新的螢幕設定，也不會產生新的 VSync 事件。

所有顯示裝置都必須支援這個電源模式。
1

螢幕已完全開啟。

所有顯示裝置都必須支援這個電源模式。
2

螢幕已開啟，並設為低耗電狀態，適合向使用者顯示環境資訊，精確度可能低於 ON，但效率更高。

顯示裝置必須同時支援 DOZE 和 DOZE_SUSPEND 電源模式，或兩者皆不支援。
3

螢幕設定為與 DOZE 相同的狀態，但可能會停止套用用戶端的螢幕更新。

這實際上是向裝置提示，繪製到螢幕的作業已暫停，裝置必須保持低耗電狀態，並無限期繼續顯示目前內容，直到電源模式變更為止。

顯示裝置必須同時支援 DOZE 和 DOZE_SUSPEND 電源模式，或兩者皆不支援。如果同時支援這兩種模式，顯示裝置可以不使用上述提示，在這種情況下，DOZE_SUSPEND 與 DOZE 相同。

TABLES

指標

定義於 fuchsia.ui.display.singleton/info.fidl

說明實體螢幕，以及如何對應實體和邏輯像素。

序數欄位類型說明
extent_in_px fuchsia.math/SizeU

與 fuchsia.hardware.display.Mode 中的 horizontal_resolution 和 vertical_resolution 意義相同。以實體像素為單位。
extent_in_mm fuchsia.math/SizeU

與 fuchsia.hardware.display.Info 中的 horizontal_size_mm 和 vertical_size_mm 意義相同。
recommended_device_pixel_ratio fuchsia.math/VecF

每個「邏輯」像素的實體像素數量，例如 fuchsia.ui.composition.LayoutInfo.logical_size。這項資訊可指出應分配的圖片緩衝區大小。這個值通常會由場景圖根目錄附近的元件使用，為場景其餘部分設定縮放比例。
maximum_refresh_rate_in_millihertz uint32

1,000 秒內傳輸至螢幕的圖片數量上限。這是螢幕的垂直刷新率上限，以毫赫茲 (0.001 Hz) 為單位。

新增：16

UNIONS

DisplayPower_SetPowerMode_Result strict

定義於 fuchsia.ui.display.singleton/power.fidl

序數Variant類型說明
response DisplayPower_SetPowerMode_Response
err zx/Status
framework_err internal