Call

public class Call : WebexBroadcastServerProtocol

See

see Phone API about how to create calls.

See

CallStatus for the states and transitions of a Call.

Since

1.2.0
  • Undocumented

    Declaration

    Swift

    public func startBroadcast()
  • Undocumented

    Declaration

    Swift

    public func stopBroadcast()
  • Undocumented

    Declaration

    Swift

    public func setup()
  • Undocumented

    Declaration

    Swift

    public func sendFrame(timeStamp: NSNumber, width: NSNumber, height: NSNumber, data: UnsafeMutableRawPointer, length: NSNumber)
  • Returns the id of this call.

    Since

    3.0.0

    Declaration

    Swift

    public var callId: String?
  • Returns the name of the caller in case of 1-1 call and name of space in case of space call.

    Since

    3.0.0

    Declaration

    Swift

    public var title: String?
  • Returns true if this call is CUCM, for Webex call it returns false.

    Since

    3.0.0

    Declaration

    Swift

    public var isCUCMCall: Bool
  • Returns true if this call is put on hold.

    Since

    3.0.0

    Declaration

    Swift

    public var isOnHold: Bool
  • Returns true if this call is not ONE_TO_ONE

    Since

    3.0.0

    Declaration

    Swift

    public var isGroupCall: Bool
  • The enumeration of directions of a call

    Since

    1.2.0
    See more

    Declaration

    Swift

    public enum Direction
  • The enumuaration of reasons for a call being disconnected.

    Since

    1.2.0
    See more

    Declaration

    Swift

    public enum DisconnectReason
  • The enumeration of media change event

    Since

    1.2.0
    See more

    Declaration

    Swift

    public enum MediaChangedEvent
  • The enumeration of call membership events.

    Since

    1.3.0
    See more

    Declaration

    Swift

    public enum CallMembershipChangedEvent
  • The enumeration of iOS broadcasting events.

    Since

    1.4.0
    See more

    Declaration

    Swift

    public enum iOSBroadcastingEvent
  • The enumeration of capabilities of a call.

    Since

    1.2.0
    See more

    Declaration

    Swift

    public enum Capabilities
  • The reasons for the call is waiting.

    Since

    2.4.0
    See more

    Declaration

    Swift

    public enum WaitReason
  • The options to specify how the video adjusts its content to be render in a view.

    Since

    2.6.0
    See more

    Declaration

    Swift

    public enum VideoRenderMode
  • Callback when remote participant(s) is ringing.

    Since

    1.2.0

    Declaration

    Swift

    public var onRinging: (() -> Void)? { get set }
  • Callback when remote participant(s) answered and this Call is connected.

    Since

    1.2.0

    Declaration

    Swift

    public var onConnected: (() -> Void)? { get set }
  • This will notify when a call gets failed

    Since

    3.0.0

    Declaration

    Swift

    public var onFailed: (() -> Void)? { get set }
  • This will notify when call object changes

    Since

    3.0.0

    Declaration

    Swift

    public var onInfoChanged: (() -> Void)? { get set }
  • Callback when the call is waiting.

    Since

    2.4.0

    Declaration

    Swift

    public var onWaiting: ((WaitReason) -> Void)?
  • Callback when this Call is disconnected (hangup, cancelled, get declined or other self device pickup the call).

    Since

    1.2.0

    Declaration

    Swift

    public var onDisconnected: ((DisconnectReason) -> Void)?
  • Callback when the memberships of this Call have changed.

    Since

    1.3.0

    Declaration

    Swift

    public var onCallMembershipChanged: ((CallMembershipChangedEvent) -> Void)?
  • Callback when the media types of this Call have changed.

    Since

    1.2.0

    Declaration

    Swift

    public var onMediaChanged: ((MediaChangedEvent) -> Void)?
  • Callback when the capabilities of this Call have changed.

    Since

    1.2.0

    Declaration

    Swift

    public var onCapabilitiesChanged: ((Capabilities) -> Void)?
  • Callback when the iOS broadcasting status of this Call have changed.

    Since

    1.4.0

    Declaration

    Swift

    public var oniOSBroadcastingChanged: ((iOSBroadcastingEvent) -> Void)?
  • Callback when the Call is scheduled call and the schedules of the call has been changed.

    Since

    2.6.0

    Declaration

    Swift

    public var onScheduleChanged: ((Call) -> Void)? { get set }
  • Multi stream feature observer protocol. Client need to set the protocol implemention into certain call.

    See

    see MultiStreamObserver

    Since

    2.0.0

    Declaration

    Swift

    public var multiStreamObserver: MultiStreamObserver?
  • The status of this Call.

    See

    CallStatus

    Since

    1.2.0

    Declaration

    Swift

    public internal(set) var status: CallStatus { get }
  • The direction of this Call.

    Since

    1.2.0

    Declaration

    Swift

    public private(set) var direction: Direction { get }
  • True if the DTMF keypad is enabled for this Call. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var sendingDTMFEnabled: Bool
  • True if the remote party of this Call is sending video. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var remoteSendingVideo: Bool
  • True if the remote party of this Call is sending audio. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var remoteSendingAudio: Bool
  • True if the remote party of this Call is sending screen share. Otherwise, false.

    Since

    1.3.0

    Declaration

    Swift

    public var remoteSendingScreenShare: Bool
  • True if the local party of this Call is sending video. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var sendingVideo: Bool { get set }
  • True if this Call is sending audio. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var sendingAudio: Bool { get set }
  • True if the local party of this Call is sending screen share. Otherwise, false.

    Since

    1.4.0

    Declaration

    Swift

    public var sendingScreenShare: Bool { get set }
  • True if the local party of this Call is receiving video. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var receivingVideo: Bool { get set }
  • True if the local party of this Call is receiving audio. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var receivingAudio: Bool { get set }
  • True if the local party of this Call is receiving screen share. Otherwise, false.

    Since

    1.3.0

    Declaration

    Swift

    public var receivingScreenShare: Bool { get set }
  • True if the loud speaker is selected as the audio output device for this Call. Otherwise, false.

    Since

    1.2.0

    Declaration

    Swift

    public var isSpeaker: Bool { get }
  • The camera facing mode selected for this Call.

    Since

    1.2.0

    Declaration

    Swift

    public var facingMode: Phone.FacingMode { get set }
  • The local video render view dimensions (points) of this Call.

    Since

    1.2.0

    Declaration

    Swift

    public var localVideoViewSize: CMVideoDimensions
  • The remote video render view dimensions (points) of this Call.

    Since

    1.2.0

    Declaration

    Swift

    public var remoteVideoViewSize: CMVideoDimensions
  • The remote screen share render view dimensions (points) of this Call.

    Since

    1.3.0

    Declaration

    Swift

    public var remoteScreenShareViewSize: CMVideoDimensions
  • The local screen share render view dimensions (points) of this Call.

    Since

    1.4.0

    Declaration

    Swift

    public var localScreenShareViewSize: CMVideoDimensions
  • Specify how the remote video adjusts its content to be render in a view.

    Since

    2.6.0

    Declaration

    Swift

    public var remoteVideoRenderMode: VideoRenderMode { get set }
  • The composited video layout for the active speaker and other attendees in the group video meeting.

    Note

    the layout just affects when Phone.videoStreamMode is composited

    Since

    2.8.0

    Declaration

    Swift

    public var compositedVideoLayout: MediaOption.CompositedVideoLayout? { get set }
  • Set the composited video layout with callback for the active speaker and other attendees in the group video meeting.

    Note

    the layout just affects when Phone.videoStreamMode is composited

    Since

    2.8.0

    Declaration

    Swift

    public func setCompositedVideoLayout(_ layout: MediaOption.CompositedVideoLayout, completionHandler: @escaping (Error?) -> Void)

    Parameters

    layout

    the video layout mode.

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

  • Call Memberships represent participants in this Call.

    Since

    1.2.0

    Declaration

    Swift

    public private(set) var memberships: [CallMembership] { get set }
  • The initiator of this Call.

    Since

    1.2.0

    Declaration

    Swift

    public var from: CallMembership? { get }
  • to

    The intended recipient of this Call.

    Since

    1.2.0

    Declaration

    Swift

    public var to: CallMembership? { get }
  • Returns the associated Space of this Call.

    Since

    2.6.0

    Declaration

    Swift

    public var spaceId: String?
  • Returns the schedules of this call if this call has one or more schedules.

    Since

    3.0.0

    Declaration

    Swift

    public private(set) var schedules: [CallSchedule]? { get }
  • A local unique identifier of a Call for Apple CallKit.

    Since

    1.2.0

    Declaration

    Swift

    public var uuid: UUID
  • The render views for local and remote video of this call. If is nil, it will update the video state as inactive to the server side.

    Since

    1.3.0

    Declaration

    Swift

    public var videoRenderViews: (local: MediaRenderView, remote: MediaRenderView)? { get set }
  • The render view for the remote screen share of this call. If is nil, it will update the screen sharing state as inactive to the server side.

    Since

    1.3.0

    Declaration

    Swift

    public var screenShareRenderView: MediaRenderView? { get set }
  • Get all opened auxiliary streams.

    See

    see AuxStream

    Since

    2.0.0

    Declaration

    Swift

    public lazy private(set) var auxStreams: [AuxStream] { get set }
  • Speaking CallMembership in meeting Video presented on remote media render view.

    See

    see CallMembership.isActiveSpeaker

    Since

    2.0.0

    Declaration

    Swift

    public internal(set) var activeSpeaker: CallMembership? { get }
  • Available auxiliary stream count.

    Since

    2.0.0

    Declaration

    Swift

    public private(set) var availableAuxStreamCount: Int { get set }
  • True if the call is space backed meeting type. Otherwise, false.

    Since

    3.1.0

    Declaration

    Swift

    public var isSpaceMeeting: Bool
  • True if self is the initiator of the call.

    Since

    3.1.0

    Declaration

    Swift

    public var isSelfCreator: Bool
  • True if anyone joined the meeting, excluding self.

    Since

    3.1.0

    Declaration

    Swift

    public var hasAnyoneJoined: Bool
  • True if the local party of this Call is receiving audio. Otherwise, false.

    Since

    3.1.0

    Declaration

    Swift

    public var isPmr: Bool
  • True if the Call is meeting type. Otherwise, false.

    Since

    3.1.0

    Declaration

    Swift

    public var isMeeting: Bool
  • True if the Call is schedule meeting type. Otherwise, false.

    Since

    3.1.0

    Declaration

    Swift

    public var isScheduledMeeting: Bool
  • Update audio session for CallKit. This must be called on provider:didActivateAudioSession: to reactivate the audio session.

    Since

    1.3.0

    Declaration

    Swift

    public func updateAudioSession()
  • Answers this call. This can only be invoked when this call is incoming and in ringing status.

    See

    see CallStatus

    Since

    1.2.0

    Declaration

    Swift

    public func answer(option: MediaOption, completionHandler: @escaping (Error?) -> Void)

    Parameters

    option

    Intended media options - audio only or audio and video - for the call.

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Rejects this call. This can only be invoked when this call is incoming and in ringing status.

    Since

    1.2.0

    See

    see CallStatus

    Declaration

    Swift

    public func reject(completionHandler: @escaping (Error?) -> Void)

    Parameters

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Disconnects this call. This can only be invoked when this call is in answered status.

    Since

    1.2.0

    See

    see CallStatus

    Declaration

    Swift

    public func hangup(completionHandler: @escaping (Error?) -> Void)

    Parameters

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Admit CallMemberships into the meeting from the lobby. This should be called by moderator.

    Since

    2.4.0

    Declaration

    Swift

    public func letIn(_ memberships: [CallMembership], completionHandler: @escaping (Error?) -> Void)

    Parameters

    memberships

    The call memberships that are waiting in the lobby.

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Sends feedback for this call to Cisco Webex team.

    Since

    1.2.0

    Declaration

    Swift

    public func sendFeedbackWith(rating: Int, comments: String? = nil, includeLogs: Bool = false)

    Parameters

    rating

    The rating of the quality of this call between 1 and 5 where 5 means excellent quality.

    comments

    The comments for this call.

    includeLogs

    True if to include logs, False as not.

    Return Value

    Void

  • Sends DTMF events to the remote party. Valid DTMF events are 0-9, *, #, a-d, and A-D.

    Since

    1.2.0

    Declaration

    Swift

    public func send(dtmf: String, completionHandler: ((Error?) -> Void)?)

    Parameters

    dtmf

    any combination of valid DTMF events matching regex mattern “^[0-9#*abcdABCD]+$”

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Start screen sharing in this call.

    Since

    1.4.0

    Declaration

    Swift

    public func startSharing(completionHandler: @escaping (Error?) -> Void)

    Parameters

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Stop screen sharing in this call.

    Since

    1.4.0

    Declaration

    Swift

    public func stopSharing(completionHandler: @escaping (Error?) -> Void)

    Parameters

    completionHandler

    A closure to be executed when completed, with error if the invocation is illegal or failed, otherwise nil.

    Return Value

    Void

  • Open one auxiliary stream with a media render view. The Maximum number of auxiliary videos could be opened is 4. When one auxiliary streams manually closed, could call this API to reopen. Result will call back through auxStreamOpenedEvent

    See

    see AuxStreamChangeEvent.auxStreamOpenedEvent

    Since

    2.0.0

    Declaration

    Swift

    public func openAuxStream(view: MediaRenderView)

    Parameters

    view

    the auxiliary display view.

    Return Value

    Void

  • Close one auxiliary stream with the indicated media render view. Result will call back throuhd auxStreamClosedEvent.

    See

    see AuxStreamChangeEvent.auxStreamClosedEvent

    Since

    2.0.0

    Declaration

    Swift

    public func closeAuxStream(view: MediaRenderView)

    Parameters

    view

    the auxiliary stream’s render view that will be closed.

    Return Value

    Void

  • This method is used to mute/unmute particular participant

    Since

    3.0.0

    Declaration

    Swift

    public func setParticipantAudioMuteState(participantId: String, isMuted: Bool)

    Parameters

    participantId

    The participant’s id who needs to be muted

    isMuted

    true to mute a call and false to un-mute a call

  • Mutes all other participants who are on call, also un-mutes the others if doMute is false

    Since

    3.0.0

    Declaration

    Swift

    public func setAllParticipantAudioMuteState(doMute: Bool)

    Parameters

    doMute

    true to mute a call and false to un-mute a call

  • Puts the call on hold or resume for the respective call id

    Since

    3.0.0

    Declaration

    Swift

    public func holdCall(putOnHold: Bool)

    Parameters

    putOnHold

    A boolean value that is used to hold and resume. To hold a call use true and to resume use false

  • This associates a new call with 3rd person. transferCall() needs to be called to transfer a call when a new call association is done,

    Since

    3.0.0

    Declaration

    Swift

    public func startAssociatedCall(dialNumber: String, associationType: CallAssociationType, isAudioCall: Bool, completionHandler: @escaping (Result<Call?>) -> Void)

    Parameters

    dialNumber

    New recipient’s cisco webex id or CUCM number who will be added on call

    associationType

    CallAssociationType.Transfer if call needs to be transferred

    isAudioCall

    true if association is Audio Type

    completionHandler

    A closure to be executed once the request has finished.

  • Transfers a call. This method needs to be called after startAssociatedCall()

    Since

    3.0.0

    Declaration

    Swift

    public func transferCall(toCallId: String)

    Parameters

    toCallId

    The new call id

  • Merges the two calls into one. This method needs to be called after startAssociatedCall()

    Since

    3.0.0

    Declaration

    Swift

    public func mergeCall(targetCallId: String)

    Parameters

    targetCallId

    The call id of the target call to be merged into