diff --git a/docs/guides/tracks.md b/docs/guides/tracks.md index 42fb45fdd..e12446cf5 100644 --- a/docs/guides/tracks.md +++ b/docs/guides/tracks.md @@ -32,6 +32,11 @@ Once you have your WebVTT file created, you can add it to Video.js using the tra ``` +Subtitles from Another Domain +----------------------------- +Because we're pulling in the text track file via Javascript, the [same-origin policy](http://en.wikipedia.org/wiki/Same_origin_policy) applies. If you'd like to have a player served from one domain, +but the text track served from another, you'll need to [enable CORS](http://enable-cors.org/) in order to do so. + Track Attributes ---------------- Additional settings for track tags. @@ -92,10 +97,10 @@ The two-letter code (valid BCP 47 language tag) for the language of the text tra fjFiji fiFinnish - + - + @@ -135,10 +140,10 @@ The two-letter code (valid BCP 47 language tag) for the language of the text tra
frFrench
fyFrisian
loLaothian
laLatin
- + - + @@ -178,10 +183,10 @@ The two-letter code (valid BCP 47 language tag) for the language of the text tra
lvLatvian (Lettish)
liLimburgish ( Limburger)
iiSichuan Yi
sdSindhi
- + - + @@ -219,7 +224,7 @@ The two-letter code (valid BCP 47 language tag) for the language of the text tra
siSinhalese
ssSiswati
yoYoruba
zuZulu
- + diff --git a/src/js/player.js b/src/js/player.js index 1b77fcb74..6df7e21f9 100644 --- a/src/js/player.js +++ b/src/js/player.js @@ -1226,7 +1226,6 @@ vjs.Player.prototype.sourceList_ = function(sources){ * Begin loading the src data. * @return {vjs.Player} Returns the player */ -// http://dev.w3.org/html5/spec/video.html#dom-media-load vjs.Player.prototype.load = function(){ this.techCall('load'); return this; @@ -1237,7 +1236,6 @@ vjs.Player.prototype.load = function(){ * Can be used in conjuction with `currentType` to assist in rebuilding the current source object. * @return {String} The current source */ -// http://dev.w3.org/html5/spec/video.html#dom-media-currentsrc vjs.Player.prototype.currentSrc = function(){ return this.techGet('currentSrc') || this.cache_.src || ''; }; @@ -1252,7 +1250,11 @@ vjs.Player.prototype.currentType = function(){ return this.currentType_ || ''; }; -// Attributes/Options +/** + * Get or set the preload attribute. + * @return {String} The preload attribute value when getting + * @return {vjs.Player} Returns the player when setting + */ vjs.Player.prototype.preload = function(value){ if (value !== undefined) { this.techCall('setPreload', value); @@ -1261,6 +1263,12 @@ vjs.Player.prototype.preload = function(value){ } return this.techGet('preload'); }; + +/** + * Get or set the autoplay attribute. + * @return {String} The autoplay attribute value when getting + * @return {vjs.Player} Returns the player when setting + */ vjs.Player.prototype.autoplay = function(value){ if (value !== undefined) { this.techCall('setAutoplay', value); @@ -1269,6 +1277,12 @@ vjs.Player.prototype.autoplay = function(value){ } return this.techGet('autoplay', value); }; + +/** + * Get or set the loop attribute on the video element. + * @return {String} The loop attribute value when getting + * @return {vjs.Player} Returns the player when setting + */ vjs.Player.prototype.loop = function(value){ if (value !== undefined) { this.techCall('setLoop', value); @@ -1452,7 +1466,16 @@ vjs.Player.prototype.error = function(err){ return this; }; +/** + * Returns whether or not the player is in the "ended" state. + * @return {Boolean} True if the player is in the ended state, false if not. + */ vjs.Player.prototype.ended = function(){ return this.techGet('ended'); }; + +/** + * Returns whether or not the player is in the "seeking" state. + * @return {Boolean} True if the player is in the seeking state, false if not. + */ vjs.Player.prototype.seeking = function(){ return this.techGet('seeking'); }; // When the player is first initialized, trigger activity so components @@ -1589,6 +1612,12 @@ vjs.Player.prototype.listenForUserActivity = function(){ }); }; +/** + * Gets or sets the current playback rate. + * @param {Boolean} rate New playback rate to set. + * @return {Number} Returns the new playback rate when setting + * @return {Number} Returns the current playback rate when getting + */ vjs.Player.prototype.playbackRate = function(rate) { if (rate !== undefined) { this.techCall('setPlaybackRate', rate); @@ -1603,7 +1632,21 @@ vjs.Player.prototype.playbackRate = function(rate) { }; +/** + * Store the current audio state + * @type {Boolean} + * @private + */ vjs.Player.prototype.isAudio_ = false; + +/** + * Gets or sets the audio flag + * + * @param {Boolean} bool True signals that this is an audio player. + * @return {Boolean} Returns true if player is audio, false if not when getting + * @return {vjs.Player} Returns the player if setting + * @private + */ vjs.Player.prototype.isAudio = function(bool) { if (bool !== undefined) { this.isAudio_ = !!bool;