סוף סוף אפשר לשלוט בתכונות ההזזה, ההטיה ושינוי מרחק התצוגה של המצלמות באינטרנט.
בפתרונות לשיחות ועידה בווידאו בקנה מידה של חדר, המצלמות כוללות יכולות של הזזה, הטיה ושינוי מרחק התצוגה (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.
ההבטחה שמוחזרת נפתרת באמצעות אובייקט 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.
שליטה ב-PTZ של המצלמה
משנים את היכולות וההגדרות של ה-PTZ במצלמה באמצעות התצוגה המקדימה MediaStreamTrack מהאובייקט stream שהתקבל קודם.
MediaStreamTrack.getCapabilities() מחזירה מילון עם היכולות הנתמכות והטווחים או הערכים המותרים. בהתאם, הפקודה MediaStreamTrack.getSettings() מחזירה את ההגדרות הנוכחיות.
היכולות וההגדרות של הזזה, הטיה ושינוי מרחק התצוגה זמינות רק אם המצלמה תומכת בהן והמשתמש נתן למצלמה הרשאת 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
Permissions API
Page Visibility API
MediaDevices.getUserMedia()
MediaDevices.getSupportedConstraints()
MediaStreamTrack.applyConstraints()
MediaStreamTrack.getCapabilities()
MediaStreamTrack.getSettings()
קישורים מועילים
תודות
המאמר הזה נבדק על ידי Joe Medley ו-Thomas Steiner. תודה ל-Rijubrata Bhaumik ול-Eero Häkkinen מ-Intel על העבודה שלהם על המפרט וההטמעה.