java.lang.Object

com.opentok.android.PublisherKit

Toutes les interfaces implémentées : : Observer

Sous-classes directes connues : : Publisher


classe publique PublisherKit hérite de Objet outils Observateur

Un éditeur capture un flux audio-vidéo à partir des sources que vous spécifiez. Vous pouvez ensuite publier ce flux audio-vidéo dans une session OpenTok en appelant la méthode Session.publish(PublisherKit publisher) méthode.

Créez une sous-classe de PublisherKit si vous souhaitez fournir votre propre implémentation de capture et de rendu vidéo. Sinon, utilisez la Publisher classe, qui intègre un module de capture et de rendu vidéo prêt à l'emploi.

Résumé des classes imbriquées

Classes imbriquées

Modificateur et type

Classe

Description

static interface

PublisherKit.AudioLevelListener

Surveille les variations du niveau audio de l'éditeur.

static interface

PublisherKit.AudioStatsListener

Définit l'objet « listener » permettant d'obtenir les statistiques audio de l'éditeur.

class

PublisherKit.AudioTransformer

Un transformateur pour un flux audio.

static class

PublisherKit.Builder

Sert à créer un PublisherKit objet.

static interface

PublisherKit.CustomAudioTransformer

Définit un transformateur personnalisé pour un flux audio, destiné à être transmis à la fonction PublisherKit.AudioTransformer constructeur.

static interface

PublisherKit.CustomVideoTransformer

Définit un transformateur personnalisé pour un flux vidéo, destiné à être transmis à la fonction PublisherKit.VideoTransformer constructeur.

static enum

PublisherKit.DegradationPreference

Décrit la stratégie que le moteur vidéo s'efforcera de suivre pour adapter la fréquence d'images et la résolution en fonction d'une bande passante et d'une puissance de calcul limitées.

static interface

PublisherKit.MediaLinkStatsListener

Définit l'objet « listener » permettant d'obtenir les statistiques relatives aux liens multimédias des éditeurs.

static interface

PublisherKit.MuteListener

Détecte les cas où un modérateur a forcé cet éditeur à couper le son.

static final class

PublisherKit.PreferredVideoCodecs

Définit les préférences de codec pour la publication de vidéos.

static class

PublisherKit.PublisherAudioStats

Définit les statistiques audio d'un éditeur.

static enum

PublisherKit.PublisherKitVideoType

Définit les valeurs pour le setPublisherVideoType(PublisherKitVideoType type) méthode.

static interface

PublisherKit.PublisherListener

Surveille le moment où un éditeur commence et arrête la diffusion en continu vers la session.

static class

PublisherKit.PublisherMediaLinkStats

Fournit des statistiques sur les liens multimédias des éditeurs, y compris des indicateurs de trafic local.

static class

PublisherKit.PublisherRtcStats

Représente les statistiques RTC relatives à un flux multimédia publié par l'éditeur.

static interface

PublisherKit.PublisherRtcStatsReportListener

Définit l'objet « listener » permettant de récupérer les rapports statistiques RTC de l'éditeur.

static class

PublisherKit.PublisherVideoStats

Définit les statistiques vidéo d'un éditeur.

static enum

PublisherKit.VideoBitratePreset

Définit les valeurs pour le setVideoBitratePreset(VideoBitratePreset preset) méthode.

static class

PublisherKit.VideoLayerStats

Représente les statistiques relatives à une seule couche vidéo publiée.

static interface

PublisherKit.VideoListener

Surveille le moment où l'éditeur commence et cesse de recevoir des données vidéo.

static interface

PublisherKit.VideoStatsListener

Définit l'objet « listener » permettant d'obtenir les statistiques vidéo de l'éditeur.

class

PublisherKit.VideoTransformer

Un transformateur pour un flux vidéo.

Résumé du champ

Champs

Modificateur et type

Champ d'application

Description

protected PublisherKit.AudioLevelListener

audioLevelListener

protected PublisherKit.AudioStatsListener

audioStatsListener

protected BaseVideoCapturer

capturer

protected android.content.Context

context

protected android.os.Handler

handler

protected PublisherKit.MediaLinkStatsListener

mediaLinkStatsListener

protected PublisherKit.MuteListener

muteListener

static final String

NETWORK_REASON_NETWORK_CONDITION_CHANGE

Indique que l'état du réseau du participant local a changé.

protected PublisherKit.PublisherListener

publisherListener

protected BaseVideoRenderer

renderer

protected PublisherKit.PublisherRtcStatsReportListener

rtcStatsReportListener

static final String

VIDEO_REASON_CODEC_CHANGE

Le codec vidéo utilisé pour le flux a changé.

static final String

VIDEO_REASON_NONE

static final String

VIDEO_REASON_QUALITY

Cet incident vidéo a été provoqué par une variation du niveau de congestion du réseau.

static final String

VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH

Dégradation de la qualité due à une bande passante réseau insuffisante.

static final String

VIDEO_REASON_QUALITY_DEGRADATION_CPU

Dégradation de la qualité due aux limitations du processeur de l'appareil client.

static final String

VIDEO_REASON_QUALITY_DEGRADATION_OTHER

Dégradation de la qualité due à d'autres causes.

static final String

VIDEO_REASON_RESOLUTION_CHANGE

Modification de la résolution vidéo ou du nombre de calques.

protected PublisherKit.VideoListener

videoListener

protected PublisherKit.VideoStatsListener

videoStatsListener

Résumé du constructeur

Constructeurs

Modificateur

Constructeur

Description

protected

PublisherKit(PublisherKit.Builder builder)

Résumé de la méthode

Toutes les méthodes · Méthodes d'instance · Méthodes concrètes · Méthodes obsolètes

Modificateur et type

Méthode

Description

void

destroy()

Libère cet objet, y compris toutes les ressources matérielles et d'interface utilisateur qui lui sont associées, s'il ne peut pas être libéré par le ramasse-miettes.

protected void

finalize()

Appelée par le ramasse-miettes lorsqu’il détecte qu’il n’y a plus de références à l’objet PublisherKit.

BaseVideoCapturer

getCapturer()

Renvoie la carte d'acquisition vidéo utilisée par cet éditeur.

PublisherKit.DegradationPreference

getDegradationPreference()

Récupère la stratégie privilégiée que le moteur vidéo appliquera pour adapter la fréquence d'images et la résolution en fonction des contraintes de bande passante et de la charge du processeur.

int

getMaxVideoBitrate()

Récupère le débit binaire maximal de la vidéo diffusée par l'éditeur, en bits par seconde.

String

getName()

Le nom du flux.

boolean

getPublishAudio()

Que l'éditeur publie du contenu audio (true) ou non ( false).

boolean

getPublishCaptions()

Que l'éditeur publie ou non des légendes (true) ou non ( false).

PublisherKit.PublisherKitVideoType

getPublisherVideoType()

Renvoie le type de vidéo associé à cet éditeur.

boolean

getPublishVideo()

Que l'éditeur publie ou non des vidéos (true) ou non ( false).

BaseVideoRenderer

getRenderer()

Renvoie le moteur de rendu vidéo associé à cet éditeur.

void

getRtcStatsReport()

Récupère le rapport statistique RTC de l'éditeur.

Session

getSession()

Renvoie le Session lié à cette instance Publisher.

Stream

getStream()

Renvoie l'objet flux correspondant au flux de l'éditeur.

String

getTargetScalabilityMode()

Récupère le mode d'évolutivité cible qui a été explicitement défini via la méthode `setTargetScalabilityMode`.

PublisherKit.VideoBitratePreset

getVideoBitratePreset()

Récupère le préréglage de débit binaire vidéo actuellement actif pour le flux de l'éditeur.

android.view.View

getView()

Renvoie l'objet `android.view.View` contenant la vidéo du `Publisher`.

protected void

onAudioLevelUpdated(float audioLevel)

Appelée périodiquement pour signaler le niveau audio de l'éditeur.

protected void

onError(OpentokError error)

Appelée en cas d'échec de l'éditeur.

protected void

onMuteForced()

Ce message s'affiche lorsqu'un modérateur a contraint cet éditeur à couper le son.

void

onPause()

N'appelez pas directement ; appelez Session.onPause() au lieu de cela.

void

onRestart()

Redémarre les ressources de l'éditeur qui avaient été précédemment libérées en appelant la fonction onStop() méthode.

void

onResume()

N'appelez pas directement ; appelez Session.onResume() au lieu de cela.

protected void

onRtcStatsReport(PublisherKit.PublisherRtcStats[] stats)

Appelée lorsque le rapport statistique RTC de l'éditeur est disponible, en réponse à un appel vers getRtcStatsReport().

void

onStop()

Libère les ressources associées à l'éditeur.

protected void

onStreamCreated(Stream stream)

Appelée lors de la création du flux de l'éditeur.

protected void

onStreamDestroyed(Stream stream)

Appelée lorsque le flux de l'éditeur est détruit.

void

setAudioLevelListener(PublisherKit.AudioLevelListener listener)

Lie un PublisherKit.AudioLevelListener à cette instance d'PublisherKit pour surveiller les mises à jour du niveau audio.

void

setAudioStatsListener(PublisherKit.AudioStatsListener listener)

Configure un écouteur pour les statistiques audio de l'éditeur.

void

setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)

Définit une liste de transformateurs audio pour le flux audio de cet éditeur.

void

setCapturer(BaseVideoCapturer newCapturer)

Obsolète.

void

setDegradationPreference(PublisherKit.DegradationPreference degradationPreference)

Récupère la stratégie privilégiée que le moteur vidéo appliquera pour adapter la fréquence d'images et la résolution en fonction des contraintes de bande passante et de la charge du processeur.

void

setMaxVideoBitrate(int maxVideoBitrate)

Définit le débit binaire maximal de la vidéo pour le flux vidéo de l'éditeur, en bits par seconde.

void

setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener listener)

Configure un écouteur pour les statistiques relatives aux liens multimédias de l'éditeur.

void

setMuteListener(PublisherKit.MuteListener listener)

Définit un PublisherKit.MuteListener objet à surveiller lorsqu'un modérateur oblige cet éditeur à couper le son.

void

setName(String name)

Obsolète.

void

setPublishAudio(boolean publishAudio)

Active ou désactive la publication du son, en fonction de la valeur transmise.

void

setPublishCaptions(boolean publishCaptions)

Active ou désactive l'affichage des sous-titres, en fonction de la valeur transmise.

void

setPublisherListener(PublisherKit.PublisherListener listener)

Lie un PublisherKit.PublisherListener à cette instance d'Publisher afin de surveiller les changements d'état.

void

setPublisherVideoType(PublisherKit.PublisherKitVideoType type)

Spécifie le type de vidéo pour ce flux.

void

setPublishVideo(boolean publishVideo)

Active ou désactive la publication de la vidéo, en fonction de la valeur transmise.

void

setRenderer(BaseVideoRenderer renderer)

Obsolète.

void

setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)

Définit l'abonné comme écouteur du rapport statistique RTC.

void

setStyle(String key, String value)

Définit un style pour le moteur de rendu vidéo utilisé par cet éditeur.

void

setTargetScalabilityMode(String scalabilityMode)

Définit le mode d'évolutivité cible (SVC - Scalable Video Coding) pour cet éditeur.

void

setVideoBitratePreset(PublisherKit.VideoBitratePreset videoBitratePreset)

Définit une stratégie de préréglage du débit binaire vidéo pour le flux vidéo de l'éditeur.

void

setVideoListener(PublisherKit.VideoListener listener)

Définit un PublisherKit.VideoListener objet permettant de surveiller le moment où l'éditeur commence et cesse d'envoyer la vidéo.

void

setVideoStatsListener(PublisherKit.VideoStatsListener listener)

Configure un écouteur pour les statistiques vidéo de l'éditeur.

void

setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)

Définit une liste de transformateurs vidéo pour le flux vidéo de cet éditeur.

void

update(Observable o, Object arg)

Obsolète.

Méthodes héritées de la classe java.lang.Objet

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Détails du champ

VIDÉO_RAISON_AUCUNE

public static final  Chaîne VIDÉO_RAISON_AUCUNE

Voir aussi : : - [Valeurs de champ constantes]

VIDÉO_RAISON_QUALITÉ

public static final  Chaîne VIDÉO_RAISON_QUALITÉ

Cet incident vidéo a été provoqué par une variation du niveau de congestion du réseau.

Le PublisherKit.VideoListener.onVideoDisabled(PublisherKit, String) méthode est appelée. Lorsque les conditions s'améliorent, le flux vidéo reprend, et la PublisherKit.VideoListener.onVideoEnabled(PublisherKit, String) La méthode est appelée.

En cas d'interruption du flux vidéo, l'abonné continue de recevoir le flux audio, le cas échéant.

Voir aussi : : - method. - method. - [Valeurs de champ constantes]

VIDÉO_RAISON_DÉGRADATION_DE_LA_QUALITÉ_BANDE PASSANTE

public static final  Chaîne VIDÉO_RAISON_DÉGRADATION_DE_LA_QUALITÉ_BANDE PASSANTE

Dégradation de la qualité due à une bande passante réseau insuffisante.

Voir aussi : : - [Valeurs de champ constantes]

VIDÉO_RAISON_DÉGRADATION_DE_LA_QUALITÉ_PROCESSEUR

public static final  Chaîne VIDÉO_RAISON_DÉGRADATION_DE_LA_QUALITÉ_PROCESSEUR

Dégradation de la qualité due aux limitations du processeur de l'appareil client.

Voir aussi : : - [Valeurs de champ constantes]

VIDÉO_RAISON_DÉGRADATION_DE_LA_QUALITÉ_AUTRE

public static final  Chaîne VIDÉO_RAISON_DÉGRADATION_DE_LA_QUALITÉ_AUTRE

Dégradation de la qualité due à d'autres causes.

Voir aussi : : - [Valeurs de champ constantes]

VIDÉO_RAISON_CHANGEMENT_DE_CODEC

public static final  Chaîne VIDÉO_RAISON_CHANGEMENT_DE_CODEC

Le codec vidéo utilisé pour le flux a changé.

Voir aussi : : - [Valeurs de champ constantes]

VIDÉO_MOTIF_MODIFICATION_DE_LA_RÉSOLUTION

public static final  Chaîne VIDÉO_MOTIF_MODIFICATION_DE_LA_RÉSOLUTION

Modification de la résolution vidéo ou du nombre de couches. Ce phénomène peut être dû à des contraintes de débit binaire, à l'adaptation de l'encodeur, à des changements au niveau de la source de la caméra (par exemple, changement de caméra ou modification de la résolution d'entrée), ou à des modifications de configuration. Cela n'implique pas nécessairement une dégradation de la qualité.

Voir aussi : : - [Valeurs de champ constantes]

NETWORK_REASON_NETWORK_CONDITION_CHANGE

public static final  Chaîne NETWORK_REASON_NETWORK_CONDITION_CHANGE

Indique que l'état du réseau du participant local a changé. Cet événement est déclenché lorsqu'un changement significatif est détecté dans l'état du réseau.

Voir aussi : : - [Valeurs de champ constantes]

gestionnaire

handler de type android.os.Handler protégé

publisherListener

protégé  PublisherKit.PublisherListener publisherListener

audioLevelListener

protégé  PublisherKit.AudioLevelListener audioLevelListener

videoStatsListener

protégé  PublisherKit.VideoStatsListener videoStatsListener

audioStatsListener

protégé  PublisherKit.AudioStatsListener audioStatsListener

mediaLinkStatsListener

protégé  PublisherKit.MediaLinkStatsListener mediaLinkStatsListener

muteListener

protégé  PublisherKit.MuteListener muteListener

rtcStatsReportListener

protégé  PublisherKit.PublisherRtcStatsReportListener rtcStatsReportListener

contexte

protected android.content.Context context

moteur de rendu

protégé  BaseVideoRenderer moteur de rendu

captureur

protégé  BaseVideoCapturer captureur

videoListener

protégé  PublisherKit.VideoListener videoListener

Informations sur le constructeur

PublisherKit

protected PublisherKit(PublisherKit.Builder constructeur)

Détails de la méthode

onPause

public void onPause()

N'appelez pas directement ; appelez Session.onPause() au lieu de cela.

onResume

public void onResume()

N'appelez pas directement ; appelez Session.onResume() au lieu de cela.

détruire

public void destroy()

Libère cet objet, y compris toutes les ressources matérielles et d'interface utilisateur qui lui sont associées, s'il ne peut pas être libéré par le ramasse-miettes. En règle générale, les ressources sont libérées en toute sécurité par le ramasse-miettes, et vous n'avez pas besoin d'appeler cette méthode. Toutefois, cette opération peut avoir lieu à tout moment, à la discrétion de la machine virtuelle, ce qui peut ne pas correspondre au comportement souhaité dans certains cas. Cette méthode permet de libérer manuellement les ressources dans les cas où une action immédiate est souhaitée :

  • Une application souhaite se republier, mais doit pouvoir accéder à l'appareil photo immédiatement après avoir été retirée de la publication.
  • Une application souhaite s'assurer que le périphérique audio est libéré immédiatement après la désactivation de la publication.

Une fois que vous avez appelé cette méthode, vous ne pouvez plus réutiliser l'éditeur.

setPublishVideo

public void setPublishVideo(boolean publishVideo)

Active ou désactive la publication de la vidéo, en fonction de la valeur transmise.

Paramètres : : publishVideo - Faut-il publier la vidéo (true) ou non ( false).

setPublishAudio

public void setPublishAudio(boolean publishAudio)

Active ou désactive la publication du son, en fonction de la valeur transmise.

Paramètres : : publishAudio - Publier ou non l'enregistrement audio (true) ou non ( false).

setPublishCaptions

public void setPublishCaptions(boolean publishCaptions)

Active ou désactive l'affichage des sous-titres, en fonction de la valeur transmise.

Paramètres : : publishCaptions - Afficher ou non les légendes (true) ou non ( false).

setName

@Obsolète public void setName(Chaîne nom)

Obsolète.

Définissez le nom de ce flux. Ce nom s'affiche au bas de la vidéo de l'éditeur et au bas des vidéos des abonnés associées au flux publié. Vous pouvez définir ce nom après l'initialisation de l' éditeur et avant la PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream) méthode est appelée. La définition de la propriété après la PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream) La méthode appelée n'a aucune incidence sur le nom affiché pour le flux.

Le nom par défaut est « » (une chaîne vide).

setPublisherVideoType

public void setPublisherVideoType(PublisherKit.PublisherKitVideoType type)

Spécifie le type de vidéo pour ce flux. Définissez cette option sur l'une des valeurs suivantes :

  • PublisherKitVideoType.PublisherKitVideoTypeScreen — Optimise l'encodage vidéo pour le partage d'écran. Il est recommandé d'utiliser une faible fréquence d'images (5 images par seconde ou moins) avec ce type de vidéo. Voir Le routeur multimédia OpenTok et les modes multimédias.
  • PublisherKitVideoType.PublisherKitVideoTypeCamera — Il s'agit du paramètre par défaut, que vous devez utiliser lorsque vous utilisez une caméra comme source vidéo.

getName

public  Chaîne getName()

Le nom du flux. Ce nom apparaît au bas des vidéos des abonnés.

Retours : : nom de l'éditeur

getPublishVideo

public boolean getPublishVideo()

Que l'éditeur publie ou non des vidéos (true) ou non ( false).

getPublishAudio

public boolean getPublishAudio()

Que l'éditeur publie du contenu audio (true) ou non ( false).

getPublishCaptions

public boolean getPublishCaptions()

Que l'éditeur publie ou non des légendes (true) ou non ( false).

getSession

public  Session getSession()

Renvoie le Session lié à cette instance Publisher.

Retours : : Le Session lié à cette instance Publisher.

Voir aussi : : - Session.publish(com.opentok.android.PublisherKit)

getStream

public  Flux getStream()

Renvoie l'objet flux correspondant au flux de l'éditeur.

Valeur renvoyée : : L'objet flux.

getPublisherVideoType

public  PublisherKit.PublisherKitVideoType getPublisherVideoType()

Renvoie le type de vidéo associé à cet éditeur.

Voir aussi : : - setPublisherVideoType(PublisherKitVideoType type)

getMaxVideoBitrate

public int getMaxVideoBitrate()

Récupère le débit binaire maximal de la vidéo diffusée par l'éditeur, en bits par seconde.

Renvoie la limite supérieure actuellement configurée. Si aucun débit binaire manuel n'a été défini, ou si un préréglage de débit binaire est actif, la valeur est 0.

Retourne : : Le débit binaire vidéo maximal en bits par seconde, ou 0 s'il n'est pas défini ou si un préréglage est utilisé.

Voir aussi : : - setMaxVideoBitrate(int maxVideoBitrate)

setMaxVideoBitrate

public void setMaxVideoBitrate(int maxVideoBitrate)

Définit le débit binaire maximal de la vidéo pour le flux vidéo de l'éditeur, en bits par seconde.

Cette méthode impose une limite supérieure explicite au débit binaire de la vidéo de l'éditeur. Si vous définissez cette valeur sur 0, toute limite manuelle est supprimée et le système revient au comportement par défaut de débit binaire adaptatif basé sur les préréglages, sans limite explicite.

Paramètres : : maxVideoBitrate - Le débit binaire maximal de la vidéo, en bits par seconde, compris entre 5 000 et 10 000 000.

Voir aussi : : - getMaxVideoBitrate() - setVideoBitratePreset(VideoBitratePreset videoBitratePreset) - Publisher Max Bitrate

getVideoBitratePreset

public  PublisherKit.VideoBitratePreset getVideoBitratePreset()

Récupère le préréglage de débit binaire vidéo actuellement actif pour le flux de l'éditeur.

Renvoie la stratégie prédéfinie actuellement utilisée. Si un débit binaire personnalisé a été défini manuellement à l'aide de setMaxVideoBitrate(int), cette méthode renvoie PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.

Retours : : L'actif PublisherKit.VideoBitratePreset.

Voir aussi : : - setVideoBitratePreset(VideoBitratePreset videoBitratePreset)

définir le préréglage de débit binaire vidéo

public void setVideoBitratePreset(PublisherKit.VideoBitratePreset (préréglage de débit binaire vidéo)

Définit une stratégie de préréglage du débit binaire vidéo pour le flux vidéo de l'éditeur.

Les configurations prédéfinies permettent d'équilibrer la qualité vidéo et l'utilisation de la bande passante grâce à des stratégies prédéfinies. Les paramètres prédéfinis et les réglages manuels du débit binaire s'excluent mutuellement. La configuration du setMaxVideoBitrate(int) Cette méthode remplace tout préréglage et modifie automatiquement le préréglage actif pour le remplacer par PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.

Note : Le PublisherKit.VideoBitratePreset.VideoBitratePresetCustom Cette valeur ne peut pas être définie directement.

Paramètres : : videoBitratePreset - Le PublisherKit.VideoBitratePreset pour postuler.

Voir aussi : : - getVideoBitratePreset() - setMaxVideoBitrate(int maxVideoBitrate) - Publisher Max Bitrate

getDegradationPreference

public  PublisherKit.Préférence de dégradation getDegradationPreference()

Récupère la stratégie privilégiée que le moteur vidéo appliquera pour adapter la fréquence d'images et la résolution en fonction des contraintes de bande passante et de la charge du processeur. Voir PublisherKit.DegradationPreference pour obtenir une description des valeurs possibles.

Renvoie : : La préférence de dégradation actuelle.

définir la préférence de dégradation

public void setDegradationPreference(PublisherKit.Préférence de dégradation (préférence de dégradation)

Récupère la stratégie privilégiée que le moteur vidéo appliquera pour adapter la fréquence d'images et la résolution en fonction des contraintes de bande passante et de la charge du processeur. Voir PublisherKit.DegradationPreference pour obtenir une description des valeurs possibles.

Paramètres : : degradationPreference - La préférence de dégradation.

setTargetScalabilityMode

public void setTargetScalabilityMode(Chaîne scalabilityMode)

Définit le mode d'évolutivité cible (SVC - Scalable Video Coding) pour cet éditeur. Le mode d'évolutivité contrôle le nombre de couches spatiales (résolution) et temporelles (fréquence d'images) que WebRTC encode. Ce mode s'applique au chemin multimédia du Media Router. Cette méthode peut être appelée à tout moment — elle ne nécessite pas que la négociation du chemin multimédia soit terminée. Le mode sera appliqué une fois que le chemin multimédia du Media Router sera établi. Si un codec non SVC (VP8, H.264) est négocié sur le chemin multimédia du Media Router, le mode applicable le plus proche est utilisé : les couches spatiales sont forcées à 1, tout en conservant la dimension temporelle (par exemple, L2T2 → L1T2 lorsque VP8 est négocié). Il s’agit d’une fonctionnalité en version bêta.

Paramètres : : scalabilityMode - Le mode d'évolutivité souhaité.

Lancers : : IllegalArgumentException - si le mode demandé n'est pas un mode d'évolutivité valide (c'est-à-dire s'il ne s'agit pas de l'un des modes suivants : L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2, L3T3).

getTargetScalabilityMode

public  Chaîne getTargetScalabilityMode()

Récupère le mode d'évolutivité cible qui a été explicitement défini via la méthode `setTargetScalabilityMode`. Renvoie la dernière valeur transmise au setter, ou null si le setter n'a jamais été appelé. Cela reflète l'intention de l'utilisateur, et non le mode réellement appliqué (qui peut différer en raison d'un repli dépendant du codec). Il s'agit d'une fonctionnalité en version bêta.

Résultats : : Le mode d'évolutivité cible défini par l'appelant, ou null s'il n'a pas été explicitement défini.

setPublisherListener

public void setPublisherListener(PublisherKit.PublisherListener auditeur)

Lie un PublisherKit.PublisherListener à cette instance d'Publisher afin de surveiller les changements d'état.

Paramètres : : listener - Le PublisherKit.PublisherListener qui surveillera cette instance, ou null pour déconnecter un écouteur.

setAudioLevelListener

public void setAudioLevelListener(PublisherKit.AudioLevelListener auditeur)

Lie un PublisherKit.AudioLevelListener à cette instance d'PublisherKit pour surveiller les mises à jour du niveau audio.

Paramètres : : listener - Le PublisherKit.AudioLevelListener qui assurera la surveillance de cette instance. Définissez cette valeur sur null pour déconnecter un écouteur et mettre fin à la surveillance des niveaux audio.

setRtcStatsReportListener

public void setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener auditeur)

Définit l'abonné comme écouteur du rapport statistique RTC. Voir getRtcStatsReport().

Paramètres : : listener - Le PublisherKit.PublisherRtcStatsReportListener objet.

setVideoTransformers

public void setVideoTransformers(Liste de tableaux<PublisherKit.VideoTransformer> (videoTransformers)

Définit une liste de transformateurs vidéo pour le flux vidéo de cet éditeur. Si la liste est vide, l'appel de cette méthode réinitialise les transformateurs. Le tableau peut être composé de transformateurs vidéo Vonage fournis par ml-library ou de transformateurs personnalisés (voir ce guide du développeur). Remarque : Les transformateurs multimédias ne sont pas pris en charge sur tous les appareils ni sur toutes les versions d'Android. Voir cette documentation.

Paramètres : : videoTransformers - La liste des transformateurs vidéo, dans l'ordre dans lequel ils doivent être appliqués au flux.

setVideoListener

public void setVideoListener(PublisherKit.VideoListener auditeur)

Définit un PublisherKit.VideoListener objet permettant de surveiller le moment où l'éditeur commence et cesse d'envoyer la vidéo.

Paramètres : : listener - Le PublisherKit.VideoListener instance.

setAudioTransformers

public void setAudioTransformers(Liste de tableaux<PublisherKit.AudioTransformer> audioTransformers)

Définit une liste de transformateurs audio pour le flux audio de cet éditeur. Si la liste est vide, l'appel de cette méthode réinitialise les transformateurs. Le tableau peut être composé de transformateurs audio Vonage fournis par ml-library ou de transformateurs personnalisés (voir ce guide du développeur). Remarque : Les transformateurs multimédias ne sont pas pris en charge sur tous les appareils ni sur toutes les versions d'Android. Voir cette documentation. .

Paramètres : : audioTransformers - La liste des transformateurs audio, dans l'ordre dans lequel ils doivent être appliqués au flux.

setStyle

public void setStyle(Chaîne clé, Chaîne valeur)

Définit un style pour le moteur de rendu vidéo utilisé par cet éditeur.

Par défaut, il n'existe qu'une seule clé de style prédéfinie : BaseVideoRenderer.STYLE_VIDEO_SCALE. Vous pouvez attribuer une valeur à cette clé pour définir le facteur d'échelle de la vidéo. Les valeurs suivantes sont prises en charge :

  • BaseVideoRenderer.STYLE_VIDEO_FILL — La vidéo est redimensionnée pour occuper toute la surface du moteur de rendu, avec un recadrage si nécessaire.
  • BaseVideoRenderer.STYLE_VIDEO_FIT — La vidéo est redimensionnée, si nécessaire, afin que l'intégralité de la vidéo soit visible, avec des bandes noires de chaque côté. Si vous ne définissez pas ce style, le paramètre par défaut est BaseVideoRenderer.STYLE_VIDEO_FIT.

L'appel de cette méthode revient à appeler getRenderer().setStyle(). Toutefois, si vous étendez cette classe, vous pouvez redéfinir cette méthode pour prendre en charge d'autres styles et comportements.

Paramètres : : key - Le style à définir. : value - La valeur à laquelle vous attribuez ce style.

setRenderer

@Obsolète public void setRenderer(BaseVideoRenderer rendu)

Obsolète.

Définit le moteur de rendu vidéo pour cet éditeur.

Cette méthode est obsolète. Utilisez plutôt la PublisherKit.Builder.renderer(BaseVideoRenderer renderer) méthode lors de l'utilisation du Builder pour créer l'instance PublisherKit.

getRenderer

public  BaseVideoRenderer getRenderer()

Renvoie le moteur de rendu vidéo associé à cet éditeur.

getCapturer

public  BaseVideoCapturer getCapturer()

Renvoie la carte d'acquisition vidéo utilisée par cet éditeur.

setCapturer

@Obsolète public void setCapturer(BaseVideoCapturer newCapturer)

Obsolète.

Définit le dispositif de capture vidéo pour cet éditeur.

Cette méthode est obsolète. Utilisez plutôt la méthode PublisherKit.Builder.capturer(BaseVideoCapturer capturer) méthode lors de l'utilisation du générateur pour créer l'instance PublisherKit.

getView

public android.view.View getView()

Renvoie l'objet `android.view.View` contenant la vidéo du `Publisher`.

setVideoStatsListener

public void setVideoStatsListener(PublisherKit.VideoStatsListener auditeur)

Configure un écouteur pour les statistiques vidéo de l'éditeur. L'objet écouteur implémente l'interface PublisherKit.VideoStatsListener.onVideoStats(PublisherKit publisher, PublisherKit.PublisherVideoStats[] stats) méthode et, éventuellement, le PublisherKit.VideoStatsListener.onVideoQualityChanged(PublisherKit, PublisherVideoStats, String) méthode.

Voir aussi : : - setAudioStatsListener(AudioStatsListener listener)

setAudioStatsListener

public void setAudioStatsListener(PublisherKit.AudioStatsListener auditeur)

Configure un écouteur pour les statistiques audio de l'éditeur. L'objet écouteur implémente l'interface PublisherKit.AudioStatsListener.onAudioStats(PublisherKit publisher, PublisherKit.PublisherAudioStats[] stats) méthode. Cette méthode est appelée périodiquement pour signaler les éléments suivants :

  • Nombre total de paquets audio perdus
  • Nombre total de paquets audio envoyés
  • Nombre total d'octets audio envoyés

Voir aussi : : - setVideoStatsListener(VideoStatsListener listener)

setMediaLinkStatsListener

public void setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener auditeur)

Configure un écouteur pour les statistiques relatives aux liens multimédias de l'éditeur. L'objet écouteur implémente l'interface PublisherKit.MediaLinkStatsListener.onMediaLinkStats(PublisherKit, PublisherMediaLinkStats[]) et PublisherKit.MediaLinkStatsListener.onNetworkConditionChanged(PublisherKit, PublisherMediaLinkStats, String) méthodes.

Paramètres : : listener - Le PublisherKit.MediaLinkStatsListener une instance, ou null pour la supprimer.

Voir aussi : : - setVideoStatsListener(VideoStatsListener listener) - setAudioStatsListener(AudioStatsListener listener)

setMuteListener

public void setMuteListener(PublisherKit.MuteListener auditeur)

Définit un PublisherKit.MuteListener objet à surveiller lorsqu'un modérateur oblige cet éditeur à couper le son.

Paramètres : : listener - Le PublisherKit.MuteListener instance.

getRtcStatsReport

public void getRtcStatsReport()

Récupère le rapport statistique RTC de l'éditeur. Il s'agit d'une opération asynchrone. Appelez la méthode setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener) méthode, puis implémenter la PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats) méthode avant d'appeler cette méthode. Lorsque les statistiques sont disponibles, l'implémentation de la PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats) la méthode est appelée.

Voir aussi setAudioStatsListener(PublisherKit.AudioStatsListener listener), setVideoStatsListener(PublisherKit.VideoStatsListener listener)et SubscriberKit.getRtcStatsReport().

onRtcStatsReport

protected void onRtcStatsReport(PublisherKit.PublisherRtcStats[] statistiques)

Appelée lorsque le rapport statistique RTC de l'éditeur est disponible, en réponse à un appel vers getRtcStatsReport().

Si vous étendez la classe PublisherKit, vous pouvez redéfinir cette méthode au lieu d’ implémenter la méthode onRtcStatsReport() de l’ interface PublisherKit.PublisherRtcStatsReportListener.

Voir aussi : : - PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherRtcStats[] stats)

onStreamCreated

protected void onStreamCreated(Flux flux)

Appelée lors de la création du flux de l'éditeur.

Si vous étendez la classe PublisherKit, vous pouvez redéfinir cette méthode à la place de la onStreamCreated() méthode de l'interface PublisherKit.PublisherListener .

Paramètres : : stream - Le flux ainsi créé.

onStreamDestroyed

protected void onStreamDestroyed(Flux flux)

Appelée lorsque le flux de l'éditeur est détruit.

Si vous étendez la classe PublisherKit, vous pouvez redéfinir cette méthode à la place de la onStreamDestroyed() méthode de l'interface PublisherKit.PublisherListener .

Paramètres : : stream - Le flux qui est détruit.

onError

protected void onError(OpentokError erreur)

Appelée en cas d'échec de l'éditeur.

Si vous étendez la classe PublisherKit, vous pouvez redéfinir cette méthode à la place de la onError() méthode de l'interface PublisherKit.PublisherListener .

Paramètres : : error - L'erreur qui a déclenché cette fonction de rappel.

onAudioLevelUpdated

protected void onAudioLevelUpdated(float audioLevel)

Appelée périodiquement pour signaler le niveau audio de l'éditeur.

Paramètres : : audioLevel - Le niveau audio, compris entre 0 et 1,0. Réglez cette valeur de manière logarithmique pour l'utiliser dans une visualisation d'interface utilisateur (telle qu'un indicateur de volume).

onMuteForced

protected void onMuteForced()

Ce message s'affiche lorsqu'un modérateur a contraint cet éditeur à couper le son.

Si vous étendez la classe PublisherKit, vous pouvez redéfinir cette méthode à la place de la onMuteForced() méthode de l'interface PublisherKit.MuteListener .

mise à jour

@Obsolète public void update(Observable o, Objet arg)

Obsolète.

Cette méthode est appelée chaque fois que l'objet observé subit une modification. Cette classe implémente l'interface Observer ; elle observe donc les événements, tels que les événements de mise en pause et de reprise de la session.

Spécifié par : : update dans l'interface  Observer

Paramètres : : o - L'objet observable. : arg - Un argument transmis à la méthode `notifyObservers`.

finaliser

protected void finalize() throws À lancer

Appelée par le ramasse-miettes lorsqu’il détecte qu’il n’y a plus de références à l’objet PublisherKit.

Remplacements : : finalize en classe  Object

Lancers : : Throwable

onStop

public void onStop()

Libère les ressources associées au diffuseur. L'appel de cette méthode entraîne l'arrêt de la capture par le diffuseur, puis libère la caméra. Pour réutiliser le diffuseur après avoir appelé cette méthode, appelez la méthode onRestart() méthode.

onRestart

public void onRestart()

Redémarre les ressources de l'éditeur qui avaient été précédemment libérées en appelant la fonction onStop() méthode.