com.twilio.video

Class VideoBandwidthProfileOptions.Builder

java.lang.Object

com.twilio.video.VideoBandwidthProfileOptions.Builder

Enclosing class:

VideoBandwidthProfileOptions

public static class VideoBandwidthProfileOptions.Builder
extends java.lang.Object

Builder class for VideoBandwidthProfileOptions.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
VideoBandwidthProfileOptions	build()
VideoBandwidthProfileOptions.Builder	dominantSpeakerPriority(TrackPriority priority) Set the minimum TrackPriority of the Dominant Speaker's RemoteVideoTracks.
VideoBandwidthProfileOptions.Builder	maxSubscriptionBitrate(java.lang.Long maxSubscriptionBitrate) Set the maximum downlink video bandwidth in Kilobits per second (Kbps).
VideoBandwidthProfileOptions.Builder	maxTracks(java.lang.Long maxTracks) Set the maximum number of visible RemoteVideoTracks selected first using TrackPriority and second using an N-Loudest policy.
VideoBandwidthProfileOptions.Builder	mode(BandwidthProfileMode mode) Set how RemoteVideoTracks TrackPriority values are mapped to bandwidth allocation in Group Rooms.
VideoBandwidthProfileOptions.Builder	renderDimensions(java.util.Map<TrackPriority,VideoDimensions> dimensions) Set the desired render dimensions of RemoteVideoTracks based on TrackPriority and the RemoteVideoTracks of the Dominant Speaker.
VideoBandwidthProfileOptions.Builder	trackSwitchOffMode(TrackSwitchOffMode mode) Configure how RemoteVideoTracks are switched off.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

dominantSpeakerPriority

public VideoBandwidthProfileOptions.Builder dominantSpeakerPriority(@Nullable
                                                                    TrackPriority priority)

Set the minimum TrackPriority of the Dominant Speaker's RemoteVideoTracks. This property is null by default and can be set to null. A null value results in the Twilio Media Server selecting the Dominant Speaker's priority. This property will only be enabled if the Dominant Speaker feature is enabled via ConnectOptions.Builder.enableDominantSpeaker(boolean).

Parameters:

priority - The track priority to use or null.

maxSubscriptionBitrate

public VideoBandwidthProfileOptions.Builder maxSubscriptionBitrate(@Nullable
                                                                   java.lang.Long maxSubscriptionBitrate)

Set the maximum downlink video bandwidth in Kilobits per second (Kbps). This property is 2,400 Kbps by default and can be set to null. A null value results in the maximum allowed bitrate for a Room.

Parameters:

maxSubscriptionBitrate - The maximum bitrate for subscribe RemoteVideoTracks or null.

maxTracks

public VideoBandwidthProfileOptions.Builder maxTracks(@Nullable
                                                      java.lang.Long maxTracks)

Set the maximum number of visible RemoteVideoTracks selected first using TrackPriority and second using an N-Loudest policy. This property is null by default and can be set to null. A null value results in no limits on the number of visible RemoteVideoTracks.

Parameters:

maxTracks - The maximum number of video tracks or null.

mode

public VideoBandwidthProfileOptions.Builder mode(@Nullable
                                                 BandwidthProfileMode mode)

Set how RemoteVideoTracks TrackPriority values are mapped to bandwidth allocation in Group Rooms. This property is null by default and can be set to null. A null value results in the Twilio Media Server selecting the mode.

Parameters:

mode - The BandwidthProfileMode to use or null.

renderDimensions

public VideoBandwidthProfileOptions.Builder renderDimensions(@NonNull
                                                             java.util.Map<TrackPriority,VideoDimensions> dimensions)

Set the desired render dimensions of RemoteVideoTracks based on TrackPriority and the RemoteVideoTracks of the Dominant Speaker. The bandwidth allocation algorithm will distribute the available downlink bandwidth proportional to the requested render dimensions.

Parameters:

dimensions - A map containing at most one entry for each TrackPriority.

trackSwitchOffMode

public VideoBandwidthProfileOptions.Builder trackSwitchOffMode(@Nullable
                                                               TrackSwitchOffMode mode)

Configure how RemoteVideoTracks are switched off. This property is null by default and can be set to null. A null value results in the Twilio Media Server selecting the track switch off mode.

Parameters:

mode - The TrackSwitchOffMode to use or null.

build

public VideoBandwidthProfileOptions build()