Class: LocalVideoTrack

Extends

• VideoTrack
• LocalTrack

Members

---

stop

See LocalTrack#stop.

Overrides:

• LocalTrack#stop

Methods

---

attach()

Attach the Track to a newly created HTMLMediaElement.

The HTMLMediaElement's srcObject will be set to a new MediaStream containing the Track's MediaStreamTrack.

Inherited From:

• Track#attach

Overrides:

• LocalTrack#attach

Returns:

Either an HTMLAudioElement or HTMLVideoElement, depending on the Track's kind

Type

HTMLMediaElement

Example

var Video = require('twilio-video');

Video.createLocalVideoTrack().then(function(track) {
  var videoElement = track.attach();
  document.getElementById('my-container').appendChild(videoElement);
});
 

---

detach()

Detach a Track from all previously attached HTMLMediaElements.

Inherited From:

• Track#detach

Overrides:

• LocalTrack#detach

Returns:

The detachedHTMLMediaElements

Type

Array.<HTMLMediaElement>

Example

var detachedElements = track.detach();
detachedElements.forEach(function(el) {
  el.remove();
});
 

---

disable()

Disable the LocalVideoTrack. This is effectively "pause".

Overrides:

• LocalTrack#disable

Fires:

• Track#event:disabled

Returns:

Type

this

---

enable( [enabled])

Enable or disable the LocalVideoTrack. This is effectively "unpause" or "pause".

Parameters:

Name	Type	Argument	Description
enabled	boolean	<optional>	Specify false to pause the LocalVideoTrack

Overrides:

• LocalTrack#enable

Fires:

• Track#event:disabled
• Track#event:enabled

Returns:

Type

this

---

enable()

Enable the LocalVideoTrack. This is effectively "unpause".

Overrides:

• LocalTrack#enable

Fires:

• Track#event:enabled

Returns:

Type

this

Type Definitions

---

Dimensions

A VideoTrack's width and height.

Type:

• object

Properties:

Name	Type	Argument	Description
width	number	<nullable>	The VideoTrack's width or null if the VideoTrack has not yet started
height	number	<nullable>	The VideoTrack's height or null if the VideoTrack has not yet started

Inherited From:

• VideoTrack#Dimensions

Events

---

dimensionsChanged

The VideoTrack's dimensions changed.

Parameters:

Name	Type	Description
track	VideoTrack	The VideoTrack whose dimensions changed

Inherited From:

• VideoTrack#event:dimensionsChanged

---

disabled

The Track was disabled. For AudioTracks this means "muted", and for VideoTracks this means "paused".

Parameters:

Name	Type	Description
track	Track	The Track that was disabled

Inherited From:

• Track#event:disabled

Overrides:

• LocalTrack#event:disabled

---

enabled

The Track was enabled. For AudioTracks this means "unmuted", and for VideoTracks this means "unpaused".

Parameters:

Name	Type	Description
track	Track	The Track that was enabled

Inherited From:

• Track#event:enabled

Overrides:

• LocalTrack#event:enabled

---

started

The Track started. This means that the Track contains enough audio or video to begin playback.

Parameters:

Name	Type	Description
track	Track	The Track that started

Inherited From:

• Track#event:started

Overrides:

• LocalTrack#event:started

---

stopped

The LocalTrack was stopped, either because LocalTrack#stop was called or because the underlying MediaStreamTrack ended).

Parameters:

Name	Type	Description
track	LocalTrack	The LocalTrack that stopped

Inherited From:

• LocalTrack#event:stopped