メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-youtube-player
チュートリアル
@capgo/capacitor-youtube-player

YouTube Player

YouTube動画を埋め込むには、完全なプレイヤー API の制御とイベントハンドリングが可能です。

ガイド

YouTube プレイヤーに関するチュートリアル

デバイスでテスト

Download the Capgo app, then scan the QR code.

YouTube Player プラグイン プレビュー QR code

@ capgo/ capacitor-youtube-player を使用

YouTube Player プラグインのインターフェイスは Capacitor を提供します。アプリ内で YouTube ビデオの再生を制御するためのメソッドを提供します。

インストール

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

このプラグインが公開するもの

  • initialize - 新しい YouTube プレーヤー インスタンスを初期化します。
  • destroy - プレーヤー インスタンスを破棄し、リソースを解放します。
  • stopVideo - ビデオ再生を停止し、ロードをキャンセルします。使用する場合は、まれに使用してください - pauseVideo() は通常の選択肢です。
  • playVideo - 現在のキューまたはロードされたビデオを再生します。最終的なプレーヤー状態は PLAYING (1) になります。

Main WebView リファラー パッチ

有効 patchRefererHeader YouTubeコンテンツがプラグインで動作するが、CapacitorのメインWebViewから失敗する場合 Referer YouTubeはブラウザのような

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

このパッチは youtube.com, youtube-nocookie.comにのみ適用されます。 youtu.be 既存のリクエストレベルの Referer ヘッダーは保持され、 refererHeader 指定されていない場合の https://www.youtube.com デフォルト値は

例えば

initialize

新しいYouTubeプレイヤーインスタンスを初期化します。

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

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

destroy

プレイヤーインスタンスを破棄し、リソースを解放します。

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

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

ビデオ再生を停止し、ロードをキャンセルします。このメソッドはまれに使用されるため、pauseVideo()は通常の選択肢です。

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);

フルリファレンス

Keep going from Using @capgo/capacitor-youtube-player

Capacitor YouTube プラグインを使用している場合 Using @capgo/capacitor-youtube-player Capacitor YouTube プラグインの実装詳細については、Capacitor YouTube プラグインを参照してください。 @capgo/capacitor-youtube-player for the implementation detail in @capgo/capacitor-youtube-player, Capacitor YouTube プラグインの実装詳細については、Capacitor YouTube プラグインを参照してください。 Capacitorの実装詳細については、Getting Startedを参照してください。 Using @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 Using @capgo/capacitor-video-player for the native capability in Using @capgo/capacitor-video-player.