TVOCallOptions Class Reference

Inherits from NSObject
Declared in TVOCallOptions.h

Overview

Represents options available when connecting to a Call. Normally, this class is not used directly. See TVOConnectOptions or TVOCAcceptOptions for example usage.

  delegateQueue

The queue where the Call and associated classes will invoke delegate methods.

@property (nonatomic, strong, readonly, nullable) dispatch_queue_t delegateQueue

Discussion

All delegate methods are performed on this queue. Any TVOCall instance which is created with these options will maintain a strong reference to the queue until it is destroyed. The default value of nil indicates that the main dispatch queue will be used.

Declared In

TVOCallOptions.h

  iceOptions

A custom ICE configuration used to connect to a Call.

@property (nonatomic, strong, readonly, nullable) TVOIceOptions *iceOptions

Declared In

TVOCallOptions.h

  preferredAudioCodecs

The collection of preferred audio codecs.

@property (nonatomic, copy, readonly, nonnull) NSArray<TVOAudioCodec*> *preferredAudioCodecs

Discussion

The list specifies which audio codecs will 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. TVOOpusCodec is the default audio codec if no preferences are set.

Declared In

TVOCallOptions.h

  enableDscp

Enables Differentiated Services Field Code Point (DSCP) with Expedited Forwarding (EF). https://tools.ietf.org/html/draft-ietf-tsvwg-rtcweb-qos-18#section-5

@property (nonatomic, assign, readonly) BOOL enableDscp

Discussion

DSCP is enabled by default.

Declared In

TVOCallOptions.h

  enableIceGatheringOnAnyAddressPorts

Enable gathering of ICE candidates on “any address” ports. When this flag is set, ports not bound to any specific network interface will be used, in addition to normal ports bound to the enumerated interfaces. This flag may need to be set to support certain network configurations (e.g. some VPN implementations) where ports are not bound to specific interfaces. Setting this flag means that additional candidates might need to be gathered and evaluated, which could lead to slower ICE connection times for regular networks.

@property (nonatomic, assign, readonly) BOOL enableIceGatheringOnAnyAddressPorts

Declared In

TVOCallOptions.h

  callMessageDelegate

The TVOCallMessageDelegate for TVOCallMessage related updates.

@property (nonatomic, weak, readonly, nullable) id<TVOCallMessageDelegate> callMessageDelegate

Declared In

TVOCallOptions.h

  audioOptions

The TVOAudioOptions that can be applied to underlying media streams or audio processing.

@property (nonatomic, strong, readonly, nullable) TVOAudioOptions *audioOptions

Declared In

TVOCallOptions.h

– init

Developers shouldn’t initialize this class directly.

- (null_unspecified instancetype)init

Discussion

Use the TVOConnectOptions or TVOAcceptOptions builder method instead.

Declared In

TVOCallOptions.h