YouTube Player Capacitor 插件

使用 @capgo/capacitor-youtube-player

用于 Capacitor 的 YouTube Player 插件。提供在应用中控制 YouTube 视频播放的方法。

安装

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

插件暴露的内容

• initialize - 初始化一个新的 YouTube player 实例。
• destroy - 销毁 player 实例并释放资源。
• stopVideo - 停止视频播放并取消加载。请谨慎使用——通常更推荐 pauseVideo()。
• playVideo - 播放当前已排队或已加载的视频。最终 player 状态将为 PLAYING (1)。

主 WebView Referer 补丁

启用 patchRefererHeader 当 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 在未指定时生效。

用法示例

initialize

初始化一个新的 YouTube player 实例。

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

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

destroy

销毁 player 实例并释放资源。

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

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

stopVideo

停止视频播放并取消加载。请谨慎使用 —— 通常建议使用 pauseVideo()。

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

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

playVideo

播放当前已排队或已加载的视频。最终 player 状态将为 PLAYING (1)。

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

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

完整参考

• 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 的实现细节， 快速入门 有关“入门指南”中的实现细节， 使用 @capgo/capacitor-live-activities 用于使用 @capgo/capacitor-live-activities 时的原生能力， @capgo/capacitor-live-activities 关于 @capgo/capacitor-live-activities 中的实现细节，以及 使用 @capgo/capacitor-video-player 有关“使用 @capgo/capacitor-video-player.”中的原生能力