ক্যামেরা প্যান, টিল্ট ও জুম নিয়ন্ত্রণ করা

ক্যামেরার প্যান, টিল্ট ও জুম ফিচার এখন ওয়েব থেকে কন্ট্রোল করা যাবে।

François Beaufort
François Beaufort

রুম-স্কেল ভিডিও কনফারেন্সিং সলিউশন প্যান, টিল্ট এবং জুম (PTZ) ক্ষমতা সহ ক্যামেরা ব্যবহার করে যাতে সফ্টওয়্যার মিটিংয়ে অংশগ্রহণকারীদের দিকে ক্যামেরা পয়েন্ট করতে পারে। Chrome 87 থেকে শুরু করে, ক্যামেরায় প্যান, টিল্ট ও জুম ফিচার MediaDevices.getUserMedia() ও MediaStreamTrack.applyConstraints()-এ মিডিয়া ট্র্যাক কনস্ট্রেন্ট ব্যবহার করে ওয়েবসাইটে উপলভ্য।

এপিআই ব্যবহার করা

ফিচার শনাক্তকরণ

হার্ডওয়্যারের জন্য ফিচার শনাক্তকরণ আপনি সম্ভবত যা ব্যবহার করেন তার থেকে আলাদা। navigator.mediaDevices.getSupportedConstraints()-এ "pan", "tilt" ও "zoom" কনস্ট্রেন্ট নামের উপস্থিতি আপনাকে জানায় যে ব্রাউজার ক্যামেরা PTZ কন্ট্রোল করার জন্য API সাপোর্ট করে, কিন্তু ক্যামেরা হার্ডওয়্যার এটি সাপোর্ট করে কিনা তা জানায় না। Chrome 87 থেকে, ডেস্কটপে ক্যামেরা PTZ কন্ট্রোল করার সুবিধা কাজ করে, যদিও Android-এ এখনও শুধু জুম করার সুবিধা কাজ করে।

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

ক্যামেরা PTZ অ্যাক্সেসের অনুরোধ করুন

ব্যবহারকারী প্রম্পটের মাধ্যমে স্পষ্টভাবে ক্যামেরার PTZ অনুমতি দিলে তবেই কোনও ওয়েবসাইটকে ক্যামেরার PTZ কন্ট্রোল করার অনুমতি দেওয়া হয়।

ক্যামেরা PTZ অ্যাক্সেসের অনুরোধ করতে, নিচে দেখানো PTZ কনস্ট্রেন্ট সহ navigator.mediaDevices.getUserMedia() কল করুন। এটি ব্যবহারকারীকে সাধারণ ক্যামেরা এবং PTZ সহ ক্যামেরা, উভয়েরই অনুমতি দিতে প্রম্পট করবে।

macOS-এর জন্য Chrome-এ ক্যামেরা 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-এর সুবিধা থাকলেও এটি প্রযোজ্য। অনুমতির জন্য আবার অনুরোধ করতে হবে। তবে, PTZ অনুমতির স্ট্যাটাস কোয়েরি ও মনিটর করতে আপনি 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-ভিত্তিক ব্রাউজার কোনও ক্যামেরার জন্য PTZ সাপোর্ট করে কিনা তা জানতে, ইন্টার্নাল about://media-internals পৃষ্ঠায় যান এবং "ভিডিও ক্যাপচার" ট্যাবে "প্যান-টিল্ট-জুম" কলামটি চেক করুন; "প্যান টিল্ট" এবং "জুম" যথাক্রমে বোঝায় যে ক্যামেরাটি "প্যানটিল্ট (অ্যাবসোলিউট)" এবং "জুম (অ্যাবসোলিউট)" UVC কন্ট্রোল সাপোর্ট করে। Chromium-ভিত্তিক ব্রাউজারে "প্যানটিল্ট (রিলেটিভ)" এবং "জুম (রিলেটিভ)" UVC কন্ট্রোল কাজ করে না।

ইন্টার্নাল ChromeOS ডিবাগ পৃষ্ঠা।
PTZ ক্যামেরা সাপোর্ট ডিবাগ করার জন্য ইন্টার্নাল পৃষ্ঠা।

ক্যামেরা PTZ কন্ট্রোল করুন

আগে পাওয়া stream অবজেক্ট থেকে প্রিভিউ MediaStreamTrack ব্যবহার করে ক্যামেরা PTZ ক্ষমতা ও সেটিংস ম্যানিপুলেট করুন। MediaStreamTrack.getCapabilities() কাজ করে এমন ক্ষমতা এবং রেঞ্জ বা অনুমোদিত ভ্যালু সহ একটি ডিকশনারি রিটার্ন করে। সেই অনুযায়ী, MediaStreamTrack.getSettings() বর্তমান সেটিংস ফিরিয়ে দেয়।

প্যান, টিল্ট ও জুম করার ক্ষমতা ও সেটিংস তখনই উপলভ্য হয় যখন ক্যামেরা এগুলি সাপোর্ট করে এবং ব্যবহারকারী ক্যামেরাকে PTZ-এর অনুমতি দেন।

ক্যামেরা PTZ কন্ট্রোল করা হচ্ছে।

উদাহরণে যেমন দেখানো হয়েছে, ক্যামেরার প্যান, টিল্ট ও জুম কন্ট্রোল করতে, উপযুক্ত PTZ উন্নত কনস্ট্রেন্ট সহ videoTrack.applyConstraints() কল করুন। প্রমিস সফল হলে তা রিটার্ন করা হয়। এটি বাতিল করে যদি এগুলির মধ্যে কোনও একটি হয়:

  • 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...
}

এছাড়াও, কিছু ক্যামেরা PTZ-এর আদর্শ কনস্ট্রেন্ট ভ্যালু সহ navigator.mediaDevices.getUserMedia() কল করে ক্যামেরা প্যান, টিল্ট ও জুম কনফিগার করা সম্ভব। ক্যামেরার PTZ ক্ষমতা আগে থেকে জানা থাকলে এটি সুবিধাজনক হয়। মনে রাখবেন যে বাধ্যতামূলক সীমাবদ্ধতা (সর্বনিম্ন, সর্বাধিক, সঠিক) এখানে অনুমোদিত নয়।

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

খেলার মাঠ

ডেমো রান করে আপনি API ব্যবহার করে দেখতে পারেন।

নিরাপত্তা সংক্রান্ত বিষয়

স্পেক লেখকরা ব্যবহারকারীর নিয়ন্ত্রণ, স্বচ্ছতা এবং এরগনোমিক্স সহ মূল ব্যবহার করে এই API ডিজাইন এবং বাস্তবায়ন করেছেন। এই API ব্যবহার করার ক্ষমতা মূলত মিডিয়া ক্যাপচার ও স্ট্রিম 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

সহায়ক লিঙ্ক

স্বীকৃতি

এই নিবন্ধটি জো মেডলি এবং থমাস স্টেইনার পর্যালোচনা করেছেন। Intel-এর ঋজুব্রত ভৌমিক এবং ইরো হাক্কিনেন-কে ধন্যবাদ, স্পেসিফিকেশন এবং ইমপ্লিমেন্টেশনের উপর তাদের কাজের জন্য।