Passer au contenu principal
Retour aux plugins
@capgo/capacitor-youtube-player
Tutoriel
@capgo/capacitor-youtube-player

Joueur YouTube

Intégrer des vidéos YouTube avec un contrôl’et une gestion d'événements complets du lecteur API

Guide

Tutoriel sur le lecteur YouTube

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

Prévisualisation du lien QR du plugin YouTube Player code

Utilisation de @capgo/capacitor-youtube-player

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

Installer

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

Ce que ce plugin expose

  • initialize - Initialiser une nouvelle instance de lecteur YouTube.
  • destroy - Détruire une instance de lecteur et libérer les ressources.
  • stopVideo - Arrêter la lecture vidéo et annuler la charge. Utilisez cela avec parcimonie - pauseVideo() est généralement préféré.
  • playVideo - Lancer la vidéo actuellement préchargée ou chargée. L'état final du lecteur sera PLAYING (1).

Patch de référentiel principal WebView

Activer patchRefererHeader lorsque le contenu YouTube fonctionne dans le plugin mais échoue dans la vue d'application principale de Capacitor car YouTube attend un navigateur similaire Referer l'entête.

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

La mise à jour ne s'applique qu'à youtube.com, youtube-nocookie.comet youtu.be les requêtes. Les en-têtes de requête existants sont préservés, et Referer par défaut refererHeader lorsqu'ils sont omis. https://www.youtube.com Exemple d'utilisation

Initialiser une nouvelle instance de lecteur YouTube.

initialize

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

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

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

destroy

Arrêter la lecture vidéo et annuler la charge. Utilisez cela avec parcimonie - pauseVideo() est généralement préféré.

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

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

Utilisation de l'API

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

await YoutubePlayer.stopVideo({} as PlayerIdOptions);

playVideo

Jouez la vidéo actuellement affichée ou chargée. L'état final du lecteur sera PLAYING (1).

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

await YoutubePlayer.playVideo({} as PlayerIdOptions);

Référence complète

Continuez à utiliser @capgo/capacitor-youtube-player

Si vous utilisez Utilisation de @capgo/capacitor-youtube-player pour planifier le comportement des médias natifs et de l'interface, connectez-l’avec @capgo/capacitor-youtube-player pour les détails d'implémentation dans @capgo/capacitor-youtube-player Prise en main pour les détails d'implémentation dans Getting Started, Utilisation de @capgo/capacitor-activités-en-ligne pour la capacité native dans Utilisation de @capgo/capacitor-activités-en-ligne, @capgo/capacitor-activités-en-ligne pour les détails d'implémentation dans @capgo/capacitor-activités-en-ligne, et Utilisation de @capgo/capacitor-jouer-un-vide pour la capacité native dans Utilisation de @capgo/capacitor-jouer-un-vide.