Guida
Come usare YouTube Player in Capacitor
Usare @capgo/capacitor-youtube-player
L'interfaccia del plugin YouTube Player per Capacitor. Offre metodi per controllare la riproduzione dei video YouTube nella tua app.
Installa
bun add @capgo/capacitor-youtube-player
bunx cap sync
Cosa espone questo plugin
initialize- Inizializza una nuova istanza del player YouTube.destroy- Distruggi un'istanza del player e libera le risorse.stopVideo- Ferma la riproduzione video e annulla il caricamento. Usalo con moderazione: di solito è preferibile pauseVideo().playVideo- Riproduci il video attualmente in coda o caricato. Lo stato finale del player sarà PLAYING (1).
Patch principale per il Referer della WebView
Abilita patchRefererHeader quando i contenuti YouTube funzionano nel plugin ma falliscono nella WebView principale di Capacitor perché YouTube richiede un Referer header.
{
"plugins": {
"YoutubePlayer": {
"patchRefererHeader": true,
"refererHeader": "https://www.youtube.com"
}
}
}
La patch si applica solo alle youtube.com, youtube-nocookie.com, e youtu.be richieste. A livello di singola richiesta Referer richiesta vengono preservati, e refererHeader ha come default https://www.youtube.com se omesso.
Esempio d'uso
initialize
Inizializza una nuova istanza del player YouTube.
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
await YoutubePlayer.initialize({
playerId: 'my-player',
videoId: 'dQw4w9WgXcQ',
playerSize: { width: 640, height: 360 },
privacyEnhanced: true
});
destroy
Distrugge un'istanza del player e libera le risorse.
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
const result = await YoutubePlayer.destroy({ playerId: 'player-id-123' });
console.log(result);
stopVideo
Interrompe la riproduzione del video e annulla il caricamento. Usalo con moderazione: solitamente è preferibile pauseVideo().
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
const result = await YoutubePlayer.stopVideo({ playerId: 'player-id-123' });
console.log(result);
playVideo
Riproduce il video attualmente in coda o caricato. Lo stato finale del player sarà PLAYING (1).
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
const result = await YoutubePlayer.playVideo({ playerId: 'player-id-123' });
console.log(result);
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-youtube-player/
- Documentazione: /docs/plugins/youtube-player/
Continua con l'uso di @capgo/capacitor-youtube-player
Se stai usando Usare @capgo/capacitor-youtube-player per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-youtube-player per i dettagli di implementazione in @capgo/capacitor-youtube-player, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.