GPU: requestAdapter() Methode

Limited availability

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

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 hier aus können Sie ein GPUDevice anfordern, Adapterinformationen, Funktionen und Grenzen.

Beachten Sie, dass der Benutzeragent entscheidet, ob ein Adapter zurückgegeben wird. Wenn ja, wählt er gemäß den bereitgestellten Optionen. Wenn keine Optionen angegeben werden, wird das Gerät Zugriff auf den Standardadapter gewähren, der normalerweise 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 Aufzählungswert, 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 gibt.
"low-power", was einen Hinweis gibt, die Energieeinsparung vor die Leistung zu stellen. Wenn Ihre App mit dieser Einstellung gut läuft, wird empfohlen, sie zu verwenden, da dies die Akkulaufzeit auf tragbaren Geräten erheblich verbessern kann. Dies ist normalerweise der Standard, wenn keine Optionen angegeben werden.
"high-performance", was einen Hinweis gibt, die Leistung vor den Energieverbrauch zu stellen. Sie werden ermutigt, diesen Wert nur anzugeben, wenn unbedingt notwendig, da er die Akkulaufzeit auf tragbaren Geräten erheblich verringern kann. Es kann auch zu einem erhöhten Verlust des GPUDevice führen – das System wird manchmal entscheiden, auf einen energieeffizienteren Adapter umzuschalten, um Strom zu sparen.

Der Hauptzweck dieses Hinweises ist, zu beeinflussen, welche GPU in einem Multi-GPU-System verwendet wird. Beispielsweise haben einige Laptops eine energieeffiziente integrierte GPU und eine leistungsstarke diskrete GPU. Verschiedene Faktoren können beeinflussen, welcher Adapter zurückgegeben wird, einschließlich des Batteriestatus, angeschlossener Displays oder entfernbarer GPUs.

Hinweis: In Chrome auf macOS-Geräten mit zwei GPUs, wenn requestAdapter() ohne die Option powerPreference aufgerufen wird, wird die leistungsstarke diskrete GPU zurückgegeben, wenn das Gerät des Benutzers an das Stromnetz angeschlossen ist. Andernfalls wird die energieeffiziente integrierte GPU zurückgegeben.

Fallback-Adapter

Der vom Benutzeragenten bereitgestellte Adapter kann ein Fallback-Adapter sein, wenn dieser bestimmt, dass er die am besten geeignete verfügbare Option ist. Ein Fallback-Adapter hat in der Regel erhebliche Leistungseinschränkungen im Austausch für eine Kombination aus breiterer Kompatibilität, vorhersehbarerem Verhalten oder verbesserter Privatsphäre. Einige Browser bieten zum Beispiel eine softwarebasierte Implementierung der API über einen Fallback-Adapter an. Ein Fallback-Adapter steht nicht auf jedem System zur Verfügung.

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

Hinweis: Die Spezifikation enthält eine forceFallbackAdapter-Option für requestAdapter(). Dies ist ein boolean, der, wenn auf true gesetzt, den Benutzeragenten zwingt, einen Fallback-Adapter zurückzugeben, wenn einer verfügbar ist. Diese Option 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