myButton > // -> myButton === myComonent.children()[0]; > > Pass in options for child constructors and options for children of the child > > var myButton = myComponent.addChild('MyButton', { > text: 'Press Me', > children: { > buttonChildExample: { > buttonChildOption: true > } > } > }); ##### PARAMETERS: * __child__ `String|vjs.Component` The class name or instance of a child to add * __options__ `Object` _(OPTIONAL)_ Options, including options to be passed to children of the child. ##### RETURNS: * `vjs.Component` The child component (created by this process if a string was used) _inherited from_: [src/js/component.js#L362](https://github.com/videojs/video.js/blob/master/src/js/component.js#L362) --- ### addClass( classToAdd ) > Add a CSS class name to the component's element ##### PARAMETERS: * __classToAdd__ `String` Classname to add ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L826](https://github.com/videojs/video.js/blob/master/src/js/component.js#L826) --- ### addTextTrack( kind, [label], [language] ) > Add a text track > In addition to the W3C settings we allow adding additional info through options. > http://www.w3.org/html/wg/drafts/html/master/embedded-content-0.html#dom-media-addtexttrack ##### PARAMETERS: * __kind__ `String` Captions, subtitles, chapters, descriptions, or metadata * __label__ `String` _(OPTIONAL)_ Optional label * __language__ `String` _(OPTIONAL)_ Optional language _defined in_: [src/js/player.js#L1722](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1722) --- ### autoplay( value ) > Get or set the autoplay attribute. ##### PARAMETERS: * __value__ ##### RETURNS: * `String` The autoplay attribute value when getting * `vjs.Player` Returns the player when setting _defined in_: [src/js/player.js#L1263](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1263) --- ### buffered() > Get a TimeRange object with the times of the video that have been downloaded > > If you just want the percent of the video that's been downloaded, > use bufferedPercent. > > // Number of different ranges of time have been buffered. Usually 1. > numberOfRanges = bufferedTimeRange.length, > > // Time in seconds when the first range starts. Usually 0. > firstRangeStart = bufferedTimeRange.start(0), > > // Time in seconds when the first range ends > firstRangeEnd = bufferedTimeRange.end(0), > > // Length in seconds of the first time range > firstRangeLength = firstRangeEnd - firstRangeStart; ##### RETURNS: * `Object` A mock TimeRange object (following HTML spec) _defined in_: [src/js/player.js#L770](https://github.com/videojs/video.js/blob/master/src/js/player.js#L770) --- ### bufferedEnd() > Get the ending time of the last buffered time range > > This is used in the progress bar to encapsulate all time ranges. ##### RETURNS: * `Number` The end of the last buffered time range _defined in_: [src/js/player.js#L821](https://github.com/videojs/video.js/blob/master/src/js/player.js#L821) --- ### bufferedPercent() > Get the percent (as a decimal) of the video that's been downloaded > > var howMuchIsDownloaded = myPlayer.bufferedPercent(); > > 0 means none, 1 means all. > (This method isn't in the HTML5 spec, but it's very convenient) ##### RETURNS: * `Number` A decimal between 0 and 1 representing the percent _defined in_: [src/js/player.js#L790](https://github.com/videojs/video.js/blob/master/src/js/player.js#L790) --- ### buildCSSClass() > Allows sub components to stack CSS class names ##### RETURNS: * `String` The constructed class name _inherited from_: [src/js/component.js#L536](https://github.com/videojs/video.js/blob/master/src/js/component.js#L536) --- ### cancelFullScreen() > Old naming for exitFullscreen **Deprecated** true _defined in_: [src/js/player.js#L1026](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1026) --- ### children() > Get an array of all child components > > var kids = myComponent.children(); ##### RETURNS: * `Array` The children _inherited from_: [src/js/component.js#L296](https://github.com/videojs/video.js/blob/master/src/js/component.js#L296) --- ### clearInterval( intervalId ) > Clears an interval and removes the associated dispose listener ##### PARAMETERS: * __intervalId__ `Number` The id of the interval to clear ##### RETURNS: * `Number` Returns the interval ID _inherited from_: [src/js/component.js#L1223](https://github.com/videojs/video.js/blob/master/src/js/component.js#L1223) --- ### clearTimeout( timeoutId ) > Clears a timeout and removes the associated dispose listener ##### PARAMETERS: * __timeoutId__ `Number` The id of the timeout to clear ##### RETURNS: * `Number` Returns the timeout ID _inherited from_: [src/js/component.js#L1185](https://github.com/videojs/video.js/blob/master/src/js/component.js#L1185) --- ### contentEl() > Return the component's DOM element for embedding content. > Will either be el_ or a new element defined in createEl. ##### RETURNS: * `Element` _inherited from_: [src/js/component.js#L239](https://github.com/videojs/video.js/blob/master/src/js/component.js#L239) --- ### controls( controls ) > Get or set whether or not the controls are showing. ##### PARAMETERS: * __controls__ `Boolean` Set controls to showing or not ##### RETURNS: * `Boolean` Controls are showing _defined in_: [src/js/player.js#L1343](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1343) --- ### createEl( [tagName], [attributes] ) > Create the component's DOM element ##### PARAMETERS: * __tagName__ `String` _(OPTIONAL)_ Element's node type. e.g. 'div' * __attributes__ `Object` _(OPTIONAL)_ An object of element attributes that should be set on the element ##### RETURNS: * `Element` _inherited from_: [src/js/component.js#L200](https://github.com/videojs/video.js/blob/master/src/js/component.js#L200) --- ### currentSrc() > Returns the fully qualified URL of the current source value e.g. http://mysite.com/video.mp4 > Can be used in conjuction with `currentType` to assist in rebuilding the current source object. ##### RETURNS: * `String` The current source _defined in_: [src/js/player.js#L1230](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1230) --- ### currentTime( [seconds] ) > Get or set the current time (in seconds) > > // get > var whereYouAt = myPlayer.currentTime(); > > // set > myPlayer.currentTime(120); // 2 minutes into the video ##### PARAMETERS: * __seconds__ `Number|String` _(OPTIONAL)_ The time to seek to ##### RETURNS: * `Number` The time in seconds, when not setting * `vjs.Player` self, when the current time is set _defined in_: [src/js/player.js#L690](https://github.com/videojs/video.js/blob/master/src/js/player.js#L690) --- ### currentType() > Get the current source type e.g. video/mp4 > This can allow you rebuild the current source object so that you could load the same > source and tech later ##### RETURNS: * `String` The source MIME type _defined in_: [src/js/player.js#L1240](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1240) --- ### dimensions( width, height ) > Set both width and height at the same time ##### PARAMETERS: * __width__ `Number|String` * __height__ `Number|String` ##### RETURNS: * `vjs.Component` The component _inherited from_: [src/js/component.js#L938](https://github.com/videojs/video.js/blob/master/src/js/component.js#L938) --- ### dispose() > Destroys the video player and does any necessary cleanup > > myPlayer.dispose(); > > This is especially helpful if you are dynamically adding and removing videos > to/from the DOM. _defined in_: [src/js/player.js#L164](https://github.com/videojs/video.js/blob/master/src/js/player.js#L164) --- ### duration( seconds ) > Get the length in time of the video in seconds > > var lengthOfVideo = myPlayer.duration(); > > **NOTE**: The video must have started loading before the duration can be > known, and in the case of Flash, may not be known until the video starts > playing. ##### PARAMETERS: * __seconds__ ##### RETURNS: * `Number` The duration of the video in seconds _defined in_: [src/js/player.js#L718](https://github.com/videojs/video.js/blob/master/src/js/player.js#L718) --- ### el() > Get the component's DOM element > > var domEl = myComponent.el(); ##### RETURNS: * `Element` _inherited from_: [src/js/component.js#L220](https://github.com/videojs/video.js/blob/master/src/js/component.js#L220) --- ### enableTouchActivity() > Report user touch activity when touch events occur > > User activity is used to determine when controls should show/hide. It's > relatively simple when it comes to mouse events, because any mouse event > should show the controls. So we capture mouse events that bubble up to the > player and report activity when that happens. > > With touch events it isn't as easy. We can't rely on touch events at the > player level, because a tap (touchstart + touchend) on the video itself on > mobile devices is meant to turn controls off (and on). User activity is > checked asynchronously, so what could happen is a tap event on the video > turns the controls off, then the touchend event bubbles up to the player, > which if it reported user activity, would turn the controls right back on. > (We also don't want to completely block touch events from bubbling up) > > Also a touchmove, touch+hold, and anything other than a tap is not supposed > to turn the controls back on on a mobile device. > > Here we're setting the default component behavior to report user activity > whenever touch events happen, and this can be turned off by components that > want touch events to act differently. _inherited from_: [src/js/component.js#L1124](https://github.com/videojs/video.js/blob/master/src/js/component.js#L1124) --- ### ended() > Returns whether or not the player is in the "ended" state. ##### RETURNS: * `Boolean` True if the player is in the ended state, false if not. _defined in_: [src/js/player.js#L1464](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1464) --- ### error( err ) > Set or get the current MediaError ##### PARAMETERS: * __err__ `*` A MediaError or a String/Number to be turned into a MediaError ##### RETURNS: * `vjs.MediaError|null` when getting * `vjs.Player` when setting _defined in_: [src/js/player.js#L1428](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1428) --- ### exitFullscreen() > Return the video to its normal size after having been in full screen mode > > myPlayer.exitFullscreen(); ##### RETURNS: * `vjs.Player` self _defined in_: [src/js/player.js#L1005](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1005) --- ### getChild( name ) > Returns a child component with the provided name ##### PARAMETERS: * __name__ ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L330](https://github.com/videojs/video.js/blob/master/src/js/component.js#L330) --- ### getChildById( id ) > Returns a child component with the provided ID ##### PARAMETERS: * __id__ ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L313](https://github.com/videojs/video.js/blob/master/src/js/component.js#L313) --- ### hasClass( classToCheck ) > Check if a component's element has a CSS class name ##### PARAMETERS: * __classToCheck__ `String` Classname to check ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L816](https://github.com/videojs/video.js/blob/master/src/js/component.js#L816) --- ### height( [num], [skipListeners] ) > Get or set the height of the component (CSS values) > > Setting the video tag dimension values only works with values in pixels. > Percent values will not work. > Some percents can be used, but width()/height() will return the number + %, > not the actual computed width/height. ##### PARAMETERS: * __num__ `Number|String` _(OPTIONAL)_ New component height * __skipListeners__ `Boolean` _(OPTIONAL)_ Skip the resize event trigger ##### RETURNS: * `vjs.Component` This component, when setting the height * `Number|String` The height, when getting _inherited from_: [src/js/component.js#L927](https://github.com/videojs/video.js/blob/master/src/js/component.js#L927) --- ### hide() > Hide the component element if currently showing ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L857](https://github.com/videojs/video.js/blob/master/src/js/component.js#L857) --- ### id() > Get the component's ID > > var id = myComponent.id(); ##### RETURNS: * `String` _inherited from_: [src/js/component.js#L258](https://github.com/videojs/video.js/blob/master/src/js/component.js#L258) --- ### init( tag, [options], [ready] ) > player's constructor function ##### PARAMETERS: * __tag__ `Element` The original video tag used for configuring options * __options__ `Object` _(OPTIONAL)_ Player options * __ready__ `Function` _(OPTIONAL)_ Ready callback function _defined in_: [src/js/player.js#L32](https://github.com/videojs/video.js/blob/master/src/js/player.js#L32) --- ### initChildren() > Add and initialize default child components from options > > // when an instance of MyComponent is created, all children in options > // will be added to the instance by their name strings and options > MyComponent.prototype.options_.children = { > myChildComponent: { > myChildOption: true > } > } > > // Or when creating the component > var myComp = new MyComponent(player, { > children: { > myChildComponent: { > myChildOption: true > } > } > }); > > The children option can also be an Array of child names or > child options objects (that also include a 'name' key). > > var myComp = new MyComponent(player, { > children: [ > 'button', > { > name: 'button', > someOtherOption: true > } > ] > }); _inherited from_: [src/js/component.js#L481](https://github.com/videojs/video.js/blob/master/src/js/component.js#L481) --- ### isFullScreen( isFS ) > Old naming for isFullscreen() **Deprecated** true ##### PARAMETERS: * __isFS__ _defined in_: [src/js/player.js#L928](https://github.com/videojs/video.js/blob/master/src/js/player.js#L928) --- ### isFullscreen( [isFS] ) > Check if the player is in fullscreen mode > > // get > var fullscreenOrNot = myPlayer.isFullscreen(); > > // set > myPlayer.isFullscreen(true); // tell the player it's in fullscreen > > NOTE: As of the latest HTML5 spec, isFullscreen is no longer an official > property and instead document.fullscreenElement is used. But isFullscreen is > still a valuable property for internal player workings. ##### PARAMETERS: * __isFS__ `Boolean` _(OPTIONAL)_ Update the player's fullscreen state ##### RETURNS: * `Boolean` true if fullscreen, false if not * `vjs.Player` self, when setting _defined in_: [src/js/player.js#L916](https://github.com/videojs/video.js/blob/master/src/js/player.js#L916) --- ### language( languageCode ) > The player's language code ##### PARAMETERS: * __languageCode__ `String` The locale string ##### RETURNS: * `String` The locale string when getting * `vjs.Player` self, when setting _defined in_: [src/js/player.js#L124](https://github.com/videojs/video.js/blob/master/src/js/player.js#L124) --- ### load() > Begin loading the src data. ##### RETURNS: * `vjs.Player` Returns the player _defined in_: [src/js/player.js#L1220](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1220) --- ### loop( value ) > Get or set the loop attribute on the video element. ##### PARAMETERS: * __value__ ##### RETURNS: * `String` The loop attribute value when getting * `vjs.Player` Returns the player when setting _defined in_: [src/js/player.js#L1277](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1277) --- ### muted( [muted] ) > Get the current muted state, or turn mute on or off > > // get > var isVolumeMuted = myPlayer.muted(); > > // set > myPlayer.muted(true); // mute the volume ##### PARAMETERS: * __muted__ `Boolean` _(OPTIONAL)_ True to mute, false to unmute ##### RETURNS: * `Boolean` True if mute is on, false if not, when getting * `vjs.Player` self, when setting mute _defined in_: [src/js/player.js#L878](https://github.com/videojs/video.js/blob/master/src/js/player.js#L878) --- ### name() > Get the component's name. The name is often used to reference the component. > > var name = myComponent.name(); ##### RETURNS: * `String` _inherited from_: [src/js/component.js#L277](https://github.com/videojs/video.js/blob/master/src/js/component.js#L277) --- ### networkState() > Returns the current state of network activity for the element, from > the codes in the list below. > - NETWORK_EMPTY (numeric value 0) > The element has not yet been initialised. All attributes are in > their initial states. > - NETWORK_IDLE (numeric value 1) > The element's resource selection algorithm is active and has > selected a resource, but it is not actually using the network at > this time. > - NETWORK_LOADING (numeric value 2) > The user agent is actively trying to download data. > - NETWORK_NO_SOURCE (numeric value 3) > The element's resource selection algorithm is active, but it has > not yet found a resource to use. ##### RETURNS: * `Number` the current network activity state _defined in_: [src/js/player.js#L1662](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1662) --- ### off( [first], [second], [third] ) > Remove an event listener from this component's element > > myComponent.off('eventType', myFunc); > > If myFunc is excluded, ALL listeners for the event type will be removed. > If eventType is excluded, ALL listeners will be removed from the component. > > Alternatively you can use `off` to remove listeners that were added to other > elements or components using `myComponent.on(otherComponent...`. > In this case both the event type and listener function are REQUIRED. > > myComponent.off(otherElement, 'eventType', myFunc); > myComponent.off(otherComponent, 'eventType', myFunc); ##### PARAMETERS: * __first__ `String|vjs.Component` _(OPTIONAL)_ The event type or other component * __second__ `Function|String` _(OPTIONAL)_ The listener function or event type * __third__ `Function` _(OPTIONAL)_ The listener for other component ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L646](https://github.com/videojs/video.js/blob/master/src/js/component.js#L646) --- ### on( first, second, third ) > Add an event listener to this component's element > > var myFunc = function(){ > var myComponent = this; > // Do something when the event is fired > }; > > myComponent.on('eventType', myFunc); > > The context of myFunc will be myComponent unless previously bound. > > Alternatively, you can add a listener to another element or component. > > myComponent.on(otherElement, 'eventName', myFunc); > myComponent.on(otherComponent, 'eventName', myFunc); > > The benefit of using this over `vjs.on(otherElement, 'eventName', myFunc)` > and `otherComponent.on('eventName', myFunc)` is that this way the listeners > will be automatically cleaned up when either component is disposed. > It will also bind myComponent as the context of myFunc. > > **NOTE**: When using this on elements in the page other than window > and document (both permanent), if you remove the element from the DOM > you need to call `vjs.trigger(el, 'dispose')` on it to clean up > references to it and allow the browser to garbage collect it. ##### PARAMETERS: * __first__ `String|vjs.Component` The event type or other component * __second__ `Function|String` The event handler or event type * __third__ `Function` The event handler ##### RETURNS: * `vjs.Component` self _inherited from_: [src/js/component.js#L577](https://github.com/videojs/video.js/blob/master/src/js/component.js#L577) --- ### one( first, second, [third] ) > Add an event listener to be triggered only once and then removed > > myComponent.one('eventName', myFunc); > > Alternatively you can add a listener to another element or component > that will be triggered only once. > > myComponent.one(otherElement, 'eventName', myFunc); > myComponent.one(otherComponent, 'eventName', myFunc); ##### PARAMETERS: * __first__ `String|vjs.Component` The event type or other component * __second__ `Function|String` The listener function or event type * __third__ `Function` _(OPTIONAL)_ The listener function for other component ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L691](https://github.com/videojs/video.js/blob/master/src/js/component.js#L691) --- ### options( obj ) > Deep merge of options objects > > Whenever a property is an object on both options objects > the two properties will be merged using vjs.obj.deepMerge. > > This is used for merging options for child components. We > want it to be easy to override individual options on a child > component without having to rewrite all the other default options. > > Parent.prototype.options_ = { > children: { > 'childOne': { 'foo': 'bar', 'asdf': 'fdsa' }, > 'childTwo': {}, > 'childThree': {} > } > } > newOptions = { > children: { > 'childOne': { 'foo': 'baz', 'abc': '123' } > 'childTwo': null, > 'childFour': {} > } > } > > this.options(newOptions); > > RESULT > > { > children: { > 'childOne': { 'foo': 'baz', 'asdf': 'fdsa', 'abc': '123' }, > 'childTwo': null, // Disabled. Won't be initialized. > 'childThree': {}, > 'childFour': {} > } > } ##### PARAMETERS: * __obj__ `Object` Object of new option values ##### RETURNS: * `Object` A NEW object of this.options_ and obj merged _inherited from_: [src/js/component.js#L179](https://github.com/videojs/video.js/blob/master/src/js/component.js#L179) --- ### pause() > Pause the video playback > > myPlayer.pause(); ##### RETURNS: * `vjs.Player` self _defined in_: [src/js/player.js#L659](https://github.com/videojs/video.js/blob/master/src/js/player.js#L659) --- ### paused() > Check if the player is paused > > var isPaused = myPlayer.paused(); > var isPlaying = !myPlayer.paused(); ##### RETURNS: * `Boolean` false if the media is currently playing, or true otherwise _defined in_: [src/js/player.js#L672](https://github.com/videojs/video.js/blob/master/src/js/player.js#L672) --- ### play() > start media playback > > myPlayer.play(); ##### RETURNS: * `vjs.Player` self _defined in_: [src/js/player.js#L647](https://github.com/videojs/video.js/blob/master/src/js/player.js#L647) --- ### playbackRate( rate ) > Gets or sets the current playback rate. ##### PARAMETERS: * __rate__ `Boolean` New playback rate to set. ##### RETURNS: * `Number` Returns the new playback rate when setting * `Number` Returns the current playback rate when getting _defined in_: [src/js/player.js#L1606](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1606) --- ### player() > Return the component's player ##### RETURNS: * `vjs.Player` _inherited from_: [src/js/component.js#L126](https://github.com/videojs/video.js/blob/master/src/js/component.js#L126) --- ### poster( [src] ) > get or set the poster image source url > > ##### EXAMPLE: > > // getting > var currentPoster = myPlayer.poster(); > > // setting > myPlayer.poster('http://example.com/myImage.jpg'); ##### PARAMETERS: * __src__ `String` _(OPTIONAL)_ Poster image source URL ##### RETURNS: * `String` poster URL when getting * `vjs.Player` self when setting _defined in_: [src/js/player.js#L1308](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1308) --- ### preload( value ) > Get or set the preload attribute. ##### PARAMETERS: * __value__ ##### RETURNS: * `String` The preload attribute value when getting * `vjs.Player` Returns the player when setting _defined in_: [src/js/player.js#L1249](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1249) --- ### ready( fn ) > Bind a listener to the component's ready state > > Different from event listeners in that if the ready event has already happened > it will trigger the function immediately. ##### PARAMETERS: * __fn__ `Function` Ready listener ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L769](https://github.com/videojs/video.js/blob/master/src/js/component.js#L769) --- ### readyState() > Returns a value that expresses the current state of the element > with respect to rendering the current playback position, from the > codes in the list below. > - HAVE_NOTHING (numeric value 0) > No information regarding the media resource is available. > - HAVE_METADATA (numeric value 1) > Enough of the resource has been obtained that the duration of the > resource is available. > - HAVE_CURRENT_DATA (numeric value 2) > Data for the immediate current playback position is available. > - HAVE_FUTURE_DATA (numeric value 3) > Data for the immediate current playback position is available, as > well as enough data for the user agent to advance the current > playback position in the direction of playback. > - HAVE_ENOUGH_DATA (numeric value 4) > The user agent estimates that enough data is available for > playback to proceed uninterrupted. ##### RETURNS: * `Number` the current playback rendering state _defined in_: [src/js/player.js#L1687](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1687) --- ### remainingTime() > Calculates how much time is left. > > var timeLeft = myPlayer.remainingTime(); > > Not a native video element function, but useful ##### RETURNS: * `Number` The time remaining in seconds _defined in_: [src/js/player.js#L742](https://github.com/videojs/video.js/blob/master/src/js/player.js#L742) --- ### removeChild( component ) > Remove a child component from this component's list of children, and the > child component's element from this component's element ##### PARAMETERS: * __component__ `vjs.Component` Component to remove _inherited from_: [src/js/component.js#L420](https://github.com/videojs/video.js/blob/master/src/js/component.js#L420) --- ### removeClass( classToRemove ) > Remove a CSS class name from the component's element ##### PARAMETERS: * __classToRemove__ `String` Classname to remove ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L837](https://github.com/videojs/video.js/blob/master/src/js/component.js#L837) --- ### requestFullScreen() > Old naming for requestFullscreen **Deprecated** true _defined in_: [src/js/player.js#L992](https://github.com/videojs/video.js/blob/master/src/js/player.js#L992) --- ### requestFullscreen() > Increase the size of the video to full screen > > myPlayer.requestFullscreen(); > > In some browsers, full screen is not supported natively, so it enters > "full window mode", where the video fills the browser window. > In browsers and devices that support native full screen, sometimes the > browser's default controls will be shown, and not the Video.js custom skin. > This includes most mobile devices (iOS, Android) and older versions of > Safari. ##### RETURNS: * `vjs.Player` self _defined in_: [src/js/player.js#L947](https://github.com/videojs/video.js/blob/master/src/js/player.js#L947) --- ### seeking() > Returns whether or not the player is in the "seeking" state. ##### RETURNS: * `Boolean` True if the player is in the seeking state, false if not. _defined in_: [src/js/player.js#L1470](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1470) --- ### setInterval( fn, interval ) > Creates an interval and sets up disposal automatically. ##### PARAMETERS: * __fn__ `Function` The function to run every N seconds. * __interval__ `Number` Number of ms to delay before executing specified function. ##### RETURNS: * `Number` Returns the interval ID _inherited from_: [src/js/component.js#L1202](https://github.com/videojs/video.js/blob/master/src/js/component.js#L1202) --- ### setTimeout( fn, timeout ) > Creates timeout and sets up disposal automatically. ##### PARAMETERS: * __fn__ `Function` The function to run after the timeout. * __timeout__ `Number` Number of ms to delay before executing specified function. ##### RETURNS: * `Number` Returns the timeout ID _inherited from_: [src/js/component.js#L1162](https://github.com/videojs/video.js/blob/master/src/js/component.js#L1162) --- ### show() > Show the component element if hidden ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L847](https://github.com/videojs/video.js/blob/master/src/js/component.js#L847) --- ### src( [source] ) > The source function updates the video source > > There are three types of variables you can pass as the argument. > > **URL String**: A URL to the the video file. Use this method if you are sure > the current playback technology (HTML5/Flash) can support the source you > provide. Currently only MP4 files can be used in both HTML5 and Flash. > > myPlayer.src("http://www.example.com/path/to/video.mp4"); > > **Source Object (or element):** A javascript object containing information > about the source file. Use this method if you want the player to determine if > it can support the file using the type information. > > myPlayer.src({ type: "video/mp4", src: "http://www.example.com/path/to/video.mp4" }); > > **Array of Source Objects:** To provide multiple versions of the source so > that it can be played using HTML5 across browsers you can use an array of > source objects. Video.js will detect which version is supported and load that > file. > > myPlayer.src([ > { type: "video/mp4", src: "http://www.example.com/path/to/video.mp4" }, > { type: "video/webm", src: "http://www.example.com/path/to/video.webm" }, > { type: "video/ogg", src: "http://www.example.com/path/to/video.ogv" } > ]); ##### PARAMETERS: * __source__ `String|Object|Array` _(OPTIONAL)_ The source URL, object, or array of sources ##### RETURNS: * `String` The current video source when getting * `String` The player when setting _defined in_: [src/js/player.js#L1135](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1135) --- ### textTracks() > Get an array of associated text tracks. captions, subtitles, chapters, descriptions > http://www.w3.org/html/wg/drafts/html/master/embedded-content-0.html#dom-media-texttracks ##### RETURNS: * `Array` Array of track objects _defined in_: [src/js/player.js#L1704](https://github.com/videojs/video.js/blob/master/src/js/player.js#L1704) --- ### trigger( event ) > Trigger an event on an element > > myComponent.trigger('eventName'); > myComponent.trigger({'type':'eventName'}); ##### PARAMETERS: * __event__ `Event|Object|String` A string (the type) or an event object with a type attribute ##### RETURNS: * `vjs.Component` self _inherited from_: [src/js/component.js#L724](https://github.com/videojs/video.js/blob/master/src/js/component.js#L724) --- ### triggerReady() > Trigger the ready listeners ##### RETURNS: * `vjs.Component` _inherited from_: [src/js/component.js#L788](https://github.com/videojs/video.js/blob/master/src/js/component.js#L788) --- ### volume( percentAsDecimal ) > Get or set the current volume of the media > > // get > var howLoudIsIt = myPlayer.volume(); > > // set > myPlayer.volume(0.5); // Set volume to half > > 0 is off (muted), 1.0 is all the way up, 0.5 is half way. ##### PARAMETERS: * __percentAsDecimal__ `Number` The new volume as a decimal percent ##### RETURNS: * `Number` The current volume, when getting * `vjs.Player` self, when setting _defined in_: [src/js/player.js#L848](https://github.com/videojs/video.js/blob/master/src/js/player.js#L848) --- ### width( [num], skipListeners ) > Set or get the width of the component (CSS values) > > Setting the video tag dimension values only works with values in pixels. > Percent values will not work. > Some percents can be used, but width()/height() will return the number + %, > not the actual computed width/height. ##### PARAMETERS: * __num__ `Number|String` _(OPTIONAL)_ Optional width number * __skipListeners__ `Boolean` Skip the 'resize' event trigger ##### RETURNS: * `vjs.Component` This component, when setting the width * `Number|String` The width, when getting _inherited from_: [src/js/component.js#L910](https://github.com/videojs/video.js/blob/master/src/js/component.js#L910) --- ## EVENTS ### durationchange `EVENT` > Fired when the duration of the media resource is first known or changed _defined in_: [src/js/player.js#L536](https://github.com/videojs/video.js/blob/master/src/js/player.js#L536) --- ### ended `EVENT` > Fired when the end of the media resource is reached (currentTime == duration) _defined in_: [src/js/player.js#L522](https://github.com/videojs/video.js/blob/master/src/js/player.js#L522) --- ### error `EVENT` > Fired when an error occurs _defined in_: [src/js/player.js#L577](https://github.com/videojs/video.js/blob/master/src/js/player.js#L577) --- ### firstplay `EVENT` > Fired the first time a video is played > > Not part of the HLS spec, and we're not sure if this is the best > implementation yet, so use sparingly. If you don't have a reason to > prevent playback, use `myPlayer.one('play');` instead. _defined in_: [src/js/player.js#L479](https://github.com/videojs/video.js/blob/master/src/js/player.js#L479) --- ### fullscreenchange `EVENT` > Fired when the player switches in or out of fullscreen mode _defined in_: [src/js/player.js#L565](https://github.com/videojs/video.js/blob/master/src/js/player.js#L565) --- ### loadedalldata `EVENT` > Fired when the player has finished downloading the source data _defined in_: [src/js/player.js#L421](https://github.com/videojs/video.js/blob/master/src/js/player.js#L421) --- ### loadeddata `EVENT` > Fired when the player has downloaded data at the current playback position _defined in_: [src/js/player.js#L415](https://github.com/videojs/video.js/blob/master/src/js/player.js#L415) --- ### loadedmetadata `EVENT` > Fired when the player has initial duration and dimension information _defined in_: [src/js/player.js#L409](https://github.com/videojs/video.js/blob/master/src/js/player.js#L409) --- ### loadstart `EVENT` > Fired when the user agent begins looking for media data _defined in_: [src/js/player.js#L366](https://github.com/videojs/video.js/blob/master/src/js/player.js#L366) --- ### pause `EVENT` > Fired whenever the media has been paused _defined in_: [src/js/player.js#L493](https://github.com/videojs/video.js/blob/master/src/js/player.js#L493) --- ### play `EVENT` > Fired whenever the media begins or resumes playback _defined in_: [src/js/player.js#L427](https://github.com/videojs/video.js/blob/master/src/js/player.js#L427) --- ### progress `EVENT` > Fired while the user agent is downloading media data _defined in_: [src/js/player.js#L511](https://github.com/videojs/video.js/blob/master/src/js/player.js#L511) --- ### resize `EVENT` > Fired when the width and/or height of the component changes _inherited from_: [src/js/component.js#L1020](https://github.com/videojs/video.js/blob/master/src/js/component.js#L1020) --- ### seeked `EVENT` > Fired when the player has finished jumping to a new time _defined in_: [src/js/player.js#L466](https://github.com/videojs/video.js/blob/master/src/js/player.js#L466) --- ### seeking `EVENT` > Fired whenever the player is jumping to a new time _defined in_: [src/js/player.js#L458](https://github.com/videojs/video.js/blob/master/src/js/player.js#L458) --- ### timeupdate `EVENT` > Fired when the current playback position has changed > > During playback this is fired every 15-250 milliseconds, depending on the > playback technology in use. _defined in_: [src/js/player.js#L505](https://github.com/videojs/video.js/blob/master/src/js/player.js#L505) --- ### volumechange `EVENT` > Fired when the volume changes _defined in_: [src/js/player.js#L559](https://github.com/videojs/video.js/blob/master/src/js/player.js#L559) --- ### waiting `EVENT` > Fired whenever the media begins waiting _defined in_: [src/js/player.js#L441](https://github.com/videojs/video.js/blob/master/src/js/player.js#L441) ---