שליטה בהזזה, בהטיה ובמרחק התצוגה של המצלמה

סוף סוף אפשר לשלוט בתכונות ההזזה, ההטיה ושינוי מרחק התצוגה של המצלמות באינטרנט.

François Beaufort
François Beaufort

בפתרונות לשיחות ועידה בווידאו בקנה מידה של חדר, המצלמות כוללות יכולות של הזזה, הטיה ושינוי מרחק התצוגה (PTZ), כך שהתוכנה יכולה לכוון את המצלמה אל המשתתפים בפגישה. החל מגרסה 87 של Chrome, התכונות של הזזה, הטיה וזום במצלמות זמינות לאתרים שמשתמשים באילוצים של מעקב מדיה ב-MediaDevices.getUserMedia() וב-MediaStreamTrack.applyConstraints().

שימוש ב-API

זיהוי תכונות

זיהוי התכונות של החומרה שונה ממה שאתם רגילים אליו. הנוכחות של שמות האילוצים "pan",‏ "tilt" ו-"zoom" ב-navigator.mediaDevices.getSupportedConstraints() מציינת שהדפדפן תומך ב-API לשליטה ב-PTZ של המצלמה, אבל לא מציינת אם חומרת המצלמה תומכת בו. החל מגרסה 87 של Chrome, יש תמיכה בשליטה על PTZ של המצלמה במחשב, וב-Android עדיין יש תמיכה רק בזום.

const supports = navigator.mediaDevices.getSupportedConstraints();
if (supports.pan && supports.tilt && supports.zoom) {
  // Browser supports camera PTZ.
}

בקשת גישה ל-PTZ של המצלמה

אתר יכול לשלוט ב-PTZ של המצלמה רק אם המשתמש העניק למצלמה הרשאת PTZ באופן מפורש באמצעות בקשה.

כדי לבקש גישה ל-PTZ של המצלמה, צריך להפעיל את navigator.mediaDevices.getUserMedia() עם אילוצי ה-PTZ, כמו שמוצג בהמשך. המשתמש יתבקש לתת הרשאות גישה למצלמה רגילה ולמצלמה עם PTZ.

צילום מסך של בקשת הרשאה למשתמש להזזה, הטיה ושינוי מרחק תצוגה (PTZ) של המצלמה ב-Chrome ל-macOS.
הנחיה למשתמש בנושא הזזה, הטיה ושינוי מרחק התצוגה (PTZ) של המצלמה.

ההבטחה שמוחזרת נפתרת באמצעות אובייקט MediaStream שמשמש להצגת שידור הווידאו מהמצלמה למשתמש. אם המצלמה לא תומכת ב-PTZ, המשתמש מקבל בקשה רגילה לשימוש במצלמה.

try {
  // User is prompted to grant both camera and PTZ access in a single call.
  // If camera doesn't support PTZ, it falls back to a regular camera prompt.
  const stream = await navigator.mediaDevices.getUserMedia({
    // Website asks to control camera PTZ as well without altering the
    // current pan, tilt, and zoom settings.
    video: { pan: true, tilt: true, zoom: true }
  });

  // Show camera video stream to user.
  document.querySelector("video").srcObject = stream;
} catch (error) {
  // User denies prompt or matching media is not available.
  console.log(error);
}

אם הרשאת גישה למצלמה ניתנה בעבר, במיוחד הרשאה ללא גישה ל-PTZ, היא לא מקבלת גישה ל-PTZ באופן אוטומטי אם היא הופכת לזמינה. זה נכון גם אם המצלמה עצמה תומכת ב-PTZ. צריך לבקש את ההרשאה מחדש. למרבה המזל, אתם יכולים להשתמש ב-Permissions API כדי לשלוח שאילתות ולעקוב אחרי הסטטוס של הרשאת PTZ.

try {
  const panTiltZoomPermissionStatus = await navigator.permissions.query({
    name: "camera",
    panTiltZoom: true
  });

  if (panTiltZoomPermissionStatus.state == "granted") {
    // User has granted access to the website to control camera PTZ.
  }

  panTiltZoomPermissionStatus.addEventListener("change", () => {
    // User has changed PTZ permission status.
  });
} catch (error) {
  console.log(error);
}

כדי לדעת אם דפדפן שמבוסס על Chromium תומך ב-PTZ במצלמה, עוברים לדף הפנימי about://media-internals ובודקים את העמודה "הזזה-הטיה-זום" בכרטיסייה "צילום וידאו". המשמעות של "הזזה-הטיה" ו "זום" היא שהמצלמה תומכת באמצעי הבקרה של UVC "הזזה-הטיה (מוחלט)" ו "זום (מוחלט)". הפקדים "הזזה והטיה (יחסי)" ו "זום (יחסי)" של UVC לא נתמכים בדפדפנים שמבוססים על Chromium.

דף פנימי לניפוי באגים ב-ChromeOS.
דף פנימי לניפוי באגים בתמיכה במצלמת PTZ.

שליטה ב-PTZ של המצלמה

משנים את היכולות וההגדרות של ה-PTZ במצלמה באמצעות התצוגה המקדימה MediaStreamTrack מהאובייקט stream שהתקבל קודם. ‫MediaStreamTrack.getCapabilities() מחזירה מילון עם היכולות הנתמכות והטווחים או הערכים המותרים. בהתאם, הפקודה MediaStreamTrack.getSettings() מחזירה את ההגדרות הנוכחיות.

היכולות וההגדרות של הזזה, הטיה ושינוי מרחק התצוגה זמינות רק אם המצלמה תומכת בהן והמשתמש נתן למצלמה הרשאת PTZ.

שליטה ב-PTZ של המצלמה.

קוראים ל-videoTrack.applyConstraints() עם האילוצים המתקדמים של PTZ המתאימים כדי לשלוט בהזזה, בהטיה ובשינוי מרחק התצוגה של המצלמה, כמו שמוצג בדוגמה. ה-promise שמוחזר נפתר אם הפעולה מצליחה. הבקשה תידחה אם:

  • לא ניתנה הרשאת גישה למצלמה עם PTZ.
  • חומרת המצלמה לא תומכת בהגבלת ה-PTZ.
  • הדף לא גלוי למשתמש. משתמשים ב-Page Visibility API כדי לזהות שינויים בחשיפה של הדף.
// Get video track capabilities and settings.
const [videoTrack] = stream.getVideoTracks();
const capabilities = videoTrack.getCapabilities();
const settings = videoTrack.getSettings();

// Let the user control the camera pan motion if the camera supports it
// and PTZ access is granted.
if ("pan" in settings) {
  const input = document.querySelector("input[type=range]");
  input.min = capabilities.pan.min;
  input.max = capabilities.pan.max;
  input.step = capabilities.pan.step;
  input.value = settings.pan;

  input.addEventListener("input", async () => {
    await videoTrack.applyConstraints({ advanced: [{ pan: input.value }] });
  });
}

if ("tilt" in settings) {
  // similar for tilt...
}
if ("zoom" in settings) {
  // similar for zoom...
}

אפשר גם להגדיר את ההזזה, ההטיה ושינוי מרחק התצוגה של המצלמה על ידי קריאה ל-navigator.mediaDevices.getUserMedia() עם ערכי אילוץ אידיאליים של PTZ במצלמה. האפשרות הזו שימושית כשיודעים מראש מהן יכולות ה-PTZ של המצלמה. שימו לב שאי אפשר להשתמש כאן באילוצי חובה (מינימום, מקסימום, מדויק).

const stream = await navigator.mediaDevices.getUserMedia({
  // Website asks to reset known camera pan.
  video: { pan: 0, deviceId: { exact: "myCameraDeviceId" } }
});

מגרש משחקים

אתם יכולים להתנסות ב-API על ידי הפעלת ההדגמה.

שיקולי אבטחה

מחברי המפרט תכננו והטמיעו את ה-API הזה באמצעות הליבה, כולל שליטה של המשתמש, שקיפות וארגונומיה. היכולת להשתמש ב-API הזה מוגבלת בעיקר על ידי אותו מודל הרשאות כמו Media Capture and Streams API. בתגובה להנחיה של המשתמש, לאתר מותר לשלוט ב-PTZ של המצלמה רק כשהדף גלוי למשתמש.

תאימות דפדפן

MediaStream API

Browser Support

  • Chrome: 55.
  • Edge: 12.
  • Firefox: 15.
  • Safari: 11.

Source

Permissions API

Browser Support

  • Chrome: 43.
  • Edge: 79.
  • Firefox: 46.
  • Safari: 16.

Source

Page Visibility API

Browser Support

  • Chrome: 33.
  • Edge: 12.
  • Firefox: 18.
  • Safari: 7.

Source

MediaDevices.getUserMedia()

Browser Support

  • Chrome: 53.
  • Edge: 12.
  • Firefox: 36.
  • Safari: 11.

Source

MediaDevices.getSupportedConstraints()

Browser Support

  • Chrome: 53.
  • Edge: 12.
  • Firefox: 44.
  • Safari: 11.

Source

MediaStreamTrack.applyConstraints()

Browser Support

  • Chrome: 59.
  • Edge: 12.
  • Firefox: 43.
  • Safari: 11.

Source

MediaStreamTrack.getCapabilities()

Browser Support

  • Chrome: 59.
  • Edge: 12.
  • Firefox: 132.
  • Safari: 11.

Source

MediaStreamTrack.getSettings()

Browser Support

  • Chrome: 59.
  • Edge: 12.
  • Firefox: 50.
  • Safari: 11.

Source

קישורים מועילים

תודות

המאמר הזה נבדק על ידי Joe Medley ו-Thomas Steiner. תודה ל-Rijubrata Bhaumik ול-Eero Häkkinen מ-Intel על העבודה שלהם על המפרט וההטמעה.