HTMLVideoElement.requestPictureInPicture()
HTMLVideoElement 接口提供的 requestPictureInPicture() 方法会发出异步请求,并以画中画的模式显示视频。
该方法不能保证视频进入画中画。如果授予了进入画中画的权限,则将返回一个 Promise,最终完成后将收到一个 enterpictureinpicture 事件,来表示它现在处于画中画状态。
语法
js
requestPictureInPicture()
返回值
PictureInPictureWindow 对象将由 Promise 最终完成后获得。可以用于监听用户何时调整该浮动窗口的大小。
示例
本示例请求视频进入画中画模式,并设置事件监听以处理窗口大小的调整。
js
function enterPictureInPicture() {
videoElement.requestPictureInPicture()
.then(pictureInPictureWindow => {
pictureInPictureWindow.addEventListener("resize", () => onPipWindowResize(), false);
})
}
规范
| Specification |
|---|
| Picture-in-Picture # request-pip |
浏览器兼容性
BCD tables only load in the browser