Sie erhalten Informationen zum Rechenbedarf Ihres Systems.
Die Compute Pressure API bietet übergeordnete Status, die den Druck auf das System darstellen. So können bei der Implementierung die richtigen zugrunde liegenden Hardwaremesswerte verwendet werden, damit Nutzer die gesamte verfügbare Rechenleistung nutzen können, solange das System nicht übermäßig belastet wird.
Aktueller Status
| Schritt | Status |
|---|---|
| 1. Erklärende Mitteilung erstellen | Abschließen |
| 2. Ersten Entwurf der Spezifikation erstellen | Abschließen |
| 3. Feedback einholen und Design iterieren | In Bearbeitung |
| 4. Ursprungstest | Abgeschlossen |
| 5. Launch | Abgeschlossen (Chrome 125) |
Compute Pressure API testen
Informationen zum lokalen Testen 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. Sie wird voraussichtlich in Chrome 123 (29. Mai 2024) enden. Registrieren Sie sich für den Ursprungstest.
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 klassifiziert. Das heißt, die Dienstqualität verschlechtert sich, wenn das System über bestimmte Zustände hinaus belastet wird, führt aber nicht zu einem Systemausfall. Diese Anwendungen mit weicher Echtzeit profitieren erheblich davon, dass ihre Arbeitslasten anhand des CPU-Verbrauchs oder der CPU-Belastung angepasst werden können.
Insbesondere soll mit der ersten Version dieser API die Möglichkeit bestehen, die folgenden Anpassungsentscheidungen zu treffen.
Videokonferenzsysteme
- Sie können die Anzahl der Videofeeds anpassen, die bei Anrufen mit vielen Teilnehmern gleichzeitig angezeigt werden.
- Qualität der Videoverarbeitung reduzieren (Videoauflösung, Frames pro Sekunde)
- Unwichtige Videoverarbeitungen wie einige Kamerafilter kannst du überspringen.
- Deaktivieren Sie unwichtige Audioverarbeitung wie die WebRTC-Rauschunterdrückung.
- Stellen Sie die Regler für Qualität und Geschwindigkeit sowie Größe und Geschwindigkeit bei der Video- und Audiocodierung (in WebRTC, WebCodecs oder Softwarecodierung) auf „Geschwindigkeit“.
Videospiele
- Verwenden Sie Assets mit niedrigerer Qualität, um das Video (3D-Modelle, Texturen, Shader) und den Audioinhalt (Stimmen, Soundeffekte) des Spiels zu erstellen.
- Deaktivieren Sie Effekte, die zu weniger realistischen, nicht wesentlichen Details führen (Wasser, Stoff, Feueranimationen, Hauthelligkeit, Blendeffekte oder physikalische Simulationen, die sich nicht auf das Gameplay auswirken).
- Passen Sie die Qualität und Geschwindigkeit in der Rendering-Engine des Spiels an (Schattenqualität, Texturfilterung, Sichtweite).
Technisch gesehen ist dies möglich, wenn Sie die Temperatur (z. B. wird das System passiv gekühlt) und den CPU-Druckstatus für den Haupt-Thread und die Worker kennen, die von der Website verwendet werden. Der thermische Systemstatus ist ein globaler Status und kann von Apps und Websites beeinflusst werden, die nicht die beobachtete Website sind.
Interfaces
Die Compute Pressure API kann in den folgenden Kontexten ausgeführt werden:
- Fenster oder Hauptthread
- Dedizierter Worker
- Shared Worker
Die Compute Pressure API definiert zwei neue Schnittstellen.
PressureObserver: Ein Objekt, um den Rechendruck einer beliebigen Anzahl von Quellen in einem vordefinierten Stichprobenintervall zu beobachten. In der ersten Iteration in Chromium wird "cpu" als source angezeigt. Weitere Informationen finden Sie im Abschnitt zu Parametern. Jeder Beobachter kann asynchron Druckänderungenstrends in einem System beobachten.
PressureRecord: Beschreibt den Drucktrend zu einem bestimmten Zeitpunkt der Umwandlung. Objekte dieses Typs können nur auf zwei Arten abgerufen werden: als Eingabe für Ihren PressureObserver-Callback oder durch Aufrufen der Methode takeRecords() für die Instanz PressureObserver.
PressureObserver
Wenn ein PressureObserver-Objekt erstellt wird, wird 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 beobachtet oder nicht beobachtet werden. Das Stichprobenintervall kann nach dem Erstellen des Objekts nicht mehr geändert werden.
Konstruktor
PressureObserver(callback): Erstellt ein neues PressureObserver-Objekt, das eine angegebene Callback-Funktion aufruft, wenn eine Änderung der Werte der beobachteten Quelle erkannt wird.
Der Konstruktor nimmt eine obligatorische Callback-Funktion an.
Rückruf
callback(): Der Callback wird mit einem Array ungelesener PressureRecord-Objekte aufgerufen.
Methoden
PressureObserver.observe(source, options): Gibt dem „PressureObserver“ an, welche Quelle beobachtet werden soll, und optional options als Parameter.
Optionen
PressureObserverOptions: Enthält das Stichprobenintervall sampleInterval in Millisekunden, in dem der Nutzer Aktualisierungen anfordert.
PressureObserver.unobserve(source): Hiermit wird dem „PressureObserver“ mitgeteilt, dass er die Beobachtung einer Quelle beenden soll.
PressureObserver.disconnect(): weist den „PressureObserver“ an, die Beobachtung aller Quellen zu beenden.
PressureObserver.takeRecords(): Gibt eine Sequenz von Eintragselementen seit der letzten Rückrufausführung zurück.
static PressureObserver.knownSources() (Lesezugriff): Gibt die bekannten Quelltypen des User-Agents in alphabetischer Reihenfolge 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 Übergangszeitpunkt.
Instanzattribute
PressureRecord.source (schreibgeschützt): Gibt einen String zurück, der die Herkunftsquelle des Datensatzes darstellt.
PressureRecord.state (schreibgeschützt): Gibt einen String zurück, der den aufgezeichneten Auslastungsstatus darstellt.
PressureRecord.time (schreibgeschützt): Gibt eine Zahl zurück, die einen Zeitstempel mit hoher Auflösung darstellt.
Beispiele
In den folgenden Abschnitten finden Sie beispielhafte Anwendungsfälle.
API-Support ermitteln
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 jeder Auslastungsaktualisierung ausgeführt wird:
const observer = new PressureObserver((records) => {
/* ... */
});
Verwendung des Drucksensors
Es gibt nur eine Möglichkeit, einen Drucksensor zu starten. Rufe für jede Quelle observer.observe(source) auf.
observer.observe("cpu" { sampleInterval: 2_000 });
In diesem Beispiel ist die "cpu" die Druckquelle, für die wir uns interessieren. Derzeit ist dies die einzige verfügbare Quelle. In Zukunft werden möglicherweise weitere Quellen wie "gpu", "power" oder "thermals" zur Verfügung gestellt.
Bei einem Stichprobenintervall (sampleInterval) von 2.000 Millisekunden werden maximal alle zwei Sekunden Aktualisierungen durchgeführt.
Wenn das angeforderte Stichprobenintervall vom System nicht bereitgestellt werden kann, stellt das System Stichproben im bestmöglichen Intervall bereit. Wenn beispielsweise ein Intervall von 2.000 ms angefordert wird, das System aber nur Daten mit maximal 1.000 ms liefern kann, wird 1.000 ms ausgewählt.
Wenn Sie die Beobachtung einer Quelle beenden möchten, verwenden Sie die Methode unobserve(), wie im folgenden Beispiel gezeigt:
observer.unobserve('cpu');
Wenn Sie die Beobachtung aller Quellen gleichzeitig aufheben möchten, verwenden Sie die Methode disconnect(), wie im folgenden Beispiel gezeigt:
observer.disconnect();
Druckdaten abrufen
Druckdatensätze können mit einer Rückruffunktion abgerufen werden, die jedes Mal aufgerufen wird, wenn sich der Druckstatus ändert.
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);
await observer.observe('cpu', { sampleInterval: 1_000 });
Der Nutzer kann das Lesen von PressureRecord auch erzwingen, indem er die Methode takeRecords() aufruft.
Die takeRecords()-Methode der PressureObserver-Schnittstelle gibt ein Array von PressureRecords-Objekten zurück, die im Druckbeobachter gespeichert sind, und leert ihn.
Der häufigste Anwendungsfall hierfür ist das sofortige Abrufen aller ausstehenden Druckdatensätze, die noch nicht von der Callback-Funktion des Beobachters verarbeitet wurden, bevor die Verbindung zum Beobachter getrennt wird. So können alle ausstehenden Datensätze beim Herunterfahren des Beobachters verarbeitet werden.
Durch das Aufrufen 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. */
});
await observer.observe('cpu', { sampleInterval: 1_000 });
setTimeout(() => {
// Forced records reading.
const records = observer.takeRecords();
observer.disconnect();
// Do something with last records if any.
}, 2000);
Feedback geben
Funktioniert die API nicht wie erwartet? Fehlt bei der Nutzung der API eine Methode oder ein Attribut? Reichen Sie ein Spezifikationsproblem ein oder kommentieren Sie ein vorhandenes im entsprechenden GitHub-Repository.
Problem mit der Implementierung melden
Haben Sie einen Fehler in der Chromium-Implementierung gefunden? Oder unterscheidet sich die Implementierung von der Spezifikation? Melden Sie den Fehler unter new.crbug.com. Gehen Sie so detailliert wie möglich vor, geben Sie eine Anleitung zur Reproduktion an und geben Sie im Feld Components (Komponenten) Blink> PerformanceAPIs> ComputePressure ein.