Meluncurkan Handler API

Kontrol cara aplikasi Anda diluncurkan.

Thomas Steiner

Dengan Launch Handler API, Anda dapat mengontrol cara peluncuran aplikasi, misalnya, apakah aplikasi menggunakan jendela yang sudah ada atau jendela baru, dan apakah jendela yang dipilih dibuka ke URL peluncuran. Sama seperti File Handing API, metode ini juga mengantrekan objek LaunchParams di window.launchQueue halaman yang diluncurkan.

Status saat ini

Langkah Status
1. Buat penjelasan Selesai
2. Membuat draf awal spesifikasi Selesai
3. Mengumpulkan masukan & mengulangi desain Selesai
4. Uji coba origin. Selesai
5. Peluncuran Selesai

Menggunakan Launch Handler API

Dukungan browser

Launch Handler hanya tersedia di ChromeOS.

Dukungan Browser

  • 110
  • 110
  • x
  • x

Sumber

Antarmuka

Launch Handler API menentukan dua antarmuka baru.

LaunchParams : Objek yang berisi targetURL yang akan ditangani oleh konsumen. LaunchQueue : Antrean akan diluncurkan hingga ditangani oleh konsumen yang ditentukan.

Anggota manifes launch_handler

Untuk menentukan perilaku peluncuran aplikasi Anda secara deklaratif, tambahkan anggota manifes launch_handler ke manifes Anda. Kolom ini memiliki satu sub-kolom yang disebut client_mode. API ini memungkinkan Anda mengontrol apakah klien baru atau yang sudah ada harus diluncurkan, dan apakah klien ini harus dibuka. Contoh di bawah ini menunjukkan file dengan nilai contoh yang selalu mengarahkan semua peluncuran ke klien baru.

{
  "launch_handler": {
    "client_mode": "navigate-new"
  }
}

Jika tidak ditentukan, launch_handler akan ditetapkan secara default ke {"client_mode": "auto"}. Nilai yang diizinkan untuk sub-kolom adalah:

  • client_mode:
    • navigate-new: Konteks penjelajahan baru dibuat di jendela aplikasi web untuk memuat URL target peluncuran.
    • navigate-existing: Interaksi terakhir dengan konteks penjelajahan di jendela aplikasi web dibuka ke URL target peluncuran.
    • focus-existing: Interaksi terakhir dengan konteks penjelajahan di jendela aplikasi web dipilih untuk menangani peluncuran. Objek LaunchParams baru dengan targetURL yang ditetapkan ke URL peluncuran akan diantrekan di window.launchQueue dokumen.
    • auto: Perilaku bergantung pada agen pengguna untuk memutuskan apa yang paling cocok untuk platform tersebut. Misalnya, perangkat seluler hanya mendukung klien tunggal dan akan menggunakan existing-client, sedangkan perangkat desktop mendukung beberapa jendela dan akan menggunakan navigate-new untuk menghindari kehilangan data.

Properti client_mode juga menerima daftar (array) nilai, tempat nilai pertama yang valid akan digunakan. Hal ini memungkinkan nilai baru ditambahkan ke spesifikasi tanpa melanggar kompatibilitas mundur dengan implementasi yang ada.

Misalnya, jika nilai hipotesis "focus-matching-url" ditambahkan, situs akan menentukan "client_mode": ["focus-matching-url", "navigate-existing"] untuk terus mengontrol perilaku browser lama yang tidak mendukung "focus-matching-url".

Menggunakan window.launchQueue

Dalam kode berikut, fungsi extractSongID() mengekstrak songID dari URL yang diteruskan saat peluncuran. Aplikasi ini digunakan untuk memutar lagu di PWA pemutar musik.

if ('launchQueue' in window) {
  launchQueue.setConsumer((launchParams) => {
    if (launchParams.targetURL) {
      const songID = extractSongId(launchParams.targetURL);
      if (songID) {
        playSong(songID);
      }
    }
  });
}

Demo

Anda dapat melihat demo Launch Handler API dalam Demo Pengendali Peluncuran PWA. Pastikan untuk memeriksa kode sumber aplikasi untuk melihat cara aplikasi menggunakan Launch Handler API.

  1. Instal aplikasi Musicr 2.0 di perangkat ChromeOS.
  2. Kirimkan link ke diri sendiri di aplikasi chat formulir https://launch-handler.glitch.me?track=https://example.com/music.mp3. (Anda dapat menyesuaikan https://example.com/music.mp3 untuk URL apa pun yang mengarah ke file audio, misalnya, https://launch-handler.glitch.me?track=https://cdn.glitch.me/3e952c9c-4d6d-4de4-9873-23cf976b422e%2Ffile_example_MP3_700KB.mp3?v=1638795977190).
  3. Klik link di aplikasi chat dan perhatikan cara Musicr 2.0 membuka dan memutar lagu.
  4. Klik lagi link di aplikasi chat dan perhatikan bahwa Anda tidak akan mendapatkan instance kedua Musicr 2.0.

Masukan

Tim Chromium ingin mengetahui pengalaman Anda saat menggunakan Launch Handler API.

Beri tahu kami tentang desain API

Apakah ada sesuatu terkait API yang tidak berfungsi seperti yang Anda harapkan? Atau apakah ada metode atau properti yang hilang yang diperlukan untuk menerapkan ide Anda? Ada pertanyaan atau komentar tentang model keamanan? Ajukan masalah spesifikasi di repo GitHub yang sesuai, atau tambahkan pendapat Anda ke masalah yang sudah ada.

Laporkan masalah terkait penerapan

Apakah Anda menemukan bug pada implementasi Chromium? Atau apakah implementasinya berbeda dengan spesifikasi? Laporkan bug di new.crbug.com. Pastikan untuk menyertakan detail sebanyak mungkin, petunjuk sederhana untuk mereproduksi, dan masukkan Blink>AppManifest di kotak Components. Glitch sangat cocok untuk membagikan repro dengan cepat dan mudah.

Menunjukkan dukungan untuk API

Apakah Anda berencana menggunakan Launch Handler API? Dukungan publik Anda membantu tim Chromium memprioritaskan fitur dan menunjukkan kepada vendor browser lain betapa pentingnya mendukung mereka.

Kirim tweet ke @ChromiumDev menggunakan hashtag #LaunchHandler dan beri tahu kami tempat dan cara Anda menggunakannya.

Link bermanfaat