Kamera kaydırma, yatırma ve yakınlaştırmayı denetleyin

Kameralardaki kaydırma, eğme ve yakınlaştırma özellikleri artık web'de kontrol edilebiliyor.

François Beaufort
François Beaufort

Oda ölçekli video konferans çözümlerinde, yazılımın kamerayı toplantı katılımcılarına yönlendirebilmesi için kaydırma, eğme ve yakınlaştırma (PTZ) özelliklerine sahip kameralar kullanılır. Chrome 87'den itibaren, kameralardaki kaydırma, eğme ve yakınlaştırma özellikleri, MediaDevices.getUserMedia() ve MediaStreamTrack.applyConstraints()'da medya parçası kısıtlamalarını kullanan web siteleri tarafından kullanılabilir.

API'yi kullanma

Özellik algılama

Donanım için özellik algılama, muhtemelen alışık olduğunuzdan farklıdır. navigator.mediaDevices.getSupportedConstraints() içinde "pan", "tilt" ve "zoom" kısıtlama adlarının bulunması, tarayıcının kamera PTZ'sini kontrol etmek için API'yi desteklediğini gösterir ancak kamera donanımının bunu destekleyip desteklemediğini göstermez. Chrome 87'den itibaren, masaüstünde kamera PTZ'sini kontrol etme desteklenirken Android'de yalnızca yakınlaştırma desteklenir.

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

Kamera PTZ erişimi isteme

Bir web sitesinin kameranın PTZ'sini kontrol etmesine yalnızca kullanıcı bir istem aracılığıyla kameraya PTZ izni verdiyse izin verilir.

Kamera PTZ erişimi istemek için navigator.mediaDevices.getUserMedia() yöntemini aşağıda gösterilen PTZ kısıtlamalarıyla çağırın. Bu işlem, kullanıcıdan hem normal kamera hem de PTZ izinlerine sahip kamera için izin vermesini ister.

macOS için Chrome'da kamera PTZ kullanıcı isteminin ekran görüntüsü.
Kamera PTZ kullanıcı istemi.

Döndürülen promise, kamera video akışını kullanıcıya göstermek için kullanılan bir MediaStream nesnesiyle çözümlenir. Kamera PTZ'yi desteklemiyorsa kullanıcıya normal bir kamera istemi gösterilir.

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

Daha önce verilmiş bir kamera izni (özellikle PTZ erişimi olmayan bir izin), PTZ erişimi kullanılabilir hale geldiğinde otomatik olarak PTZ erişimi kazanmaz. Kameranın kendisi PTZ'yi desteklese bile bu durum geçerlidir. İznin tekrar istenmesi gerekir. Neyse ki PTZ izninin durumunu sorgulamak ve izlemek için Permissions API'yi kullanabilirsiniz.

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 tabanlı bir tarayıcının bir kamera için PTZ'yi destekleyip desteklemediğini öğrenmek istiyorsanız dahili about://media-internals sayfasına gidin ve "Video Yakalama" sekmesindeki "Kaydırma-Eğme-Yakınlaştırma" sütununa bakın. "Kaydırma eğme" ve "yakınlaştırma", kameranın sırasıyla "KaydırmaEğme (Mutlak)" ve "Yakınlaştırma (Mutlak)" UVC kontrollerini desteklediği anlamına gelir. "PanTilt (Göreceli)" ve "Yakınlaştırma (Göreceli)" UVC kontrolleri, Chromium tabanlı tarayıcılarda desteklenmez.

Dahili ChromeOS hata ayıklama sayfası.
PTZ kamera desteğinde hata ayıklamak için dahili sayfa.

Kamera PTZ'sini kontrol etme

Daha önce elde edilen stream nesnesinden MediaStreamTrack önizlemesini kullanarak kameranın PTZ özelliklerini ve ayarlarını değiştirin. MediaStreamTrack.getCapabilities(), desteklenen özelliklerin yanı sıra aralıkları veya izin verilen değerleri içeren bir sözlük döndürür. Buna göre MediaStreamTrack.getSettings(), mevcut ayarları döndürür.

Kaydırma, eğme ve yakınlaştırma özellikleri ve ayarları yalnızca kamera tarafından destekleniyorsa ve kullanıcı kameraya PTZ izni vermişse kullanılabilir.

Kamera PTZ'sini kontrol etme.

Örnekte gösterildiği gibi kameranın kaydırma, eğme ve yakınlaştırma özelliklerini kontrol etmek için uygun PTZ gelişmiş kısıtlamalarıyla videoTrack.applyConstraints() yöntemini çağırın. Döndürülen promise başarılı olursa çözümlenir. Aşağıdaki durumlarda reddeder:

  • PTZ izni olan kameraya izin verilmedi.
  • Kamera donanımı PTZ kısıtlamasını desteklemiyor.
  • Sayfa kullanıcıya gösterilmez. Sayfa görünürlüğü değişikliklerini algılamak için Page Visibility API'yi kullanın.
// 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...
}

Kameranın kaydırma, eğme ve yakınlaştırma ayarlarını, bazı kamera PTZ ideal kısıtlama değerleriyle navigator.mediaDevices.getUserMedia() yöntemini çağırarak da yapılandırabilirsiniz. Bu, kamera PTZ özellikleri önceden bilindiğinde kullanışlıdır. Zorunlu kısıtlamalara (min, maks, tam) burada izin verilmediğini unutmayın.

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

Çocuk parkı

Demoyu çalıştırarak API'yi deneyebilirsiniz.

Güvenlikle ilgili olarak göz önünde bulundurulması gerekenler

Spesifikasyon yazarları, bu API'yi kullanıcı kontrolü, şeffaflık ve ergonomi gibi temel ilkeleri kullanarak tasarlayıp uygulamıştır. Bu API'yi kullanma olanağı, öncelikle Media Capture and Streams API ile aynı izin modeliyle sınırlandırılmıştır. Kullanıcı istemine yanıt olarak web sitesinin kamera PTZ'sini kontrol etmesine yalnızca sayfa kullanıcı tarafından görülebildiğinde izin verilir.

Tarayıcı uyumluluğu

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

Faydalı bağlantılar

Onaylar

Bu makale Joe Medley ve Thomas Steiner tarafından incelenmiştir. Spesifikasyon ve uygulama konusundaki çalışmaları için Intel'den Rijubrata Bhaumik ve Eero Häkkinen'e teşekkür ederiz.