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>

枚举

PowerMode灵活

类型：uint32

在 fuchsia.ui.display.singleton/power.fidl 中定义

显示硬件的电源模式。

添加：HEAD

名称值说明
0

显示屏已关闭。硬件不会应用新的显示屏配置，也不会生成新的 VSync 事件。

所有显示设备都必须支持此电源模式。
1

显示屏已完全开启。

所有显示设备都必须支持此电源模式。
2

显示屏已开启，并配置为低功耗状态，适合向用户显示环境信息，保真度可能低于“开启”状态，但效率更高。

显示设备必须同时支持 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 中定义

序数变体类型说明
response DisplayPower_SetPowerMode_Response
err zx/Status
framework_err internal