1. References
  2. Android SDK v3
  3. com.voximplant.android.sdk.calls
  4. Call
Rate this page:

Call

Methods

answer

Copy URL
@Throws(CallException)
fun answer(callSettings: 
CallSettings
): 
Unit

Answers the call. Should be used only for incoming calls.

Parameters

  • callSettings:

    CallSettings

    Call settings with additional call parameters, such as preferred video codec, custom data, extra headers etc.

Returns

  • type:

    Unit

Throws

CallException if the call is already answered or RECORD_AUDIO permission is not granted.

hangup

Copy URL
fun hangup(headers: 
Map<String, String>?
): 
Unit

Hangs up the call.

Parameters

  • headers:

    Map<String, String>?

    Optional

    Optional set of headers to be sent to the Voximplant Cloud. Names should begin with "X-" to be processed by SDK

Returns

  • type:

    Unit

hold

Copy URL
fun hold(enable: 
Boolean
, callback: 
CallCallback?
): 
Unit

Holds or unholds the call.

Parameters

  • enable:

    Boolean

    Whether to put the call on hold

  • callback:

    CallCallback?

    Optional

    Object to receive the result of this operation

Returns

  • type:

    Unit

muteAudio

Copy URL
fun muteAudio(muted: 
Boolean
): 
Unit

Enables or disables audio from microphone into the call.

Parameters

  • muted:

    Boolean

    Whether to mute the microphone

Returns

  • type:

    Unit

reject

Copy URL
@Throws(CallException)
fun reject(mode: 
RejectMode
, headers: 
Map<String, String>?
): 
Unit

Rejects the call. Should be used only for incoming calls.

Parameters

  • mode:

    RejectMode

    RejectMode

  • headers:

    Map<String, String>?

    Optional

    Optional set of headers to be sent to the Voximplant Cloud. Names should begin with "X-" to be processed by SDK

Returns

  • type:

    Unit

Throws

CallException if the call is already answered or ended

sendDTMF

Copy URL
fun sendDTMF(tone: 
String
): 
Unit

Sends DTMF tones to the call.

Parameters

  • tone:

    String

    DTMF tones

Returns

  • type:

    Unit

sendInfo

Copy URL
fun sendInfo(mimeType: 
String
, content: 
String
, headers: 
Map<String, String>?
): 
Unit

Sends an INFO message within the call.

Parameters

  • mimeType:

    String

    MIME type of info

  • content:

    String

    Custom string data

  • headers:

    Map<String, String>?

    Optional

    Optional set of headers to be sent with message. Names should begin with "X-" to be processed by SDK

Returns

  • type:

    Unit

sendMessage

Copy URL
fun sendMessage(text: 
String
): 
Unit

Sends a message within the call.

Implemented atop SIP INFO for communication between call endpoint and Voximplant cloud, and is separated from Voximplant messaging API.

Parameters

  • text:

    String

    Message text

Returns

  • type:

    Unit

setCallListener

Copy URL
fun setCallListener(listener: 
CallListener?
): 
Unit

Sets a listener to be notified of the call events

Parameters

  • listener:

    CallListener?

    Optional

    The listener to be notified of call events. If null, previously set listener is removed.

Returns

  • type:

    Unit

setQualityIssueListener

Copy URL
fun setQualityIssueListener(listener: 
QualityIssueListener?
): 
Unit

Sets QualityIssueListener to monitor issues that affect call quality.

Parameters

Returns

  • type:

    Unit

start

Copy URL
@Throws(CallException)
fun start(): 
Unit

Starts the outgoing call.

Returns

  • type:

    Unit

Throws

CallException if the call is already started, if RECORD_AUDIO (for audio and video call) or CAMERA (for video call) permissions are not granted, if the method is called for incoming call.

startSendingVideo

Copy URL
fun startSendingVideo(videoStream: 
LocalVideoStream
, callback: 
CallCallback?
): 
Unit

Starts sending video in the call.

Parameters

  • videoStream:

    LocalVideoStream

    Video stream to be sent within the call

  • callback:

    CallCallback?

    Optional

    Object to receive the result of this operation

Returns

  • type:

    Unit

stopSendingVideo

Copy URL
fun stopSendingVideo(callback: 
CallCallback?
): 
Unit

Stops sending video in the call.

If the operation is completed successfully, you must close the local video stream that has been previously used to send the video. Otherwise the video resources are not released.

Parameters

  • callback:

    CallCallback?

    Optional

    Object to receive the result of this operation

Returns

  • type:

    Unit

toString

Copy URL
fun toString(): 
String

Returns

  • type:

    String

Props

currentQualityIssues

Copy URL
val currentQualityIssues: 
Map<QualityIssue, QualityIssueLevel>

The current status for all quality issues.

Returns

direction

Copy URL
val direction: 
CallDirection

Whether the call is incoming or outgoing.

Returns

duration

Copy URL
val duration: 
Long

The call duration in milliseconds.

Returns

  • type:

    Long

id

Copy URL
val id: 
String

The call id.

Returns

  • type:

    String

isMuted

Copy URL
var isMuted: 
Boolean

Whether the user's microphone is muted. You can change this state via Call.muteAudio.

Returns

  • type:

    Boolean

isVideoEnabled

Copy URL
val isVideoEnabled: 
Boolean

Whether video is enabled in the call. True if video send or receive is enabled by current user, false otherwise.

Returns

  • type:

    Boolean

localVideoStream

Copy URL
val localVideoStream: 
LocalVideoStream?

Outgoing video stream during the call or null if the local video is disabled.

Returns

number

Copy URL
val number: 
String

Specifies the number used to make outgoing call.

Returns

  • type:

    String

remoteDisplayName

Copy URL
val remoteDisplayName: 
String?

The participant's display name.

For incoming calls it is available immediately, for outgoing calls it is available after the CallListener.onCallConnected event.

Returns

  • type:

    String?

remoteSipUri

Copy URL
val remoteSipUri: 
String?

The participant SIP URI.

For incoming calls it is available immediately, for outgoing calls it is available after the CallListener.onCallConnected event.

Returns

  • type:

    String?

remoteVideoStreams

Copy URL
val remoteVideoStreams: 
List<RemoteVideoStream>

The list of remote video streams.

Returns

state

Copy URL
val state: 
CallState

The call state.

Returns