कैमरा पैन, टिल्ट, और ज़ूम को कंट्रोल करें

कैमरे में पैन, टिल्ट, और ज़ूम करने की सुविधाओं को अब वेब पर कंट्रोल किया जा सकता है.

François Beaufort
François Beaufort

रूम-स्केल वीडियो कॉन्फ़्रेंसिंग के विकल्पों में, पैन, टिल्ट, और ज़ूम (पीटीज़ेड) की सुविधाओं वाले कैमरे इस्तेमाल किए जाते हैं. इससे सॉफ़्टवेयर, मीटिंग में हिस्सा लेने वाले लोगों पर कैमरे को फ़ोकस कर सकता है. Chrome 87 से, कैमरे पर पैन, टिल्ट, और ज़ूम करने की सुविधाएं उन वेबसाइटों के लिए उपलब्ध हैं जो MediaDevices.getUserMedia() और MediaStreamTrack.applyConstraints() में मीडिया ट्रैक की पाबंदियों का इस्तेमाल करती हैं.

एपीआई का इस्तेमाल करना

सुविधा का पता लगाने की सुविधा

हार्डवेयर के लिए सुविधा की पहचान करने का तरीका, आपके सामान्य तरीके से अलग है. navigator.mediaDevices.getSupportedConstraints() में "pan", "tilt", और "zoom" कंस्ट्रेंट के नाम मौजूद होने से पता चलता है कि ब्राउज़र, कैमरे के पीटीज़ेड को कंट्रोल करने के लिए एपीआई के साथ काम करता है. हालांकि, इससे यह पता नहीं चलता कि कैमरे का हार्डवेयर इसके साथ काम करता है या नहीं. Chrome 87 से, डेस्कटॉप पर कैमरे के पीटीज़ेड को कंट्रोल करने की सुविधा उपलब्ध है. हालांकि, Android पर अब भी सिर्फ़ ज़ूम करने की सुविधा उपलब्ध है.

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

कैमरे के पीटीज़ेड ऐक्सेस का अनुरोध करना

किसी वेबसाइट को कैमरे के पीटीज़ेड को कंट्रोल करने की अनुमति सिर्फ़ तब मिलती है, जब उपयोगकर्ता ने प्रॉम्प्ट के ज़रिए कैमरे को पीटीज़ेड की अनुमति दी हो.

कैमरे के पीटीज़ेड ऐक्सेस का अनुरोध करने के लिए, navigator.mediaDevices.getUserMedia() को कॉल करें. इसके लिए, पीटीज़ेड की पाबंदियों का इस्तेमाल करें, जैसा कि यहां दिखाया गया है. इससे उपयोगकर्ता को सामान्य कैमरे और पीटीज़ेड कैमरे, दोनों को ऐक्सेस करने की अनुमति देने के लिए कहा जाएगा.

macOS के लिए Chrome में, कैमरे के पीटीज़ेड कंट्रोल की अनुमति मांगने वाले प्रॉम्प्ट का स्क्रीनशॉट.
कैमरे के पीटीज़ेड के लिए उपयोगकर्ता का प्रॉम्प्ट.

रिस्पॉन्स में मिला प्रॉमिस, MediaStream ऑब्जेक्ट के साथ रिज़ॉल्व होता है. इसका इस्तेमाल, उपयोगकर्ता को कैमरे की वीडियो स्ट्रीम दिखाने के लिए किया जाता है. अगर कैमरा पीटीज़ेड के साथ काम नहीं करता है, तो उपयोगकर्ता को सामान्य कैमरे का प्रॉम्प्ट दिया जाता है.

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

अगर आपने किसी वेबसाइट को पहले ही कैमरा ऐक्सेस करने की अनुमति दी है, लेकिन पीटीज़ेड ऐक्सेस नहीं दिया है, तो पीटीज़ेड ऐक्सेस उपलब्ध होने पर भी उसे अपने-आप यह ऐक्सेस नहीं मिलेगा. यह बात तब भी लागू होती है, जब कैमरे में पीटीज़ेड की सुविधा मौजूद हो. अनुमति का अनुरोध फिर से करना होगा. खुशकिस्मती से, Permissions API का इस्तेमाल करके, पीटीज़ेड की अनुमति की स्थिति के बारे में क्वेरी की जा सकती है और उसे मॉनिटर किया जा सकता है.

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 पर आधारित कोई ब्राउज़र, कैमरे के लिए पीटीज़ेड के साथ काम करता है या नहीं, यह जानने के लिए इंटरनल about://media-internals पेज पर जाएं. इसके बाद, "वीडियो कैप्चर" टैब में "पैन-टिल्ट-ज़ूम" कॉलम देखें. "पैन टिल्ट" और "ज़ूम" का मतलब है कि कैमरा, "पैनटिल्ट (ऐब्सलूट)" और "ज़ूम (ऐब्सलूट)" यूवीसी कंट्रोल के साथ काम करता है. Chromium पर आधारित ब्राउज़र में, "पैनटिल्ट (रिलेटिव)" और "ज़ूम (रिलेटिव)" यूवीसी कंट्रोल काम नहीं करते.

ChromeOS का इंटरनल डीबग पेज.
पीटीज़ेड कैमरे की सुविधा को डीबग करने के लिए इंटरनल पेज.

कैमरे के पीटीज़ेड को कंट्रोल करना

पहले मिले stream ऑब्जेक्ट से MediaStreamTrack की झलक का इस्तेमाल करके, कैमरे की पीटीज़ेड सुविधाओं और सेटिंग में बदलाव करें. MediaStreamTrack.getCapabilities(), इस्तेमाल की जा सकने वाली सुविधाओं और रेंज या अनुमति वाली वैल्यू के साथ एक डिक्शनरी दिखाता है. इसके बाद, MediaStreamTrack.getSettings() मौजूदा सेटिंग दिखाता है.

पैन, टिल्ट, और ज़ूम करने की सुविधाएं और सेटिंग सिर्फ़ तब उपलब्ध होती हैं, जब कैमरे में ये सुविधाएं काम करती हों और उपयोगकर्ता ने कैमरे को पीटीज़ेड की अनुमति दी हो.

कैमरे के पीटीज़ेड को कंट्रोल करना.

उदाहरण में दिखाए गए तरीके से कैमरे के पैन, टिल्ट, और ज़ूम को कंट्रोल करने के लिए, सही पीटीज़ेड ऐडवांस कंस्ट्रेंट के साथ videoTrack.applyConstraints() को कॉल करें. अगर अनुरोध पूरा हो जाता है, तो रिटर्न किया गया प्रॉमिस रिज़ॉल्व हो जाता है. इनमें से कोई भी शर्त पूरी होने पर, बुकिंग अस्वीकार कर दी जाती है:

  • पीटीज़ेड की अनुमति वाला कैमरा नहीं दिया गया है.
  • कैमरे का हार्डवेयर, पीटीज़ेड की पाबंदी के साथ काम नहीं करता.
  • उपयोगकर्ता को पेज नहीं दिख रहा है. पेज के दिखने की सेटिंग में हुए बदलावों का पता लगाने के लिए, 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() को कॉल करके, कैमरे के पैन, टिल्ट, और ज़ूम को भी कॉन्फ़िगर किया जा सकता है. यह सुविधा तब काम आती है, जब कैमरे की पीटीज़ेड सुविधाओं के बारे में पहले से पता हो. ध्यान दें कि यहां ज़रूरी शर्तों (कम से कम, ज़्यादा से ज़्यादा, सटीक) की अनुमति नहीं है.

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

खेल का मैदान

डेमो चलाकर, एपीआई को आज़माया जा सकता है.

सुरक्षा से जुड़ी ज़रूरी बातें

स्पेसिफ़िकेशन के लेखकों ने इस एपीआई को डिज़ाइन और लागू किया है. इसके लिए, उन्होंने उपयोगकर्ता के कंट्रोल, पारदर्शिता, और एर्गोनॉमिक्स जैसे मुख्य सिद्धांतों का इस्तेमाल किया है. इस एपीआई का इस्तेमाल करने की सुविधा, मुख्य रूप से उसी अनुमतियों के मॉडल से कंट्रोल होती है जिससे मीडिया कैप्चर और स्ट्रीम एपीआई कंट्रोल होता है. उपयोगकर्ता के प्रॉम्प्ट के जवाब में, वेबसाइट को कैमरे के पीटीज़ेड को कंट्रोल करने की अनुमति सिर्फ़ तब मिलती है, जब उपयोगकर्ता को पेज दिख रहा हो.

वेबसाइट का अलग-अलग ब्राउज़र पर चलना

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

सहायता के लिए लिंक

Acknowledgements

इस लेख की समीक्षा जो मेडली और थॉमस स्टाइनर ने की है. Intel के रिजुब्रत भौमिक और ईरो हैकिनन को धन्यवाद, जिन्होंने इस सुविधा को लागू करने और इसकी खास जानकारी देने में मदद की.