تصویردرتصویر خودکار برای برنامه‌های وب کنفرانس ویدیویی

François Beaufort
François Beaufort

با معرفی اخیر Document Picture-in-Picture API (و حتی قبل‌از آن)، توسعه‌دهندگان وب به‌طور فزاینده‌ای علاقه‌مند هستند که بتوانند به‌طور خودکار پنجره تصویردرتصویر را وقتی کاربر تمرکز را از برگه فعلی خود تغییر می‌دهد، باز کنند. این ویژگی به‌ویژه برای برنامه‌های وب کنفرانس ویدیویی مفید است، زیرا به ارائه‌دهندگان امکان می‌دهد درحین ارائه سند یا استفاده از برگه‌ها یا پنجره‌های دیگر، شرکت‌کنندگان را در زمان واقعی ببینند و با آن‌ها تعامل داشته باشند.

وقتی کاربر زبانه‌ها را عوض می‌کند، پنجره تصویردرتصویر به‌طور خودکار باز و بسته می‌شود.

ورود خودکار به حالت تصویر در تصویر

برای پشتیبانی از این موارد استفاده از کنفرانس ویدیویی، از Chrome 120، برنامه‌های وب رایانه می‌توانند به‌طور خودکار وارد تصویردرتصویر شوند، با چند محدودیت برای اطمینان از تجربه کاربری مثبت. برنامه وب فقط درصورتی واجدشرایط تصویر در تصویر خودکار است که همه شرایط زیر را داشته باشد:

  • این برنامه یک گرداننده کنش جلسه رسانه برای کنش "enterpictureinpicture" ثبت کرده است.

  • بااستفاده از getUserMedia، به‌طور فعال درحال ضبط دوربین یا میکروفون است.

  • کاربر ازطریق تنظیمات مرورگر که به‌طور پیش‌فرض فعال است، اجازه «تصویردرتصویر خودکار» را می‌دهد.

تنظیم تصویردرتصویر خودکار در قاب اطلاعات سایت مرورگر Chrome.
تنظیم «تصویردرتصویر خودکار» در پانل اطلاعات سایت مرورگر Chrome.

وقتی برنامه وب واجدشرایط باشد، تابع بازخوانی گرداننده کنش جلسه رسانه برای کنش "enterpictureinpicture" زمانی فعال می‌شود که کاربر تمرکز را به زبانه دیگری تغییر دهد، که به آن اجازه می‌دهد پنجره تصویردرتصویر را بدون اشاره کاربر باز کند.

توسعه‌دهندگان وب می‌توانند از Picture-in-Picture API for <video> برای باز کردن پنجره تصویردرتصویر از عنصر HTML <video> یا از Document Picture-in-Picture API برای باز کردن پنجره‌ای که همیشه در بالا قرار دارد و پر کردن آن با محتوای HTML دلخواه استفاده کنند. پنجره تصویردرتصویر هنگام باز شدن فوکوس نمی‌شود و وقتی نمایان بودن صفحه دوباره نمایان می‌شود، به‌طور خودکار بسته می‌شود.

مثال زیر نحوه درخواست دسترسی به دوربین کاربر را نشان می‌دهد. سپس، به‌طور ایمن یک گرداننده کنش جلسه رسانه برای کنش "enterpictureinpicture" با تابع بازخوانی که پنجره تصویردرتصویر را باز می‌کند ثبت کنید. این پنجره حاوی جاری‌سازی ویدیویی دوربین کاربر با Picture-in-Picture API برای <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.");
}

نمونه جلسه رسانه کنفرانس ویدیویی را امتحان کنید.

ورود به تصویردرتصویر از کنترل رسانه مرورگر

کنش جلسه رسانه "enterpictureinpicture" همچنین زمانی مفید است که کاربر بخواهد بااستفاده از کنترل رسانه در میانای کاربر مرورگر Chrome وارد تصویردرتصویر شود.

کنترل رسانه در مرورگر Chrome، با مکان‌نما روی کنترل کاربر تصویردرتصویر.
کنترل رسانه در مرورگر Chrome، با مکان‌نما روی کنترل کاربر تصویردرتصویر.

وقتی عنصر HTML <video> درحال پخش نیست و فقط صدا پخش می‌شود، ثبت کردن گرداننده کنش جلسه رسانه برای "enterpictureinpicture" به مرورگر می‌گوید که برنامه وب می‌داند چگونه آن را مدیریت کند و خودش باز کردن پنجره تصویردرتصویر را برعهده می‌گیرد.

همچنین زمانی مفید است که برنامه وب بخواهد از Document Picture-in-Picture API برای باز کردن پنجره تصویردرتصویر استفاده کند، به‌جای اینکه به مرورگر اجازه دهد آن را با Picture-in-Picture API برای <video> مدیریت کند.

مثال زیر نشان می‌دهد که چگونه می‌توان به‌طور ایمن یک گرداننده کنش جلسه رسانه را برای کنش "enterpictureinpicture" ثبت کرد. وقتی کاربر بااستفاده از کنترل رسانه در میانای کاربری مرورگر Chrome وارد حالت تصویردرتصویر می‌شود، تابع بازخوانی بااستفاده از Document Picture-in-Picture API پنجره تصویردرتصویر را باز می‌کند.

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

نمونه پخش‌کننده VideoJS در Document Picture-in-Picture API یا نمونه Video Media Session را امتحان کنید.

تعامل و هم‌رسانی بازخورد

اگر بازخوردی دارید یا با مشکلی مواجه شدید، می‌توانید آن را در crbug.com هم‌رسانی کنید.

منابع

سپاس‌گزاری

از تامی استایمل، رایان فلورس، شمی رحیم، فرانک لیبراتو، و ریچل اندرو برای مرورهایشان سپاس‌گزاریم.