メインコンテンツへスキップ
@capgo/capacitor-video-player メディア オープンソース

ビデオプレーヤー Capacitor プラグイン

字幕、全画面表示、充実したコントロールを備えたネイティブ動画再生

インストール

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

ガイド

Capacitor で Video Player を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

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

@capgo/capacitor-video-playerの使用方法

ネイティブプレーヤーで動画を再生するためのCapacitorプラグイン。

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

import { VideoPlayer } from '@capgo/capacitor-video-player';

API の概要

メソッド 説明
initPlayer ビデオプレーヤーを初期化します。
isPlaying 指定した playerId が再生中かどうかを返します。
play 指定した playerId のビデオを再生します。
pause 指定した playerId のビデオを一時停止します。
getDuration 指定した playerId のビデオの再生時間を取得します。
getCurrentTime 指定した playerId のビデオの現在の再生位置を取得します。
setCurrentTime 指定した playerId のビデオのシーク先の再生位置を設定します。
getVolume 指定した playerId のビデオの音量を取得します。
setVolume 指定した playerId のビデオの音量を設定します。
getMuted 指定した playerId のビデオのミュート状態を取得します。
setMuted 指定した playerId のビデオのミュート状態を設定します。
setRate 指定した playerId の現在のビデオの再生速度を設定します。
getRate 指定した playerId の現在のビデオの再生速度を取得します。
stopAllPlayers 再生中のすべてのプレイヤーを停止します。
showController コントローラーを表示します。
isControllerIsFullyVisible isControllerIsFullyVisible
exitPlayer プレイヤーを終了します。
hidePlayer 再生を停止せずに、現在表示中のプレイヤー UI を非表示にします(ネイティブフルスクリーン)。
showPlayer 以前に非表示にしたプレイヤー UI を再表示します(ネイティブフルスクリーン)。

例

initPlayer()

ビデオプレーヤーを初期化します。

import { VideoPlayer } from '@capgo/capacitor-video-player';

const result = await VideoPlayer.initPlayer({ mode: 'fullscreen' });
console.log(result);

isPlaying()

指定した playerId が再生中かどうかを返します。

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

play()

指定した playerId のビデオを再生します。

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

pause()

指定した playerId のビデオを一時停止します。

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

getDuration()

指定した playerId のビデオの再生時間を取得します。

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

getCurrentTime()

指定した playerId のビデオの現在の再生位置を取得します。

import { VideoPlayer } from '@capgo/capacitor-video-player';

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

上記のテーブルには19のコアメソッドがリストされています。リスナーやバージョンヘルパー、各メソッドの完全な仕様については、ドキュメントを参照してください。 GitHub リポジトリ.

完全なリファレンス

@capgo/capacitor-video-player の使い方から続ける

使用している場合 @capgo/capacitor-video-playerの使用方法 ネイティブメディアとインターフェースの挙動を計画するには、次と連携させてください @capgo/capacitor-video-player @capgo/capacitor-video-player の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities の使用におけるネイティブ機能については、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装の詳細については、 @capgo/capacitor-native-navigation の活用 @capgo/capacitor-native-navigation. の使い方におけるネイティブ機能については

よくある質問

Video Player プラグインの FAQ

Capacitor アプリに Video Player プラグインをインストールするには?

"bun add @capgo/capacitor-video-player" (または "npm install @capgo/capacitor-video-player") を実行し、続けて "bunx cap sync" を実行して iOS と Android のプロジェクトにネイティブの code を反映させてください。アプリの code で "@capgo/capacitor-video-player" からインポートしてください。

@capgo/capacitor-video-player は React、Vue、Angular で動作しますか?

はい。Video Player は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、プレーン JavaScript など、Capacitor 内で動作するすべての Web フレームワークで利用できます。

@capgo/capacitor-video-player はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

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

はい。ソース code は https://github.com/Cap-go/capacitor-video-player/ の GitHub で公開されており、npm から無料でインストールできます。バグ報告やプルリクエストをお待ちしています。

Video Player を使用している code を、App Store のレビューなしで更新できますか?

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

アプリの審査を待たずにVideo Playerの変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める