videojs文檔翻譯-Player（v6.0.0-RC.2）

Player

當使用任何Video.js設置方法初始化視頻時，將建立Player類的實例。

建立實例後，能夠經過兩種方式在全局訪問：

調用videojs（'example_video_1'）;
直接經過videojs.players.example_video_1使用它;

構造函數

new Player(tag, optionsopt, readyopt)

建立此類的實例

參數:

名稱	類型	屬性	描述
tag	Element		用於配置選項的原始 video DOM 元素。
options	Object	<optional>	選項名稱和值的對象。
ready	Component~ReadyCallback	<optional>	Ready 回調函數。

延伸

• Component

 

成員

---

 靜態 players :Object

全局播放器列表。

 

方法

---

 靜態 getTagSettings(tag) → {Object}

獲取標籤設置

參數:

名稱	類型	描述
tag	Element	播放器標籤

返回值:

Object - 包含播放器標籤的全部設置的對象

$(selector, contextopt) → {Element|null}

查找與選擇器匹配的單個DOM元素。 這能夠在組件contentEl（）或另外一個自定義上下文中。

Parameters:

名稱	類型	屬性	默認	描述
selector	string			一個有效的CSS選擇器，它將被傳遞給querySelector。
context	Element | string	<optional>	this.contentEl()	要查詢的DOM元素。 也能夠是選擇器字符串，在這種狀況下，第一個匹配元素將用做上下文。 若是缺失則this.contentEl（）被使用。 若是this.contentEl（）不返回任何東西，它會回到 document。

返回值:

Element | null - 找到的dom元素，或null

繼承自:

• Component#$

$$(selector, contextopt) → {NodeList}

查找與選擇器匹配的全部DOM元素。 這能夠在組件contentEl（）或另外一個自定義上下文中。

參數:

名稱	類型	屬性	默認	描述
selector	string			一個有效的CSS選擇器，它將被傳遞給 querySelectorAll.
context	Element | string	<optional>	this.contentEl()	要查詢的DOM元素。 也能夠是選擇器字符串，在這種狀況下，第一個匹配元素將用做上下文。 若是缺失則this.contentEl（）被使用。 若是this.contentEl（）不返回任何東西，它會回到 document。

返回值:

NodeList - 找到的dom元素的列表

繼承自:

• Component#$$

addChild(child, optionsopt, indexopt) → {Component}

在當前組件中添加子組件。

參數:

名稱	類型	屬性	默認	描述
child	string | Component			要添加的子級的名稱或實例。
options	Object	<optional>	{}	將要傳遞給子級的子組件選項的鍵/值存儲。
index	number	<optional>	this.children_.length	嘗試添加子元素的索引。

返回值:

Component - 做爲子項添加的組件。 當使用字符串時，組件將由此過程建立。

繼承自:

• Component#addChild

addClass(classToAdd)

 　　 向Components元素添加CSS類名稱。

參數:

名稱	類型	描述
classToAdd	string	添加的CSS類名稱

繼承自:

• Component#addClass

addRemoteTextTrack(options, manualCleanupopt) → {HTMLTrackElement}

建立遠程TextTrack和HTMLTrackElement。 每當源更改時，它將從視頻元素中自動刪除，除非manualCleanup設置爲false。

參數:

名稱	類型	屬性	默認	描述
options	Object			在建立期間傳遞到HTMLTrackElement的選項。 請參閱您應該使用的對象屬性的HTMLTrackElement。
manualCleanup	boolean	<optional>	true	若是設置爲false，TextTrack 不會自動刪除

返回值:

HTMLTrackElement - 

已建立並添加到HTMLTrackElementList和遠程TextTrackList的HTMLTrackElement

已棄用:

• 在即將到來的Video.js版本中，「manualCleanup」參數的默認值默認爲「false」

addTextTrack(kindopt, labelopt, languageopt) → {TextTrack|undefined}

用於向TextTrackList添加TextTrack的輔助方法。

除了W3C設置，咱們容許經過選項添加附加信息。

參數:

名稱	類型	屬性	描述
kind	string	<optional>	您要添加的TextTrack的類型
label	string	<optional>	標籤給出TextTrack標籤
language	string	<optional>	在TextTrack上設置的語言

返回值:

TextTrack | undefined - 已被添加的TextTrack或undefined （若是沒有技術）

aspectRatio(ratioopt) → {string|undefined}

用於播放器寬高比的getter / setter。

參數:

名稱	類型	屬性	描述
ratio	string	<optional>	設置播放器寬高比的值。

返回值:

string | undefined -

• 播放器當前的縱橫比，獲取時

   - undefined 設置時

audioTracks() → {AudioTrackList}

獲取AudioTrackList

返回值:

AudioTrackList - 

當前音軌列表

autoplay(valueopt) → {string} 

獲取或設置autoplay屬性。

參數:

名稱	類型	屬性	描述
value	boolean	<optional>	true 表示咱們應該自動播放 - false 表示咱們應該不自動播放

返回值:

string - 

獲取時自動播放的當前值

blur()

今後組件中刪除焦點

繼承自:

• Component#blur

buffered() → {TimeRange}

使用已下載的視頻時間數組獲取TimeRange對象。 若是您只想要下載的視頻的百分比，請使用bufferedPercent。

返回值:

TimeRange - 模擬TimeRange對象（遵循HTML規範）

bufferedEnd() → {number}

獲取上次緩衝時間範圍的結束時間這在進度條中用於封裝全部時間範圍。

返回值:

number - 最新緩衝時間範圍的結束

bufferedPercent() → {number}

獲取已下載視頻的百分比（十進制）。 此方法不是原生HTML video API的一部分。

返回值:

number - 0和1之間的小數表示緩衝的百分比，0是0％，1是100％

abstract（抽象修飾） buildCSSClass() → {string}

構建默認DOM類名稱。 應該被子組件覆蓋。

返回值:

string - 此對象的DOM類名稱。

繼承自:

• Component#buildCSSClass

cancelAnimationFrame(id) → {number}

取消傳遞到Component＃requestAnimationFrame（rAF）的排隊回調。

若是您經過Component＃requestAnimationFrame對rAF回調進行排隊，請使用此函數，而不是window.cancelAnimationFrame。 若是沒有，你的Dispose偵聽器將不會被清除，直到Component＃dispose！

參數:

名稱	類型	描述
id	number	要清除的rAF ID。 Component＃requestAnimationFrame的返回值。

返回值:

number - 返回已清除的rAF ID。

繼承自:

• Component#cancelAnimationFrame

canPlayType(type) → {string}

檢查播放器是否能夠播放給定的mimetype

參數:

名稱	類型	描述
type	string	要檢查的mimetype

返回值:

string - 'probably', 'maybe', or '' (empty string) - 頗有可能、可能、空字符串

 

children() → {Array}

獲取全部子組件的數組

返回值:

Array - 子組件的數組

繼承自:

• Component#children

clearInterval(intervalId) → {number}

清除經過window.setInterval或Component＃setInterval建立的間隔。 若是經過組件＃setInterval設置一個inteval，則使用此函數，而不是使用window.clearInterval。 若是你不這樣作，你的配置偵聽器將不會被清理，直到Component＃dispose！

參數:

名稱	類型	描述
intervalId	number	要清除的間隔的ID。Component＃setInterval或window.setInterval的返回值。

返回值:

number - 返回已清除的間隔ID。

繼承自:

• Component#clearInterval

clearTimeout(timeoutId) → {number}

清除經過window.setTimeout或Component＃setTimeout建立的超時。 若是經過Component＃setTimeout設置超時，則使用此函數，而不是使用window.clearTimout。 若是你不這樣作，你的配置偵聽器將不會被清理，直到Component＃dispose！

參數:

名稱	類型	描述
timeoutId	number	要清除的超時的ID。 Component＃setTimeout或window.setTimeout的返回值。

返回值:

number - 返回已清除的超時id。

繼承自:

• Component#clearTimeout

contentEl() → {Element}

返回組件DOM元素。 這是子組件插入的地方。 這一般與Component＃el中返回的元素相同。

返回值:

Element - 組件的內容元素。

繼承自:

• Component#contentEl

controls(boolopt) → {boolean}

獲取或設置控件是否顯示。

參數:

名稱	類型	屬性	描述
bool	boolean	<optional>	true 打開控制 - false 關閉控制

觸發器:

• Player#event:controlsenabled

返回值:

boolean - 獲取時controls的當前值

createEl() → {Element}

建立播放器的DOM元素。

返回值:

Element - 建立的DOM元素。

覆蓋:

• Component#createEl

createModal(content, optionsopt) → {ModalDialog}

建立一個簡單的模態對話框（ModalDialog組件的一個實例），當即用任意內容覆蓋播放器，並在關閉時刪除它本身。

參數:

名稱	類型	屬性	描述
content	string | function | Element |Array | null		與ModalDialog＃content的同名參數相同。 最直接的用法是提供一個字符串或DOM元素。
options	Object	<optional>	將被傳遞到ModalDialog的額外選項。

返回值:

ModalDialog - 建立的ModalDialog

currentDimension(widthOrHeight) → {number}

獲取組件元素計算樣式的寬度或高度。 使用window.getComputedStyle。

參數:

名稱	類型	描述
widthOrHeight	string	包含「width」或「height」的字符串。 不管你想獲得什麼。

返回值:

number - 獲取要求的維度，若是未爲該維度設置任何內容，則爲0。

繼承自:

• Component#currentDimension

currentDimensions() → {Component~DimensionObject}

獲取包含組件計算樣式的寬度和高度值的對象。

返回值:

Component~DimensionObject - 組件元素的尺寸

繼承自:

• Component#currentDimensions

currentHeight() → {number}

獲取組件計算樣式的高度。 使用window.getComputedStyle。

返回值:

number - 組件計算樣式的高度。

Inherited From:

• Component#currentHeight

currentSource() → {Tech~SourceObject}

返回當前資源對象。

返回值:

Tech~SourceObject - 當前資源對象

currentSources() → {Array.<Tech~SourceObject>}

返回全部當前資源對象。

Returns:

Array.<Tech~SourceObject> - 當前資源對象數組

currentSrc() → {string}

返回當前資源值的徹底限定網址，例如 http://mysite.com/video.mp4能夠與currentType結合使用，以幫助重建當前源對象。

返回值:

string - 當前資源網址

currentTime(secondsopt) → {number}

獲取或設置當前時間（以秒爲單位）

參數:

名稱	類型	屬性	描述
seconds	number | string	<optional>	設置時尋找的時間，以秒爲單位

返回值:

number -

• 獲取時以秒爲單位的當前時間

currentType() → {string}

獲取當前的資源類型，例如 video / mp4，這能夠容許您重建當前源對象，以便之後能夠加載相同的資源和技術

返回值:

string - 資源的MIME類型

currentWidth() → {number}

獲取組件計算樣式的寬度。 使用window.getComputedStyle。

返回值:

number - 組件計算樣式的寬度。

繼承自:

• Component#currentWidth

defaultMuted(defaultMutedopt) → {boolean|Player}

獲取當前的defaultMuted狀態，或打開或關閉defaultMuted。 defaultMuted表示初始播放時靜音的狀態。

var myPlayer = videojs('some-player-id');

  myPlayer.src("http://www.example.com/path/to/video.mp4");

  // 獲取的值爲false
  console.log(myPlayer.defaultMuted());
  // 設置爲true
  myPlayer.defaultMuted(true);
  // 獲取的值爲 true
  console.log(myPlayer.defaultMuted());

參數:

名稱	類型	屬性	描述
defaultMuted	boolean	<optional>	true 設置爲靜音 - false 取消靜音

返回值:

boolean | Player -

• 若是defaultMuted爲on並獲取，則爲true

   - 若是defaultMuted爲off並獲取，則爲false

   - 設置時引用的當前播放器

defaultPlaybackRate(rateopt) → {number|Player}

獲取或設置當前默認播放速率。 例如默認回放速率1.0表示正常速度，0.5表示半速回放。 defaultPlaybackRate只會表示視頻的初始playbackRate，而不是當前的playbackRate。

參數:

名稱	類型	屬性	描述
rate	number	<optional>	要設置的新默認播放速率。

返回值:

number | Player -

•  獲取時的默認播放速率 or 1.0

   - 設置時返回播放器

dimension(dimension, valueopt) → {number} 維度

播放器寬度和高度的getter / setter。

參數:

名稱	類型	屬性	描述
dimension	string		此字符串多是: - 'width' - 'height'
value	number	<optional>	第一個參數中指定的維度值。

返回值:

number - 獲取時制定的維度參數值 (width/height).

覆蓋:

• Component#dimension

dimensions(width, height)

同時設置Component元素的寬度和高度。

參數:

名稱	類型	描述
width	number | string	要設置的Component元素的寬度。
height	number | string	要設置的Component元素的高度。

繼承自:

• Component#dimensions

dispose()

銷燬視頻播放器並進行任何須要的清理。

若是您要動態向DOM添加視頻和從DOM中刪除視頻，這一點尤爲有用。

觸發:

• Player#event:dispose

覆蓋:

• Component#dispose

duration(secondsopt) → {number}

一般獲取視頻的時間長度（以秒爲單位）; 除了最罕見的用例以外，參數不會被傳遞給方法

注意：視頻必須在已知持續時間以前開始加載，對於Flash，在視頻開始播放以前可能沒法知道。

參數:

名稱	類型	屬性	描述
seconds	number	<optional>	視頻設置的持續時間（以秒爲單位）

Fires:

• Player#event:durationchange

返回值:

number -

• 獲取視頻的時長（以秒爲單位）

el() → {Element}

獲取組件的的dom元素

返回值:

Element - 

The DOM element for this Component.

Inherited From:

• Component#el

enableTouchActivity()

此函數在觸摸事件發生時報告用戶活動。這能夠關閉任何想要觸摸事件以另一種方式運行的子組件

觸摸事件發生時報告用戶觸摸活動。用戶活動用於肯定控件什麼時候應顯示/隱藏。它是簡單的，當涉及到鼠標事件，由於任何鼠標事件應該顯示控件。所以，咱們捕獲向玩家發出的鼠標事件，並在發生時報告活動。有觸摸事件它不像touchstart和touchend切換播放器控件同樣簡單。因此觸摸事件不能幫助咱們在播放器級別。

異步檢查用戶活動。因此可能發生的是在視頻上的點擊事件關閉控制。而後，touchend事件冒泡向玩家。其中，若是它報告用戶活動，將從新打開控件。咱們也不想徹底阻止觸摸事件冒泡。此外，touchmove事件和除了水龍頭以外的任何東西，不該該從新打開控制。

監聽下列事件:

• Component#event:touchstart
• Component#event:touchmove
• Component#event:touchend
• Component#event:touchcancel

繼承自:

• Component#enableTouchActivity

ended() → {Boolean}

返回玩家是否處於「已結束」狀態。

返回值:

Boolean - 

若是玩家處於結束狀態，則返回True ，不然返回false 。

enterFullWindow()

當不支持全屏時，咱們能夠將視頻容器拉伸到瀏覽器容許的寬度。

Fires:

• Player#event:enterFullWindow

error(erropt) → {MediaError|null}

設置或獲取當前的MediaError

參數:

名稱	類型	屬性	描述
err	MediaError | string | number	<optional>	MediaError或要變成MediaError的字符串/數字

Fires:

• Player#event:error

返回值:

MediaError | null - 

當獲取時的當前MediaError（或null）

exitFullscreen()

在全屏模式後，將視頻恢復到正常大小

Fires:

• Player#event:fullscreenchange

exitFullWindow()

退出全窗口模式

Fires:

• Player#event:exitFullWindow

flexNotSupported_() → {boolean}

肯定是否支持flexbox

返回值:

boolean -

• true 若是支持flexbox

   - false 若是不支持flexbox

fluid(boolopt) → {boolean|undefined}

Player上的vjs-fluid className的getter / setter / toggler。

參數:

名稱	類型	屬性	描述
bool	boolean	<optional>	值爲 true 則添加此calss. -值爲 false 則移除此 class. - 沒有值將toggle the fluid class.

返回值:

boolean | undefined -

• The value of fluid when getting.

   - `undefined` when setting.

focus()

將焦點設置到此組件

Inherited From:

• Component#focus

fullWindowOnEscKey(event)

在ESC鍵上檢查呼叫是退出完整窗口仍是全屏

參數:

名稱	類型	描述
event	string	Event to check for key press

getAttribute(attribute) → {string|null}

獲取Components元素上的屬性值。

參數:

名稱	類型	描述
attribute	string	要獲取值的屬性的名稱。

返回值:

string | null -

• 要求的屬性的值。
  

   - 若是該屬性不存在或沒有值，則多是某些瀏覽器上的空字符串 - 若是屬性不存在或沒有值，大多數瀏覽器將返回null。

Inherited From:

• Component#getAttribute

See:

• DOM API

getCache() → {Object}

獲取緩存值的對象。

返回值:

Object - 

獲取當前對象緩存

getChild(name) → {Component|undefined}

返回具備給定名稱的子組件。

參數:

名稱	類型	描述
name	string	要獲取的子組件的名稱。

返回值:

Component | undefined - 

具備給定名稱的子組件或未定義。

Inherited From:

• Component#getChild

getChildById(id) → {Component|undefined}

返回具備給定ID的子組件。

參數:

名稱	類型	描述
id	string	要獲取的子組件的id。

返回值:

Component | undefined - 

給定id的自組建或者undefined

Inherited From:

• Component#getChildById

hasClass(classToCheck) → {boolean}

檢查組件的元素是否具備CSS類名稱。

參數:

名稱	類型	描述
classToCheck	string	要檢查的CSS類名稱。

返回值:

boolean -

• True if the Component has the class.

   - False if the `Component` does not have the class`

Inherited From:

• Component#hasClass

hasPlugin(name) → {boolean}

報告播放器是否有可用的插件。

這裏不報告插件是否已經在這個播放器上被初始化了。 爲此，usingPlugin。

參數:

名稱	類型	描述
name	string	插件的名稱。

返回值:

boolean - 

該播放器是否具備可用的請求插件。

hasStarted(hasStarted) → {boolean}

Add/remove the vjs-has-started class

參數:

名稱	類型	描述
hasStarted	boolean	true: adds the class - false: remove the class

Fires:

• Player#event:firstplay

返回值:

boolean - 

the boolean value of hasStarted

height(valueopt) → {number}

A getter/setter for the Player's height.

參數:

名稱	類型	屬性	描述
value	number	<optional>	The value to set the `Player's heigth to.

返回值:

number - 

The current height of the Player when getting.

Overrides:

• Component#height

hide()

Hide the Components element if it is currently showing by adding the 'vjs-hidden` class name to it.

Inherited From:

• Component#hide

id() → {string}

Get this Components ID

返回值:

string - 

The id of this Component

Inherited From:

• Component#id

initChildren()

根據選項添加和初始化默認的子組件。

Inherited From:

• Component#initChildren

isAudio(bool) → {boolean}

Gets or sets the audio flag

參數:

名稱	類型	描述
bool	boolean	true signals that this is an audio player - false signals that this is not an audio player

返回值:

boolean - 

The current value of isAudio when getting

isFullscreen(isFSopt) → {boolean}

檢查播放器是否處於全屏模式，或者告訴播放器它是或不是全屏模式。

注意：根據最新的HTML5規範，isFullscreen再也不是官方屬性，而是使用document.fullscreenElement。 但isFullscreen仍然是內部播放器運行的有價值的屬性。

參數:

名稱	類型	屬性	描述
isFS	boolean	<optional>	設置播放器當前的全屏狀態

返回值:

boolean -

• true 若是全屏是開啓的而且獲取時

   - false 若是全屏是關閉的而且獲取時

language(codeopt) → {string}

 

The player's language code NOTE: The language should be set in the player options if you want the the controls to be built with a specific language. Changing the lanugage later will not update controls text.

參數:

名稱	類型	屬性	描述
code	string	<optional>	the language code to set the player to

返回值:

string - 

The current language code when getting

languages() → {Array}

 

Get the player's language dictionary Merge every time, because a newly added plugin might call videojs.addLanguage() at any time Languages specified directly in the player options have precedence

返回值:

Array - 

An array of of supported languages

load()

 

Begin loading the src data.

localize(string) → {string}

 

Localize a string given the string in english.

參數:

名稱	類型	描述
string	string	The string to localize.

返回值:

string - 

The localized string or if no localization exists the english string.

Inherited From:

• Component#localize

loop(valueopt) → {string}

 

Get or set the loop attribute on the video element.

參數:

名稱	類型	屬性	描述
value	boolean	<optional>	true means that we should loop the video - false means that we should not loop the video

返回值:

string - 

The current value of loop when getting

muted(mutedopt) → {boolean}

 

Get the current muted state, or turn mute on or off

參數:

名稱	類型	屬性	描述
muted	boolean	<optional>	true to mute - false to unmute

返回值:

boolean -

• true if mute is on and getting

   - false if mute is off and getting

name() → {string}

 

Get the Components name. The name gets used to reference the Component and is set during registration.

返回值:

string - 

The name of this Component.

Inherited From:

• Component#name

networkState() → {number}

 

從如下列表中的代碼返回元素的網絡活動的當前狀態。

• NETWORK_EMPTY (numeric value 0) 元素還沒有初始化， 全部屬性都處於初始狀態。
• NETWORK_IDLE (numeric value 1) 元素的資源選擇算法處於活動狀態，而且已經選擇了一個資源，但此時並不實際使用該網絡。
• NETWORK_LOADING (numeric value 2) 用戶代理正在積極嘗試下載數據。
• NETWORK_NO_SOURCE (numeric value 3) 元素的資源選擇算法處於活動狀態，但還沒有找到要使用的資源。

返回值:

number - 

當前網絡活動狀態

options(obj) → {Object}

 

Deep merge of options objects with new options.

Note: When both obj and options contain properties whose values are objects. The two properties get merged using module:mergeOptions

參數:

名稱	類型	描述
obj	Object	The object that contains new options.

返回值:

Object - 

A new object of this.options_ and obj merged together.

Inherited From:

• Component#options

Deprecated:

• since version 5

pause() → {Player}

 

Pause the video playback

返回值:

Player - 

A reference to the player object this function was called on

paused() → {boolean}

 

Check if the player is paused or has yet to play

返回值:

boolean -

• false: if the media is currently playing

   - true: if media is not currently playing

play() → {Promise|undefined}

 

start media playback

返回值:

Promise | undefined - 

Returns a Promise if the browser returns one, for most browsers this will return undefined.

playbackRate(rateopt) → {number}

 

Gets or sets the current playback rate. A playback rate of 1.0 represents normal speed and 0.5 would indicate half-speed playback, for instance.

參數:

名稱	類型	屬性	描述
rate	number	<optional>	New playback rate to set.

返回值:

number - 

The current playback rate when getting or 1.0

See:

• https://html.spec.whatwg.org/multipage/embedded-content.html#dom-media-playbackrate

played() → {TimeRange}

 

Get a TimeRange object representing the current ranges of time that the user has played.

返回值:

TimeRange - 

A time range object that represents all the increments of time that have been played.

player() → {Player}

 

Return the Player that the Component has attached to.

返回值:

Player - 

The player that this Component has attached to.

Inherited From:

• Component#player

poster(srcopt) → {string}

 

Get or set the poster image source url

參數:

名稱	類型	屬性	描述
src	string	<optional>	Poster image source URL

Fires:

• Player#event:posterchange

返回值:

string - 

The current value of poster when getting

preload(valueopt) → {string}

獲取或設置preload屬性

參數:

名稱	類型	屬性	描述
value	boolean	<optional>	true 意味着要預加載 - false 意味着不須要預加載

返回值:

string - 

獲取時的preload屬性值

ready() → {Component}

將偵聽器綁定到組件的就緒狀態。 與事件偵聽器不一樣的是，若是ready事件已經發生，它將當即觸發該功能。

返回值:

Component - 

返回本身; 方法能夠連接。

Inherited From:

• Component#ready

readyState() → {number}

從下面的列表中的代碼返回一個值，表示當前呈現當前播放位置的元素的當前狀態。

HAVE_NOTHING（數值0）沒有關於媒體資源的信息可用。
HAVE_METADATA（數值1）已得到足夠的資源，資源的持續時間可用。
HAVE_CURRENT_DATA（數值2）即時當前播放位置的數據可用。
HAVE_FUTURE_DATA（數值3）即時當前播放位置的數據可用，以及足夠的數據供用戶代理在播放方向上提早播放當前位置。
HAVE_ENOUGH_DATA（數值4）用戶代理估計足夠的數據可用於播放以不間斷地繼續。

• HAVE_NOTHING（數值0）沒有關於媒體資源的信息可用。
• HAVE_METADATA（數值1）已得到足夠的資源，資源的持續時間可用。
• HAVE_CURRENT_DATA (數值 2) 當前播放位置的即時數據可用。
• HAVE_FUTURE_DATA (數值 3) 當前播放位置的即時數據可用, 以及足夠的數據供用戶代理在播放方向上提早播放當前位置。
• HAVE_ENOUGH_DATA (數值 4) 用戶代理估計足夠的數據可用於播放以不間斷地繼續。

返回值:

number - 

當前播放渲染狀態

See:

• https://html.spec.whatwg.org/multipage/embedded-content.html#dom-media-readystate

remainingTime() → {number}

計算視頻中剩餘多少時間。 不是原生視頻API的一部分。

返回值:

number - 

剩餘時間以秒爲單位

remoteTextTrackEls() → {HTMLTrackElementList}

 

Get the remote HTMLTrackElementList tracks.

返回值:

HTMLTrackElementList - 

The current remote text track element list

removeAttribute(attribute)

 

Remove an attribute from the Components element.

參數:

名稱	類型	描述
attribute	string	Name of the attribute to remove.

Inherited From:

• Component#removeAttribute

See:

• DOM API

removeChild(component)

 

Remove a child Component from this Components list of children. Also removes the child Components element from this Components element.

參數:

名稱	類型	描述
component	Component	The child Component to remove.

Inherited From:

• Component#removeChild

removeClass(classToRemove)

 

Remove a CSS class name from the Components element.

參數:

名稱	類型	描述
classToRemove	string	CSS class name to remove

Inherited From:

• Component#removeClass

removeRemoteTextTrack(track) → {undefined}

 

Remove a remote TextTrack from the respective TextTrackList and HTMLTrackElementList.

參數:

名稱	類型	描述
track	Object	Remote TextTrack to remove

返回值:

undefined - 

does not return anything

reportUserActivity(event)

 

Report user activity

參數:

名稱	類型	描述
event	Object	Event object

requestAnimationFrame(fn) → {number}

 

Queues up a callback to be passed to requestAnimationFrame (rAF), but with a few extra bonuses:

• Supports browsers that do not support rAF by falling back to Component#setTimeout.

• The callback is turned into a Component~GenericCallback (i.e. bound to the component).

• Automatic cancellation of the rAF callback is handled if the component is disposed before it is called.

參數:

名稱	類型	描述
fn	Component~GenericCallback	A function that will be bound to this component and executed just before the browser's next repaint.

Listens to Events:

• Component#event:dispose

返回值:

number - 

Returns an rAF ID that gets used to identify the timeout. It can also be used in Component#cancelAnimationFrame to cancel the animation frame callback.

Inherited From:

• Component#requestAnimationFrame

See:

• Similar to

requestFullscreen()

將視頻的大小增長到全屏在某些瀏覽器中，全屏不被原生支持，所以進入「完整窗口模式」，視頻填充瀏覽器窗口。 在支持原生全屏的瀏覽器和設備中，有時會顯示瀏覽器的默認控件，而不是Video.js的自定義外觀。 這包括大多數移動設備（iOS，Android）和較舊版本的Safari。

Fires:

• Player#event:fullscreenchange

reset()

重置播放器. 加載techOrder的第一個技術，而且調用tech上的重置

scrubbing(isScrubbingopt) → {boolean}

返回用戶是否正在「擦除」。 擦洗是當用戶點擊進度條手柄並沿着進度條拖動時。

參數:

名稱	類型	屬性	描述
isScrubbing	boolean	<optional>	用戶是否擦除

返回值:

boolean - 

獲取時scrubbing的值

seekable() → {TimeRanges}

返回當前可用於尋找的媒體的TimeRanges。

返回值:

TimeRanges - 

媒體時間軸的可尋找間隔

seeking() → {Boolean}

返回玩家是否處於「尋求」狀態。

返回值:

Boolean - 

若是玩家處於尋求狀態，則爲真，不然爲假。

selectSource(sources) → {Object|boolean}

Select source based on tech-order or source-order Uses source-order selection if options.sourceOrder is truthy. Otherwise, defaults to tech-order selection

參數:

名稱	類型	描述
sources	Array	The sources for a media asset

返回值:

Object | boolean - 

Object of source and tech order or false

setAttribute(attribute, value)

Set the value of an attribute on the Component's element

參數:

名稱	類型	描述
attribute	string	Name of the attribute to set.
value	string	Value to set the attribute to.

Inherited From:

• Component#setAttribute

See:

• DOM API

setInterval(fn, interval) → {number}

建立一個每x毫秒運行的函數。 這個函數是一個圍繞window.setInterval的包裝器。 用這個函數代替有如下緣由。

1. 當Component＃dispose被調用時，它經過Component＃clearInterval清除。
2. 函數回調將是一個Component〜GenericCallback

參數:

名稱	類型	描述
fn	Component~GenericCallback	每x秒運行一次的函數。
interval	number	每x毫秒執行指定的函數。

Listens to Events:

• Component#event:dispose

返回值:

number - 

返回可用於標識interval的ID。 也能夠在Component＃clearInterval中使用它來清除間隔

Inherited From:

• Component#setInterval

 

setTimeout(fn, timeout) → {number}

Creates a function that runs after an x millisecond timeout. This function is a wrapper around window.setTimeout. There are a few reasons to use this one instead though:

建立在x毫秒超時後運行的函數。 這個函數是一個圍繞window.setTimeout的包裝器。 使用這個函數的一些緣由：

1.  當Component＃dispose被調用時，它經過Component＃clearTimeout清除。
2. 函數回調將變成一個Component〜GenericCallback

注意：您能夠在此函數返回的id上使用window.clearTimeout。 這將使其dispose listene不被清理！ 請使用Component＃clearTimeout或Component＃dispose。

參數:

名稱	類型	描述
fn	Component~GenericCallback	超時後運行的函數。
timeout	number	在執行指定功能以前延遲（以毫秒爲單位）。

Listens to Events:

• Component#event:dispose

返回值:

number - 

返回用於標識超時的超時ID。 它也能夠在Component＃clearTimeout中使用，以清除設置的超時。

Inherited From:

• Component#setTimeout

 

show()

 

Show the Components element if it is hidden by removing the 'vjs-hidden' class name from it.

Inherited From:

• Component#show

src(sourceopt) → {string}

 

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.

參數:

名稱	類型	屬性	描述
source	Tech~SourceObject | Array.<Tech~SourceObject>	<optional>	One SourceObject or an array of SourceObjects

返回值:

string - 

The current video source when getting

supportsFullScreen() → {boolean}

檢查當前的技術能夠支持原生的全屏（例如，內置的控件，如iOS，因此不是咱們的Flash swf）

返回值:

boolean - 

if native fullscreen is supported

tech(safetyopt) → {Tech}

Return a reference to the current Tech. It will print a warning by default about the danger of using the tech directly but any argument that is passed in will silence the warning.

參數:

名稱	類型	屬性	描述
safety	*	<optional>	Anything passed in to silence the warning

返回值:

Tech - 

The Tech

textTracks() → {TextTrackList}

 

Get the TextTrackList

返回值:

TextTrackList - 

the current text track list

textTracks() → {TextTrackList}

 

Get the remote TextTrackList

返回值:

TextTrackList - 

The current remote text track list

toggleClass(classToToggle, predicateopt)

 

Add or remove a CSS class name from the component's element.

• classToToggle gets added when Component#hasClass would return false.
• classToToggle gets removed when Component#hasClass would return true.

參數:

名稱	類型	屬性	描述
classToToggle	string		The class to add or remove based on (@link Component#hasClass}
predicate	boolean | Dom~predicate	<optional>	An Dom~predicate function or a boolean

Inherited From:

• Component#toggleClass

toJSON() → {Object}

 

returns a JavaScript object reperesenting the current track information. DOES not return it as JSON

返回值:

Object - 

Object representing the current of track info

triggerReady()

觸發此組件的全部就緒偵聽器。

發起:

• Component#event:ready

繼承自:

• Component#triggerReady

userActive(boolopt) → {boolean}

 

Get/set if user is active

參數:

名稱	類型	屬性	描述
bool	boolean	<optional>	true if the user is active - false if the user is inactive

Fires:

• Player#event:useractive
• Player#event:userinactive

返回值:

boolean - 

The current value of userActive when getting

usingNativeControls(boolopt) → {boolean}

 

Toggle native controls on/off. Native controls are the controls built into devices (e.g. default iPhone controls), Flash, or other techs (e.g. Vimeo Controls) This should only be set by the current tech, because only the tech knows if it can support native controls

參數:

名稱	類型	屬性	描述
bool	boolean	<optional>	true to turn native controls on - false to turn native controls off

Fires:

• Player#event:usingnativecontrols
• Player#event:usingcustomcontrols

返回值:

boolean - 

The current value of native controls when getting

usingPlugin(name) → {boolean}

 

Reports whether or not a player is using a plugin by name.

For basic plugins, this only reports whether the plugin has ever been initialized on this player.

參數:

名稱	類型	描述
name	string	The name of a plugin.

返回值:

boolean - 

Whether or not this player is using the requested plugin.

videoHeight() → {number}

 

Get video height

返回值:

number - 

current video height

videoTracks() → {VideoTrackList}

 

Get the VideoTrackList

返回值:

VideoTrackList - 

the current video track list

videoWidth() → {number}

Get video width

返回值:

number - 

current video width

volume(percentAsDecimalopt) → {number}

Get or set the current volume of the media

參數:

名稱	類型	屬性	描述
percentAsDecimal	number	<optional>	The new volume as a decimal percent: - 0 is muted/0%/off - 1.0 is 100%/full - 0.5 is half volume or 50%

返回值:

number - 

The current volume as a percent when getting

width(valueopt) → {number}

A getter/setter for the Player's width.

參數:

名稱	類型	屬性	描述
value	number	<optional>	The value to set the `Player's width to.

返回值:

number - 

The current width of the Player when getting.

Overrides:

• Component#width

事件

abort

當音頻/視頻的加載停止時觸發。

類型:

• EventTarget~Event

canplay

媒體具備 HAVE_FUTURE_DATA 或更大的readyState。

類型:

• EventTarget~Event

canplaythrough

媒體具備HAVE_ENOUGH_DATA或更大的readyState。 這意味着整個媒體文件能夠無緩衝播放。

類型:

• EventTarget~Event

componentresize

調整組件大小時觸發。

類型:

• EventTarget~Event

繼承自:

• Component#event:componentresize

controlsdisabled

　　　控制條禁用時觸發。

類型:

• EventTarget~Event

controlsenabled

    　控制條啓用時觸發。

類型:

• EventTarget~Event

dispose

播放器被銷燬時調用。

類型:

• EventTarget~Event

此事件的監聽器:

• Plugin

覆蓋:

• Component#event:dispose

durationchange

　　　播放時長被更改時調用。

類型:

• EventTarget~Event

此事件的監聽器:

• DurationDisplay#updateContent
• LiveDisplay#updateShowing
• RemainingTimeDisplay#updateContent

emptied

當前播放列表爲空時觸發。

類型:

• EventTarget~Event

ended

當媒體資源結束時觸發 (currentTime == duration)

類型:

• EventTarget~Event

此事件監聽器:

• SeekBar#update

enterFullWindow

　　　當運行enterFullWindow（瀏覽器不支持全屏時的全屏）方法時觸發

類型:

• EventTarget~Event

error

　　　發生錯誤是觸發

類型:

• EventTarget~Event

exitFullWindow

　　　當運行enterFullWindow（瀏覽器不支持全屏時的退出全屏）方法時觸發，

類型:

• EventTarget~Event

firstplay

首次播放視頻時觸發。 不是HLS規範的一部分，而且這可能不是最好的實現，因此使用謹慎。 若是你沒有理由阻止播放，使用 myPlayer.one（'play'）; 代替。

類型:

• EventTarget~Event

fullscreenchange

　　　在進入和退出全屏時觸發。 

類型:

• EventTarget~Event

此事件的監聽器:

• FullscreenToggle#handleFullscreenChange
• TextTrackDisplay#updateDisplay

loadeddata

當播放器已在當前播放位置數據加載完後時觸發。

類型:

• EventTarget~Event

loadedmetadata

瀏覽器加載完成音頻/視頻的元數據時觸發。（播放器獲取初始持續時間和尺寸信息）

類型:

• EventTarget~Event

此事件的監聽器:

• DurationDisplay#updateContent

loadstart

當用戶代理開始查找媒體數據時觸發。

類型:

• EventTarget~Event

此事件監聽器:

• MuteToggle#update
• PlaybackRateMenuButton#updateVisibility
• TextTrackDisplay#toggleDisplay

pause

每當媒體暫停時觸發

類型:

• EventTarget~Event

此事件的監聽器:

• PlayToggle#handlePause

play

每當發生Tech＃play事件時觸發。 表示播放已開始或恢復。

類型:

• EventTarget~Event

此事件的監聽器:

• PlayToggle#handlePlay

playing

媒體再也不被阻止播放，並已開始播放。

類型:

• EventTarget~Event

pluginsetup

表示插件剛剛在播放器上設置。

類型:

• Plugin~PluginEventHash

posterchange

當海報圖片在播放器上更改時，此事件觸發。

類型:

• EventTarget~Event

此事件的監聽器:

• PosterImage#update

progress

在用戶代理正在下載媒體數據時觸發。

類型:

• EventTarget~Event

此事件的監聽器:

• LoadProgressBar#update

ready

組件準備就緒時觸發。

類型:

• EventTarget~Event

繼承自:

• Component#event:ready

resize

視頻的內部尺寸更改時觸發。

類型:

• event

seeked

當播放器完成跳躍到新的時間時觸發

類型:

• EventTarget~Event

seeking ：尋找

當播放器跳到新的時間時觸發

類型:

• EventTarget~Event

stalled ：停頓

在瀏覽器嘗試獲取媒體數據時觸發，但數據不可用。

類型:

• EventTarget~Event

suspend ：中斷

當瀏覽器故意未獲取媒體數據時觸發。

類型:

• EventTarget~Event

tap

當組件被點擊時觸發。

類型:

• EventTarget~Event

繼承自:

• Component#event:tap

textdata

當咱們從tech獲取textdata事件時觸發

類型:

• EventTarget~Event

timeupdate

當前播放位置已更改時觸發。在播放期間，每15 - 250毫秒觸發一次，具體取決於使用的播放技術。

類型:

• EventTarget~Event

此事件的監聽器:

• CurrentTimeDisplay#updateContent
• DurationDisplay#updateContent
• RemainingTimeDisplay#updateContent
• SeekBar#update

useractive

 　　 用戶活動時觸發

類型:

• EventTarget~Event

userinactive

 　　 用戶不活動時觸發

類型:

• EventTarget~Event

usingcustomcontrols

播放器正在使用自定義HTML控件時觸發

類型:

• EventTarget~Event

usingnativecontrols

播放器正在使用本地設備控件時觸發

類型:

• EventTarget~Event

volumechange

音量更改時觸發

類型:

• EventTarget~Event

此事件的監聽器:

• MuteToggle#update
• VolumeBar#updateARIAAttributes

waiting

DOM元素上的readyState更改已致使播放中止。

類型:

• EventTarget~Event

若是屬性不存在或沒有值，大多數瀏覽器將返回null。