Zum Inhalt springen

@capgo/capacitor-youtube-player

YouTube-Videos mit voller Player-Steuerung über API und Event-Handling einbetten

YouTube-Videos mit voller Player-Steuerung über API und Event-Handling einbetten

Starte mit initialize() und den anderen unten aufgeführten Core-Methoden.

PlattformSupportNotizen
iOSJaNative
AndroidJaNative
WebNeinAbsichern mit Capacitor.getPlatform()
  • initialize - Initialisiert eine neue YouTube-Player-Instanz.
  • destroy - Zerstört eine Player-Instanz und gibt Ressourcen frei.
  • stopVideo - Stoppt die Videowiedergabe und bricht das Laden ab. Sparsam einsetzen – pauseVideo() ist in der Regel vorzuziehen.
  • playVideo - Spielt das aktuell eingestellte oder geladene Video ab. Der finale Player-Status ist PLAYING (1).
MethodeBeschreibung
initializeInitialisiert eine neue YouTube-Player-Instanz.
destroyZerstört eine Player-Instanz und gibt Ressourcen frei.
stopVideoVideoabspielung stoppen und Laden abbrechen. Nur sparsam verwenden – in der Regel ist pauseVideo() die bessere Wahl.
playVideoSpielt das aktuell eingestellte oder geladene Video ab. Der finale Player-Status ist PLAYING (1).
pauseVideoPausiert das aktuell laufende Video. Der finale Player-Status ist PAUSED (2), sofern nicht bereits ENDED (0).
seekToSpringt zu einer bestimmten Zeit im Video. Wenn der Player pausiert ist, bleibt er pausiert. Wenn er läuft, setzt er die Wiedergabe fort.
loadVideoByIdEin Video anhand seiner YouTube-ID laden und abspielen.
cueVideoByIdVideo per ID laden, ohne es abzuspielen. Lädt das Thumbnail und bereitet den Player vor, fordert das Video aber erst an, wenn playVideo() aufgerufen wird.
loadVideoByUrlLädt und spielt ein Video über seine vollständige URL ab.
cueVideoByUrlEin Video per URL vorbereiten, ohne es abzuspielen.
cuePlaylistPlaylist einladen, ohne sie abzuspielen. Lädt die Playlist und bereitet das erste Video vor.
loadPlaylistPlaylist laden und abspielen.
nextVideoDas nächste Video in der Playlist abspielen.
previousVideoDas vorherige Video in der Playlist abspielen.
playVideoAtSpielt ein bestimmtes Video in der Playlist über den Index ab.
muteSchaltet den Ton des Players stumm.
unMuteSchaltet den Ton des Players wieder ein.
isMutedPrüft, ob der Player aktuell stummgeschaltet ist.
setVolumeDie Lautstärke des Players festlegen.
getVolumeRuft die aktuelle Lautstärke des Players ab. Gibt die Lautstärke zurück, auch wenn der Player stummgeschaltet ist.
setSizeDie Player-Dimensionen in Pixeln festlegen.
getPlaybackRateDie aktuelle Wiedergabegeschwindigkeit abrufen.
setPlaybackRateDie Wiedergabegeschwindigkeit festlegen.
getAvailablePlaybackRatesListe der verfügbaren Wiedergabegeschwindigkeiten für das aktuelle Video abrufen.
setLoopPlaylist-Schleife aktivieren oder deaktivieren. Wenn aktiviert, startet die Playlist nach dem letzten Video von vorne.
setShufflePlaylist-Shuffle aktivieren oder deaktivieren.
getVideoLoadedFractionGibt den gepufferten Anteil des Videos zurück. Zuverlässiger als die veralteten getVideoBytesLoaded/getVideoBytesTotal.
getPlayerStateRuft den aktuellen Status des Players ab.
getAllPlayersEventsStateRuft den Ereigniszustand aller aktiven Player ab. Nützlich zum Verfolgen mehrerer Player-Instanzen.
getCurrentTimeGibt die aktuelle Abspielposition in Sekunden zurück.
toggleFullScreenVollbildmodus ein- oder ausschalten.
getPlaybackQualityRuft die aktuelle Wiedergabequalität ab.
setPlaybackQualitySetzt die empfohlene Wiedergabequalität. Die tatsächliche Qualität kann je nach Netzwerkbedingungen abweichen.
getAvailableQualityLevelsRuft die Liste der verfügbaren Qualitätsstufen für das aktuelle Video ab.
getDurationDie Dauer des aktuellen Videos in Sekunden abrufen.
getVideoUrlDie YouTube.com-URL des aktuellen Videos abrufen.
getVideoEmbedCodeDen Embed code für das aktuelle Video abrufen. Gibt einen HTML-iframe-Embed code zurück.
getPlaylistEin Array der Video-IDs aus der aktuellen Playlist abrufen.
getPlaylistIndexDen Index des aktuell abgespielten Videos in der Playlist abrufen.
getIframeDas iframe-DOM-Element des Players abrufen. Nur für Web-Plattformen.
addEventListenerEinen Event-Listener zum Player hinzufügen. Nur Web-Plattform.
removeEventListenerEinen Event-Listener vom Player entfernen. Nur Web-Plattform.
getPluginVersionDie Plugin-Versionsnummer abrufen. Gibt plattformspezifische Versionsinfos zurück.

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-youtube-player.

Wenn du es nutzt @capgo/capacitor-youtube-player Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Nutzung von @capgo/capacitor-youtube-player für die native Funktion bei der Nutzung von @capgo/capacitor-youtube-player, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.