Ivs player for Capacitor app Android and IOS.
npm install @capgo/ivs-player
npx cap sync
create(...)
start()
cast()
getCastStatus()
pause()
delete()
getUrl()
getState()
setPlayerPosition(...)
getPlayerPosition()
setAutoQuality(...)
getAutoQuality()
setPip(...)
getPip()
setFrame(...)
getFrame()
setBackgroundState(...)
getBackgroundState()
setMute(...)
getMute()
setQuality(...)
getQuality()
getQualities()
getPluginVersion()
addListener('startPip', ...)
addListener('stopPip', ...)
addListener('expandPip', ...)
addListener('closePip', ...)
addListener('onState', ...)
addListener('onCues', ...)
addListener('onDuration', ...)
addListener('onError', ...)
addListener('onRebuffering', ...)
addListener('onSeekCompleted', ...)
addListener('onVideoSize', ...)
addListener('onQuality', ...)
addListener('onCastStatus', ...)
removeAllListeners()
create(options: { url: string; pip?: boolean; title?: string; subtitle?: string; cover?: string; autoPlay?: boolean; toBack?: boolean; x?: number; y?: number; width?: number; height?: number; }) => Promise<void>
Param | Type |
---|---|
options |
{ url: string; pip?: boolean; title?: string; subtitle?: string; cover?: string; autoPlay?: boolean; toBack?: boolean; x?: number; y?: number; width?: number; height?: number; } |
start() => Promise<void>
cast() => Promise<void>
getCastStatus() => Promise<{ isActive: boolean; }>
Returns: Promise<{ isActive: boolean; }>
pause() => Promise<void>
delete() => Promise<void>
getUrl() => Promise<{ url: string; }>
Returns: Promise<{ url: string; }>
getState() => Promise<{ state: CapacitorIvsPlayerState; }>
Returns: Promise<{ state: CapacitorIvsPlayerState; }>
setPlayerPosition(options?: { toBack: boolean; } | undefined) => Promise<void>
Param | Type |
---|---|
options |
{ toBack: boolean; } |
getPlayerPosition() => Promise<{ toBack: boolean; }>
Returns: Promise<{ toBack: boolean; }>
setAutoQuality(options?: { autoQuality?: boolean | undefined; } | undefined) => Promise<void>
Param | Type |
---|---|
options |
{ autoQuality?: boolean; } |
getAutoQuality() => Promise<{ autoQuality: boolean; }>
Returns: Promise<{ autoQuality: boolean; }>
setPip(options?: { pip?: boolean | undefined; } | undefined) => Promise<void>
Param | Type |
---|---|
options |
{ pip?: boolean; } |
getPip() => Promise<{ pip: boolean; }>
Returns: Promise<{ pip: boolean; }>
setFrame(options?: { x?: number | undefined; y?: number | undefined; width?: number | undefined; height?: number | undefined; } | undefined) => Promise<void>
Set the frame of the player view, all number have to be positive and integers
Param | Type | Description |
---|---|---|
options |
{ x?: number; y?: number; width?: number; height?: number; } |
: number, y: number, width: number, height: number} |
Since: 1.0.0
getFrame() => Promise<CapacitorFrame>
Returns: Promise<CapacitorFrame>
setBackgroundState(options: { backgroundState: CapacitorIvsPlayerBackgroundState; }) => Promise<void>
Param | Type |
---|---|
options |
{ backgroundState: CapacitorIvsPlayerBackgroundState; } |
getBackgroundState() => Promise<{ backgroundState: CapacitorIvsPlayerBackgroundState; }>
Returns: Promise<{ backgroundState: CapacitorIvsPlayerBackgroundState; }>
setMute(options?: { muted?: boolean | undefined; } | undefined) => Promise<void>
Param | Type |
---|---|
options |
{ muted?: boolean; } |
getMute() => Promise<{ mute: boolean; }>
Returns: Promise<{ mute: boolean; }>
setQuality(options?: { quality: string; } | undefined) => Promise<void>
Param | Type |
---|---|
options |
{ quality: string; } |
getQuality() => Promise<{ quality: string; }>
Returns: Promise<{ quality: string; }>
getQualities() => Promise<{ qualities: string[]; }>
Returns: Promise<{ qualities: string[]; }>
getPluginVersion() => Promise<{ version: string; }>
Get the native Capacitor plugin version
Returns: Promise<{ version: string; }>
addListener(eventName: "startPip", listenerFunc: () => void) => Promise<PluginListenerHandle>
Listen for start pip
Param | Type |
---|---|
eventName |
'startPip' |
listenerFunc |
() => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "stopPip", listenerFunc: () => void) => Promise<PluginListenerHandle>
Listen for stop pip
Param | Type |
---|---|
eventName |
'stopPip' |
listenerFunc |
() => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "expandPip", listenerFunc: () => void) => Promise<PluginListenerHandle>
Listen for expend pip
Param | Type |
---|---|
eventName |
'expandPip' |
listenerFunc |
() => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "closePip", listenerFunc: () => void) => Promise<PluginListenerHandle>
Listen for close pip
Param | Type |
---|---|
eventName |
'closePip' |
listenerFunc |
() => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onState", listenerFunc: (data: { state: CapacitorIvsPlayerState; }) => void) => Promise<PluginListenerHandle>
Listen for state changes
Param | Type |
---|---|
eventName |
'onState' |
listenerFunc |
(data: { state: CapacitorIvsPlayerState; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onCues", listenerFunc: (data: { cues: string; }) => void) => Promise<PluginListenerHandle>
Listen for cue changes
Param | Type |
---|---|
eventName |
'onCues' |
listenerFunc |
(data: { cues: string; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onDuration", listenerFunc: (data: { duration: number; }) => void) => Promise<PluginListenerHandle>
Listen for duration changes
Param | Type |
---|---|
eventName |
'onDuration' |
listenerFunc |
(data: { duration: number; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onError", listenerFunc: (data: { error: string; }) => void) => Promise<PluginListenerHandle>
Listen for errors
Param | Type |
---|---|
eventName |
'onError' |
listenerFunc |
(data: { error: string; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onRebuffering", listenerFunc: () => void) => Promise<PluginListenerHandle>
Listen for rebuffering
Param | Type |
---|---|
eventName |
'onRebuffering' |
listenerFunc |
() => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onSeekCompleted", listenerFunc: (data: { position: number; }) => void) => Promise<PluginListenerHandle>
Listen for position changes
Param | Type |
---|---|
eventName |
'onSeekCompleted' |
listenerFunc |
(data: { position: number; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onVideoSize", listenerFunc: (data: { width: number; height: number; }) => void) => Promise<PluginListenerHandle>
Listen for video size changes
Param | Type |
---|---|
eventName |
'onVideoSize' |
listenerFunc |
(data: { width: number; height: number; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onQuality", listenerFunc: (data: { quality: string; }) => void) => Promise<PluginListenerHandle>
Listen for quality changes
Param | Type |
---|---|
eventName |
'onQuality' |
listenerFunc |
(data: { quality: string; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
addListener(eventName: "onCastStatus", listenerFunc: (data: { isActive: boolean; }) => void) => Promise<PluginListenerHandle>
Listen for cast status changes
Param | Type |
---|---|
eventName |
'onCastStatus' |
listenerFunc |
(data: { isActive: boolean; }) => void |
Returns: Promise<PluginListenerHandle>
Since: 1.0.0
removeAllListeners() => Promise<void>
Remove all listeners for this plugin.
Since: 1.0.0
Prop | Type |
---|---|
x |
number |
y |
number |
width |
number |
height |
number |
Prop | Type |
---|---|
remove |
() => Promise<void> |
"IDLE" | "BUFFERING" | "READY" | "PLAYING" | "ENDED" | "UNKNOWN"
"PAUSED" | "PLAYING"
singen @capgo/ivs-player
Um das @capgo/ivs-player-Paket zu installieren, müssen Sie den folgenden Befehl ausführen:
npm install @capgo/ivs-player
npx cap sync
Das @capgo/ivs-player-Paket bietet die folgende API:
Diese Methode erstellt eine Instanz des IVS-Players. Sie nimmt ein Optionsobjekt als Parameter, das verschiedene Eigenschaften wie die URL des Videos, ob der Bild-in-Bild-Modus aktiviert werden soll, den Titel und Untertitel des Videos und mehr enthält. Sie gibt ein Promise zurück, das zur erstellten Instanz aufgelöst wird.
Diese Methode startet die Wiedergabe des Videos im IVS-Player. Sie gibt ein Promise zurück.
Diese Methode streamt das Video zu einem angeschlossenen Gerät. Sie gibt ein Promise zurück.
Diese Methode ruft den Status der Casting-Funktion ab. Sie gibt ein Promise zurück, das zu einem Objekt mit der Eigenschaft isActive aufgelöst wird, die angibt, ob das Casting aktiv ist.
Diese Methode pausiert die Video-Wiedergabe. Sie gibt ein Promise zurück.
Diese Methode löscht die IVS-Player-Instanz. Sie gibt ein Promise zurück.
Diese Methode ruft die URL des aktuell wiedergegebenen Videos ab. Sie gibt ein Promise zurück.
Diese Methode ruft den aktuellen Zustand des IVS-Players ab. Sie gibt ein Promise zurück.
Diese Methode setzt die Position des IVS-Players auf dem Bildschirm. Sie nimmt x- und y-Koordinaten als Parameter und gibt ein Promise zurück.
Diese Methode ruft die aktuelle Position des IVS-Players auf dem Bildschirm ab. Sie gibt ein Promise zurück.
Diese Methode setzt den automatischen Qualitätsmodus des IVS-Players. Sie nimmt einen booleschen Wert als Parameter und gibt ein Promise zurück.
Diese Methode ruft den aktuellen automatischen Qualitätsmodus des IVS-Players ab. Sie gibt ein Promise zurück.
Diese Methode setzt den Bild-in-Bild-Modus des IVS-Players. Sie nimmt einen booleschen Wert als Parameter und gibt ein Promise zurück.
Diese Methode ruft den aktuellen Bild-in-Bild-Modus des IVS-Players ab. Sie gibt ein Promise zurück.
Diese Methode setzt das Frame des IVS-Players. Sie nimmt einen Zahlenwert als Parameter und gibt ein Promise zurück.
Diese Methode ruft das aktuelle Frame des IVS-Players ab. Sie gibt ein Promise zurück.
Diese Methode setzt den Stumm-Modus des IVS-Players. Sie nimmt einen booleschen Wert als Parameter und gibt ein Promise zurück.
Diese Methode ruft den aktuellen Stumm-Modus des IVS-Players ab. Sie gibt ein Promise zurück.
Diese Methode setzt die Qualität des Videos im IVS-Player. Sie nimmt einen String-Wert als Parameter und gibt ein Promise zurück.
Diese Methode ruft die aktuelle Qualität des Videos im IVS-Player ab. Sie gibt ein Promise zurück.
Diese Methode ruft die verfügbaren Qualitäten des Videos im IVS-Player ab. Sie gibt ein Promise zurück.
Diese Methode fügt einen Listener für das expandPip-Ereignis hinzu. Sie nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das closePip-Ereignis hinzu. Sie nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onState-Ereignis hinzu. Sie nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onCues-Ereignis hinzu. Sie nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onDuration-Ereignis hinzu.Es nimmt eine Callback-Funktion als Parameter und gibt void zurück
Diese Methode fügt einen Listener für das onError-Ereignis hinzu. Es nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onRebuffering-Ereignis hinzu. Es nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onSeekCompleted-Ereignis hinzu. Es nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onVideoSize-Ereignis hinzu. Es nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onQuality-Ereignis hinzu. Es nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode fügt einen Listener für das onCastStatus-Ereignis hinzu. Es nimmt eine Callback-Funktion als Parameter und gibt void zurück.
Diese Methode entfernt alle hinzugefügten Ereignis-Listener. Es gibt void zurück.
Das @capgo/ivs-player-Paket bietet eine umfassende API zur Integration eines IVS-Players in Ihre Capacitor-App. Durch das Befolgen der Installationsschritte und das Referenzieren der API-Dokumentation können Sie einfach beginnen, Videos in Ihrer App mit dem IVS-Player abzuspielen.