Zum Hauptinhalt springen

YouTube Player Capacitor Plugin

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

Installieren

bun add @capgo/capacitor-youtube-player bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-youtube-player
  • pnpm add @capgo/capacitor-youtube-player
  • yarn add @capgo/capacitor-youtube-player

Anleitung

YouTube Player in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

YouTube Player Plugin Vorschau QR code

Mit @capgo/capacitor-youtube-player

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

Installieren

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

Was dieses Plugin bereitstellt

  • initialize - Eine neue YouTube-Player-Instanz initialisieren.
  • destroy - Eine Player-Instanz zerstören und Ressourcen freigeben.
  • stopVideo - Videowiedergabe stoppen und Laden abbrechen. Sparsam verwenden – pauseVideo() ist meist besser.
  • playVideo - Spielt das aktuell vorgemerkte oder geladene Video ab. Der finale Player-Status ist PLAYING (1).

Main WebView Referer Patch

Aktivieren patchRefererHeader wenn YouTube-Inhalte im Plugin funktionieren, aber in der Haupt-WebView von Capacitor fehlschlagen, weil YouTube ein browserähnliches Verhalten erwartet Referer header.

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

Der Patch gilt nur für youtube.com, youtube-nocookie.com, und youtu.be Requests. Bestehende Header auf Referer Request-Ebene bleiben erhalten, und refererHeader ist standardmäßig https://www.youtube.com wenn weggelassen.

Anwendungsbeispiel

initialize

Initialisiert eine neue YouTube-Player-Instanz.

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

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

destroy

Zerstört eine Player-Instanz und gibt Ressourcen frei.

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

const result = await YoutubePlayer.destroy({ playerId: 'player-id-123' });
console.log(result);

stopVideo

Videowiedergabe stoppen und Laden abbrechen. Sparsam einsetzen – pauseVideo() ist meist besser.

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

const result = await YoutubePlayer.stopVideo({ playerId: 'player-id-123' });
console.log(result);

playVideo

Das aktuell vorgemerkte oder geladene Video abspielen. Der Endzustand des Players ist PLAYING (1).

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

const result = await YoutubePlayer.playVideo({ playerId: 'player-id-123' });
console.log(result);

Vollständige Referenz

Weiter mit Nutzung von @capgo/capacitor-youtube-player

Wenn du es nutzt Nutzung von @capgo/capacitor-youtube-player , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-youtube-player für die Implementierungsdetails in @capgo/capacitor-youtube-player, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“

FAQ

YouTube Player Plugin FAQ

Wie installiere ich das YouTube Player Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-youtube-player" (oder "npm install @capgo/capacitor-youtube-player") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-youtube-player".

Funktioniert @capgo/capacitor-youtube-player mit React, Vue und Angular?

Ja. Der YouTube Player ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-youtube-player unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-youtube-player kostenlos und Open Source?

Ja. Der code Quellcode ist auf GitHub unter https://github.com/Cap-go/capacitor-youtube-player/ öffentlich einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit YouTube Player aktualisieren, ohne ein App Store Review abzuwarten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Änderungen am YouTube Player ausrollen, ohne auf das App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo