com.opentok.android.PublisherKit
com.opentok.android.Publisher
Toutes les interfaces implémentées :
: Observer
classe publique Publisher hérite de PublisherKit
Permet de capturer un flux audio-vidéo à partir du microphone et de la caméra de l'appareil en vue de son utilisation dans une session OpenTok. Créez une instance Publisher en appelant le constructeur Publisher.
Lorsqu'une vue d'un Publisher quitte la fenêtre active, l'objet Publisher est détruit. C'est le cas lorsqu'une activité est arrêtée ou mise en pause.
Voir aussi :
: - Session.publish(PublisherKit publisher)
Résumé des classes imbriquées
Classes imbriquées
Modificateur et type
Classe
Description
static class
Publisher.Builder
Sert à créer un Publisher objet.
static enum
Publisher.CameraCaptureFrameRate
Définit les valeurs pour le frameRate du paramètre
Publisher.Builder.frameRate(Publisher.CameraCaptureFrameRate frameRate) méthode.
static enum
Publisher.CameraCaptureResolution
Définit les valeurs pour le resolution du paramètre
Publisher.Builder.resolution(Publisher.CameraCaptureResolution resolution) méthode.
static interface
Publisher.CameraListener
Détecte les changements de caméra utilisés par l'éditeur.
Classes/interfaces imbriquées héritant de la classe com.opentok.android.PublisherKit
PublisherKit.AudioLevelListener, PublisherKit.AudioStatsListener, PublisherKit.AudioTransformer, PublisherKit.CustomAudioTransformer, PublisherKit.CustomVideoTransformer, PublisherKit.DegradationPreference, PublisherKit.MediaLinkStatsListener, PublisherKit.MuteListener, PublisherKit.PreferredVideoCodecs, PublisherKit.PublisherAudioStats, PublisherKit.PublisherKitVideoType, PublisherKit.PublisherListener, PublisherKit.PublisherMediaLinkStats, PublisherKit.PublisherRtcStats, PublisherKit.PublisherRtcStatsReportListener, PublisherKit.PublisherVideoStats, PublisherKit.VideoBitratePreset, PublisherKit.VideoLayerStats, PublisherKit.VideoListener, PublisherKit.VideoStatsListener, PublisherKit.VideoTransformer
Résumé du champ
Champs
Modificateur et type
Champ d'application
Description
protected Publisher.CameraCaptureFrameRate
cameraFrameRate
protected Publisher.CameraListener
cameraListener
protected Publisher.CameraCaptureResolution
cameraResolution
Champs hérités de la classe com.opentok.android.PublisherKit
audioLevelListener, audioStatsListener, capturer, context, handler, mediaLinkStatsListener, muteListener, NETWORK_REASON_NETWORK_CONDITION_CHANGE, publisherListener, renderer, rtcStatsReportListener, VIDEO_REASON_CODEC_CHANGE, VIDEO_REASON_NONE, VIDEO_REASON_QUALITY, VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH, VIDEO_REASON_QUALITY_DEGRADATION_CPU, VIDEO_REASON_QUALITY_DEGRADATION_OTHER, VIDEO_REASON_RESOLUTION_CHANGE, videoListener, videoStatsListener
Résumé du constructeur
Constructeurs
Modificateur
Constructeur
Description
protected
Publisher(Publisher.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
cycleCamera()
Passe d'une caméra à l'autre, s'il y a plusieurs caméras sur l'appareil.
int
getCameraId()
Obsolète.
protected void
onCameraChanged(int newCameraId)
Appelée lorsque l'éditeur modifie la caméra active.
protected void
onCameraError(OpentokError error)
Cette méthode est appelée lorsqu'une erreur survient lors de l'accès à la caméra.
void
setCameraId(int cameraId)
Obsolète.
void
setCameraListener(Publisher.CameraListener listener)
Définit un Publisher.CameraListener objet permettant de détecter les changements de caméra utilisés par
l'éditeur.
void
setCameraTorch(boolean enable)
Permet de définir le mode « lampe de poche » (torche) par défaut pour l'appareil photo.
void
setCameraZoomFactor(float cameraZoomFactor)
Le facteur de zoom (rapport) recommandé pour la caméra.
void
startPreview()
Obsolète.
void
swapCamera()
Obsolète.
Méthodes héritées de la classe com.opentok.android.PublisherKit
destroy, finalize, getCapturer, getDegradationPreference, getMaxVideoBitrate, getName, getPublishAudio, getPublishCaptions, getPublisherVideoType, getPublishVideo, getRenderer, getRtcStatsReport, getSession, getStream, getTargetScalabilityMode, getVideoBitratePreset, getView, onAudioLevelUpdated, onError, onMuteForced, onPause, onRestart, onResume, onRtcStatsReport, onStop, onStreamCreated, onStreamDestroyed, setAudioLevelListener, setAudioStatsListener, setAudioTransformers, setCapturer, setDegradationPreference, setMaxVideoBitrate, setMediaLinkStatsListener, setMuteListener, setName, setPublishAudio, setPublishCaptions, setPublisherListener, setPublisherVideoType, setPublishVideo, setRenderer, setRtcStatsReportListener, setStyle, setTargetScalabilityMode, setVideoBitratePreset, setVideoListener, setVideoStatsListener, setVideoTransformers, update
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
fréquence d'images de la caméra
protégé Publisher.CameraCaptureFrameRate fréquence d'images de la caméra
résolution de la caméra
protégé Publisher.CameraCaptureResolution résolution de la caméra
cameraListener
protégé Publisher.CameraListener cameraListener
Informations sur le constructeur
Éditeur
protected Publisher(Publisher.Builder constructeur)
Détails de la méthode
setCameraListener
public void setCameraListener(Publisher.CameraListener auditeur)
Définit un Publisher.CameraListener objet permettant de détecter les changements de caméra utilisés par
l'éditeur.
Paramètres :
: listener - Le Publisher.CameraListener instance.
setCameraId
@Obsolète public void setCameraId(int cameraId)
Obsolète.
Permet de sélectionner la caméra souhaitée. cameraId peut être une valeur comprise entre 0
et android.hardware.Camera#getNumberOfCameras() - 1.
Lorsque l'appareil photo utilisé par l'éditeur change, le
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
la méthode est appelée.
Cette méthode est obsolète. Vous devriez utiliser la nouvelle cycleCamera() méthode permettant de basculer
d'une caméra à l'autre, s'il y a plusieurs caméras sur l'appareil.
Paramètres :
: cameraId - l'identifiant de la caméra que vous souhaitez utiliser sur ce diffuseur
setCameraTorch
public void setCameraTorch(boolean enable)
Définit le mode « lampe de poche » (torche) par défaut pour l'appareil photo. Notez qu'il s'agit d'un paramètre de préférence et qu'il peut ne pas s'appliquer si l'appareil photo actif ne prend pas en charge la fonctionnalité « lampe de poche » (par exemple, l'appareil photo avant ne prend généralement pas en charge cette fonctionnalité).
Paramètres :
: enable - La valeur par défaut est « false ». En indiquant « true » ou « false »,
vous précisez si l'éditeur doit activer ou désactiver le flash de l'appareil photo
lorsqu'il est disponible.
setCameraZoomFactor
public void setCameraZoomFactor(float cameraZoomFactor)
Le facteur de zoom (rapport) souhaité pour la caméra. Une valeur de 1,0 correspond à l'absence de zoom (vue par défaut). La valeur varie entre 0,5 et le facteur de zoom maximal. Les valeurs comprises entre 0,5 et 1,0 correspondent à un angle ultra-grand angle (zoom arrière) et celles comprises entre 1,0 et le facteur de zoom maximal correspondent à un zoom avant. Le facteur de zoom réel appliqué est automatiquement limité à la plage prise en charge par la configuration de la caméra active — si la caméra ne prend pas en charge l’ultra-grand angle, les facteurs de zoom inférieurs à 1,0 ne seront pas pris en compte et aucun zoom ne sera appliqué. Pour les valeurs supérieures au facteur de zoom maximal pris en charge par la caméra, le facteur de zoom sera défini sur la valeur maximale. Si la caméra de l’éditeur est activée, l’appel de cette propriété renvoie le facteur de zoom actuel ; si la caméra de l’éditeur n’est pas activée, l’appel de cette propriété renvoie le facteur de zoom préféré.
Paramètres :
: cameraZoomFactor - La définition de cette propriété permet de spécifier le niveau de zoom souhaité,
une valeur de 1,0 correspondant à l'absence de zoom (affichage par défaut).
cycleCamera
public void cycleCamera()
Bascule entre les caméras, s'il y en a plusieurs sur l'appareil. Lorsque
la caméra utilisée par l'éditeur change, le
Publisher.CameraListener.onCameraChanged(Publisher publisher, int newCameraId)
la méthode est appelée.
swapCamera
@Obsolète public void changerDeCaméra()
Obsolète.
Cette méthode est obsolète. Vous devriez utiliser la nouvelle cycleCamera() méthode permettant de basculer
d'une caméra à l'autre, s'il y a plusieurs caméras sur l'appareil.
Si vous utilisez un dispositif de capture vidéo personnalisé, implémentez la méthode
BaseVideoCapturer.CaptureSwitch interface dans l'objet qui hérite de
BaseVideoCapturer, puis implémentez l'interface
BaseVideoCapturer.CaptureSwitch.swapCamera(int cameraId) méthode permettant de définir le comportement
de la Publisher.swapCamera() méthode.
getCameraId
@Obsolète public int getCameraId()
Obsolète.
Renvoie l'identifiant de la caméra actuellement active. Cette valeur est soit 0 (pour la
caméra arrière), soit 1 (pour la caméra avant). Si
setCameraId(int) n'est jamais appelée, la valeur de retour est 1 (pour la
caméra avant).
Cette méthode est obsolète. Vous devriez utiliser la nouvelle cycleCamera() méthode permettant de basculer
d'une caméra à l'autre, s'il y a plusieurs caméras sur l'appareil.
onCameraChanged
protected void onCameraChanged(int newCameraId)
Appelée lorsque l'éditeur modifie la caméra active.
Si vous étendez la classe Publisher, vous pouvez redéfinir cette méthode à la place de la
onCameraChanged() méthode de l'interface Publisher.CameraListener
.
Paramètres :
: newCameraId - L'identifiant de la nouvelle caméra active.
onCameraError
protected void onCameraError(OpentokError erreur)
Cette méthode est appelée lorsqu'une erreur survient lors de l'accès à la caméra.
Paramètres :
: error - L'erreur.
startPreview
@Obsolète public void lancerAperçu()
Obsolète.
À partir de la version 2.17.0, cette méthode n'a plus aucun effet. Dès la création de l'objet Publisher, la vidéo de la caméra s'affiche dans la vue du Publisher. Cette modification permet d' harmoniser le comportement entre les différents SDK clients OpenTok.