Kiểm soát tính năng kéo, nghiêng và thu phóng của máy ảnh

Giờ đây, bạn có thể điều khiển các tính năng xoay, nghiêng và thu phóng trên camera qua web.

François Beaufort
François Beaufort

Các giải pháp hội nghị truyền hình quy mô phòng họp triển khai camera có khả năng xoay, nghiêng và thu phóng (PTZ) để phần mềm có thể hướng camera vào những người tham gia cuộc họp. Kể từ Chrome 87, các tính năng xoay, nghiêng và thu phóng trên máy ảnh sẽ được cung cấp cho các trang web sử dụng các quy tắc ràng buộc về bản nhạc đa phương tiện trong MediaDevices.getUserMedia() và MediaStreamTrack.applyConstraints().

Sử dụng API

Phát hiện tính năng

Tính năng phát hiện phần cứng khác với những gì bạn có thể đã quen thuộc. Sự hiện diện của tên quy tắc ràng buộc "pan", "tilt" và "zoom" trong navigator.mediaDevices.getSupportedConstraints() cho bạn biết rằng trình duyệt hỗ trợ API để điều khiển PTZ của camera, nhưng không cho biết liệu phần cứng camera có hỗ trợ hay không. Kể từ Chrome 87, tính năng điều khiển PTZ của camera được hỗ trợ trên máy tính, trong khi Android vẫn chỉ hỗ trợ tính năng thu phóng.

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

Yêu cầu quyền truy cập vào tính năng PTZ của camera

Trang web chỉ được phép điều khiển PTZ của camera nếu người dùng đã cấp quyền PTZ cho camera một cách rõ ràng thông qua lời nhắc.

Để yêu cầu quyền truy cập vào PTZ của camera, hãy gọi navigator.mediaDevices.getUserMedia() bằng các quy tắc ràng buộc của PTZ như bên dưới. Thao tác này sẽ nhắc người dùng cấp cả quyền truy cập vào camera thông thường và camera có PTZ.

Ảnh chụp màn hình lời nhắc người dùng về PTZ của camera trong Chrome dành cho macOS.
Lời nhắc của người dùng về camera PTZ.

Lời hứa được trả về sẽ phân giải bằng một đối tượng MediaStream dùng để hiển thị luồng video của camera cho người dùng. Nếu camera không hỗ trợ PTZ, người dùng sẽ nhận được lời nhắc thông thường về camera.

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

Quyền truy cập camera đã được cấp trước đó, cụ thể là quyền không có quyền truy cập PTZ, sẽ không tự động có quyền truy cập PTZ nếu quyền này được cung cấp. Điều này đúng ngay cả khi camera hỗ trợ PTZ. Bạn phải yêu cầu cấp quyền lại. May mắn là bạn có thể sử dụng Permissions API (API Quyền) để truy vấn và theo dõi trạng thái của quyền 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);
}

Để biết trình duyệt dựa trên Chromium có hỗ trợ PTZ cho camera hay không, hãy truy cập vào trang nội bộ about://media-internals và xem cột "Pan-Tilt-Zoom" (Xoay-Nghiêng-Thu phóng) trong thẻ "Video Capture" (Quay video); "pan tilt" (xoay nghiêng) và "zoom" (thu phóng) tương ứng có nghĩa là camera hỗ trợ các chế độ điều khiển UVC "PanTilt (Absolute)" (XoayNghiêng (Tuyệt đối)) và "Zoom (Absolute)" (Thu phóng (Tuyệt đối)). Các chế độ điều khiển UVC "Quay quét (Tương đối)" và "Thu phóng (Tương đối)" không được hỗ trợ trong các trình duyệt dựa trên Chromium.

Trang gỡ lỗi nội bộ của ChromeOS.
Trang nội bộ để gỡ lỗi tính năng hỗ trợ camera PTZ.

Điều khiển PTZ của camera

Thao tác với các chức năng và chế độ cài đặt PTZ của camera bằng cách sử dụng bản xem trước MediaStreamTrack từ đối tượng stream thu được trước đó. MediaStreamTrack.getCapabilities() trả về một từ điển có các chức năng được hỗ trợ và phạm vi hoặc giá trị được phép. Tương ứng, MediaStreamTrack.getSettings() sẽ trả về các chế độ cài đặt hiện tại.

Các chức năng và chế độ cài đặt xoay, nghiêng và thu phóng chỉ hoạt động nếu camera hỗ trợ và người dùng đã cấp quyền PTZ cho camera.

Điều khiển camera PTZ.

Gọi videoTrack.applyConstraints() bằng các quy tắc ràng buộc nâng cao về PTZ thích hợp để điều khiển chế độ xoay, nghiêng và thu phóng của camera như trong ví dụ. Lời hứa được trả về sẽ được thực hiện nếu thành công. Hệ thống sẽ từ chối nếu:

  • Máy ảnh không được cấp quyền PTZ.
  • Phần cứng camera không hỗ trợ quy tắc ràng buộc PTZ.
  • Người dùng không nhìn thấy trang. Sử dụng Page Visibility API (API Chế độ hiển thị của trang) để phát hiện các thay đổi về chế độ hiển thị của trang.
// 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...
}

Bạn cũng có thể định cấu hình chế độ xoay, nghiêng và thu phóng của camera bằng cách gọi navigator.mediaDevices.getUserMedia() với một số giá trị ràng buộc lý tưởng cho chế độ PTZ của camera. Điều này rất hữu ích khi bạn biết trước các chức năng PTZ của camera. Xin lưu ý rằng bạn không được phép sử dụng các quy tắc ràng buộc bắt buộc (tối thiểu, tối đa, chính xác) tại đây.

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

Sân chơi

Bạn có thể thử nghiệm API bằng cách chạy bản minh hoạ.

Lưu ý về bảo mật

Các tác giả thông số kỹ thuật đã thiết kế và triển khai API này bằng cách sử dụng các nguyên tắc cốt lõi, bao gồm cả quyền kiểm soát của người dùng, tính minh bạch và tính tiện dụng. Khả năng sử dụng API này chủ yếu được kiểm soát bằng cùng một mô hình quản lý quyền như API Ghi và truyền trực tuyến nội dung nghe nhìn. Để phản hồi lời nhắc của người dùng, trang web chỉ được phép điều khiển PTZ của camera khi người dùng nhìn thấy trang.

Khả năng tương thích với trình duyệt

MediaStream API

Browser Support

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

Source

API Quyền

Browser Support

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

Source

API Chế độ hiển thị trang

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

Đường liên kết hữu ích

Xác nhận

Bài viết này đã được Joe Medley và Thomas Steiner xem xét. Cảm ơn Rijubrata Bhaumik và Eero Häkkinen tại Intel vì đã nỗ lực xây dựng thông số kỹ thuật và triển khai.