Saltare al contenuto principale

Guida

Tutorial sul lettore YouTube

Testare sul dispositivo

Scarica l'app Capgo, poi scansa 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'applicazione.

Installa

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

Cos'è che questo plugin espone

  • initialize - Inizializza una nuova istanza del player di 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() è di solito 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 When il contenuto di YouTube funziona nel plugin ma fallisce dal WebView principale di Capacitor perché YouTube aspetta un browser simile. Referer La intestazione.

{
  "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 capi di richiesta esistenti sono preservati, e Referer i valori predefiniti si applicano refererHeader quando sono omessi. https://www.youtube.com Esempio di utilizzo

Inizializza una nuova istanza del player di YouTube.

initialize

Distruggi un'istanza del player e libera le risorse.

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

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

destroy

Interrompi 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.destroy({} as PlayerIdOptions);

stopVideo

Initialize a new YouTube player instance.

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-attività-in-vivo per la capacità nativa in Usando @capgo/capacitor-attività-in-vivo, @capgo/capacitor-attività-in-vivo per i dettagli di implementazione in @capgo/capacitor-attività-in-vivo, e Usando @capgo/capacitor-lettore-di-video per la capacità nativa in Usando @capgo/capacitor-lettore-di-video.