Sinds de recente introductie van de Document Picture-in-Picture API (en zelfs daarvoor) zijn webontwikkelaars steeds meer geïnteresseerd in de mogelijkheid om automatisch een scherm-in-scherm-venster te openen als de gebruiker de focus verlegt van het huidige tabblad. Dit is vooral handig voor web-apps voor videovergaderingen, omdat presentatoren zo in realtime deelnemers kunnen zien en met ze kunnen communiceren terwijl ze een document presenteren of andere tabbladen of vensters gebruiken.
Automatisch scherm-in-scherm openen
Vanaf Chrome 120 kunnen web-apps voor desktops automatisch scherm-in-scherm openen om deze use cases voor videovergaderingen te ondersteunen. Er gelden wel een paar beperkingen om een positieve gebruikerservaring te garanderen. Een web-app komt alleen in aanmerking voor automatisch scherm-in-scherm als deze aan alle volgende voorwaarden voldoet:
Er is een handler voor mediasessieacties geregistreerd voor de actie
"enterpictureinpicture".De app legt actief de camera of microfoon vast met getUserMedia.
De gebruiker staat automatisch scherm-in-scherm toe via een browserinstelling die standaard aanstaat.
Als een web-app in aanmerking komt, wordt de callbackfunctie van de actiehandler voor mediasessies voor de actie "enterpictureinpicture" geactiveerd als de gebruiker de focus naar een ander tabblad verplaatst. De web-app kan dan een scherm-in-scherm-venster openen zonder gebruikersactivatie.
Webontwikkelaars kunnen de Picture-in-Picture API voor <video> gebruiken om een scherm-in-scherm-venster te openen vanuit een HTML-element <video> of de Document Picture-in-Picture API om een venster te openen dat altijd op de voorgrond staat en dat kan worden gevuld met willekeurige HTML-content. Het scherm-in-scherm-venster is niet gefocust wanneer het wordt geopend en wordt automatisch gesloten wanneer de pagina weer zichtbaar wordt.
In het volgende voorbeeld zie je hoe je toegang tot de camera van de gebruiker vraagt. Registreer daarna op een veilige manier een actiehandler voor mediasessies voor de actie "enterpictureinpicture" met een callbackfunctie die een scherm-in-scherm-venster opent. Dit venster bevat de videostream van de camera van de gebruiker met de scherm-in-scherm API voor <video>.
const video = document.querySelector("video");
// Request access to the user's camera.
navigator.mediaDevices.getUserMedia({ video: true }).then((stream) => {
video.srcObject = stream;
});
try {
// Request video to automatically enter picture-in-picture when eligible.
navigator.mediaSession.setActionHandler("enterpictureinpicture", () => {
video.requestPictureInPicture();
});
} catch (error) {
console.log("The enterpictureinpicture action is not yet supported.");
}
Probeer het voorbeeld Mediasessie voor videovergaderingen.
Scherm-in-scherm openen via de mediabediening van de browser
De mediasessieactie "enterpictureinpicture" is ook handig als de gebruiker scherm-in-scherm wil openen via de mediabediening in de UI van de Chrome-browser.
Als er geen HTML-element <video> wordt afgespeeld maar alleen audio, laat je de browser weten dat de web-app weet hoe die hiermee moet omgaan en zelf een scherm-in-scherm-venster opent door de actiehandler voor mediasessies voor "enterpictureinpicture" te registreren.
Dit is ook handig als de web-app de Document Picture-in-Picture API wil gebruiken om een scherm-in-scherm-venster te openen in plaats van de browser dit te laten afhandelen met de Picture-in-Picture API voor <video>.
In het volgende voorbeeld zie je hoe je op een veilige manier een actiehandler voor mediasessies registreert voor de actie "enterpictureinpicture". De callbackfunctie opent een scherm-in-schermvenster met de Document Picture-in-Picture API als de gebruiker scherm-in-scherm opent via de mediabediening in de UI van de Chrome-browser.
try {
// Use the Document Picture-in-Picture API when entering
// picture-in-picture from browser media control.
navigator.mediaSession.setActionHandler("enterpictureinpicture", async () => {
const pipWindow = await documentPictureInPicture.requestWindow();
// Populate HTML content and handle closing window...
});
} catch (error) {
console.log("The enterpictureinpicture action is not yet supported.");
}
Probeer de demo van de Document scherm-in-scherm API VideoJS-speler of het voorbeeld van de videosessie.
Betrokkenheid en feedback delen
Als je feedback hebt of problemen tegenkomt, kun je deze delen op crbug.com.
Bronnen
Erkenning
Met dank aan Tommy Steimel, Ryan Flores, Shimi Rahim, Frank Liberato en Rachel Andrew voor hun reviews.