Diese Seite wurde von der Cloud Translation API übersetzt.

Compute Pressure API

Informieren Sie sich über die Rechenleistung Ihres Systems.

Jeff Posnick

Kenneth Christiansen

Arnaud (Arno) Mandy

Die Compute Pressure API bietet allgemeine Status, die die Belastung des Systems darstellen. Bei der Implementierung können die richtigen zugrunde liegenden Hardwaremesswerte verwendet werden, damit Nutzer die gesamte ihnen zur Verfügung stehende Rechenleistung nutzen können, solange das System nicht unter unüberschaubarer Belastung steht.

Aktueller Status

Step	Status
1. Erklärende Erklärung erstellen	Abschließen
2. Ersten Entwurf der Spezifikation erstellen	Abschließen
3. Feedback einholen und Design iterieren	In Bearbeitung
4. Ursprungstest	Abschließen
5. Launch	Abgeschlossen (Chrome 125)

Compute Pressure API testen

Informationen zum lokalen Experimentieren mit der Compute Pressure API finden Sie auf dieser Seite.

Für Ursprungstest registrieren

Ab Chrome 115 ist die Compute Pressure API als Ursprungstest verfügbar. Es wird voraussichtlich in Chrome 123 (29. Mai 2024) enden. Hier anmelden

Anwendungsfälle

Die wichtigsten Anwendungsfälle, die durch die aktuelle Compute Pressure API verbessert werden, sind Videokonferenzen und Videospiele.

Diese beliebten Echtzeitanwendungen werden als Soft-Apps eingestuft. Das heißt, die Dienstqualität verschlechtert sich, wenn das System über bestimmte Zustände hinaus ausgelastet wird, dies aber nicht zu einem Gesamtsystemausfall führt. Diese Soft-Real-Time-Anwendungen profitieren enorm davon, dass sie ihre Arbeitslasten basierend auf der CPU-Nutzung oder -Auslastung anpassen können.

Konkret soll die erste Version dieser API die folgenden Anpassungsentscheidungen ermöglichen.

Videokonferenzsysteme

Du kannst die Anzahl der Videofeeds anpassen, die während eines Anrufs mit vielen Teilnehmern gleichzeitig angezeigt werden.
Verringere die Qualität der Videoverarbeitung (Videoauflösung, Bilder pro Sekunde).
Überspringen Sie die Videoverarbeitung, die nicht notwendig ist, z. B. einige Kamerafilter.
Deaktiviere die grundlegende Audioverarbeitung, z. B. die WebRTC-Rauschunterdrückung.
Drehen Sie die Schieberegler für Qualität und Geschwindigkeit in Richtung „Geschwindigkeit“ in der Video- und Audiocodierung (in WebRTC, WebCodecs oder Softwarecodierung).

Videospiele

Verwenden Sie Assets von geringerer Qualität, um das Video des Spiels (3D-Modelle, Texturen, Shader) und Audio (Stimmen, Soundeffekte) zusammenzustellen.
Deaktivieren Sie Effekte, die zu weniger realistischen, nicht wesentlichen Details führen, wie Wasser, Stoff, Feueranimationen, Hautleuchtigkeit, Blendeffekte oder physische Simulationen, die sich nicht auf das Spiel auswirken.
Passen Sie die Steuerelemente für Qualität im Vergleich zur Geschwindigkeit in der Rendering-Engine des Spiels an (Schattenqualität, Texturfilterung, Sichtentfernung).

Technisch gesehen kann dies durch die Kenntnis von Temperaturzuständen (z. B. ob das System passiv gekühlt wird) und CPU-Druckstatus für den Hauptthread und die Worker, die vom Standort verwendet werden, erreicht werden. Der thermische Zustand des Systems ist ein globaler Zustand, der von anderen Anwendungen und Websites als der überwachenden Website beeinflusst werden kann.

Interfaces

Die Compute Pressure API kann in den folgenden Kontexten ausgeführt werden:

Fenster oder Hauptthread
Engagierte Mitarbeiter
Shared Worker

Die Compute Pressure API definiert zwei neue Schnittstellen.

PressureObserver: Ein Objekt, um die Auslastung einer beliebigen Anzahl von Quellen in einem vordefinierten Stichprobenintervall zu beobachten. Beim ersten Durchlauf in Chromium wird "cpu" als source angezeigt. Weitere Informationen finden Sie im Abschnitt zu Parametern. Jeder Beobachter kann asynchron Druckänderungen in einem System beobachten.

PressureRecord: Beschreibt den Drucktrend an einem bestimmten Zeitpunkt des Übergangs. Objekte dieses Typs können nur auf zwei Arten abgerufen werden: als Eingabe in den PressureObserver-Callback oder durch Aufrufen der Methode takeRecords() für die Instanz PressureObserver.

PressureObserver

Wenn ein PressureObserver-Objekt erstellt wird, ist es so konfiguriert, dass es den Druck unterstützter Quellen in einem bestimmten Stichprobenintervall überwacht. Die unterstützten Quellen können während der Lebensdauer des PressureObserver-Objekts jederzeit einzeln oder unbeobachtet beobachtet werden. Das Stichprobenintervall kann nach dem Erstellen des Objekts nicht mehr geändert werden.

Konstruktor

PressureObserver(callback, options): Erstellt ein neues PressureObserver-Objekt, das eine angegebene Callback-Funktion aufruft, wenn eine Änderung der Werte der beobachteten Quelle erkannt wurde.

Der Konstruktor akzeptiert eine obligatorische Callback-Funktion und optionale options als Parameter.

Rückruf

callback(): Der Callback wird mit einem Array ungelesener PressureRecord-Objekte aufgerufen.

Optionen

PressureObserverOptions: enthält das Stichprobenintervall sampleInterval in Millisekunden, in dem der Nutzer Aktualisierungen anfordert.

Methoden

PressureObserver.observe(source): Teilt dem „PressureObserver“ mit, welche Quelle beobachtet werden soll.

PressureObserver.unobserve(source): Weist den „PressureObserver“ an, eine Quelle nicht mehr zu beobachten.

PressureObserver.disconnect(): Weist den „PressureObserver“ an, keine Quellen mehr zu beobachten.

PressureObserver.takeRecords(): Gibt eine Folge von Datensätzen seit dem letzten Callback-Aufruf zurück.

static PressureObserver.supportedSources() (schreibgeschützt): Gibt unterstützte Quelltypen von der Hardware zurück.

Parameter

source: Die zu beobachtende Quelle, z. B. "cpu". Dies muss einer der unterstützten Quelltypen sein.

In der aktuellen Version von Compute Pressure wird nur "cpu" unterstützt.

PressureRecord

Die PressureRecord-Schnittstelle der Compute Pressure API beschreibt den Drucktrend einer Quelle zu einem bestimmten Zeitpunkt des Übergangs.

Instanzeigenschaften

PressureRecord.source (schreibgeschützt): Gibt einen String zurück, der die Ursprungsquelle darstellt, aus der der Datensatz stammt.

PressureRecord.state (schreibgeschützt): Gibt einen String zurück, der den aufgezeichneten Druckstatus darstellt.

PressureRecord.time (schreibgeschützt): Gibt eine Zahl zurück, die einen Zeitstempel mit hoher Auflösung darstellt.

Beispiele

Wird die Compute Pressure API unterstützt?

if ('PressureObserver' in globalThis) {
  // The Compute Pressure API is supported.
}

Druckbeobachter erstellen

Erstellen Sie den Auslastungsbeobachter, indem Sie seinen Konstruktor mit einer Callback-Funktion aufrufen, die bei einem Auslastungsupdate ausgeführt wird:

const observer = new PressureObserver(
  (records) => { /* ... */ },
  { sampleInterval: 2000 }
);

Ein Stichprobenintervall sampleInterval von 2.000 ms bedeutet, dass höchstens alle zwei Sekunden Aktualisierungen erfolgen.

Wenn das angeforderte Stichprobenintervall nicht vom System bereitgestellt werden kann. Das System stellt Stichproben mit dem am besten geeigneten Intervall bereit. Wenn beispielsweise ein Intervall von 2.000 ms angefordert wird, das System aber nur Stichproben bei maximal 1.000 ms bereitstellen kann, werden 1.000 ms ausgewählt.

Druckbeobachter verwenden

Es gibt nur eine Möglichkeit, einen Druckbeobachter zu starten. Rufen Sie für jede Quelle observer.observe(source) auf.

observer.observe("cpu");

In diesem Beispiel ist "cpu" die Druckquelle, an der wir interessiert sind. Derzeit ist es die einzige verfügbare Quelle. In Zukunft wird es möglicherweise weitere Quellen wie "gpu", "power" oder "thermals" geben.

Wenn Sie eine Quelle nicht mehr beobachten möchten, verwenden Sie die Methode unobserve() wie im folgenden Beispiel:

observer.unobserve("cpu");

Um die Beobachtung aller Quellen gleichzeitig aufzuheben, verwenden Sie die Methode disconnect() wie im folgenden Beispiel:

observer.disconnect();

Druckdaten abrufen

Druckdatensätze können mit einer Callback-Funktion abgerufen werden, die jedes Mal aufgerufen wird, wenn eine Änderung des Auslastungsstatus erfolgt.

function callback(records) {
  const lastRecord = records[records.length - 1];
  console.log(`Current pressure ${lastRecord.state}`);
  if (lastRecord.state === "critical") {
    // Reduce workers load by 4.
  } else if (lastRecord.state === "serious") {
    // Reduce workers load by 2.
  } else {
    // Do not reduce.
  }
}

const observer = new PressureObserver(callback, { sampleInterval: 1000 });
await observer.observe("cpu");

Der Nutzer kann das Lesen von PressureRecord auch erzwingen, indem er die Methode takeRecords() aufruft.

Die Methode takeRecords() der PressureObserver-Schnittstelle gibt ein Array von PressureRecords-Objekten zurück, die im Druckbeobachter gespeichert sind, und leert ihn.

Der häufigste Anwendungsfall dafür besteht darin, vor dem Trennen des Beobachters sofort alle ausstehenden Auslastungseinträge abzurufen, die noch nicht von der Callback-Funktion des Beobachtenden verarbeitet wurden, damit alle ausstehenden Datensätze beim Herunterfahren des Beobachters verarbeitet werden können.

Durch den Aufruf dieser Methode wird die Liste der ausstehenden Einträge gelöscht, sodass der Callback nicht ausgeführt wird.

const observer = new PressureObserver(
  (records) => { /* Do something with records. */ },
  { sampleInterval: 1000 }
);

await observer.observe("cpu");

setTimeout(() => {
  // Forced records reading.
  const records = observer.takeRecords();
  observer.disconnect();
  // Do something with last records if any.
}, 2000);

Informationen zum API-Design

Gibt es etwas an der API, das nicht wie erwartet funktioniert? Fehlt eine Methode oder Eigenschaft für die Nutzung der API? Melden Sie ein Spezifikationsproblem oder kommentieren Sie ein vorhandenes Problem im entsprechenden GitHub-Repository.

Problem mit der Implementierung melden

Haben Sie einen Fehler bei der Implementierung von Chromium gefunden? Oder unterscheidet sich die Implementierung von der Spezifikation? Melden Sie einen Fehler unter new.crbug.com. Geben Sie dabei so viele Details wie möglich und einfache Anweisungen zur Reproduktion an und geben Sie Blink>PerformanceAPIs>ComputePressure in das Feld Components ein.