はじめから
インストール手順とこのプラグインのフル マークダウン ガイドを含むセットアップの質問をコピーします。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-video-player`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/video-player/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
インストール
Installbun add @capgo/capacitor-video-playerbunx cap syncインポート
インポートimport { VideoPlayer } from '@capgo/capacitor-video-player';API の概要
API の概要initPlayer
initPlayer動画再生用プレイヤーを初期化
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.initPlayer({} as capVideoPlayerOptions);isPlaying
再生中かどうか指定された playerId がプレイ中の場合に返します。
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.isPlaying({} as capVideoPlayerIdOptions);play
セクション「プレイ」指定された playerId の現在のビデオを再生します。
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.play({} as capVideoPlayerIdOptions);pause
セクション「一時停止」指定された playerId の現在のビデオを一時停止します。
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.pause({} as capVideoPlayerIdOptions);getDuration
セクション「ビデオの長さを取得」指定された playerId の現在のビデオの長さを取得します。
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.getDuration({} as capVideoPlayerIdOptions);getCurrentTime
セクション「現在の時間を取得」__CAPGO_KEEP_0__の現在の時間を指定されたplayerIdから取得します
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.getCurrentTime({} as capVideoPlayerIdOptions);setCurrentTime
setCurrentTimeセクション__CAPGO_KEEP_0__の現在の時間を指定されたplayerIdから取得し、指定されたplayerIdの動画を指定された時間まで再生します
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.setCurrentTime({} as capVideoTimeOptions);getVolume
getVolumeセクション__CAPGO_KEEP_0__の現在の音量を指定されたplayerIdから取得します
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.getVolume({} as capVideoPlayerIdOptions);setVolume
setVolumeセクション__CAPGO_KEEP_0__の音量を指定されたplayerIdから取得し、指定されたplayerIdの動画の音量を指定された値に設定します
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.setVolume({} as capVideoVolumeOptions);getMuted
getMutedセクション指定されたplayerIdから現在の動画のミュートを取得する
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.getMuted({} as capVideoPlayerIdOptions);setMuted
セクション “setMuted”指定されたplayerIdから現在の動画のミュートを設定する
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.setMuted({} as capVideoMutedOptions);setRate
セクション “setRate”指定されたplayerIdから現在の動画の再生速度を設定する
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.setRate({} as capVideoRateOptions);getRate
セクション “getRate”指定されたplayerIdから現在の動画の再生速度を取得する
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.getRate({} as capVideoPlayerIdOptions);stopAllPlayers
セクション “stopAllPlayers”全てのプレイヤーを停止
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.stopAllPlayers();showController
showControllerコントローラーを表示
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.showController();isControllerIsFullyVisible
isControllerIsFullyVisibleコントローラーが完全に表示されているか
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.isControllerIsFullyVisible();exitPlayer
exitPlayerプレイヤーを終了
import { VideoPlayer } from '@capgo/capacitor-video-player';
await VideoPlayer.exitPlayer();capVideoPlayerOptions
「capVideoPlayerOptions」セクションexport interface capVideoPlayerOptions { /** * Player mode * - "fullscreen" * - "embedded" (Web only) */ mode?: string; /** * The url of the video to play */ url?: string; /** * The url of subtitle associated with the video */ subtitle?: string; /** * The language of subtitle * see https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers */ language?: string; /** * SubTitle Options */ subtitleOptions?: SubTitleOptions; /** * Id of DIV Element parent of the player */ playerId?: string; /** * Initial playing rate */ rate?: number; /** * Exit on VideoEnd (iOS, Android) * default: true */ exitOnEnd?: boolean; /** * Loop on VideoEnd when exitOnEnd false (iOS, Android) * default: false */ loopOnEnd?: boolean; /** * Picture in Picture Enable (iOS, Android) * default: true */ pipEnabled?: boolean; /** * Background Mode Enable (iOS, Android) * default: true */ bkmodeEnabled?: boolean; /** * Show Controls Enable (iOS, Android) * default: true */ showControls?: boolean; /** * Display Mode ["all", "portrait", "landscape"] (iOS, Android) * default: "all" */ displayMode?: string; /** * Component Tag or DOM Element Tag (React app) */ componentTag?: string; /** * Player Width (mode "embedded" only) */ width?: number; /** * Player height (mode "embedded" only) */ height?: number; /** * Headers for the request (iOS, Android) * by Manuel García Marín (https://github.com/PhantomPainX) */ headers?: { [key: string]: string; }; /** * Title shown in the player (Android) * by Manuel García Marín (https://github.com/PhantomPainX) */ title?: string; /** * Subtitle shown below the title in the player (Android) * by Manuel García Marín (https://github.com/PhantomPainX) */ smallTitle?: string; /** * ExoPlayer Progress Bar and Spinner color (Android) * by Manuel García Marín (https://github.com/PhantomPainX) * Must be a valid hex color code * default: #FFFFFF */ accentColor?: string; /** * Chromecast enable/disable (Android) * by Manuel García Marín (https://github.com/PhantomPainX) * default: true */ chromecast?: boolean; /** * Artwork url to be shown in Chromecast player * by Manuel García Marín (https://github.com/PhantomPainX) * default: "" */ artwork?: string; /** * DRM configuration for protected content (iOS: FairPlay, Android: Widevine) */ drm?: DrmOptions;}capVideoPlayerResult
「capVideoPlayerResult」セクションexport interface capVideoPlayerResult { /** * result set to true when successful else false */ result?: boolean; /** * method name */ method?: string; /** * value returned */ value?: any; /** * message string */ message?: string;}capVideoPlayerIdOptions
「capVideoPlayerIdOptions」セクションexport interface capVideoPlayerIdOptions { /** * Id of DIV Element parent of the player */ playerId?: string;}capVideoTimeOptions
「capVideoTimeOptions」セクションexport interface capVideoTimeOptions { /** * Id of DIV Element parent of the player */ playerId?: string; /** * Video time value you want to seek to */ seektime?: number;}capVideoVolumeOptions
「capVideoVolumeOptions」セクションexport interface capVideoVolumeOptions { /** * Id of DIV Element parent of the player */ playerId?: string; /** * Volume value between [0 - 1] */ volume?: number;}capVideoMutedOptions
「capVideoMutedOptions」セクションexport interface capVideoMutedOptions { /** * Id of DIV Element parent of the player */ playerId?: string; /** * Muted value true or false */ muted?: boolean;}capVideoRateOptions
セクション「capVideoRateOptions」export interface capVideoRateOptions { /** * Id of DIV Element parent of the player */ playerId?: string; /** * Rate value */ rate?: number;}SubTitleOptions
セクション「SubTitleOptions」export interface SubTitleOptions { /** * Foreground Color in RGBA (default rgba(255,255,255,1) */ foregroundColor?: string; /** * Background Color in RGBA (default rgba(0,0,0,1) */ backgroundColor?: string; /** * Font Size in pixels (default 16) */ fontSize?: number;
/** * Get the native Capacitor plugin version * * @returns {Promise<{ id: string }>} an Promise with version for this device * @throws An error if the something went wrong */ getPluginVersion(): Promise<{ version: string }>;}DrmOptions
セクション「DrmOptions」export interface DrmOptions { /** * FairPlay DRM configuration (iOS) */ fairplay?: FairPlayDrmOptions; /** * PlayReady DRM configuration */ playready?: PlayreadyDrmOptions; /** * Widevine DRM configuration (Android) */ widevine?: WidevineDrmOptions;}FairPlayDrmOptions
セクション「FairPlayDrmOptions」export interface FairPlayDrmOptions { /** * The URL to fetch the FairPlay certificate */ certificateUrl?: string; /** * The URL to send the SPC and receive the CKC license (FairPlay license server URL) */ contentKeySpcUrl?: string;}PlayreadyDrmOptions
セクション「PlayreadyDrmOptions」export interface PlayreadyDrmOptions { /** * The URL to fetch the PlayReady license */ certificateUrl?: string;}WidevineDrmOptions
セクション「WidevineDrmOptions」export interface WidevineDrmOptions { /** * The URL to fetch the Widevine license */ certificateUrl?: string;}真実の源
「真実の源」というセクションこのページはプラグインの src/definitions.ts公開 API がアップストリームで変更された場合に再度同期を実行してください。
「Getting Started」から続けてください
「Getting Started」を使用ネイティブメディアとインターフェイスの動作を計画する場合、 「Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-video-player」を 「Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-video-player」にネイティブ機能を接続する 「Using @capgo/capacitor-video-player」 「Using @capgo/capacitor-video-player」 @capgo/capacitor-live-activities Using @capgo/capacitor-live-activities @capgo/capacitor-live-activities Using @capgo/capacitor-live-activities, @capgo/capacitor-video-player Using @capgo/capacitor-video-player, and Using @capgo/capacitor-native-navigation Using @capgo/capacitor-native-navigation.