Allez directement au contenu principal

Joueur de YouTube plugin Capacitor

Intégrez des vidéos YouTube avec un contrôl’et un traitement d'événements du lecteur complet API

Installer

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

Guide

Comment utiliser le lecteur YouTube dans Capacitor

Tester sur appareil

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

Prévisualisation du plugin YouTube Player QR 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 - Jouez la vidéo actuellement affichée ou chargée. L'état final du lecteur sera PLAYING (1).

Patch de référentiel principal de WebView

Activer patchRefererHeader lorsque le contenu YouTube fonctionne dans le plugin mais échoue depuis la vue principale de Capacitor car YouTube attend un navigateur similaire Referer header.

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

La mise à jour ne s'applique qu'à youtube.com, youtube-nocookie.com, and youtu.be demandes. Demande existante Referer lorsqu'il est omis. refererHeader par défaut https://www.youtube.com lorsqu'il est omis.

Utilisation d'Exemple

initialize

Initialisez une nouvelle instance de 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étruirez une instance de lecteur et libérez les ressources.

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

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

stopVideo

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

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

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

playVideo

Lancez la vidéo actuellement chargée ou prête à jouer. 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

Continuez à partir de l'utilisation de @capgo/capacitor-youtube-player

Si vous utilisez L'utilisation de @capgo/capacitor-youtube-player pour planifier le comportement de médias natifs et d'interface, connectez-l’avec @capgo/capacitor-youtube-player pour les détails d'implémentation dans @capgo/capacitor-youtube-player Getting Started pour les détails d'implémentation dans Démarrage 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-joueur-de-videos pour la capacité native dans Utilisation de @capgo/capacitor-joueur-de-videos.

FAQ

FAQ du plugin YouTube Player

Comment installer le plugin YouTube Player dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-youtube-player » (ou « npm install @capgo/capacitor-youtube-player »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le code natif. Importez-l’à partir de « @capgo/capacitor-youtube-player » dans votre application code.

Le plugin @capgo/capacitor-youtube-player fonctionne-t-il avec React, Vue et Angular ?

Yes. Le lecteur YouTube est un Capacitor package, donc il fonctionne avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript simple.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-youtube-player ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à votre version majeure de Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le fichier README du GitHub liste les versions maintenues.

Le lecteur YouTube @capgo/capacitor-youtube-player est-il gratuit et open source ?

Oui. Le code source de code est public sur GitHub à https://github.com/Cap-go/capacitor-youtube-player/ et le package est gratuit pour l'installation à partir de npm. Les rapports de bugs et les demandes de mise à jour sont les bienvenus.

Puis-je mettre à jour code utilisant YouTube Player sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif de code, il faut donc une nouvelle build de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour live de Capgo.

Envoyez les modifications du lecteur YouTube sans attendre la revue de l'application

Une fois l'extension dans votre magasin de build, les mises à jour en direct Capgo poussent vos modifications JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Commencez avec Capgo