Intégrez des vidéos YouTube avec un contrôle complet du player API et la gestion des événements
Commencez par initialize() et les autres méthodes principales listées ci-dessous.
Support des plateformes
Section intitulée « Support des plateformes »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Natif |
| Android | Oui | Natif |
| Le Web | Non | Protéger avec Capacitor.getPlatform() |
Fonctionnalités clés
Section intitulée « Fonctionnalités clés »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).
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
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). |
pauseVideo | Met en pause la vidéo en cours de lecture. L’état final du lecteur sera PAUSED (2), sauf s’il est déjà ENDED (0). |
seekTo | Aller à un moment précis de la vidéo. Si le lecteur est en pause, il reste en pause. S’il est en lecture, la lecture continue. |
loadVideoById | Charger et lire une vidéo à partir de son ID YouTube. |
cueVideoById | Charge une vidéo par ID sans la lire. Charge la miniature et prépare le lecteur, sans demander la vidéo avant l’appel de playVideo(). |
loadVideoByUrl | Charger et lire une vidéo à partir de son URL complète. |
cueVideoByUrl | Préparer une vidéo par URL sans la lire. |
cuePlaylist | Prépare une playlist sans la lire. Charge la playlist et prépare la première vidéo. |
loadPlaylist | Charger et lire une playlist. |
nextVideo | Lire la vidéo suivante de la playlist. |
previousVideo | Lire la vidéo précédente de la playlist. |
playVideoAt | Lire une vidéo précise de la playlist par son index. |
mute | Couper le son du lecteur. |
unMute | Réactiver le son du lecteur. |
isMuted | Vérifier si le son du lecteur est actuellement coupé. |
setVolume | Définit le niveau de volume du lecteur. |
getVolume | Renvoie le niveau de volume actuel du lecteur. Renvoie le volume même si le lecteur est en sourdine. |
setSize | Définissez les dimensions du lecteur en pixels. |
getPlaybackRate | Récupérer le débit de lecture actuel. |
setPlaybackRate | Régler la vitesse de lecture. |
getAvailablePlaybackRates | Récupérer la liste des vitesses de lecture disponibles pour la vidéo actuelle. |
setLoop | Activez ou désactivez la lecture en boucle de la playlist. Une fois activée, la playlist redémarrera du début après la dernière vidéo. |
setShuffle | Enable or disable playlist shuffle. |
getVideoLoadedFraction | Récupérer la part de la vidéo mise en mémoire tampon. Plus fiable que les méthodes obsolètes getVideoBytesLoaded/getVideoBytesTotal. |
getPlayerState | Récupérez l'état actuel du player. |
getAllPlayersEventsState | Récupérer les états d'événement de tous les lecteurs actifs. Utile pour suivre plusieurs instances de lecteur. |
getCurrentTime | Récupérez la position de lecture actuelle en secondes. |
toggleFullScreen | Activer ou désactiver le mode plein écran. |
getPlaybackQuality | Récupérer la qualité de lecture actuelle. |
setPlaybackQuality | Définir la qualité de lecture suggérée. La qualité réelle peut varier selon les conditions du réseau. |
getAvailableQualityLevels | Récupérer la liste des niveaux de qualité disponibles pour la vidéo actuelle. |
getDuration | Récupérer la durée en secondes de la vidéo en cours. |
getVideoUrl | Récupérer l'URL YouTube.com de la vidéo en cours. |
getVideoEmbedCode | Récupère le code d'intégration pour la vidéo actuelle. Retourne le code d'intégration iframe HTML. |
getPlaylist | Récupérer le tableau des ID des vidéos de la playlist actuelle. |
getPlaylistIndex | Récupérez l'index de la vidéo en cours de lecture dans la playlist. |
getIframe | Récupère l'élément DOM de l'iframe du player. Plateforme Web uniquement. |
addEventListener | Ajoute un écouteur d'événements au player. Plateforme Web uniquement. |
removeEventListener | Supprime un écouteur d'événements du player. Plateforme Web uniquement. |
getPluginVersion | Récupère le numéro de version du plugin. Retourne les informations de version propres à la plateforme. |
Source de vérité
Section intitulée « Source de vérité »Cette référence est synchronisée depuis src/definitions.ts dans capacitor-youtube-player.
Continuer avec @capgo/capacitor-youtube-player
Section intitulée « Continuer avec @capgo/capacitor-youtube-player »Si vous utilisez @capgo/capacitor-youtube-player pour planifier le travail sur les plugins natifs, connectez-l’à Utiliser @capgo/capacitor-youtube-player pour la capacité native dans Utiliser @capgo/capacitor-youtube-player, Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.