MediaStreamTrack

Интерфейс MediaStreamTrack API захвата медиаданных и потоков представляет собой отдельную медиадорожку в потоке; обычно это аудио- или видеодорожки, но могут существовать и другие типы дорожек.

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

В дополнение к свойствам, перечисленным ниже, MediaStreamTrack имеет свойства, которые можно настраивать с помощью applyConstraints() и получать доступ к ним с помощью getConstraints() и getSettings(). Чтобы правильно работать со свойствами, которые можно настраивать, см. Возможности, ограничения и настройки. Неправильное обращение с ними приведет к ненадежности вашего кода.

MediaStreamTrack.contentHint

Строка, которую веб-приложение может использовать, чтобы указать тип содержимого, содержащегося в дорожке, чтобы направить, как API-потребители должны с ним обращаться. Допустимые значения зависят от значения свойства MediaStreamTrack.kind.

MediaStreamTrack.enabled

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

Примечание: Вы можете реализовать стандартную функцию «приглушить», установив enabled в false. Свойство muted относится к ситуации, когда нет медиаданных из-за технической проблемы.

MediaStreamTrack.id Только для чтения

Возвращает строку, содержащую уникальный идентификатор (GUID) дорожки; он генерируется браузером.

MediaStreamTrack.kind Только для чтения

Возвращает строку, установленную в "audio" , если дорожка является аудиодорожкой, и в "video", если это видеодорожка. Она не изменяется, если дорожка отсоединена от источника.

MediaStreamTrack.label Только для чтения

Возвращает строку, содержащую назначенное пользователем агентом имя, которое идентифицирует источник дорожки, как в "internal microphone". Строка может быть пустой и пуста, пока не подключен ни один источник. Когда дорожка отсоединена от источника, имя не изменяется.

MediaStreamTrack.muted Только для чтения

Возвращает булево значение, указывающее, не может ли дорожка предоставить данные медиа из-за технической проблемы.

Примечание: Вы можете реализовать стандартную функцию «приглушить», установив enabled в false, и развести звук, снова установив его в true.

MediaStreamTrack.readyState Только для чтения

Возвращает строку с перечислением, указывающую статус дорожки. Это может быть одно из следующих значений:

• "live" , что указывает на подключение входа и делает все возможное для предоставления данных в режиме реального времени. В этом случае вывод данных можно включить или выключить с помощью атрибута enabled.
• "ended" , что указывает на то, что вход больше не предоставляет данные и никогда не предоставит новых данных.

MediaStreamTrack.applyConstraints()

Позволяет приложению указать желаемые и/или диапазоны допустимых значений для любого количества доступных настраиваемых свойств MediaStreamTrack.

MediaStreamTrack.clone()

Возвращает дубликат MediaStreamTrack.

MediaStreamTrack.getCapabilities()

Возвращает объект, описывающий принятые значения или диапазон значений для каждого настраиваемого свойства связанного MediaStreamTrack.

MediaStreamTrack.getConstraints()

Возвращает объект MediaTrackConstraints, содержащий текущие ограничения для дорожки; возвращаемое значение соответствует ограничениям, установленным в последний раз с помощью applyConstraints().

MediaStreamTrack.getSettings()

Возвращает объект MediaTrackSettings, содержащий текущие значения каждого из настраиваемых свойств MediaStreamTrack.

MediaStreamTrack.stop()

Останавливает воспроизведение источника, связанного с дорожкой; и источник, и дорожка отключаются. Состояние дорожки устанавливается в ended.

Подпишитесь на эти события с помощью addEventListener() или назначив обработчик событий свойству oneventname этого интерфейса:

ended

Отправляется при завершении воспроизведения дорожки (когда значение readyState меняется на ended), кроме случаев, когда дорожка завершается вызовом MediaStreamTrack.stop.

mute

Отправляется MediaStreamTrack , когда значение свойства muted изменяется на true, что указывает на временную недоступность данных дорожки (например, при сбоях в работе сети).

unmute

Отправляется на дорожку, когда данные снова становятся доступными, завершая состояние muted.

• API захвата медиа и потоков
• MediaStream