GPU: Método requestAdapter()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.

Nota: Esta característica está disponible en Web Workers.

El método requestAdapter() de la interfaz GPU devuelve una Promise que se resuelve con una instancia del objeto GPUAdapter. Desde aquí puedes solicitar un GPUDevice, información del adaptador, características y límites.

Ten en cuenta que el agente de usuario es quien decide si devolver un adaptador. De ser así, lo elige según las opciones proporcionadas. Si no se proporcionan opciones, el dispositivo proporcionará acceso al adaptador predeterminado, lo cual suele ser suficiente para la mayoría de los casos.

Sintaxis

requestAdapter()
requestAdapter(options)

Parámetros

options Opcional

Un objeto que contiene las siguientes propiedades:

powerPreference Opcional

Un valor enumerado que se puede usar para proporcionar una pista al agente de usuario que indica qué clase de adaptador se debería escoger entre los adaptadores disponibles del sistema. Los valores disponibles son:

undefined (o no especificado), que no proporciona ninguna pista.
"low-power", lo que indica que se debe priorizar el ahorro de energía frente al rendimiento. Si la aplicación funciona correctamente con esta configuración, se recomienda usarla, ya que puede mejorar significativamente la duración de la batería en dispositivos portátiles. Esta suele ser la opción predeterminada si no se ofrecen opciones.
"high-performance", lo que indica que se debe priorizar el rendimiento sobre el consumo de energía. Se recomienda especificar este valor solo si es absolutamente necesario, ya que puede reducir significativamente la duración de la batería en dispositivos portátiles. También puede resultar en una mayor probabilidad de pérdida del GPUDevice, en ocasiones, el sistema optará por usar un adaptador de menor consumo para ahorrar energía.

El objetivo principal de esta pista es determinar qué GPU se usará en un sistema con varias GPU. Por ejemplo, algunos portátiles tienen una GPU integrada de bajo consumo y una GPU discreta de alto rendimiento. Diversos factores pueden afectar qué adaptador es devuelto, incluyendo el estado de la batería, las pantallas conectadas o las GPU extraíbles.

Nota: En Chrome ejecutándose en dispositivos macOS con doble GPU, si se llama a requestAdapter() sin una opción powerPreference, se devuelve la GPU discreta de alto rendimiento cuando el dispositivo del usuario está conectado a la corriente eléctrica. De lo contrario, se devolverá la GPU integrada de bajo consumo.

Adaptadores de respaldo

El adaptador proporcionado por el agente de usuario puede ser un adaptador de respaldo, si determina que es la opción disponible más apropiada. Un adaptador de respaldo generalmente ofrece limitaciones de rendimiento significativas a cambio de una mayor compatibilidad, un comportamiento más predecible, o una mayor privacidad. Por ejemplo, algunos navegadores pueden ofrecer una implementación de la API basada en el software a través de un adaptador de respaldo. Es posible que un adaptador de respaldo no esté disponible en todos los sistemas.

Si quieres prevenir que tus aplicaciones se ejecuten en adaptadores de respaldo, deberías comprobar el atributo GPUAdapter.isFallbackAdapter antes de solicitar un GPUDevice.

Nota: La especificación incluye una opción forceFallbackAdapter para requestAdapter(). Esto es un booleano que, si es establecido a true, fuerza al agente de usuario a devolver un adaptador de respaldo si uno está disponible. Esto no está soportado por ningún navegador todavía.

async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU no está soportado.");
  }

  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("No se pudo solicitar un adaptador de WebGPU.");
  }

  const device = await adapter.requestDevice();

  // …
}