Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-youtube-player
Tutorial
@capgo/capacitor-youtube-player

YouTube Player

Embed YouTube videos with full player API control and event handling

Richtlinie

Tutorial zum YouTube-Player

Verwendung von @capgo/capacitor-youtube-player

YouTube-Player-Plugin-Schnittstelle für Capacitor. Bietet Methoden zur Steuerung der YouTube-Videowiedergabe in Ihrer App.

Installieren

bun add @capgo/capacitor-youtube-player
bunx cap sync

Was diese Erweiterung offenlegt

  • initialize - Eine neue Instanz des YouTube-Players initialisieren.
  • destroy - Eine Spielerinstanz zerstören und Ressourcen freigeben.
  • stopVideo - Die Videoabspielung stoppen und das Laden stornieren. Verwenden Sie dies sparsam - pauseVideo() wird normalerweise bevorzugt.
  • playVideo - Das derzeit angezeigte oder geladene Video abspielen. Der endgültige Spielerzustand wird auf PLAYING (1) gesetzt.

Haupt-WebView-Referer-Patch

Aktivieren patchRefererHeader Wenn YouTube-Inhalte in der Erweiterung funktionieren, aber aus der Haupt-WebView von Capacitor fehlschlagen, weil YouTube einen browserartigen Referer Header erwartet.

{
  "plugins": {
    "YoutubePlayer": {
      "patchRefererHeader": true,
      "refererHeader": "https://www.youtube.com"
    }
  }
}

Der Patch gilt nur für youtube.com, youtube-nocookie.com] youtu.be Anfragen. Bestehende Anfrage-Ebene Referer Kopfzeilen werden beibehalten, und refererHeader wird standardmäßig verwendet, wenn https://www.youtube.com weggelassen wird.

Beispiel für die Verwendung

initialize

Initialisieren Sie eine neue Instanz des YouTube-Players.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.initialize({
  playerId: 'my-player',
  videoId: 'dQw4w9WgXcQ',
  playerSize: { width: 640, height: 360 },
  privacyEnhanced: true
});

destroy

Zerstören Sie eine Spielerinstanz und freigeben Sie Ressourcen.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

Beenden Sie die Videoabspielung und stornieren Sie die Ladevorgänge. Verwenden Sie dies sparsam - pauseVideo() wird normalerweise bevorzugt.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.stopVideo({} as PlayerIdOptions);

playVideo

Wiedergeben Sie das derzeit angezeigte oder geladene Video. Der endgültige Spielerzustand wird auf PLAYING (1) gesetzt.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.playVideo({} as PlayerIdOptions);

Vollständige Referenz

Weitermachen von Using @capgo/capacitor-youtube-player

Wenn Sie native Medien und Schnittstellenverhalten planen, verbinden Sie es mit @capgo/capacitor-youtube-player für die Implementierungsdetails in @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-youtube-player, @capgo/capacitor-youtube-player for the implementation detail in @capgo/capacitor-youtube-player, Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities für die native Fähigkeit in Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities, @capgo/capacitor-live-activities @capgo/capacitor-live-activities @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten und Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player.