GPU: requestAdapter() Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die requestAdapter() Methode der GPU-Schnittstelle gibt ein Promise zurück, das mit einer Instanz des GPUAdapter-Objekts erfüllt wird. Von diesem aus können Sie ein GPUDevice, Adapterinformationen, Funktionen und Einschränkungen anfordern.

Beachten Sie, dass der Benutzeragent entscheidet, ob ein Adapter zurückgegeben wird. Falls ja, wird er gemäß den angegebenen Optionen ausgewählt. Wenn keine Optionen angegeben sind, stellt das Gerät Zugriff auf den Standardadapter bereit, der in der Regel für die meisten Zwecke ausreichend ist.

Syntax

requestAdapter()
requestAdapter(options)

Parameter

options Optional

Ein Objekt, das die folgenden Eigenschaften enthält:

powerPreference Optional

Ein enumerierter Wert, der verwendet werden kann, um dem Benutzeragenten einen Hinweis zu geben, welche Klasse von Adapter aus den verfügbaren Adaptern des Systems ausgewählt werden soll. Verfügbare Werte sind:

undefined (oder nicht angegeben), was keinen Hinweis liefert.
"low-power", was einen Hinweis gibt, die Energieeinsparung gegenüber der Leistung zu priorisieren. Wenn Ihre App mit dieser Einstellung gut läuft, wird empfohlen, sie zu verwenden, da sie die Akkulaufzeit auf tragbaren Geräten erheblich verbessern kann. Dies ist normalerweise die Standardeinstellung, wenn keine Optionen angegeben sind.
"high-performance", was einen Hinweis gibt, die Leistung gegenüber dem Energieverbrauch zu priorisieren. Sie werden ermutigt, diesen Wert nur anzugeben, wenn dies absolut notwendig ist, da dies die Akkulaufzeit auf tragbaren Geräten erheblich verringern kann. Es kann auch zu einem erhöhten Verlust von GPUDevice führen — das System wird manchmal einen Wechsel zu einem energieeffizienteren Adapter vornehmen, um Energie zu sparen.

Der Hauptzweck dieses Hinweises besteht darin, zu beeinflussen, welche GPU in einem System mit mehreren GPUs verwendet wird. Beispielsweise haben einige Laptops eine energieeffiziente integrierte GPU und eine leistungsstarke dedizierte GPU. Verschiedene Faktoren können beeinflussen, welcher Adapter zurückgegeben wird, einschließlich des Akkustatus, angeschlossener Bildschirme oder abnehmbarer GPUs.

Hinweis: In Chrome, das auf macOS-Geräten mit zwei GPUs läuft, wird die leistungsstarke dedizierte GPU zurückgegeben, wenn requestAdapter() ohne powerPreference-Option aufgerufen wird und das Gerät des Benutzers mit Netzstrom betrieben wird. Andernfalls wird die energieeffiziente integrierte GPU zurückgegeben.

Fallback-Adapter

Der vom Benutzeragenten bereitgestellte Adapter kann ein Fallback-Adapter sein, wenn er bestimmt, dass dies die am besten geeignete verfügbare Option ist. Ein Fallback-Adapter hat im Allgemeinen erhebliche Leistungseinschränkungen im Austausch für eine Kombination aus breiterer Kompatibilität, vorhersehbareren Verhalten oder verbesserter Privatsphäre. Beispielsweise bieten einige Browser möglicherweise eine softwarebasierte Implementierung der API über einen Fallback-Adapter an. Ein Fallback-Adapter wird nicht auf jedem System verfügbar sein.

Wenn Sie verhindern möchten, dass Ihre Apps auf Fallback-Adaptern laufen, sollten Sie das GPUAdapter.isFallbackAdapter-Attribut überprüfen, bevor Sie ein GPUDevice anfordern.

Hinweis: Die Spezifikation enthält eine forceFallbackAdapter-Option für requestAdapter(). Dies ist ein Boolean, der, wenn er auf true gesetzt ist, den Benutzeragenten zwingt, einen Fallback-Adapter zurückzugeben, falls einer verfügbar ist. Dies wird derzeit von keinem Browser unterstützt.

async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU not supported.");
  }

  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("Couldn't request WebGPU adapter.");
  }

  const device = await adapter.requestDevice();

  // …
}

Spezifikationen

Specification
WebGPU # dom-gpu-requestadapter

Browser-Kompatibilität

Siehe auch

Die WebGPU API