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 estBaseVideoRenderer.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.