MediaTrackConstraints: свойство suppressLocalAudioPlayback

Свойство suppressLocalAudioPlayback словаря MediaTrackConstraints представляет собой ConstrainBoolean, описывающее запрошенные или обязательные ограничения, накладываемые на значение параметра suppressLocalAudioPlayback. Это свойство управляет тем, будет ли аудио, воспроизводимое в вкладке, продолжать воспроизводиться через локальные динамики пользователя после захвата вкладки.

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

Значение типа ConstrainBoolean.

Если это значение — просто true или false, пользовательский агент попытается получить медиаданные с включённым или выключенным воспроизведением локального аудио, если это возможно, но не потерпит неудачу, если этого сделать нельзя.

Если значение задано как ideal, булево значение этого поля указывает на идеальную настройку для функции подавления воспроизведения локального аудио; если её невозможно достичь, запрос приведёт к ошибке.

let isLocalAudioSuppressed = displayStream
  .getVideoTracks()[0]
  .getSettings().suppressLocalAudioPlayback;

Пример Constraint exerciser демонстрирует использование ограничений для медиапотоков.

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