Saltare al contenuto principale

Guida

Tutoriale sul lettore YouTube

Testare sul dispositivo

Scarica l'app Capgo, poi scansione il codice QR code.

Collegamento QR di anteprima del plugin YouTube Player code

Utilizza @capgo/capacitor-youtube-player

Interfaccia del plugin YouTube Player per Capacitor. Fornisce metodi per controllare la riproduzione dei video di YouTube nel tuo'app.

Installa

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

Cosa questo plugin espone

  • initialize - Inizializza una nuova istanza del player YouTube.
  • destroy - Distruggi un'istanza del player e libera le risorse.
  • stopVideo - Ferma la riproduzione del video e annulla il caricamento. Utilizza questo con parsimonia - pauseVideo() è spesso preferito.
  • playVideo - Riproduci il video attualmente caricato o caricabile. Lo stato finale del player sarà PLAYING (1).

Patch di Referer per WebView principale

Abilita patchRefererHeader quando il contenuto di YouTube funziona nel plugin ma fallisce dal WebView principale di Capacitor perché YouTube aspetta un browser simile Referer il header.

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

La patch si applica solo a youtube.com, youtube-nocookie.come youtu.be le richieste. I header di richiesta esistenti sono preservati, e Referer quando omesso. refererHeader Esempio di utilizzo https://www.youtube.com Inizializza una nuova istanza del player di YouTube.

Distruggi un'istanza del player e libera le risorse.

initialize

Ferma la riproduzione del video e annulla il caricamento. Utilizza questo con parsimonia - pauseVideo() è di solito preferito.

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

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

destroy

Esempio di utilizzo

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

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

Inizializza una nuova istanza del player di YouTube.

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

await YoutubePlayer.stopVideo({} as PlayerIdOptions);

playVideo

Gioca il video attualmente selezionato o caricato. Lo stato finale del player sarà PLAYING (1).

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

await YoutubePlayer.playVideo({} as PlayerIdOptions);

Riferimento completo

Continua a utilizzare @capgo/capacitor-youtube-player

Se stai utilizzando Utilizza @capgo/capacitor-youtube-player per pianificare il comportamento dei media nativi e dell'interfaccia, collega @capgo/capacitor-youtube-player per i dettagli di implementazione in @capgo/capacitor-youtube-player Iniziare per i dettagli di implementazione in Getting Started, Usando @capgo/capacitor-live-attività per la capacità nativa in Usando @capgo/capacitor-live-attività, @capgo/capacitor-live-attività per i dettagli di implementazione in @capgo/capacitor-live-attività, e Usando @capgo/capacitor-player-video per la capacità nativa in Usando @capgo/capacitor-player-video.