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"
chanter @capgo/ivs-player
Pour installer le package @capgo/ivs-player, vous devez exécuter la commande suivante :
[[BLOC_DE_CODE]]
Le package @capgo/ivs-player fournit l'API suivante :
Cette méthode crée une instance du lecteur IVS. Elle prend un objet d'options comme paramètre, qui contient diverses propriétés telles que l'URL de la vidéo, la possibilité d'activer le mode image dans l'image, le titre et le sous-titre de la vidéo, et plus encore. Elle retourne une promesse qui se résout avec l'instance créée.
Cette méthode commence la lecture de la vidéo dans le lecteur IVS. Elle retourne une promesse.
Cette méthode diffuse la vidéo sur un appareil connecté. Elle retourne une promesse.
Cette méthode récupère l'état de la fonction de diffusion. Elle retourne une promesse qui se résout avec un objet contenant la propriété isActive, qui indique si la diffusion est active.
Cette méthode met en pause la lecture de la vidéo. Elle retourne une promesse.
Cette méthode supprime l'instance du lecteur IVS. Elle retourne une promesse.
Cette méthode récupère l'URL de la vidéo actuellement en cours de lecture. Elle retourne une promesse.
Cette méthode récupère l'état actuel du lecteur IVS. Elle retourne une promesse.
Cette méthode définit la position du lecteur IVS à l'écran. Elle prend les coordonnées x et y comme paramètres et retourne une promesse.
Cette méthode récupère la position actuelle du lecteur IVS à l'écran. Elle retourne une promesse.
Cette méthode définit le mode de qualité automatique du lecteur IVS. Elle prend une valeur booléenne comme paramètre et retourne une promesse.
Cette méthode récupère le mode de qualité automatique actuel du lecteur IVS. Elle retourne une promesse.
Cette méthode définit le mode image dans l'image du lecteur IVS. Elle prend une valeur booléenne comme paramètre et retourne une promesse.
Cette méthode récupère le mode image dans l'image actuel du lecteur IVS. Elle retourne une promesse.
Cette méthode définit la valeur de cadre du lecteur IVS. Elle prend une valeur numérique comme paramètre et retourne une promesse.
Cette méthode récupère le cadre actuel du lecteur IVS. Elle retourne une promesse.
Cette méthode définit le mode sourd du lecteur IVS. Elle prend une valeur booléenne comme paramètre et retourne une promesse.
Cette méthode récupère le mode sourd actuel du lecteur IVS. Elle retourne une promesse.
Cette méthode définit la qualité de la vidéo dans le lecteur IVS. Elle prend une valeur string comme paramètre et retourne une promesse.
Cette méthode récupère la qualité actuelle de la vidéo dans le lecteur IVS. Elle retourne une promesse.
Cette méthode récupère les qualités disponibles de la vidéo dans le lecteur IVS. Elle retourne une promesse.
Cette méthode ajoute un écouteur pour l'événement expandPip. Elle prend une fonction de rappel comme paramètre et retourne void.
Cette méthode ajoute un écouteur pour l'événement closePip. Elle prend une fonction de rappel comme paramètre et retourne void.
Cette méthode ajoute un écouteur pour l'événement onState. Elle prend une fonction de rappel comme paramètre et retourne void.
Cette méthode ajoute un écouteur pour l'événement onCues. Elle prend une fonction de rappel comme paramètre et retourne void.
Cette méthode ajoute un écouteur pour l'événement onDuration.Il prend une fonction de rappel comme paramètre et retourne void
Cette méthode ajoute un écouteur pour l'événement onError. Elle prend une fonction de rappel comme paramètre et retourne void
Cette méthode ajoute un écouteur pour l'événement onRebuffering. Elle prend une fonction de rappel comme paramètre et retourne void
Cette méthode ajoute un écouteur pour l'événement onSeekCompleted. Elle prend une fonction de rappel comme paramètre et retourne void
Cette méthode ajoute un écouteur pour l'événement onVideoSize. Elle prend une fonction de rappel comme paramètre et retourne void
Cette méthode ajoute un écouteur pour l'événement onQuality. Elle prend une fonction de rappel comme paramètre et retourne void
Cette méthode ajoute un écouteur pour l'événement onCastStatus. Elle prend une fonction de rappel comme paramètre et retourne void
Cette méthode supprime tous les écouteurs d'événements ajoutés. Elle retourne void
Le package @capgo/ivs-player offre une API complète pour intégrer un lecteur IVS dans votre application Capacitor. En suivant les étapes d'installation et en consultant la documentation de l'API, vous pouvez facilement commencer à lire des vidéos dans votre application en utilisant le lecteur IVS.