com.opentok.android.PublisherKit.Builder
Sous-classes directes connues :
: Publisher.Builder
Classe englobante : : PublisherKit
classe publique statique PublisherKit.Builder hérite de Objet
Sert à créer un PublisherKit objet. Instanciez un objet Builder à l'aide de la méthode
PublisherKit.Builder(Context context) constructeur. Appelez ensuite les méthodes de
la Builder instance pour ajouter les paramètres de l'éditeur. Appelez ensuite la méthode
build() méthode, qui renvoie un PublisherKit objet.
Utiliser le Session.publish(PublisherKit publisher) méthode permettant de lancer la diffusion en continu
depuis l'éditeur vers une session.
Les éditeurs ne peuvent pas être réutilisés. Créez un nouvel PublisherKit objet à chaque fois que vous
souhaitez publier un nouveau flux.
Voir aussi :
: - PublisherKit.setPublisherListener(PublisherKit.PublisherListener listener)
Résumé du constructeur
Constructeurs
Constructeur
Description
Builder(android.content.Context context)
Instancie un PublisherKit.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
PublisherKit.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.
PublisherKit.Builder
audioBitrate(int bitsPerSecond)
Définit le débit binaire souhaité pour le flux audio publié, en bits par seconde.
PublisherKit.Builder
audioTrack(boolean enabled)
Détermine s'il faut inclure une piste audio dans le flux publié (true,
(par défaut) ou non (false).
PublisherKit
build()
PublisherKit.Builder
capturer(BaseVideoCapturer capturer)
Définit la carte d'acquisition vidéo à utiliser pour l'éditeur.
PublisherKit.Builder
enableOpusDtx(boolean enable)
Faut-il l'activer ? Opus DTX (true) ou non (false(par défaut).
PublisherKit.Builder
name(String name)
Définit le nom de la vidéo publiée.
PublisherKit.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
PublisherKit.Builder
publisherAudioFallbackEnabled(boolean enabled)
Le flux utilisera-t-il la fonctionnalité de repli audio de l'éditeur (true) ou pas
(false).
PublisherKit.Builder
renderer(BaseVideoRenderer renderer)
Définit le moteur de rendu vidéo à utiliser pour l'éditeur.
PublisherKit.Builder
scalableScreenshare(boolean enabled)
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).
PublisherKit.Builder
senderStatsTrack(boolean enabled)
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.
PublisherKit.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é.
PublisherKit.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 PublisherKit.Builder objet.
Paramètres :
: context - Le android.content.Context pour l'éditeur.
Détails de la méthode
nom
public PublisherKit.Builder nom(Chaîne nom)
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).
piste audio
public PublisherKit.Builder audioTrack(booléen enabled)
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.
videoTrack
public PublisherKit.Builder videoTrack(booléen enabled)
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.
captureur
public PublisherKit.Builder capturer(BaseVideoCapturer captureur)
Définit la carte d'acquisition vidéo à utiliser pour l'éditeur.
moteur de rendu
public PublisherKit.Builder renderer(BaseVideoRenderer rendu)
Définit le moteur de rendu vidéo à utiliser pour l'éditeur.
audioBitrate
public PublisherKit.Builder audioBitrate(int bitsParSeconde)
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.
Paramètres :
: bitsPerSecond - Le débit binaire souhaité pour l'audio, en bits par seconde.
Renvoie : : Cet objet Builder.
activerOpusDtx
public PublisherKit.Builder enableOpusDtx(booléen enable)
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.
partage d'écran adaptatif
public PublisherKit.Builder scalableScreenshare(booléen enabled)
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).
subscriberAudioFallbackEnabled
public PublisherKit.Builder subscriberAudioFallbackEnabled(booléen 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é. 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.
Voir aussi :
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- le
routeur multimédia OpenTok et les modes multimédia
publisherAudioFallbackEnabled
public PublisherKit.Builder publisherAudioFallbackEnabled(booléen enabled)
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).
Voir aussi :
: - PublisherKit.VideoListener.onVideoDisabled(PublisherKit publisher, String reason)
- le
routeur multimédia OpenTok et les modes multimédia
autoriserLaCaptureAudioEnModeSilencieux
public PublisherKit.Builder allowAudioCaptureWhileMuted(booléen allow)
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 ».
codecs vidéo préférés
public PublisherKit.Builder preferredVideoCodecs(PublisherKit.Codecs vidéo préférés (codecs vidéo préférés)
senderStatsTrack
public PublisherKit.Builder senderStatsTrack(booléen enabled)
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.
construire
public PublisherKit build()
Retourne :
: Retourne un nouvel PublisherKit par exemple, en fonction de la PublisherKit.Builder
paramètres.