TVOCallDelegate Protocol Reference

Conforms to NSObject
Declared in TVOCallDelegate.h

Overview

Objects can conform to the TVOCallDelegate protocol to be informed of the lifecycle events of a TVOCall.

Required Methods

– callDidConnect: required method

Notifies the delegate that a Call has connected.

- (void)callDidConnect:(nonnull TVOCall *)call

Parameters

call

The TVOCall that was connected.

See Also

Declared In

TVOCallDelegate.h

– call:didFailToConnectWithError: required method

Notifies the delegate that a Call has failed to connect.

- (void)call:(nonnull TVOCall *)call didFailToConnectWithError:(nonnull NSError *)error

Parameters

call

The TVOCall that failed to connect.
error

The <NSError> that occurred.

See Also

Declared In

TVOCallDelegate.h

– call:didDisconnectWithError: required method

Notifies the delegate that a Call has disconnected.

- (void)call:(nonnull TVOCall *)call didDisconnectWithError:(nullable NSError *)error

Parameters

call

The TVOCall that was disconnected.
error

Indicates why the disconnect occurred.

Discussion

If the disconnection was unexpected then a Non-null NSError will be present.

See Also

Declared In

TVOCallDelegate.h

Optional Methods

– callDidStartRinging:

Notifies the delegate that the called party is being alerted of a Call.

- (void)callDidStartRinging:(nonnull TVOCall *)call

Parameters

call

The TVOCall that the called party is being alerted of.

Discussion

Introduced a new callback method [TVOCallDelegate callDidStartRinging:]. This callback is invoked once before the [TVOCallDelegate callDidConnect:] callback when the callee is being alerted of a Call. The duration of the TVOCallStateRinging is determined by the answerOnBridge flag provided in the Dial verb of your TwiML application associated with this client. If the answerOnBridge flag is false, which is the default, the [TVOCallDelegate callDidConnect:] callback will be emitted immediately after [TVOCallDelegate callDidStartRinging:]. If the answerOnBridge flag is true this will cause the Call to emit the callDidConnect callback only until the call is answered. See https://www.twilio.com/docs/voice/twiml/dial#answeronbridge for more details on how to use it with the Dial TwiML verb. If the twiML response contains a Say verb, then the call will emit the [TVOCallDelegate callDidConnect:] callback immediately after [TVOCallDelegate callDidStartRinging:] is raised, irrespective of the value of answerOnBridge being set to true or false.

See Also

Declared In

TVOCallDelegate.h