Tuesday, 14 April, 2020 UTC

JavaScript Picture-in-Picture API

JavaScript Picture-in-Picture API

Summary

As a huge fan of media on the web, I’m always excited about enhancements to how we can control our media. Maybe I get excited about simple things like the <video> tag and its associated elements and attributes because media on the web started with custom codecs, browser extensions, and Flash. The latest awesome media feature I’m excited about on the web is Picture-in-Picture, a native web API that displays docked video. Let’s have a look at how it works!
View Demo
Benefits of Picture-in-Picture
Before using Picture-in-Picture, it’s important to know why to use it and the benefits you get:
  • No need to create your own docked video element when the user scrolls — the browser does it for you!
  • Big performance, usability, and maintenance win
  • The docked video displays above all tabs in your browser, not just the tab it was launched in
  • Stays in PiP mode until you change pages
Detect Picture-in-Picture Support
Before using any API it’s best to ensure the feature is supported and enabled; for that the browser exposes document.pictureInPictureEnabled, as well as a per-video attribute:
if(
    document.pictureInPictureEnabled && 
    !videoElement.disablePictureInPicture
) {
    // Yay, we can use the feature!
}
With the browser supporting the API, it’s time to get started!
Launching Picture-In-Picture
Before launching into picture-in-picture, it’s important to first check that we aren’t already in PiP:
if(!document.pictureInPictureElement) {
    videoElement.requestPictureInPicture();
}
Once we confirm that PiP isn’t being used, we can launch PiP by calling requestPictureInPicture() on the HTMLVideoElement.
Exiting Picture-in-Picture
To exit Picture-in-Picture mode, you can call exitPictureInPicture():
document.exitPictureInPicture();
The PiP window will be removed from the bottom of your browser.
Safe Picture-in-Picture Function
Bringing together the code samples provided, we can put together a safe Picture-in-Picture utility function:
function enterPictureInPicture(videoElement) {
    if(
        document.pictureInPictureEnabled && 
        !videoElement.disablePictureInPicture) {
            try {
                if (document.pictureInPictureElement) {
                    document.exitPictureInPicture();
                }
                videoElement.requestPictureInPicture();
            } catch(err) {
                console.error(err);
            }
    }
}
This function can safely put your video into Picture-in-Picture while protecting you from errors or videos already PiP.
Picture-in-Picture Events
Along with the functionality to enter and exit Picture-in-Picture, a set of JavaScript events are emitted during each step:
  • enterpictureinpicture: fired on the HTMLVideoElement that was placed into Picture-in-Picture
  • leavepictureinpicture: fired on the HTMLVideoElement for which PiP was exited
Here’s a quick example of each:
$("#myVideo").addEventListener("enterpictureinpicture", e => {
    // Entered PiP!
});

$("#myVideo").addEventListener("leavepictureinpicture", e => {
    // Exited PiP!
});
View Demo
Picture-in-Picture mode is an amazing API to allow users to consume video content as they explore other tabs or simply navigate within your page. Coupled with the scroll event or even with Intersection Observer API, Picture-in-Picture is a powerful feature your users will love!
The post JavaScript Picture-in-Picture API appeared first on David Walsh Blog.

... more @ davidwalsh.name

davidwalsh.name