MediaTrackConstraints: свойство logicalSurface

Свойство logicalSurface словаря MediaTrackConstraints представляет собой ConstrainDOMString, описывающий запрошенные или обязательные ограничения, накладываемые на значение свойств logicalSurface.

Это используется для указания, должен ли getDisplayMedia() позволять пользователю выбирать поверхности отображения, которые не обязательно полностью видны на экране, такие как скрытые окна или полное содержимое окон, достаточно больших, чтобы для просмотра всего их содержимого требовалось прокручивание.

При необходимости, вы можете определить, поддерживается ли это ограничение, проверив значение MediaTrackSupportedConstraints.logicalSurface, возвращаемое вызовом MediaDevices.getSupportedConstraints(). Однако, как правило, это не нужно, так как браузеры будут игнорировать любые ограничения, с которыми они не знакомы.

Значение ConstrainBoolean, которое равно true , если логические поверхности должны быть разрешены среди вариантов, доступных пользователю.

См. как определяются ограничения.

Вы можете проверить значение, выбранное пользователем, после создания отображаемых медиа с помощью getDisplayMedia(), вызвав getSettings() для видео MediaStreamTrack отображаемых медиа, а затем проверив значение возвращённого объекта MediaTrackSettings и его объекта logicalSurface.

Например, если вашему приложению нужно узнать, является ли выбранная поверхность отображения логической:

let isLogicalSurface = displayStream
  .getVideoTracks()[0]
  .getSettings().logicalSurface;

После этого кода, isLogicalSurface равно true, если поверхность отображения, содержащаяся в потоке, является логической поверхностью; то есть такой, которая может быть не полностью на экране, или даже полностью вне экрана.

• API захвата экрана
• Использование API захвата экрана
• Возможности, ограничения и настройки
• MediaTrackConstraints
• MediaDevices.getSupportedConstraints()
• MediaTrackSupportedConstraints