Lecteur YouTube Plugin Capacitor

Utiliser @capgo/capacitor-youtube-player

Interface du plugin YouTube Player pour Capacitor. Fournit des méthodes pour contrôler la lecture des vidéos YouTube dans votre application.

Installer

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

Ce que ce plugin expose

• initialize - Initialiser une nouvelle instance du lecteur YouTube.
• destroy - Détruire une instance du lecteur et libérer les ressources.
• stopVideo - Arrête la lecture de la vidéo et annule le chargement. À utiliser avec parcimonie — pauseVideo() est généralement préférable.
• playVideo - Lire la vidéo actuellement en file d'attente ou chargée. L'état final du lecteur sera PLAYING (1).

Patch du referer de la WebView principale

Activer patchRefererHeader lorsque le contenu YouTube fonctionne dans le plugin mais échoue depuis la WebView principale de Capacitor, car YouTube s'attend à un navigateur Referer header valide.

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

Le patch ne s'applique qu'aux youtube.com, youtube-nocookie.com, et youtu.be requêtes. Niveau requête existant Referer les en-têtes sont conservés, et refererHeader par défaut sur https://www.youtube.com lorsqu'ils sont omis.

Exemple d'utilisation

initialize

Initialiser une nouvelle instance du lecteur YouTube.

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

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

destroy

Détruire une instance du lecteur et libérer les ressources.

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

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

stopVideo

Arrête la lecture de la vidéo et annule le chargement. À utiliser avec parcimonie — pauseVideo() est généralement préférable.

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

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

playVideo

Lire la vidéo actuellement en file d'attente ou chargée. L'état final du lecteur sera PLAYING (1).

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

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

Référence complète

• GitHub : https://github.com/Cap-go/capacitor-youtube-player/
• Docs : /docs/plugins/youtube-player/

Continuer à partir de « Utiliser @capgo/capacitor-youtube-player »

Si vous utilisez Utiliser @capgo/capacitor-youtube-player pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-youtube-player pour le détail d’implémentation dans @capgo/capacitor-youtube-player, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.