Zum Hauptinhalt springen

Führung

Tutorial zum YouTube-Player

Gerät testen

Die Capgo-App herunterladen, dann die QR-Code code scannen.

YouTube-Player-Plugin-Vorschau-QR code

Mit @capgo/capacitor-youtube-player verwenden

YouTube-Player-Plugin-Interface für Capacitor. Bietet Methoden zum Steuern des YouTube-Videowiedergangs in Ihrer App.

Installieren

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

Wie dieses Plugin funktioniert

  • 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 im Plugin 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"
    }
  }
}

Die Patches gelten nur für youtube.com, youtube-nocookie.com und youtu.be Anfragen. Bestehende Anfrage-Niveau Referer Header werden beibehalten, und refererHeader defaults zu https://www.youtube.com wenn nicht angegeben.

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 Spieler-Instanz 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

Spielen Sie das derzeit angezeigte oder geladene Video. Der endgültige Spielerzustand wird zu PLAYING (1) sein.

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

await YoutubePlayer.playVideo({} as PlayerIdOptions);

Vollständige Referenz

Weitermachen von Using @capgo/capacitor-youtube-player

Wenn Sie Using verwenden Using @capgo/capacitor-youtube-player um native Medien und Schnittstellenverhalten zu planen, verbinden Sie es mit @capgo/capacitor-youtube-player für die Implementierungsdetails in @capgo/capacitor-youtube-player Einstieg Für die Implementierungsdetails in Getting Started, Mit @capgo/capacitor-live-aktivitäten Für die native Fähigkeit in Mit @capgo/capacitor-live-aktivitäten, @capgo/capacitor-live-aktivitäten 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.