as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
Vega图形API提供允许应用查询已连接显示器功能的功能。这些功能包括屏幕分辨率、刷新率、色深和格式,以及HDR支持。API还会考虑设备支持,并根据设备限制返回功能信息。

开始使用

先决条件

Vega应用可以通过Vega SDK使用此程序包。 有关如何安装Vega SDK的说明,请参阅Vega SDK设置。

设置

Vega图形Turbo模块由kepler-graphics npm程序包提供。将以下库依赖项添加到package.json文件的dependencies部分。

权限

显示API由get方法和set方法组成。通过DisplayManager类使用set方法的应用需要安全权限com.amazon.graphics.privilege.display.manager,该权限位于其manifest.toml文件的[needs]部分下,如下所示。
get方法不需要任何权限。 包含com.amazon.graphics.privilege.display.manager允许以下一组操作:
  • 将当前屏幕分辨率和刷新率更改为支持的值之一。
  • 更改其他显示器属性,如色深、颜色格式、HDR模式和ALLM。

用法

以下是支持的用例列表:
  • 侦听显示器热插拔事件。
  • 查询支持的屏幕分辨率(宽x高)和显示器的刷新率。
  • 查询支持的HDR类型/传输函数、最高HDCP级别、显示器的屏幕像素密度 (DPI)。
  • 查询显示器的当前有效屏幕分辨率、刷新率、色深、颜色格式、HDR模式、低延迟模式 (ALLM)。
  • 侦听显示器属性的更改事件。
以下部分提供了一些用例的示例代码。

导入所需的组件

要使用Vega图形API,请从@amazon-devices/kepler-graphics导入所需的组件。 在源代码文件中,应从kepler-graphics程序包导入接口和类型,如下所示:
前面的导入显示了所有潜在可用的组件。您只需为应用使用的方法导入相应的组件。

检查显示器状态

要检查显示器是否已连接到设备,请使用以下方法。

显示热插拔事件

在显示面板连接或断开连接时获取回调事件。IDisplayControllerListener.onAddDisplay()和IDisplayControllerListener.onRemoveDisplay()回调方法会提供这些事件,如下所示。

获取当前屏幕分辨率和刷新率

Display.getCurrentConfig()方法会以IDisplayConfig对象的形式返回当前生效的配置。IDisplayConfig对象的成员提供屏幕分辨率(宽x高)、屏幕像素密度、支持的刷新率等。

检查HDR支持

以下示例代码显示如何检查显示器和设备是否支持HDR。
注意:​ 示例代码中检索到的受支持HDR类型仅针对当前使用的显示器配置(分辨率)有效。通Display.getAllSupportedConfigs()获得的其他显示器配置可能会列出其他HDR类型。只有当通过DisplayManager.requestConfigChange()方法将当前有效的配置更改为该特定的显示配置时,您才能使用这些HDR类型。

查询其他显示器属性

侦听更改事件

以下代码示例显示应用可以使用IDisplayListener回调接口来侦听对以下项的更改:
  • 显示屏属性(例如屏幕分辨率)
  • 刷新率、色深/色彩空间
  • HDCP级别
  • HDR模式
  • 低延迟模式

常见问题解答

问1: 为什么IDisplayConfig.supportedHdrType数组中没有列出显示器支持的HDR类型?

在报告支持的类型时,该方法实现除了考虑显示器属性外,还会考虑设备功能。如果设备不支持特定HDR类型,例如“Dolby Vision”,则IDisplayConfig.supportedHdrType报告的列表不会包含该类型。

问2: 如何取消订阅侦听器回调?

方法Display.addDisplayListener()和DisplayController.addListener()返回ISubscription对象。您可使用此对象来取消订阅侦听器,方法是调用unsubscribe()方法。查看以下代码示例。

问3: 为什么supportedHdrType会返回多个重复的值,比如

HDR类型与刷新率相关。在这种情况下,有5种不同的刷新率,每种刷新率都有相应HDR类型支持信息。例如,在60毫赫兹 (MHz) 的刷新率下,HDR支持类型为1,对应于HdrType.NONE。

API参考

类

  • Display — 检索主显示屏属性的类。
  • DisplayController — DisplayController特有的操作是通过此类完成的
  • DisplayManager — DisplayManager提供用于更改显示屏配置/设置的API。

接口

枚举

  • AisrState — 定义显示屏AI超分辨率状态的值。
  • BufferPixelFormat — 缓冲区像素格式指定用于存储的内存布局和位数
  • ColorDepth — 定义显示屏所有可能的色深。
  • ColorGamut — 定义色域类型列表。
  • ColorSpace — 定义显示屏不同的颜色空间类型。
  • HdcpLevel — 定义显示屏可支持的所有可能的HDCP级别。
  • HdrMode — 定义显示屏高动态模式的值。
  • HdrType — 定义支持的底层HDR技术列表
  • LlmState — 定义显示器可支持的所有可能的低延迟模式 (LLM) 状态。
  • TransferFunction — 定义显示屏转换函数列表

最后修改于 2026年7月22日