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 - Eine neue YouTube-Player-Instanz initialisieren.
  • destroy - Eine Player-Instanz zerstören und Ressourcen freigeben.
  • stopVideo - Die Videowiedergabe stoppen und das Laden abbrechen. Sparsam verwenden – pauseVideo() ist meist besser.
  • playVideo - Das aktuell vorgemerkte oder geladene Video abspielen. Der finale Player-Status ist PLAYING (1).
MethodeBeschreibung
initializeInitialisiert eine neue YouTube-Player-Instanz.
destroyZerstört eine Player-Instanz und gibt Ressourcen frei.
stopVideoVideowiedergabe stoppen und Laden abbrechen. Sparsam einsetzen – pauseVideo() ist meist vorzuziehen.
playVideoDas aktuell vorgemerkte oder geladene Video abspielen. Der Endzustand des Players ist PLAYING (1).
pauseVideoDas aktuell laufende Video pausieren. Der Endzustand ist PAUSED (2), sofern nicht bereits ENDED (0).
seekToZu einer bestimmten Zeit im Video springen. Bei pausiertem Player bleibt dieser pausiert; bei laufendem Player wird weiter abgespielt.
loadVideoByIdEin Video anhand seiner YouTube-ID laden und abspielen.
cueVideoByIdEin Video per ID vormerken, ohne es abzuspielen. Lädt Thumbnail und bereitet Player vor, fordert das Video aber erst bei playVideo() an.
loadVideoByUrlEin Video über die vollständige URL laden und abspielen.
cueVideoByUrlEin Video per URL vorbereiten, ohne es abzuspielen.
cuePlaylistPlaylist laden, 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.
getVolumeDie aktuelle Lautstärke abrufen. Gibt die Lautstärke auch bei stummgeschaltetem Player zurück.
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-Looping aktivieren oder deaktivieren. Wenn aktiviert, startet die Playlist nach dem letzten Video von vorn.
setShufflePlaylist-Shuffle aktivieren oder deaktivieren.
getVideoLoadedFractionGibt den Anteil des gepufferten Videos zurück. Zuverlässiger als die veralteten getVideoBytesLoaded/getVideoBytesTotal-Methoden.
getPlayerStateRuft den aktuellen Status des Players ab.
getAllPlayersEventsStateRuft die Event-States aller aktiven Player ab. Nützlich für das Tracking mehrerer Player-Instanzen.
getCurrentTimeGibt die aktuelle Abspielposition in Sekunden zurück.
toggleFullScreenVollbildmodus ein- oder ausschalten.
getPlaybackQualityDie aktuelle Wiedergabequalität abrufen.
setPlaybackQualityDie empfohlene Wiedergabequalität festlegen. Die tatsächliche Qualität kann je nach Netzwerkbedingungen variieren.
getAvailableQualityLevelsListe der verfügbaren Qualitätsstufen für das aktuelle Video abrufen.
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 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.