Panduan
Cara menggunakan YouTube Player di Capacitor
Menggunakan @capgo/capacitor-youtube-player
Interface plugin YouTube Player untuk Capacitor. Menyediakan metode untuk mengontrol playback video YouTube di aplikasi Anda.
Instal
bun add @capgo/capacitor-youtube-player
bunx cap sync
Apa yang Diekspos Plugin Ini
initialize- Inisialisasi instance player YouTube baru.destroy- Hancurkan instance player dan bebaskan resource.stopVideo- Hentikan playback video dan batalkan loading. Gunakan sesekali saja - pauseVideo() biasanya lebih disarankan.playVideo- Putar video yang sedang di-cue atau dimuat. Status akhir player akan menjadi PLAYING (1).
Patch Referer Main WebView
Aktifkan patchRefererHeader ketika konten YouTube berjalan di plugin tetapi gagal di WebView utama Capacitor karena YouTube mengharapkan lingkungan seperti browser Referer header.
{
"plugins": {
"YoutubePlayer": {
"patchRefererHeader": true,
"refererHeader": "https://www.youtube.com"
}
}
}
Patch ini hanya berlaku untuk youtube.com, youtube-nocookie.com, dan youtu.be request. Header request-level yang ada Referer tetap dipertahankan, dan refererHeader defaultnya adalah https://www.youtube.com saat tidak disertakan.
Contoh Penggunaan
initialize
Inisialisasi instance YouTube player baru.
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
await YoutubePlayer.initialize({
playerId: 'my-player',
videoId: 'dQw4w9WgXcQ',
playerSize: { width: 640, height: 360 },
privacyEnhanced: true
});
destroy
Hancurkan instance player dan bebaskan resource.
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
const result = await YoutubePlayer.destroy({ playerId: 'player-id-123' });
console.log(result);
stopVideo
Hentikan playback video dan batalkan loading. Gunakan seperlunya - pauseVideo() biasanya lebih dipilih.
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
const result = await YoutubePlayer.stopVideo({ playerId: 'player-id-123' });
console.log(result);
playVideo
Putar video yang sedang di-cue atau sudah dimuat. Status akhir player adalah PLAYING (1).
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
const result = await YoutubePlayer.playVideo({ playerId: 'player-id-123' });
console.log(result);
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-youtube-player/
- Dokumentasi: /docs/plugins/youtube-player/
Lanjutkan dari Menggunakan @capgo/capacitor-youtube-player
Jika Anda menggunakan Menggunakan @capgo/capacitor-youtube-player untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-youtube-player untuk detail implementasi di @capgo/capacitor-youtube-player, Panduan Memulai untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, dan Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player.