Die videojs() Funktion dient gleichzeitig als Hauptfunktion für Benutzer zum Erstellen eines Spieler -Instanz sowie den Namensraum der Hauptbibliothek.
Es kann auch als Getter für ein bereits vorhandenes . verwendet werden Spieler Beispiel. Wir jedoch stark Verwendung empfehlen videojs.getPlayer() für diesen Zweck, weil es jede Möglichkeit einer unbeabsichtigten Initialisierung vermeidet.
Wegen Einschränkungen unseres JSDoc-Templates können wir dies nicht sowohl als Funktion als auch als Namespace richtig dokumentieren, daher ist seine Funktionssignatur hier dokumentiert.
Argumente
id
Zeichenfolge|Element, erforderlich
Videoelement- oder Videoelement-ID.
Optionen
Objekt, optional
Options-Objekt zum Bereitstellen von Einstellungen. Siehe: Optionshandbuch.
bereit
Komponente~ReadyCallback , Optional
Eine Funktion, die aufgerufen wird, wenn die Spieler und Technik sind bereit.
Rückgabewert
Die videojs() Funktion gibt a . zurück Spieler Beispiel.
Klassen
Mitglieder
-
statisch Browser :Objekt
-
Ein Hinweis auf die Browser-Utility-Modul als Objekt.
- Siehe:
-
statisch dom :Objekt
-
Ein Hinweis auf die DOM-Dienstprogrammmodul als Objekt.
- Siehe:
-
statisch Protokoll :Funktion
-
Ein Hinweis auf die log-Dienstprogrammmodul als Objekt.
- Siehe:
-
statisch Optionen :Objekt
-
Das globale Optionsobjekt. Dies sind die Einstellungen, die wirksam werden, wenn beim Erstellen des Players keine Überschreibungen angegeben werden.
-
statische Spieler :Objekt
-
Globale Aufzählung von Spielern.
Die Schlüssel sind die Spieler-IDs und die Werte sind entweder die Player-Instanz oder
Nullfür entsorgte Spieler. -
statisch TOUCH AKTIVIERT :boolesch
-
Verwenden browser.TOUCH_ENABLED stattdessen; nur aus Gründen der Abwärtskompatibilität mit 4.x enthalten.
- Veraltet:
-
- Verwenden Sie seit Version 5.0 browser.TOUCH_ENABLED stattdessen.
-
statisch URL :Objekt
-
Ein Hinweis auf die URL-Dienstprogrammmodul als Objekt.
- Siehe:
-
statisch AUSFÜHRUNG :string
-
Aktuelle Video.js-Version. Folgt semantische Versionierung.
Methoden
-
statisch Sprache hinzufügen(Code, Daten) → {Objekt
-
Hinzufügen von Sprachen, damit sie für alle Spieler verfügbar sind. Beispiel:
videoJS.addLanguage ('es', {'Hello': 'Hola'});Parameter:
Nennen Typ Beschreibung CodeString Der Sprachcode oder die Wörterbucheigenschaft
DatenObjekt Die zu übersetzenden Datenwerte
Gibt zurück:
Objekt -Das resultierende Sprachwörterbuchobjekt
-
statisch bind(kontext, fn, uidopt) → {Funktion}
-
Binden (auch bekannt als Proxy oder Kontext). Eine einfache Methode zum Ändern des Kontextes einer Funktion.
Es speichert auch eine eindeutige ID in der Funktion, sodass sie leicht aus Ereignissen entfernt werden kann.
Parameter:
Nennen Typ Attribute Beschreibung KontextGemischt Das Objekt, das als Bereich gebunden werden soll.
fnFunktion Die Funktion, die an einen Bereich gebunden werden soll.
uidZahl <optional>
Eine optionale eindeutige ID für die zu setzende Funktion
Gibt zurück:
funktion -Die neue Funktion, die in den angegebenen Kontext gebunden wird
-
statisch berechneter Stil(el, Stütze)
-
Ein sicheres GetComputedStyle.
Dies wird benötigt, weil in Firefox, wenn der Player in einem iframe mit geladen wird
Anzeige: keine, danngetComputedStylekehrt zurückNull, also führen wir eine Nullprüfung durch, um sicherzustellen, dass der Player in diesen Fällen nicht kaputt geht.Parameter:
Nennen Typ Beschreibung elElement Das Element, von dem Sie den berechneten Stil haben möchten
RequisiteString Der gewünschte Eigenschaftsname
-
statisch createTimeRange(Start Ende)
-
Erstellen Sie ein
TimeRange-Objekt, das eine HTML5 TimeRanges Instanz nachahmt.Parameter:
Nennen Typ Beschreibung beginnennummer | Array.<Array> Der Beginn eines einzelnen Bereichs (eine Zahl) oder eines Arrays von Bereichen (ein Array von Arrays mit jeweils zwei Zahlen).
EndeZahl Das Ende eines einzelnen Bereichs. Kann nicht mit der Array-Form des
Start-Arguments verwendet werden. -
statische CreateTimeranges(start, end)
-
Erstellen Sie ein
TimeRange-Objekt, das eine HTML5 TimeRanges Instanz nachahmt.Parameter:
Nennen Typ Beschreibung beginnennummer | Array.<Array> Der Beginn eines einzelnen Bereichs (eine Zahl) oder eines Arrays von Bereichen (ein Array von Arrays mit jeweils zwei Zahlen).
EndeZahl Das Ende eines einzelnen Bereichs. Kann nicht mit der Array-Form des
Start-Arguments verwendet werden. -
statisches deregisterPlugin(Name)
-
Deregistrieren Sie ein Video.js Plugin.
Parameter:
Nennen Typ Beschreibung NameString Der Name des Plugins, das abregistriert werden soll. Muss eine Zeichenfolge sein, die mit einem vorhandenen Plugin übereinstimmt.
Wirft:
-
Wenn versucht wird, das Basis-Plugin abzumelden.
- Typ
- Fehler
-
-
statische Erweiterung(SuperClass,SubClassMethods opt) → {Funktion}
-
Wird verwendet, um eine vorhandene Klasse unterzuordnen, indem die ES-Unterklasse mit dem emuliert wird
erweitertStichwort.Parameter:
Nennen Typ Attribute Standardwert Beschreibung SuperClassFunktion Die Klasse, von der geerbt werden soll
SubClassMethodsObjekt <optional>
{} Methoden der neuen Klasse
Gibt zurück:
funktion -Die neue Klasse mit SubClassMethods, die SuperClass geerbt hat.
- Veraltet:
-
- Ja
Beispiel
var MyComponent = videojs.extend(videojs.getComponent('Component'), { myCustomMethod: function() { // Dinge in meiner Methode tun. } }); -
statisch formatTime(Sekunden, guide) → {string}
-
Delegiert entweder an die Standardzeitformatierungsfunktion oder eine benutzerdefinierte Funktion, die über
SetFormatTime bereitgestellt wird.Formatiert Sekunden als Zeitzeichenfolge (H:MM:SS oder M:SS). Die Bereitstellung einer Anleitung (in Sekunden) zwingt eine Reihe führender Nullen, um die Länge der Führung abzudecken.
Parameter:
Nennen Typ Beschreibung SekundenZahl Anzahl der Sekunden, die in eine Zeichenfolge umgewandelt werden sollen
LeitfadenZahl Zahl (in Sekunden), nach der die Zeichenfolge modelliert werden soll
Gibt zurück:
string -Zeit formatiert als H:MM:SS oder M:SS
Beispiel
formatTime (125, 600) === "02:05" -
statisch getAllPlayers() → {Array}
-
Gibt ein Array aller aktuellen Spieler zurück.
Gibt zurück:
Array -Ein Array aller Spieler. Das Array wird in der Reihenfolge sein, dass
Objekt.Schlüsselbietet, die möglicherweise zwischen JavaScript-Engines variieren können. -
statisch getComponent(name) → {Component}
-
Holen Sie sich eine
Komponentebasierend auf dem Namen, mit dem sie registriert wurde.Parameter:
Nennen Typ Beschreibung NameString Der Name der abzurufen Komponente.
-
statischer getPlayer(id) → {Spieler|undefiniert}
-
Holen Sie sich einen Einzelspieler basierend auf einem ID- oder DOM-Element.
Dies ist nützlich, wenn Sie überprüfen möchten, ob ein Element oder eine ID über einen zugeordneten Video.js-Player verfügt, aber keinen erstellen möchten, wenn dies nicht der Fall ist.
Parameter:
Nennen Typ Beschreibung idstring | Element Ein HTML-Element -
< Video>,< Audio->, oder< video-js>- oder eine Zeichenfolge, die zu passtIch würdeeines solchen Elements.Gibt zurück:
Spieler | nicht definiert -Eine Spielerinstanz oder
nicht definiertwenn keine Spielerinstanz mit dem Argument übereinstimmt. -
static getPlayers() → {Objekt}
-
Holen Sie sich ein Objekt mit den aktuell erstellten Spielern, die von der Spieler-ID erfasst werden
Gibt zurück:
Objekt -Die erstellten Spieler
-
statisch getPlugin(name) → {function|undefined}
-
Ruft ein Plugin nach Namen ab, falls es existiert.
Parameter:
Nennen Typ Beschreibung NameString Der Name eines Plugins.
Gibt zurück:
funktion | undefined -Das Plugin (oder
undefiniert). -
statisch getPlugins(namesopt) → {Object|undefined}
-
Ruft ein Objekt ab, das mehrere Video.js Plugins enthält.
Parameter:
Nennen Typ Attribute Beschreibung NamenReihe <optional>
Falls angegeben, sollte es sich um ein Array von Plugin-Namen handeln. Standardmäßig werden alle Plugin-Namen verwendet.
Gibt zurück:
Objekt | unbestimmtes -Ein Objekt, das Plugins enthält, die mit ihrem Namen (n) verknüpft sind oder
nicht definiert sind,wenn keine übereinstimmenden Plugins vorhanden sind). -
statisch getPluginVersion(name) → {string}
-
Ruft die Version eines Plugins ab, falls verfügbar
Parameter:
Nennen Typ Beschreibung NameString Der Name eines Plugins.
Gibt zurück:
string -Die Version des Plugins oder eine leere Zeichenfolge.
-
statisch getTech(name) → {Tech|undefined}
-
Holen Sie sich einen
Techaus der freigegebenen Liste nach Namen.Parameter:
Nennen Typ Beschreibung NameString CamelCaseoderTitleCaseName des zu erlangenden TechGibt zurück:
Tech | unbestimmtes -Der
Techoder undefined, wenn es keine Technologie mit dem angeforderten Namen gab. -
statisch isCrossOrigin(url, winLocopt) → {boolean}
-
Gibt zurück, ob die übergebene URL eine domänenübergreifende Anfrage ist oder nicht.
Parameter:
Nennen Typ Attribute Beschreibung urlString Die zu überprüfende URL.
WinLocObjekt <optional>
Die Domäne, gegen die die URL überprüft werden soll, ist standardmäßig window.location
Immobilien
Nennen Typ Attribute Beschreibung ProtokollString <optional>
Das Fensterspeicherprotokoll ist standardmäßig window.location protocol
GastgeberString <optional>
Der Host für den Fensterstandort ist standardmäßig window.location host
Gibt zurück:
boolescher Wert -Ob es sich um eine domainübergreifende Anfrage handelt oder nicht.
-
statisch mergeOptions(...sources) → {Object}
-
Füge zwei Objekte rekursiv zusammen.
Führt eine tiefe Zusammenführung wie lodash.merge durch, führt aber nur einfache Objekte (keine Arrays, Elemente oder irgendetwas anderes) zusammen.
Nicht einfache Objektwerte werden direkt aus dem Argument ganz rechts kopiert.
Parameter:
Nennen Typ Attribute Beschreibung QuellenArray.<Objekt> <wiederholbar>
Ein oder mehrere Objekte, die zu einem neuen Objekt zusammengeführt werden sollen.
Gibt zurück:
Objekt -Ein neues Objekt, das das zusammengeführte Ergebnis aller Quellen ist.
-
statisch aus(elem, Typopt, fnopt)
-
Entfernt Ereignis-Listener aus einem Element
Parameter:
Nennen Typ Attribute Beschreibung ElemElement | Objekt Objekt, aus dem Listener entfernt werden sollen.
Typstring | Array.<Zeichenfolge> <optional>
Typ des zu entfernenden Listener. Schließen Sie nicht ein, um alle Ereignisse aus dem Element zu entfernen.
fneventTarget~EventListener <optional>
Bestimmter Listener, der entfernt werden soll Schließen Sie nicht ein, um Listener für einen Ereignistyp zu entfernen.
-
statisch auf(elem, type, fn)
-
Hinzufügen eines Ereignis-Listener zum Element Es speichert die Handler-Funktion in einem separaten Cache-Objekt und fügt dem Ereignis des Elements einen generischen Handler zusammen mit einer eindeutigen ID (guid) zum Element hinzu.
Parameter:
Nennen Typ Beschreibung ElemElement | Objekt Element oder Objekt, an das Listener gebunden werden sollen
Typstring | Array.<Zeichenfolge> Art des Ereignisses, an das gebunden werden soll.
fneventTarget~EventListener Event-Listener.
-
statisch (elem, type, fn)
-
Lösen Sie einen Listener nur einmal für ein Ereignis aus.
Parameter:
Nennen Typ Beschreibung ElemElement | Objekt Element oder Objekt, an das gebunden werden soll.
Typstring | Array.<Zeichenfolge> Name/Art des Ereignisses
fnevent~EventListener Ereignis-Listener-Funktion
-
statisch parseUrl(url) → {url:URLObject}
-
Lösen und analysieren Sie die Elemente einer URL.
Parameter:
Nennen Typ Beschreibung urlZeichenfolge Die zu analysende URL
Gibt zurück:
url:urloBject -Ein Objekt von URL-Details
-
statisch Plugin(Name, Plugin)
-
Veraltete Methode zum Registrieren eines Plugins bei Video.js
Parameter:
Nennen Typ Beschreibung NameString Der Plugin-Name
PluginPlugin | Funktion Die Plugin-Unterklasse oder -Funktion
- Veraltet:
-
- videojs.plugin() ist veraltet; verwende stattdessen videojs.registerPlugin()
-
statische RegisterComponent(Name, Zusammensetzung) → {Komponente}
-
Registrieren Sie eine Komponente, damit sie namentlich angesprochen werden kann. Wird beim Hinzufügen zu anderen Komponenten verwendet, entweder über addChild
Component.addChild ('myComponent')oder über die standardmäßigen untergeordneten Optionen{children: ['myComponent']}.HINWEIS: Sie können die Komponente auch einfach vor dem Hinzufügen initialisieren.
Komponente.addChild(neue MyComponent());Parameter:
Nennen Typ Beschreibung NameString Der Klassenname der Komponente
compKomponente Die Komponentenklasse
-
statisch registerPlugin(name, plugin) → {Funktion}
-
Registrieren Sie ein Video.js Plugin.
Parameter:
Nennen Typ Beschreibung NameString Der Name des zu registrierenden Plugins. Muss eine Zeichenfolge sein und darf nicht mit einem vorhandenen Plugin oder einer Methode des
Player-Prototyps übereinstimmen.PluginFunktion Eine Unterklasse von
Pluginoder eine Funktion für grundlegende Plugins.Gibt zurück:
funktion -Für erweiterte Plugins eine Factory-Funktion für dieses Plugin. Für grundlegende Plugins eine Wrapper-Funktion, die das Plugin initialisiert.
-
statische RegisterTech(Name, Technologie)
-
Registriert einen
Techin einer freigegebenen Liste für Videojs.Parameter:
Nennen Typ Beschreibung NameString Name des
Technikzu registrieren.TechObjekt Die
Tech-Klasse zum Registrieren. -
statisch resetFormatTime()
-
Setzt FormatTime auf die Standardimplementierung zurück.
-
statische setFormatTime(CustomImplementation)
-
Ersetzt die standardmäßige FormatTime-Implementierung durch eine benutzerdefinierte Implementierung.
Parameter:
Nennen Typ Beschreibung CustomImplementierungFunktion Eine Funktion, die anstelle der standardmäßigen FormatTime-Implementierung verwendet wird. Erhält die aktuelle Zeit in Sekunden und den Guide (in Sekunden) als Argumente.
-
statisch trigger(elem, event, hashopt) → {boolean|undefined}
-
Löst ein Ereignis für ein Element aus
Parameter:
Nennen Typ Attribute Beschreibung ElemElement | Objekt Element, auf dem ein Ereignis ausgelöst werden soll
EreigniseventTarget~Event | string Eine Zeichenfolge (der Typ) oder ein Ereignisobjekt mit einem type-Attribut
HashObjekt <optional>
Daten-Hash, der mit dem Ereignis weitergegeben werden soll
Gibt zurück:
boolean | undefined -Gibt das Gegenteil von
DefaultPrevented zurück,wenn der Standardwert verhindert wurde. Andernfalls gibtundefined zurück -
statische Verwendung(Typ, Middleware)
-
Definieren Sie eine Middleware, die der Player über eine Factory-Funktion verwenden soll, die ein Middleware-Objekt zurückgibt.
Parameter:
Nennen Typ Beschreibung TypString Der übereinstimmende MIME-Typ oder
„*“für alle MIME-Typen.MiddlewareMiddlewareFactory Eine Middleware-Factory-Funktion, die für übereinstimmende Typen ausgeführt wird.
-
static xhr(Optionen) → {xmlHttpRequest|xDomainRequest}
-
Ein browserübergreifender XMLHttpRequest-Wrapper.
Parameter:
Nennen Typ Beschreibung OptionenObjekt Einstellungen für die Anfrage.
Gibt zurück:
XMLHttpRequest | XDomainRequest -Das Anfrageobjekt.