com.twilio.video

Class ConnectOptions.Builder

java.lang.Object

com.twilio.video.ConnectOptions.Builder

Enclosing class:

ConnectOptions

public static class ConnectOptions.Builder
extends Object

Build new ConnectOptions.

All methods are optional.

Constructor Summary

Constructors

Constructor and Description
Builder(String accessToken)

Method Summary

Modifier and Type	Method and Description
ConnectOptions.Builder	audioTracks(List<LocalAudioTrack> audioTracks) Audio tracks that will be published upon connection.
ConnectOptions	build() Builds ConnectOptions object.
ConnectOptions.Builder	dataTracks(List<LocalDataTrack> dataTracks) Data tracks that will be published upon connection.
ConnectOptions.Builder	enableAutomaticSubscription(boolean enableAutomaticSubscription) Toggles automatic track subscription.
ConnectOptions.Builder	enableDominantSpeaker(boolean enableDominantSpeaker) Enable reporting of a Room's dominant speaker.
ConnectOptions.Builder	enableInsights(boolean enable) Enable sending stats data to Insights.
ConnectOptions.Builder	enableNetworkQuality(boolean enableNetworkQuality) Enable or disable the Network Quality API.
ConnectOptions.Builder	encodingParameters(EncodingParameters encodingParameters) Set EncodingParameters for audio and video tracks shared to a Room.
ConnectOptions.Builder	iceOptions(IceOptions iceOptions) Custom ICE configuration used to connect to a Room.
ConnectOptions.Builder	preferAudioCodecs(List<AudioCodec> preferredAudioCodecs) Set preferred audio codecs.
ConnectOptions.Builder	preferVideoCodecs(List<VideoCodec> preferredVideoCodecs) Set preferred video codecs.
ConnectOptions.Builder	region(String region) The region of the signaling Server the Client will use.
ConnectOptions.Builder	roomName(String roomName) The name of the room.
ConnectOptions.Builder	videoTracks(List<LocalVideoTrack> videoTracks) Video tracks that will be published upon connection.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder(String accessToken)

Method Detail

roomName

public ConnectOptions.Builder roomName(String roomName)

The name of the room.

audioTracks

public ConnectOptions.Builder audioTracks(List<LocalAudioTrack> audioTracks)

Audio tracks that will be published upon connection.

videoTracks

public ConnectOptions.Builder videoTracks(List<LocalVideoTrack> videoTracks)

Video tracks that will be published upon connection.

dataTracks

public ConnectOptions.Builder dataTracks(List<LocalDataTrack> dataTracks)

Data tracks that will be published upon connection.

iceOptions

public ConnectOptions.Builder iceOptions(IceOptions iceOptions)

Custom ICE configuration used to connect to a Room.

enableInsights

public ConnectOptions.Builder enableInsights(boolean enable)

Enable sending stats data to Insights. Sending stats data to Insights is enabled by default.

enableAutomaticSubscription

public ConnectOptions.Builder enableAutomaticSubscription(boolean enableAutomaticSubscription)

Toggles automatic track subscription. If set to false, the LocalParticipant will receive notifications of track publish events, but will not automatically subscribe to them. If set to true, the LocalParticipant will automatically subscribe to tracks as they are published. If unset, the default is true. Note: This feature is only available for Group Rooms. Toggling the flag in a P2P room does not modify subscription behavior.

enableDominantSpeaker

public ConnectOptions.Builder enableDominantSpeaker(boolean enableDominantSpeaker)

Enable reporting of a Room's dominant speaker. This option has no effect if the Room topology is P2P.

See Also:

Room.getDominantSpeaker(), Room.Listner#onDominantSpeakerChanged()

enableNetworkQuality

public ConnectOptions.Builder enableNetworkQuality(boolean enableNetworkQuality)

Enable or disable the Network Quality API.

Set this to true to enable the Network Quality API when using Group Rooms. This option has no effect in Peer-to-Peer Rooms. The default value is false.

preferAudioCodecs

public ConnectOptions.Builder preferAudioCodecs(List<AudioCodec> preferredAudioCodecs)

Set preferred audio codecs. The list specifies which audio codecs would be preferred when negotiating audio between participants. The preferences are applied in the order found in the list starting with the most preferred audio codec to the least preferred audio codec. Audio codec preferences are not guaranteed to be satisfied because not all participants are guaranteed to support all audio codecs. OpusCodec is the default audio codec if no preferences are set.

The following snippet demonstrates how to prefer a single audio codec.

     ConnectOptions connectOptions = new ConnectOptions.Builder(token)
          .preferAudioCodecs(Collections.singletonList(new IsacCodec()))
          .build();
 

The following snippet demonstrates how to specify the exact order of codec preferences.

     ConnectOptions connectOptions = new ConnectOptions.Builder(token)
          .preferAudioCodecs(Arrays.asList(new IsacCodec(),
                  new G722Codec(), new OpusCodec()))
          .build();
 

preferVideoCodecs

public ConnectOptions.Builder preferVideoCodecs(List<VideoCodec> preferredVideoCodecs)

Set preferred video codecs. The list specifies which video codecs would be preferred when negotiating video between participants. The preferences are applied in the order found in the list starting with the most preferred video codec to the least preferred video codec. Video codec preferences are not guaranteed to be satisfied because not all participants are guaranteed to support all video codecs. Vp8Codec is the default video codec if no preferences are set.

The following snippet demonstrates how to prefer a single video codec.

     ConnectOptions connectOptions = new ConnectOptions.Builder(token)
          .preferVideoCodecs(Collections.singletonList(new H264Codec()))
          .build();
 

The following snippet demonstrates how to specify the exact order of codec preferences.

     ConnectOptions connectOptions = new ConnectOptions.Builder(token)
          .preferVideoCodecs(Arrays.asList(new H264Codec(),
                  new Vp8Codec(), new Vp9Codec()))
          .build();
 

region

public ConnectOptions.Builder region(String region)

The region of the signaling Server the Client will use. By default, the Client will connect to the nearest signaling Server determined by latency based routing. Setting a value other than "gll" bypasses routing and guarantees that signaling traffic will be terminated in the region that you prefer. If you are connecting to a Group Room created with the "gll" Media Region (either Ad-Hoc or via the REST API), then the Room's Media Region will be selected based upon your Client's region. The default value is `gll`.

encodingParameters

public ConnectOptions.Builder encodingParameters(EncodingParameters encodingParameters)

Set EncodingParameters for audio and video tracks shared to a Room.

build

public ConnectOptions build()

Builds ConnectOptions object.

Throws:

Exception - if accessToken is null or empty.