使用@capgo/capacitor-youtube-player
Capacitor YouTube Player插件接口。提供控制 YouTube 视频播放的方法。
安装
bun add @capgo/capacitor-youtube-player
bunx cap sync
此插件暴露的内容
initialize- 初始化一个新的 YouTube 播放器实例。destroy- 销毁一个播放器实例并释放资源。stopVideo- 停止视频播放并取消加载。请谨慎使用 - pauseVideo() 通常更合适。playVideo- 播放当前缓冲或加载的视频。最终播放器状态将为 PLAYING (1)。
主 WebView Referer 修补
启用 patchRefererHeader When YouTube 内容在插件中正常工作,但从 Capacitor 的主 WebView 中失败,因为 YouTube 期望浏览器样式 Referer 标题。
{
"plugins": {
"YoutubePlayer": {
"patchRefererHeader": true,
"refererHeader": "https://www.youtube.com"
}
}
}
该补丁仅适用于 youtube.com, youtube-nocookie.com, 和 youtu.be 请求。现有的请求级别 Referer 头部保留,且 refererHeader 当省略时默认值。 https://www.youtube.com 示例用法
初始化一个新的 YouTube 播放器实例。
initialize
销毁一个播放器实例并释放资源。
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
await YoutubePlayer.initialize({
playerId: 'my-player',
videoId: 'dQw4w9WgXcQ',
playerSize: { width: 640, height: 360 },
privacyEnhanced: true
});
destroy
停止视频播放并取消加载。请谨慎使用 - 使用 pauseVideo() 通常更好。
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
await YoutubePlayer.destroy({} as PlayerIdOptions);
stopVideo
仅适用于
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
await YoutubePlayer.stopVideo({} as PlayerIdOptions);
playVideo
播放当前缓冲或已加载的视频。最终播放器状态将为PLAYING (1).
import { YoutubePlayer } from '@capgo/capacitor-youtube-player';
await YoutubePlayer.playVideo({} as PlayerIdOptions);
全局参考
- GitHub: https://github.com/Cap-go/capacitor-youtube-player/
- 文档:/docs/plugins/youtube-player/
继续使用@capgo/capacitor-youtube-player
如果您正在使用 使用@capgo/capacitor-youtube-player 来规划原生媒体和界面行为,连接它与 @capgo/capacitor-youtube-player 查看@capgo/capacitor-youtube-player的实现细节 开始使用 For the implementation detail in Getting Started, 使用 @capgo/capacitor-live-activities For the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor-live-activities For the implementation detail in @capgo/capacitor-live-activities, and 使用 @capgo/capacitor-video-player For the native capability in Using @capgo/capacitor-video-player.