Chế độ hình trong hình tự động cho ứng dụng web hội nghị truyền hình

François Beaufort
François Beaufort

Với bản phát hành gần đây của API Hình trong hình tài liệu (và thậm chí là trước đó), các nhà phát triển web ngày càng quan tâm đến việc có thể tự động mở cửa sổ hình trong hình khi người dùng chuyển tiêu điểm khỏi thẻ hiện tại. Tính năng này đặc biệt hữu ích cho các ứng dụng web hội nghị truyền hình, cho phép người trình bày nhìn thấy và tương tác với người tham gia theo thời gian thực trong khi trình bày tài liệu hoặc sử dụng các thẻ hoặc cửa sổ khác.

Cửa sổ hình trong hình tự động mở và đóng khi người dùng chuyển đổi thẻ.

Tự động chuyển sang chế độ hình trong hình

Để hỗ trợ các trường hợp sử dụng hội nghị truyền hình này, kể từ Chrome 120, các ứng dụng web dành cho máy tính có thể tự động chuyển sang chế độ hình trong hình, kèm theo một số quy định hạn chế để đảm bảo trải nghiệm tích cực cho người dùng. Một ứng dụng web chỉ đủ điều kiện sử dụng chế độ hình trong hình tự động nếu đáp ứng tất cả các điều kiện sau:

  • Ứng dụng đã đăng ký một trình xử lý hành động trong phiên phát nội dung nghe nhìn cho hành động "enterpictureinpicture".

  • Trang này đang chủ động ghi lại camera hoặc micrô bằng getUserMedia.

  • Người dùng cho phép "chế độ hình trong hình tự động" thông qua một chế độ cài đặt của trình duyệt được bật theo mặc định.

Chế độ cài đặt hình trong hình tự động trong ngăn thông tin trang web của trình duyệt Chrome.
Chế độ cài đặt hình trong hình tự động trong ngăn thông tin trang web của trình duyệt Chrome.

Khi một ứng dụng web đủ điều kiện, hàm callback của trình xử lý hành động trong phiên phát nội dung nghe nhìn cho hành động "enterpictureinpicture" sẽ được kích hoạt khi người dùng chuyển tiêu điểm sang một thẻ khác, cho phép ứng dụng mở cửa sổ hình trong hình mà không cần cử chỉ của người dùng.

Nhà phát triển web có thể sử dụng API Hình trong hình cho <video> để mở cửa sổ hình trong hình từ phần tử <video> HTML hoặc API Hình trong hình cho tài liệu để mở cửa sổ luôn ở trên cùng nhằm điền nội dung HTML tuỳ ý. Cửa sổ hình trong hình không được lấy tiêu điểm khi mở và tự động đóng khi chế độ hiển thị của trang trở lại trạng thái hiển thị.

Ví dụ sau đây cho bạn biết cách yêu cầu quyền truy cập vào camera của người dùng. Sau đó, hãy đăng ký một cách an toàn trình xử lý hành động của phiên phát nội dung nghe nhìn cho hành động "enterpictureinpicture" bằng một hàm callback mở cửa sổ hình trong hình. Cửa sổ này chứa luồng video từ camera của người dùng thông qua API Hình trong hình cho <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.");
}

Hãy thử mẫu Phiên nghe nhìn hội nghị truyền hình.

Chuyển sang chế độ hình trong hình bằng nút điều khiển nội dung nghe nhìn của trình duyệt

Thao tác phiên phát nội dung nghe nhìn "enterpictureinpicture" cũng hữu ích khi người dùng muốn chuyển sang chế độ hình trong hình bằng cách sử dụng nút điều khiển nội dung nghe nhìn trong giao diện người dùng của trình duyệt Chrome.

Các nút điều khiển nội dung nghe nhìn trong trình duyệt Chrome, với con trỏ trên nút điều khiển hình trong hình của người dùng.
Các nút điều khiển nội dung nghe nhìn trong trình duyệt Chrome, với con trỏ trên nút điều khiển hình trong hình của người dùng.

Khi không có phần tử <video> HTML nào đang phát mà chỉ có âm thanh, việc đăng ký trình xử lý hành động của phiên phát nội dung nghe nhìn cho "enterpictureinpicture" sẽ cho trình duyệt biết rằng ứng dụng web biết cách xử lý và sẽ tự mở cửa sổ hình trong hình.

Tính năng này cũng hữu ích khi ứng dụng web muốn sử dụng Document Picture-in-Picture API để mở cửa sổ hình trong hình thay vì để trình duyệt xử lý bằng Picture-in-Picture API cho <video>.

Ví dụ sau đây minh hoạ cách đăng ký một cách an toàn trình xử lý hành động của phiên phát nội dung đa phương tiện cho hành động "enterpictureinpicture". Hàm callback sẽ mở một cửa sổ hình trong hình bằng Document Picture-in-Picture API khi người dùng chuyển sang chế độ hình trong hình bằng nút điều khiển nội dung nghe nhìn trong giao diện người dùng của trình duyệt Chrome.

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.");
}

Hãy thử bản minh hoạ trình phát VideoJS của API Hình trong hình cho tài liệu hoặc mẫu Phiên phát nội dung nghe nhìn dạng video.

Tương tác và chia sẻ ý kiến phản hồi

Nếu có ý kiến phản hồi hoặc gặp vấn đề, bạn có thể chia sẻ tại crbug.com.

Tài nguyên

Lời cảm ơn

Cảm ơn Tommy Steimel, Ryan Flores, Shimi Rahim, Frank Liberato và Rachel Andrew đã đánh giá.