Lompat ke konten utama

Pemain YouTube Capacitor plugin

Tampilkan video YouTube dengan pemutaran penuh dan kendali API serta penanganan event

Install

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

Panduan

Cara menggunakan Player YouTube di Capacitor

Uji di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau plugin pemutar YouTube code

Menggunakan @capgo/capacitor-pemutar-youtube

Antarmuka plugin pemutar YouTube untuk Capacitor. Menyediakan metode untuk mengontrol pemutaran video YouTube di aplikasi Anda.

Pasang

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

Apa yang Dibuka oleh Plugin Ini

  • initialize - Inisialisasi instance pemutar YouTube baru.
  • destroy - Hancurkan instance pemutar dan bebaskan sumber daya.
  • stopVideo - Berhenti pemutaran video dan batalkan pengisian. Gunakan dengan hati-hati - pauseVideo() biasanya lebih disukai.
  • playVideo - Mainkan video yang sedang dipilih atau dimuat. Status akhir pemutar akan menjadi PLAYING (1).

Patch Referer WebView Utama

Enable patchRefererHeader ketika konten YouTube berfungsi di plugin tetapi gagal dari Capacitor's WebView utama karena YouTube mengharapkan header seperti browser. Referer header.

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

Hanya patch ini yang berlaku untuk youtube.com, youtube-nocookie.com, and youtu.be permintaan. Permintaan yang ada Referer header dipertahankan, dan refererHeader menggunakan default https://www.youtube.com ketika dihilangkan.

Contoh Penggunaan

initialize

Inisialisasi instance pemutar YouTube baru.

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

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

destroy

Hapus instance pemutar dan bebaskan sumber daya.

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

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

stopVideo

Hentikan pemutaran video dan batalkan muatan. Gunakan ini dengan hati-hati - pauseVideo() biasanya lebih disukai.

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

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

playVideo

Mainkan video yang saat ini dipilih atau dimuat. Status pemutar akhir akan menjadi PLAYING (1).

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

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

Referensi Lengkap

Teruskan dari Menggunakan @capgo/capacitor-youtube-player

Jika Anda menggunakan Menggunakan @capgo/capacitor-youtube-player untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan Penggunaan @capgo/capacitor-youtube-player untuk detail implementasi di @capgo/capacitor-youtube-player Mulai Menggunakan untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-aktivitas-hidup untuk kemampuan asli di Menggunakan @capgo/capacitor-aktivitas-hidup @capgo/capacitor-aktivitas-hidup untuk detail implementasi di @capgo/capacitor-aktivitas-hidup, dan Menggunakan @capgo/capacitor-player-video untuk kemampuan asli di Menggunakan @capgo/capacitor-player-video

FAQ

FAQ untuk Plugin Player YouTube

Bagaimana Cara Menginstal Plugin Player YouTube di Aplikasi Capacitor?

Jalankan perintah "bun add @capgo/capacitor-youtube-player" (atau "npm install @capgo/capacitor-youtube-player"), kemudian jalankan "bunx cap sync" agar proyek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-youtube-player" di aplikasi code Anda.

Apakah @capgo/capacitor-youtube-player dapat digunakan dengan React, Vue, dan Angular?

Paket YouTube Player adalah Capacitor package, jadi itu berfungsi dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte dan JavaScript biasa.

Versi Capacitor apa yang didukung oleh @capgo/capacitor-youtube-player?

Plugin Capgo mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menampilkan versi yang dipertahankan.

Apakah @capgo/capacitor-youtube-player gratis dan terbuka sumber?

Iya. Sumber code yang terbuka ada di GitHub di https://github.com/Cap-go/capacitor-youtube-player/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan permintaan pull selalu welcome.

Bisa saya memperbarui code yang menggunakan YouTube Player tanpa review App Store?

Pemasangan atau pengupgrade plugin mengubah code native, jadi itu memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML dan CSS yang memanggil plugin dapat berlayar segera dengan Capgo live updates.

Kirim perubahan Player YouTube tanpa harus menunggu ulasan aplikasi

Setelah plugin masuk ke dalam toko Anda, Capgo pembaruan live mengirimkan perubahan JavaScript, HTML, dan CSS ke pengguna dalam menit-menit.

Mulai dengan Capgo