Vai al contenuto principale

Player di YouTube Capacitor plugin

Inserisci video di YouTube con il controllo completo del player e il gestione degli eventi API

Installa

bun add @capgo/capacitor-youtube-player bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-youtube-player
  • pnpm add @capgo/capacitor-youtube-player
  • yarn add @capgo/capacitor-youtube-player

Guida

Come utilizzare il player di YouTube in Capacitor

Testare sul dispositivo

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

Link QR di anteprima del plugin YouTube Player code

Utilizza @capgo/capacitor-youtube-player

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 di YouTube.
  • destroy - Distruggi un'istanza del player e libera le risorse.
  • stopVideo - Fermare la riproduzione del video e cancellare il caricamento. Utilizzalo con parsimonia - fermareVideo() è spesso preferito.
  • playVideo - Riproduci il video attualmente caricato o caricabile. Lo stato finale del player sarà PLAYING (1).

Patch di Referente per WebView Principale

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

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

Il patch si applica solo a youtube.com, youtube-nocookie.com, and youtu.be richieste. Richieste esistenti Referer testi di intestazione sono preservati, e refererHeader predefinito su https://www.youtube.com quando è omesso.

Esempio di utilizzo

initialize

Inizializza un nuovo 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

Distruggi 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

Sospendi la riproduzione del video e annulla il caricamento. Utilizza questo con parsimonia - pauseVideo() è spesso preferito.

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

const result = await YoutubePlayer.stopVideo({ playerId: 'player-id-123' });
console.log(result);

playVideo

Riproduci il video attualmente caricato 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

Continua con l'utilizzo di @capgo/capacitor-youtube-player

Se stai utilizzando L'utilizzo di @capgo/capacitor-youtube-player per pianificare il comportamento dei media nativi e dell'interfaccia, connettilo con @capgo/capacitor-youtube-player per i dettagli di implementazione in @capgo/capacitor-youtube-player Guida introduttiva per i dettagli di implementazione in Guida introduttiva L'utilizzo di @capgo/capacitor-live-activities per la capacità nativa in L'utilizzo di @capgo/capacitor-live-activities @capgo/capacitor-attività-in-vivo per i dettagli di implementazione in @capgo/capacitor-live-activities e Utilizza @capgo/capacitor-video-player per la capacità nativa in Utilizza @capgo/capacitor-video-player.

FAQ

FAQ del plugin YouTube Player

Come posso installare il plugin YouTube Player in un'app Capacitor?

Esegui "bun add @capgo/capacitor-youtube-player" (o "npm install @capgo/capacitor-youtube-player"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino i nativi code. Importalo da "@capgo/capacitor-youtube-player" nella tua app code.

Funziona @capgo/capacitor-youtube-player con React, Vue e Angular?

Sì. YouTube Player è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-youtube-player?

Capgo plugin seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-youtube-player?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-youtube-player/ e il pacchetto è gratuito da installare su npm. I segnalazioni di bug e richieste di pull sono benvenuti.

Posso aggiornare code che utilizza YouTube Player senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica i nativi code, quindi richiede una nuova build dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con Capgo live updates.

Consegna delle modifiche al player YouTube senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, Capgo le aggiornamenti in tempo reale inviano i cambiamenti JavaScript, HTML e CSS ai tuoi utenti in pochi minuti.

Inizia con Capgo