VideoCall

registerCallback

abstract fun registerCallback(callback: InCallService.VideoCall.Callback!): Unit

Registers a callback to receive commands and state changes for video calls.

registerCallback

abstract fun registerCallback(
    callback: InCallService.VideoCall.Callback!, 
    handler: Handler!
): Unit

Registers a callback to receive commands and state changes for video calls.

requestCallDataUsage

abstract fun requestCallDataUsage(): Unit

Issues a request to the Connection.VideoProvider to retrieve the cumulative data usage for the video component of the current call (in bytes). Data usage is reported to the caller via VideoCall.Callback#onCallDataUsageChanged.

Handled by Connection.VideoProvider.onRequestConnectionDataUsage().

requestCameraCapabilities

abstract fun requestCameraCapabilities(): Unit

Issues a request to the Connection.VideoProvider to retrieve the capabilities of the current camera. The current camera is selected using VideoCall.setCamera(String).

Camera capabilities are reported to the caller via VideoCall.Callback#onCameraCapabilitiesChanged(VideoProfile.CameraCapabilities).

Handled by Connection.VideoProvider.onRequestCameraCapabilities().

sendSessionModifyRequest

abstract fun sendSessionModifyRequest(requestProfile: VideoProfile!): Unit

Issues a request to modify the properties of the current video session.

Example scenarios include: requesting an audio-only call to be upgraded to a bi-directional video call, turning on or off the user's camera, sending a pause signal when the InCallService is no longer the foreground application.

Handled by Connection.VideoProvider.onSendSessionModifyRequest(VideoProfile, VideoProfile).

sendSessionModifyResponse

abstract fun sendSessionModifyResponse(responseProfile: VideoProfile!): Unit

Provides a response to a request to change the current call video session properties. This should be called in response to a request the InCallService has received via VideoCall.Callback#onSessionModifyRequestReceived.

Handled by Connection.VideoProvider.onSendSessionModifyResponse(VideoProfile).

setCamera

abstract fun setCamera(cameraId: String!): Unit

Sets the camera to be used for the outgoing video.

Handled by Connection.VideoProvider.onSetCamera(String).

setDeviceOrientation

abstract fun setDeviceOrientation(rotation: Int): Unit

Sets the device orientation, in degrees. Assumes that a standard portrait orientation of the device is 0 degrees.

Handled by Connection.VideoProvider.onSetDeviceOrientation(int).

setDisplaySurface

abstract fun setDisplaySurface(surface: Surface!): Unit

Sets the surface to be used for displaying the video received from the remote device.

Handled by Connection.VideoProvider.onSetDisplaySurface(Surface).

setPauseImage

abstract fun setPauseImage(uri: Uri!): Unit

Provides the Connection.VideoProvider with the Uri of an image to be displayed to the peer device when the video signal is paused.

Handled by Connection.VideoProvider.onSetPauseImage(Uri).

setPreviewSurface

abstract fun setPreviewSurface(surface: Surface!): Unit

Sets the surface to be used for displaying a preview of what the user's camera is currently capturing. When video transmission is enabled, this is the video signal which is sent to the remote device.

Handled by Connection.VideoProvider.onSetPreviewSurface(Surface).

setZoom

abstract fun setZoom(value: Float): Unit

Sets the camera zoom ratio.

Handled by Connection.VideoProvider.onSetZoom(float).

unregisterCallback

abstract fun unregisterCallback(callback: InCallService.VideoCall.Callback!): Unit

Clears the video call callback set via #registerCallback.