Paramètres de l'abonné

Vue d'ensemble

Les SDK du client vidéo de Vonage permettent aux participants de s'abonner à l'audio et à la vidéo dans une session. Les SDK Client permettent de configurer l'objet Abonné en fonction de vos préférences et de votre cas d'utilisation.

Ce mode d'emploi aborde les points suivants :

Abonnement audio ou vidéo uniquement
Détecter si un flux contient de l'audio ou de la vidéo
Modifier les paramètres vidéo d'un abonné
Modifier les paramètres audio d'un abonné

Abonnement à l'audio ou à la vidéo uniquement

Lorsque vous s'abonner à un fluxVous pouvez spécifier si vous souhaitez vous abonner initialement au flux audio ou vidéo (s'ils sont disponibles). Par exemple, le code suivant s'abonne uniquement au flux audio :

subscriber = OTSubscriber(stream: stream, delegate: self)
subscriber.subscribeToAudio = false

Après avoir créé un objet Subscriber, vous activez ou désactivez l'audio en appelant la fonction subscribeToAudio() de l'objet Abonné :

subscriber.subscribeToAudio = false // audio off
subscriber.subscribeToAudio = true // audio on

Vous pouvez activer ou désactiver la vidéo en appelant la fonction subscribeToVideo() de l'objet Abonné :

subscriber.subscribeToVideo = false // video off
subscriber.subscribeToVideo = true // video on

Notez toutefois que vous ne pouvez vous abonner à l'audio ou à la vidéo que si le client qui publie le flux inclut l'audio ou la vidéo. Par exemple, en appelant subscribeToVideo(false) n'aura aucun effet si le client qui publie le flux ne publie que de l'audio.

Détecter si un flux contient de l'audio ou de la vidéo

Par défaut, un objet Subscriber lit à la fois l'audio et la vidéo (s'ils sont disponibles). Vous pouvez vérifier si un flux contient de l'audio ou de la vidéo (si l'éditeur du flux diffuse de l'audio ou de la vidéo) en vérifiant l'attribut hasAudio et hasVideo de l'objet Stream :

You may want to set state properties based on the hasAudio and hasVideo properties and adjust the UI for the OTSubscriber based on these state values. You may want to adjust the user interface based on whether the stream has audio or video. For example, you may want to indicate to the user whether a stream has audio or not; or you may not want to hide a subscriber if a stream does not have video.

if !stream.hasAudio {
    // You may want to adjust the user interface
}
if !stream.hasVideo {
    // You may want to adjust the user interface
}

You can call the otc_stream_has_audio() and otc_stream_has_audio() member functions of an otc_stream instance to see if it has audio or video.

Par exemple, lorsque vous s'abonner à un fluxIl se peut que vous souhaitiez adapter l'interface utilisateur en fonction de la présence d'audio ou de vidéo dans le flux. Par exemple, vous pouvez indiquer à l'utilisateur si un flux est audio ou non, ou ne pas masquer un abonné si un flux ne contient pas de vidéo.

Détecter quand un flux ajoute ou supprime de l'audio ou de la vidéo

The OTSession object dispatches a streamPropertyChanged event when a stream toggles audio or video on or off. The event object has a changedProperty property set to hasAudio or hasVideo when the audio or video changes. The newValue property is set to a Boolean value. For example, the following code listens for changes in a audio and video in a Stream:

The Session object dispatches a streamPropertyChanged event when a stream toggles audio or video on or off. The streamPropertyChanged event is defined by the StreamPropertyChangedEvent class. The event object has a changedProperty property (identifying the Stream property that changed) and a newValue property (the new value of the Stream property). For example, the following code listens for changes in an audio and video in a Stream:

Note that a subscriber's video can be disabled or enabled for reasons other than the publisher disabling or enabling it. A Subscriber object dispatches videoDisabled and videoEnabled events in all conditions that cause the subscriber's stream to be disabled or enabled. For details, see the documentation for the Subscriber videoDisabled and [Subscriber videoEnabled]https://vonage.github.io/video-docs/video-js-reference/latest/Subscriber.html#event:videoEnabled) events.

Modifier les paramètres vidéo d'un abonné

Réglage de la résolution et de la fréquence d'images d'une vidéo

Vous pouvez définir la fréquence d'images et la résolution pour le flux d'un abonné en définissant les paramètres suivants la preferredFrameRate et preferredResolution des options que vous passez dans la fonction session.subscribe() méthode. Nous recommandons de définir la preferredResolution à l'option "auto" pour optimiser l'utilisation de l'unité centrale et du réseau. Les "auto" est une fonction bêta. Voir aussi Réglage de la fréquence d'images et de la résolution

Modification des paramètres audio d'un abonné

Commutation de la sortie audio utilisée par un abonné

You can switch the audio output device (a speaker or headphones) used to play audio from all publishers and subscribers (in all Vonage Video sessions in the browser).

The OT.getAudioOutputDevices() method enumerates the audio and video input devices available to the browser.

The OT.getActiveAudioOutputDevice() method identifies the currently active audio output device.

Use the OT.setAudioOutputDevice() method to set the audio output device.

For example, the following code shows you how to implement a cycleAudioOutput() function that cycles through the available audio output devices:

Modification du niveau audio d'un abonné

Lorsque vous s'abonner à un fluxVous pouvez régler le volume initial de l'abonné lorsque vous appelez le numéro de téléphone de l'abonné. subscribe() de l'objet Session :

After you create a Subscriber object, you can set its volume by calling its setAudioVolume() method, passing in a value from 0 (silent) to 100 (full volume):

Note that the user can also mute the subscriber via user interface controls in the subscriber.

After you create a Subscriber object, you can set its volume by calling its setAudioVolume() method, passing in a value from 0 (silent) to 100 (full volume):

Note that the user can also mute the subscriber via user interface controls in the subscriber.

You can individually set the audio volume for each subscriber by setting the OTSubscriberKit.audioVolume property.

You can individually set the audio volume for each subscriber by calling the Subscriber.AudioVolume property.

You can individually set the audio volume for each subscriber by calling the otc_subscriber_set_audio_volume() function.