Kontrol cara aplikasi Anda diluncurkan.
Launch Handler API memungkinkan Anda mengontrol cara peluncuran aplikasi, misalnya, apakah menggunakan
jendela yang ada atau baru dan apakah jendela yang dipilih akan diarahkan ke URL peluncuran. Seperti halnya File Handing API, tindakan ini juga mengantrekan objek LaunchParams
di window.launchQueue
halaman yang diluncurkan.
Status saat ini
Langkah | Status |
---|---|
1. Buat penjelasan | Selesai |
2. Buat draf awal spesifikasi | Selesai |
3. Mengumpulkan masukan & melakukan iterasi desain | Selesai |
4. Uji coba origin. | Selesai |
5. Peluncuran | Selesai |
Menggunakan Launch Handler API
Dukungan browser
Launch Handler hanya tersedia di ChromeOS.
Antarmuka
Launch Handler API menentukan dua antarmuka baru.
LaunchParams
: Objek yang berisi targetURL
yang akan ditangani oleh konsumen.
LaunchQueue
: Antrean diluncurkan sampai 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
. Ini memungkinkan Anda mengontrol apakah klien baru atau yang sudah ada harus diluncurkan, dan apakah klien ini harus dibuka. Contoh di bawah menunjukkan file dengan nilai contoh yang akan 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
: Bagian yang terakhir berinteraksi dengan konteks penjelajahan di jendela aplikasi web dibuka ke URL target peluncuran.focus-existing
: Yang terakhir berinteraksi dengan konteks penjelajahan di jendela aplikasi web dipilih untuk menangani peluncuran. ObjekLaunchParams
baru dengantargetURL
yang ditetapkan ke URL peluncuran akan diantrekan diwindow.launchQueue
dokumen.auto
: Perilaku bergantung pada agen pengguna untuk menentukan tindakan yang paling tepat untuk platform. Misalnya, perangkat seluler hanya mendukung klien tunggal dan akan menggunakanexisting-client
, sedangkan perangkat desktop mendukung beberapa jendela dan akan menggunakannavigate-new
untuk menghindari kehilangan data.
Properti client_mode
juga menerima daftar (array) nilai, tempat nilai valid pertama akan digunakan. Tindakan ini memungkinkan nilai baru ditambahkan ke spesifikasi tanpa mengganggu 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. File 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 cara kerja Launch Handler API di Demo Pengendali Peluncuran PWA. Pastikan Anda memeriksa kode sumber aplikasi untuk melihat cara aplikasi menggunakan Launch Handler API.
- Instal aplikasi Musicr 2.0 di perangkat ChromeOS.
- Kirim link ke diri Anda sendiri dalam aplikasi chat dengan format
https://launch-handler.glitch.me?track=https://example.com/music.mp3
. (Anda dapat menyesuaikanhttps://example.com/music.mp3
untuk setiap URL 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
). - Klik link di aplikasi chat dan perhatikan cara Musicr 2.0 terbuka dan memutar lagu.
- Klik lagi link di aplikasi chat dan perhatikan bahwa Anda tidak akan mendapatkan instance kedua dari Musicr 2.0.
Masukan
Tim Chromium ingin mengetahui pengalaman Anda menggunakan Launch Handler API.
Beri tahu kami tentang desain API
Apakah ada sesuatu pada API yang tidak berfungsi seperti yang Anda harapkan? Atau apakah ada metode atau properti yang hilang yang diperlukan untuk menerapkan ide Anda? Punya pertanyaan atau komentar tentang model keamanan? Laporkan masalah spesifikasi di repo GitHub yang sesuai, atau tambahkan pendapat Anda ke masalah yang sudah ada.
Melaporkan masalah terkait penerapan
Apakah Anda menemukan bug pada penerapan 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 Komponen.
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 fitur tersebut.
Kirim tweet ke @ChromiumDev menggunakan hashtag
#LaunchHandler
dan
beri tahu kami di mana dan bagaimana Anda menggunakannya.