MediaStreamTrack

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Sumario

La interfaz MediaStream representa un flujo de contenido de los medios. Un flujo consiste en gran cantidad de tracks, como pistas de audio o video.

Propiedades

MediaStreamTrack.enabled

Es un valor Booleano con un valor de true si la pista está habilitada, que se permite para renderizar el fujo fuente del medio; o false si está desactivado, ue no está rederizando el flujo de la fuente de medios que el silencio y la oscuridad. Si la pista se ha desconectado, este valor puede ser cambiado, pero no tiene más efecto.

MediaStreamTrack.id Read only

Retorna un DOMString que contiene un identificador único (GUID) para la pista; que es generado por le navegador.

MediaStreamTrack.kind Read only

Retorna un DOMString se establece en "audio" si la pista es un audio y para "video", si es una pista de video. Este no cambia si la pista se disociada de su fuente.

MediaStreamTrack.label Read only

Retorna un DOMString que contiene una etiqueta agente-asignado por el usuario que identifica la fuente de la pista, como en "internal microphone". La cadena puede dejarse vacío y está vacía, siempre y cuando ninguna fuente haya sido conectada. Cuando la pista está disociada de la fuente, la etiqueta no cambia.

MediaStreamTrack.muted Read only

Retorna un valor booleano con un valor de true si la pista esta silenciada, de lo contrario false.

MediaStreamTrack.readonly Read only

Retona un valor Booleano con un valor de true si la pista es de solo lectura ( una fuente de archivo de vídeo o una cámara que los ajustes no puedan ser modificados), de lo contrario false.

MediaStreamTrack.readyState Read only

Retorna un valor enumerado dando el estado de la pista. Este toma uno de los siguientes valores:

  • "live" el cual indica que una entrada es conectada y hace de esta el mejor esfuerzo en proveer datos en tiempo real. En este caso, la salida de datos puede ser cambiada a on u off usando el atributo MediaStreamTrack.enabled.
  • "ended" este indica que la entrada no esta obteniendo algun dato mas y negará proporcionar nuevos datos.
MediaStreamTrack.remote Read only

retorna un booleano con un valor de verdadero si la pista es originada por RTCPeerConnection, falso a cualquier otro.

Disparador de eventos

MediaStreamTrack.onstarted

Es un contenedor event handler de la acción a realizar cuando el evento started es disparado sobre el objeto, que es cuando un objeto MediaStreamTrack es añadido.

MediaStreamTrack.onmute

Es un contenedor event handler de la acción ha realizar cuando un evento mute es disparado sobre el objeto, que es cuando la transmición es terminada.

MediaStreamTrack.onunmute

Es un contenedor event handler de la acción ha realizar cuando un evento unmute es disparado sobre el objeto, que es cuando un objeto MediaStreamTrack es removido por este.

MediaStreamTrack.onoverconstrained

Es un contenedor event handler de la acción ha realizar cuando un objeto overconstrained es disparado sobre el objeto, que es cuando un objeto MediaStreamTrack es removido por este.

MediaStreamTrack.oneended

Es un contenedor event handler de la acción ha realizar cuando un evento ended es disparado sobre el objeto, que es cuando un objeto MediaStreamTrack es removido por este.

Métodos

MediaStreamTrack.getConstraints()

Empty

MediaStreamTrack.applyConstraints()

Empty

MediaStreamTrack.getSettings()

Empty

MediaStreamTrack.getCapabilities()

Empty

MediaStreamTrack.clone()

Empty

MediaStreamTrack.stop()

Detiene la reproducción del origen asociado a la pista, pero el origen y la pista son desasociados. El estado de la pista es un conjunto de ended.

Especificaciones

Specification
Media Capture and Streams
# mediastreamtrack

Compatibilidad con navegadores

BCD tables only load in the browser

Ver támbien