メインコンテンツにジャンプ
@capgo/capacitor-youtube-player メディア オープンソース

YouTube プレイヤー Capacitor プラグイン

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

インストール

bun add @capgo/capacitor-youtube-player bunx cap sync
pnpmまたはyarnのnpm
  • npm install @capgo/capacitor-youtube-player
  • pnpm add @capgo/capacitor-youtube-player
  • yarn add @capgo/capacitor-youtube-player

ガイド

How to use YouTube Player in Capacitor

デバイスでテスト

Download the Capgo app, then scan the QR code.

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

capgo/capacitor-youtube-playerを使用

YouTube プレイヤー プラグインは、Capacitor用のインターフェイスを提供し、YouTube動画の再生を制御するためのメソッドを提供します。

インストール

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

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

  • initialize - YouTube プレイヤー インスタンスを新規に作成します。
  • destroy - プレイヤー インスタンスを破棄し、リソースを解放します。
  • stopVideo - ビデオ再生を停止し、ロードをキャンセルします。使用する場合は、まれに使用します。 - pauseVideo() は通常、優先されます。
  • playVideo - 予めクエューまたはロードされたビデオを再生します。最終的なプレイヤー状態はPLAYING (1) になります。

メイン WebView リファラーパッチ

有効 patchRefererHeader YouTube コンテンツがプラグインで動作するが、Capacitor の Main WebView から失敗する場合に使用します。YouTube はブラウザのようなヘッダーを期待します。 Referer このパッチは、

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

、 youtube.com, youtube-nocookie.com, and youtu.be Capacitor Youtube Player requests. Existing request-level 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';

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

現在のキューまたはロード済みの動画を再生します。最終的なプレイヤー状態はPLAYING(1)になります。

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

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

フルリファレンス

@capgo/capacitor-youtube-playerを継続して使用してください。

Capacitor YouTube プレイヤーを使用している場合 Using @capgo/capacitor-youtube-player Capacitor YouTube プレイヤーを使用して、ネイティブメディアとインターフェイスの動作を計画するには、Capacitor YouTube プレイヤーと接続してください @capgo/capacitor-youtube-player Capacitor Youtube プレイヤー実装の詳細については、@capgo/capacitor-youtube-playerを参照してください。 Capacitor YouTube プレイヤー Capacitor YouTube プレイヤー @capgo/capacitorライブ活動を使用 native機能のために@capgo/capacitor-live-activitiesを使用します。 @capgo/capacitor-ライブ活動 @capgo/capacitor-ライブアクティビティの実装詳細について Using @capgo/capacitor-video-player Capacitorのネイティブ機能として@capgo/capacitor-video-playerを使用します。

FAQ

YouTube Player プラグイン FAQ

YouTube Player プラグインを Capacitor アプリにどのようにインストールしますか?

「bun add @capgo/capacitor-youtube-player」 (または「npm install @capgo/capacitor-youtube-player」) を実行し、次に「bunx cap sync」を実行して iOS と Android プロジェクトがネイティブ code を取得するようにします。次に、@capgo/capacitor-youtube-player をアプリの code からインポートします。

React、Vue、Angular と @capgo/capacitor-youtube-player はどのように動作しますか?

はい。YouTube Player は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、または単純な JavaScript など、Capacitor 内で実行される任意の Web フレームワークと互換性があります。

どの Capacitor バージョンが @capgo/capacitor-youtube-player に対応していますか?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-youtube-player は無料でオープンソースですか?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-youtube-player/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code を使用しているアプリに YouTube Player を更新することは App Store のレビューなしで可能ですか?

プラグインをインストールまたはアップグレードするとネイティブ code が変更されるため、新しいストアビルドが必要になります。その後、JavaScript、HTML、CSS の変更がプラグインを呼び出すと Capgo のライブアップデートで即時配信できます。

YouTube プラグインの変更をアプリレビューの待たずに配信します。

プラグインがストアにビルドされたら、Capgo ライブアップデートは、ユーザーに JavaScript、HTML、CSS の変更を数分で反映します。

Capgo で始めます。