Komputasi Tekanan API

Dapatkan informasi tentang tekanan komputasi sistem Anda.

Kenneth Christiansen
Kenneth Christiansen
Arnaud (Arno) Mandy

Compute Pressure API menawarkan status level tinggi yang mewakili tekanan pada sistem. Solusi ini memungkinkan implementasi untuk menggunakan metrik hardware dasar yang tepat untuk memastikan pengguna dapat memanfaatkan semua daya pemrosesan yang tersedia selama sistem tidak berada dalam tekanan yang tidak terkendali.

Status saat ini

Langkah Status
1. Buat pesan penjelasan Selesai
2. Membuat draf awal spesifikasi Selesai
3. Mengumpulkan masukan & mengulangi desain Dalam proses
4. Uji coba origin Selesai
5. Peluncuran Selesai (Chrome 125)

Mencoba Compute Pressure API

Untuk bereksperimen dengan Compute Pressure API secara lokal, baca halaman ini.

Mendaftar ke uji coba origin

Mulai Chrome 115, Compute Pressure API tersedia sebagai uji coba origin. Update ini diperkirakan akan berakhir di Chrome 123 (29 Mei 2024). Daftar ke uji coba origin.

Kasus penggunaan

Kasus penggunaan utama yang ditingkatkan oleh Compute Pressure API saat ini adalah konferensi video dan video game.

Aplikasi real-time populer ini diklasifikasikan sebagai soft. Artinya, kualitas layanan akan menurun jika sistem dijalankan di luar status tertentu, tetapi tidak menyebabkan kegagalan sistem total. Aplikasi soft real-time ini sangat diuntungkan karena dapat menyesuaikan workload berdasarkan konsumsi atau tekanan CPU.

Secara khusus, versi pertama API ini bertujuan untuk memungkinkan keputusan adaptasi berikut.

Konferensi video

  • Sesuaikan jumlah feed video yang ditampilkan secara bersamaan selama panggilan dengan banyak peserta.
  • Mengurangi kualitas pemrosesan video (resolusi video, frame per detik).
  • Lewati pemrosesan video yang tidak penting, seperti beberapa filter kamera.
  • Nonaktifkan pemrosesan audio yang tidak penting, seperti peredam bising WebRTC.
  • Ubah tombol kualitas, kecepatan, dan kecepatan ke arah "kecepatan" dalam encoding video dan audio (di WebRTC, WebCodecs, atau encoding software).

Game video

  • Gunakan aset berkualitas lebih rendah untuk menyusun video game (model 3D, tekstur, shader) dan audio (suara, efek suara).
  • Nonaktifkan efek yang menghasilkan detail yang kurang realistis (air, kain, animasi api, luminans kulit, efek silau, atau simulasi fisik yang tidak memengaruhi gameplay).
  • Sesuaikan tombol kecepatan dengan kualitas vs. kecepatan di mesin rendering game (kualitas bayangan, pemfilteran tekstur, jarak tampilan).

Secara teknis, hal ini dapat dicapai dengan mengetahui termal (misalnya, apakah sistem didinginkan secara pasif) dan status tekanan CPU untuk thread utama dan pekerja yang digunakan situs. Status termal sistem adalah status global dan dapat dipengaruhi oleh aplikasi dan situs selain situs yang mengamati.

Antarmuka

Compute Pressure API dapat dijalankan dalam konteks berikut:

  • Jendela atau thread utama
  • Pekerja Khusus
  • Pekerja Bersama

Compute Pressure API menentukan dua antarmuka baru.

PressureObserver: Objek untuk mengamati tekanan komputasi sejumlah sumber pada interval sampel yang telah ditentukan. Iterasi pertama di Chromium mengekspos "cpu" sebagai source. Lihat bagian tentang parameter untuk mengetahui detail selengkapnya. Setiap observer dapat secara asinkron mengamati tren perubahan tekanan dalam sistem.

PressureRecord: Menjelaskan tren tekanan pada momen transisi tertentu. Objek jenis ini hanya dapat diperoleh dengan dua cara: sebagai input untuk callback PressureObserver Anda, atau dengan memanggil metode takeRecords() pada instance PressureObserver.

PressureObserver

Saat dibuat, objek PressureObserver akan dikonfigurasi untuk mengamati tekanan sumber yang didukung, pada interval sampel tertentu. Sumber yang didukung dapat diamati satu per satu atau tidak diamati kapan saja selama masa aktif objek PressureObserver. Interval sampel tidak dapat diubah setelah objek dibuat.

Konstruktor

PressureObserver(callback): Membuat objek PressureObserver baru yang akan memanggil fungsi callback yang ditentukan saat mendeteksi bahwa perubahan nilai sumber yang diamati telah terjadi.

Konstruktor menggunakan fungsi callback wajib.

Telepon Balik

callback(): Callback dipanggil dengan array objek PressureRecord yang belum dibaca.

Metode

PressureObserver.observe(source, options): Memberi tahu 'PressureObserver' sumber mana yang akan diamati dan options opsional, sebagai parameter.

Opsi

PressureObserverOptions: Berisi interval sampel, sampleInterval dalam milidetik, saat pengguna meminta update.

PressureObserver.unobserve(source): Memberi tahu 'PressureObserver' untuk berhenti mengamati sebuah sumber.

PressureObserver.disconnect(): Memberi tahu 'PressureObserver' untuk berhenti mengamati semua sumber.

PressureObserver.takeRecords(): Menampilkan urutan data, sejak pemanggilan callback terakhir.

static PressureObserver.knownSources() (hanya baca): Menampilkan jenis sumber yang diketahui milik agen pengguna dalam urutan abjad.

Parameter

source: Sumber yang akan diamati, misalnya "cpu". Ini harus berupa salah satu jenis sumber yang didukung.

Dalam versi Compute Pressure saat ini, hanya "cpu" yang didukung.

PressureRecord

Antarmuka PressureRecord Compute Pressure API menjelaskan tren tekanan sumber pada momen transisi tertentu.

Properti Instance

PressureRecord.source (Hanya baca): Menampilkan string yang mewakili sumber asal tempat data berasal.

PressureRecord.state (Hanya baca): Menampilkan string yang mewakili status tekanan yang direkam.

PressureRecord.time (Hanya baca): Menampilkan angka yang mewakili stempel waktu resolusi tinggi.

Contoh

Bagian berikut mencantumkan contoh penggunaan contoh.

Menentukan dukungan API

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

Membuat observer tekanan

Buat observer tekanan dengan memanggil konstruktornya beserta fungsi callback yang akan dijalankan setiap kali ada pembaruan tekanan:

const observer = new PressureObserver((records) => {
  /* ... */
});

Penggunaan observer tekanan

Hanya ada satu cara untuk memulai pengamat tekanan. Untuk setiap sumber, panggil observer.observe(source).

observer.observe("cpu" { sampleInterval: 2_000 });

Dalam contoh ini, "cpu" adalah sumber tekanan yang kita minati. Untuk sekarang, ini adalah satu-satunya sumber yang tersedia. Pada masa mendatang, mungkin ada sumber lain seperti "gpu", "power", atau "thermals".

Interval sampel, sampleInterval, sebesar 2000 md, berarti akan ada pembaruan maksimal setiap dua detik.

Jika interval sampel yang diminta tidak dapat dilayani oleh sistem, sistem akan memberikan sampel pada interval yang paling sesuai yang ada. Misalnya, jika interval 2.000 md diminta, tetapi sistem hanya dapat memberikan sampel pada waktu maksimum 1.000 md, maka 1.000 md akan dipilih.

Untuk berhenti mengamati sumber, gunakan metode unobserve(), seperti pada contoh berikut:

observer.unobserve('cpu');

Untuk tidak mengamati semua sumber sekaligus, gunakan metode disconnect(), seperti dalam contoh berikut:

observer.disconnect();

Mengambil catatan tekanan

Catatan tekanan dapat diambil dengan fungsi callback, yang akan dipanggil setiap kali perubahan terjadi dalam status tekanan.

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 });

Pengguna juga dapat memaksa pembacaan PressureRecord dengan memanggil metode takeRecords().

Metode takeRecords() dari antarmuka PressureObserver menampilkan array objek PressureRecords yang disimpan dalam observer tekanan, yang mengosongkannya.

Kasus penggunaan yang paling umum untuk hal ini adalah segera mengambil semua rekaman tekanan yang tertunda, yang belum diproses oleh fungsi callback observer, sebelum memutuskan hubungan observer, sehingga setiap kumpulan data yang tertunda dapat diproses saat mematikan observer.

Memanggil metode ini akan menghapus daftar data yang tertunda, sehingga callback tidak akan dijalankan.

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);

Bagikan masukan

Apakah ada sesuatu pada API yang tidak berfungsi seperti yang Anda harapkan? Apakah Anda melihat metode atau properti yang hilang untuk penggunaan API? Laporkan masalah spesifikasi atau komentari yang sudah ada di repo GitHub yang sesuai.

Melaporkan masalah terkait penerapan

Apakah Anda menemukan bug pada implementasi Chromium? Atau apakah implementasinya berbeda dengan spesifikasi? Laporkan bug di new.crbug.com. Pastikan Anda menyertakan detail sebanyak mungkin, petunjuk untuk mereproduksi, dan masukkan Blink>PerformanceAPIs>ComputePressure di kotak Components.

Resource