MediaStreamTrack
================

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` (en-US)

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` (en-US) Read only 

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

`MediaStreamTrack.kind` (en-US) 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` (en-US) 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` (en-US) 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` (en-US) 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` (en-US) 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` (en-US)

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` (en-US)

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` (en-US)

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()` (en-US)

Empty

`MediaStreamTrack.applyConstraints()` (en-US)

Empty

`MediaStreamTrack.getSettings()` (en-US)

Empty

`MediaStreamTrack.getCapabilities()` (en-US)

Empty

`MediaStreamTrack.clone()` (en-US)

Empty

`MediaStreamTrack.stop()` (en-US)

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 with JavaScript enabled. Enable JavaScript to view data.

Ver támbien
-----------

* Using the MediaStream API