Intégrez des vidéos YouTube avec un contrôle complet du lecteur API et la gestion des événements
Commencez par initialize() et les autres méthodes principales listées ci-dessous.
Plateformes compatibles
Section intitulée « Plateformes compatibles »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Natif |
| Android | Oui | Natif |
| Web | Non | Sécurisez 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 | Initialise une nouvelle instance du lecteur YouTube. |
destroy | Détruit une instance du lecteur et libère 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 | Lance 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 player sera PAUSED (2), sauf s'il est déjà en état ENDED (0). |
seekTo | Accéder à un moment précis de la vidéo. Si le player est en pause, il reste en pause. S'il est en lecture, la lecture continue. |
loadVideoById | Charge et lance une vidéo via son ID YouTube. |
cueVideoById | Préparez une vidéo par son ID sans la lancer. Charge la miniature et prépare le player, mais ne demande la vidéo qu'une fois playVideo() appelé. |
loadVideoByUrl | Charge et lance une vidéo via son URL complète. |
cueVideoByUrl | Préparez une vidéo via son URL sans la lancer. |
cuePlaylist | Préparez une playlist sans la lancer. 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 spécifique de la playlist par son index. |
mute | Couper le son du lecteur. |
unMute | Réactiver le son du lecteur. |
isMuted | Vérifier si le lecteur est actuellement en mode muet. |
setVolume | Régler le niveau du volume du lecteur. |
getVolume | Obtenir le niveau de volume actuel. Retourne le volume même si le lecteur est en muet. |
setSize | Définir les dimensions du lecteur en pixels. |
getPlaybackRate | Obtenir la vitesse de lecture actuelle. |
setPlaybackRate | Régler la vitesse de lecture. |
getAvailablePlaybackRates | Récupérer la liste des vitesses de lecture disponibles pour la vidéo actuelle. |
setLoop | Activer ou désactiver la lecture en boucle de la playlist. Si 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 fraction de la vidéo mise en mémoire tampon. Plus fiable que les fonctions obsolètes getVideoBytesLoaded/getVideoBytesTotal. |
getPlayerState | Récupérer l'état actuel du lecteur. |
getAllPlayersEventsState | Récupérer les états d'événement pour tous les lecteurs actifs. Utile pour suivre plusieurs instances de lecteurs. |
getCurrentTime | Récupérer 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 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 de la vidéo actuelle en secondes. |
getVideoUrl | Récupérer l'URL YouTube.com de la vidéo actuelle. |
getVideoEmbedCode | Récupérer l'embed code de la vidéo actuelle. Retourne l'embed iframe HTML code. |
getPlaylist | Récupérer le tableau des IDs vidéo de la playlist actuelle. |
getPlaylistIndex | Récupérer l'index de la vidéo en cours de lecture dans la playlist. |
getIframe | Récupérer l'élément DOM iframe du player. Plateforme Web uniquement. |
addEventListener | Ajouter un écouteur d'événement au player. Plateforme Web uniquement. |
removeEventListener | Supprimer un écouteur d'événement du player. Plateforme Web uniquement. |
getPluginVersion | Récupère le numéro de version du plugin. Renvoie les informations de version spécifiques à 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 un plugin natif, connectez-l’à Utiliser @capgo/capacitor-youtube-player pour la fonctionnalité native dans « Utiliser @capgo/capacitor-youtube-player », Répertoire des plugins Capgo pour le workflow produit dans le répertoire des plugins Capgo, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans « Ajouter ou mettre à jour des plugins », et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise.