com.opentok.android.PublisherKit.Builder
com.opentok.android.Publisher.Builder
Classe englobante : : Éditeur
classe publique statique Publisher.Builder hérite de PublisherKit.Builder
Sert à créer un Publisher objet. Instanciez un objet Builder à l'aide de la méthode
Publisher.Builder(Context context) constructeur. Appelez ensuite les méthodes de la
Builder par exemple, pour ajouter des paramètres pour l'éditeur. (Notez que le
Publisher.Builder La classe hérite des méthodes de la PublisherKit.Builder
(classe.) Appelez ensuite la build() méthode, qui renvoie un Publisher objet.
Utiliser le Session.publish(PublisherKit publisher) méthode permettant de lancer la diffusion en continu
depuis l'éditeur vers une session.
Résumé du constructeur
Constructeurs
Constructeur
Description
Builder(android.content.Context context)
Instancie un Publisher.Builder objet.
Résumé de la méthode
Toutes les méthodes · Méthodes d'instance · Méthodes concrètes
Modificateur et type
Méthode
Description
Publisher.Builder
allowAudioCaptureWhileMuted(boolean allow)
Si cette option est définie sur « false », le microphone sera automatiquement désactivé lorsque tous les intervenants auront coupé leur micro.
Publisher.Builder
audioBitrate(int bitsPerSecond)
Définit le débit binaire souhaité pour le flux audio publié, en bits par seconde.
Publisher.Builder
audioTrack(boolean enabled)
Détermine s'il faut inclure une piste audio dans le flux publié (true,
(par défaut) ou non (false).
Publisher
build()
Renvoie un nouvel Publisher par exemple, en fonction de la Publisher.Builder
paramètres.
Publisher.Builder
capturer(BaseVideoCapturer capturer)
Définit la carte d'acquisition vidéo à utiliser pour l'éditeur.
Publisher.Builder
enableOpusDtx(boolean enable)
Faut-il l'activer ? Opus DTX (true) ou non (false(par défaut).
Publisher.Builder
frameRate(Publisher.CameraCaptureFrameRate frameRate)
Permet de définir la fréquence d'images souhaitée pour la vidéo publiée.
Publisher.Builder
name(String name)
Définit le nom de la vidéo publiée.
Publisher.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
Publisher.Builder
publisherAudioFallbackEnabled(boolean enabled)
Le flux utilisera-t-il la fonctionnalité de repli audio de l'éditeur (true) ou pas
(false).
Publisher.Builder
renderer(BaseVideoRenderer renderer)
Définit le moteur de rendu vidéo à utiliser pour l'éditeur.
Publisher.Builder
resolution(Publisher.CameraCaptureResolution resolution)
Définit la résolution de la vidéo publiée.
Publisher.Builder
scalableScreenshare(boolean enable)
Faut-il autoriser l'utilisation de vidéo évolutive pour un éditeur dont le paramètre `videoType` est défini sur `PublisherKitVideoTypeScreen` (true) ou non (false, valeur par défaut).
Publisher.Builder
senderStatsTrack(boolean allow)
Si vous n'appelez pas cette fonction et que vous ne lui transmettez pas true, le sous-système de statistiques de l'expéditeur ne sera pas
initialisé pour l'éditeur.
Publisher.Builder
subscriberAudioFallbackEnabled(boolean enabled)
Le flux utilisera-t-il la fonctionnalité de repli audio pour les abonnés (true) ou pas
(false), pour les abonnés au flux publié.
Publisher.Builder
videoTrack(boolean enabled)
Détermine s'il faut inclure une piste vidéo dans le flux publié (true,
(par défaut) ou non (false).
Méthodes héritées de la classe java.lang.Objet
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Informations sur le constructeur
Constructeur
public Builder(android.content.Context context)
Instancie un Publisher.Builder objet.
Détails de la méthode
résolution
public Publisher.Builder résolution(Publisher.CameraCaptureResolution résolution)
Définit la résolution de la vidéo publiée. Définissez cette valeur sur une valeur définie dans le fichier
Publisher.CameraCaptureResolution enum
fréquence d'images
public Publisher.Builder frameRate(Publisher.CameraCaptureFrameRate frameRate)
Permet de définir la fréquence d'images souhaitée pour la vidéo publiée. Définissez cette valeur sur une valeur définie dans
le Publisher.CameraCaptureFrameRate enum. Si l'appareil ne prend pas en charge la
fréquence d'images spécifiée, il utilisera la fréquence d'images prise en charge la plus proche. Notez que
dans les sessions utilisant OpenTok Media Router (sessions dont le mode multimédia est défini sur
« routed »), la réduction de la fréquence d'images diminue proportionnellement la bande passante utilisée par le flux.
En revanche, dans les sessions dont le mode multimédia est défini sur « relayed », la réduction de la fréquence d’images
ne réduit pas la bande passante du flux. (Voir
Le routeur multimédia OpenTok et les modes multimédias.)
nom
public Publisher.Builder nom(Chaîne nom)
Description extraite de la classe : PublisherKit.Builder
Définit le nom de la vidéo publiée. Le name La propriété d'un flux
publié par cet éditeur sera définie sur cette valeur (sur tous les clients).
Remplacements :
: name en classe PublisherKit.Builder
piste audio
public Publisher.Builder audioTrack(booléen enabled)
Description extraite de la classe : PublisherKit.Builder
Détermine s'il faut inclure une piste audio dans le flux publié (true,
(par défaut) ou non (false). La création d'un diffuseur sans piste audio
peut permettre d'économiser des ressources du processeur et de réduire la bande passante utilisée par le flux.
Si vous appelez cette fonction et que vous lui transmettez false, le sous-système audio ne sera pas
initialisé pour l'éditeur, et l'appel de la fonction
PublisherKit.setPublishAudio(boolean publishAudio) Cette méthode n'aura aucun effet.
Si votre application ne nécessite pas l'utilisation de l'audio, il est recommandé d'utiliser ce
paramètre du Builder plutôt que d'utiliser le
PublisherKit.setPublishAudio(boolean publishAudio) méthode, qui ne fait que
désactiver temporairement la piste audio.
Remplacements :
: audioTrack en classe PublisherKit.Builder
videoTrack
public Publisher.Builder videoTrack(booléen enabled)
Description extraite de la classe : PublisherKit.Builder
Détermine s'il faut inclure une piste vidéo dans le flux publié (true,
(par défaut) ou non (false). La création d'un diffuseur sans piste vidéo
peut permettre d'économiser des ressources CPU et de réduire la bande passante utilisée par le flux.
Si vous appelez cette fonction et que vous lui transmettez false, le sous-système vidéo ne sera pas
initialisé pour l'éditeur, et l'appel de la fonction
PublisherKit.setPublishVideo(boolean publishVideo) Cette méthode n'aura aucun effet.
Si votre application ne nécessite pas l'utilisation de la vidéo, il est recommandé d'utiliser ce
paramètre du Builder plutôt que d'utiliser la
PublisherKit.setPublishVideo(boolean publishVideo) méthode, qui ne fait que
désactiver temporairement la piste vidéo.
Remplacements :
: videoTrack en classe PublisherKit.Builder
captureur
public Publisher.Builder capturer(BaseVideoCapturer captureur)
Définit le capteur vidéo à utiliser pour l'éditeur. Si vous n'appelez pas cette méthode, l'éditeur utilisera le capteur par défaut de l'éditeur.
Remplacements :
: capturer en classe PublisherKit.Builder
moteur de rendu
public Publisher.Builder renderer(BaseVideoRenderer rendu)
Définit le moteur de rendu vidéo à utiliser pour l'éditeur. Si vous n'appelez pas cette méthode, l'éditeur utilisera le moteur de rendu par défaut de l'éditeur.
Remplacements :
: renderer en classe PublisherKit.Builder
audioBitrate
public Publisher.Builder audioBitrate(int bitsParSeconde)
Description extraite de la classe : PublisherKit.Builder
Définit le débit binaire souhaité pour le flux audio diffusé, en bits par seconde. La plage de valeurs prise en charge est comprise entre 6 000 et 510 000. (Les valeurs non valides sont ignorées.) Définissez cette valeur pour activer un son de haute qualité (ou pour réduire l'utilisation de la bande passante en optant pour un son de qualité inférieure).
Les paramètres suivants sont recommandés :
- 8 000 - 12 000 pour la parole en bande étroite (NB)
- 16 000 - 20 000 pour la parole à large bande (WB)
- 28 000 - 40 000 pour la parole en bande complète (FB)
- 48 000 - 64 000 pour la musique mono en bande complète (FB)
- 64 000 - 128 000 pour la musique stéréo à bande complète (FB)
La valeur par défaut est 40 000.
Pour définir d'autres paramètres audio, consultez la section AudioDeviceManager classe.
Remplacements :
: audioBitrate en classe PublisherKit.Builder
Paramètres :
: bitsPerSecond - Le débit binaire souhaité pour l'audio, en bits par seconde.
Renvoie : : Cet objet Builder.
partage d'écran adaptatif
public Publisher.Builder scalableScreenshare(booléen enable)
Description extraite de la classe : PublisherKit.Builder
Faut-il autoriser l'utilisation de vidéo évolutive pour un éditeur dont le paramètre `videoType` est défini sur `PublisherKitVideoTypeScreen` (true) ou non (false, valeur par défaut).
Remplacements :
: scalableScreenshare en classe PublisherKit.Builder
activerOpusDtx
public Publisher.Builder enableOpusDtx(booléen enable)
Description extraite de la classe : PublisherKit.Builder
Faut-il l'activer ? Opus DTX (true) ou non (false, par défaut). L'activation d'Opus DTX
peut réduire la consommation de bande passante dans les flux comportant de longues périodes de silence.
Par défaut, Opus DTX est désactivé. Si cette propriété est définie sur true,
La fonctionnalité Opus DTX sera activée pour l'éditeur.
Remplacements :
: enableOpusDtx en classe PublisherKit.Builder
subscriberAudioFallbackEnabled
public Publisher.Builder subscriberAudioFallbackEnabled(booléen enabled)
Description extraite de la classe : PublisherKit.Builder
Le flux utilisera-t-il la fonctionnalité de repli audio pour les abonnés (true) ou pas
(false), pour les abonnés au flux publié. La fonctionnalité de repli audio pour les abonnés
est disponible dans les sessions utilisant le routeur multimédia OpenTok. Lorsque la
fonctionnalité de basculement audio des abonnés est activée (par défaut), si l’OpenTok Media Router détecte que la
qualité d’un flux s’est considérablement dégradée pour un abonné spécifique, il désactive la vidéo
pour cet abonné afin de préserver la qualité audio.
Le paramètre par défaut est true (la fonctionnalité de repli audio est activée).
Lorsque vous utilisez le type de vidéo « écran » dans une session exploitant le serveur multimédia OpenTok, le
paramètre de repli audio de l'abonné est défini sur false par défaut,
afin que la vidéo ne soit pas interrompue chez les abonnés.
Remplacements :
: subscriberAudioFallbackEnabled en classe PublisherKit.Builder
Voir aussi :
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- le
routeur multimédia OpenTok et les modes multimédia
publisherAudioFallbackEnabled
public Publisher.Builder publisherAudioFallbackEnabled(booléen enabled)
Description extraite de la classe : PublisherKit.Builder
Le flux utilisera-t-il la fonctionnalité de repli audio de l'éditeur (true) ou pas
(false). Lorsque la fonctionnalité de repli audio de l'éditeur est activée (par défaut), si
l'éditeur constate que la qualité d'un flux s'est considérablement dégradée, il désactive la vidéo
afin de préserver la qualité audio.
Le paramètre par défaut est false (la fonctionnalité de repli audio est désactivée).
Remplacements :
: publisherAudioFallbackEnabled en classe PublisherKit.Builder
Voir aussi :
: - PublisherKit.VideoListener.onVideoDisabled(PublisherKit publisher, String reason)
- le
routeur multimédia OpenTok et les modes multimédia
autoriserLaCaptureAudioEnModeSilencieux
public Publisher.Builder allowAudioCaptureWhileMuted(booléen allow)
Description extraite de la classe : PublisherKit.Builder
Si cette option est définie sur « false », le microphone sera automatiquement désactivé lorsque tous les éditeurs auront coupé leur son. Le microphone sera automatiquement réactivé dès qu’au moins un éditeur réactivera son son. Si cette option est définie sur « true », le microphone restera toujours activé, même lorsque tous les éditeurs auront coupé leur son. Notez que lorsque le microphone est désactivé, les callbacks tels que `AudioLevel` ou `AudioData` ne seront plus appelés pour les diffuseurs. La valeur par défaut est « false ».
Remplacements :
: allowAudioCaptureWhileMuted en classe PublisherKit.Builder
codecs vidéo préférés
public Publisher.Builder preferredVideoCodecs(PublisherKit.Codecs vidéo préférés (codecs vidéo préférés)
Remplacements :
: preferredVideoCodecs en classe PublisherKit.Builder
senderStatsTrack
public Publisher.Builder senderStatsTrack(booléen allow)
Description extraite de la classe : PublisherKit.Builder
Si vous n'appelez pas cette fonction et que vous ne lui transmettez pas true, le sous-système de statistiques de l'expéditeur ne sera pas
initialisé pour l'éditeur.
Remplacements :
: senderStatsTrack en classe PublisherKit.Builder
construire
public Éditeur build()
Renvoie un nouvel Publisher par exemple, en fonction de la Publisher.Builder
paramètres.
Remplacements :
: build en classe PublisherKit.Builder
Retourne :
: Retourne un nouvel PublisherKit par exemple, en fonction de la PublisherKit.Builder
paramètres.