SINCallDelegate

Objective-C

@protocol SINCallDelegate <NSObject>

Swift

protocol SINCallDelegate : NSObjectProtocol

The delegate of a SINCall object must adopt the SINCallDelegate protocol. The required methods handle call state changes.

Call State Progression

For a complete outgoing call, the delegate methods will be called in the following order:

  • callDidProgress:
  • callDidEstablish:
  • callDidEnd:

For a complete incoming call, the delegate methods will be called in the following order, after the client delegate method [SINClientDelegate client:didReceiveIncomingCall:] has been called:

  • callDidEstablish:

  • callDidEnd:

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

  • Tells the delegate that the call ended.

    The call has entered the SINCallStateEnded state.

    See

    SINCall

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

    Declaration

    Objective-C

    - (void)callDidEnd:(id<SINCall>)call;

    Swift

    optional func callDidEnd(_ call: SINCall!)

    Parameters

    call

    The call that ended.

  • Tells the delegate that the outgoing call is progressing and a progress tone can be played.

    The call has entered the SINCallStateProgressing state.

    See

    SINCall

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

    Declaration

    Objective-C

    - (void)callDidProgress:(id<SINCall>)call;

    Swift

    optional func callDidProgress(_ call: SINCall!)

    Parameters

    call

    The outgoing call to the client on the other end.

  • Tells the delegate that the call was established.

    The call has entered the SINCallStateEstablished state.

    See

    SINCall

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

    Declaration

    Objective-C

    - (void)callDidEstablish:(id<SINCall>)call;

    Swift

    optional func callDidEstablish(_ call: SINCall!)

    Parameters

    call

    The call that was established.

  • Tells the delegate that a video track has been added to the call. (A delegate can use SINVideoController to manage rendering views.)

    See

    SINVideoController

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

    Declaration

    Objective-C

    - (void)callDidAddVideoTrack:(id<SINCall>)call;

    Swift

    optional func callDidAddVideoTrack(_ call: SINCall!)

  • Tells the delegate that a video track has been paused in the call. (A delegate can use SINVideoController to manage rendering views.)

    See

    SINVideoController

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

    Declaration

    Objective-C

    - (void)callDidPauseVideoTrack:(id<SINCall>)call;

    Swift

    optional func callDidPauseVideoTrack(_ call: SINCall!)

  • Tells the delegate that a video track has been resumed in the call. (A delegate can use SINVideoController to manage rendering views.)

    See

    SINVideoController

    Important

    Thread safety notes: Should be called on main thread/main GCD queue.

    Declaration

    Objective-C

    - (void)callDidResumeVideoTrack:(id<SINCall>)call;

    Swift

    optional func callDidResumeVideoTrack(_ call: SINCall!)