メインコンテンツへスキップ
@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 のソースコードは GitHub の https://github.com/Cap-go/capacitor-video-player/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Store の審査なしで、Video Player を使用している code をアップデートできますか?

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

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

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

Capgo から始める