public
static
abstract
class
InCallService.VideoCall
extends Object
| java.lang.Object | |
| ↳ | android.telecom.InCallService.VideoCall |
Used to issue commands to the Connection.VideoProvider associated with a
Call.
Nested classes | |
|---|---|
class |
InCallService.VideoCall.Callback
The |
Public constructors | |
|---|---|
InCallService.VideoCall()
|
|
Public methods | |
|---|---|
abstract
void
|
registerCallback(InCallService.VideoCall.Callback callback, Handler handler)
Registers a callback to receive commands and state changes for video calls. |
abstract
void
|
registerCallback(InCallService.VideoCall.Callback callback)
Registers a callback to receive commands and state changes for video calls. |
abstract
void
|
requestCallDataUsage()
Issues a request to the |
abstract
void
|
requestCameraCapabilities()
Issues a request to the |
abstract
void
|
sendSessionModifyRequest(VideoProfile requestProfile)
Issues a request to modify the properties of the current video session. |
abstract
void
|
sendSessionModifyResponse(VideoProfile responseProfile)
Provides a response to a request to change the current call video session properties. |
abstract
void
|
setCamera(String cameraId)
Sets the camera to be used for the outgoing video. |
abstract
void
|
setDeviceOrientation(int rotation)
Sets the device orientation, in degrees. |
abstract
void
|
setDisplaySurface(Surface surface)
Sets the surface to be used for displaying the video received from the remote device. |
abstract
void
|
setPauseImage(Uri uri)
Provides the |
abstract
void
|
setPreviewSurface(Surface surface)
Sets the surface to be used for displaying a preview of what the user's camera is currently capturing. |
abstract
void
|
setZoom(float value)
Sets camera zoom ratio. |
abstract
void
|
unregisterCallback(InCallService.VideoCall.Callback callback)
Clears the video call callback set via |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
void registerCallback (InCallService.VideoCall.Callback callback, Handler handler)
Registers a callback to receive commands and state changes for video calls.
| Parameters | |
|---|---|
callback |
InCallService.VideoCall.Callback:
The video call callback. |
handler |
Handler:
A handler which commands and status changes will be delivered to.
|
void registerCallback (InCallService.VideoCall.Callback callback)
Registers a callback to receive commands and state changes for video calls.
| Parameters | |
|---|---|
callback |
InCallService.VideoCall.Callback:
The video call callback.
|
void requestCallDataUsage ()
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 onCallDataUsageChanged(long).
Handled by onRequestConnectionDataUsage().
void requestCameraCapabilities ()
Issues a request to the Connection.VideoProvider to retrieve the capabilities
of the current camera. The current camera is selected using
setCamera(String).
Camera capabilities are reported to the caller via
onCameraCapabilitiesChanged(VideoProfile.CameraCapabilities).
Handled by onRequestCameraCapabilities().
void sendSessionModifyRequest (VideoProfile requestProfile)
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
onSendSessionModifyRequest(VideoProfile, VideoProfile).
| Parameters | |
|---|---|
requestProfile |
VideoProfile:
The requested call video properties.
|
void sendSessionModifyResponse (VideoProfile responseProfile)
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 onSessionModifyRequestReceived(VideoProfile).
Handled by
onSendSessionModifyResponse(VideoProfile).
| Parameters | |
|---|---|
responseProfile |
VideoProfile:
The response call video properties.
|
void setCamera (String cameraId)
Sets the camera to be used for the outgoing video.
Handled by onSetCamera(String).
| Parameters | |
|---|---|
cameraId |
String:
The id of the camera (use ids as reported by
getCameraIdList()).
|
void setDeviceOrientation (int rotation)
Sets the device orientation, in degrees. Assumes that a standard portrait orientation of the device is 0 degrees.
Handled by onSetDeviceOrientation(int).
| Parameters | |
|---|---|
rotation |
int:
The device orientation, in degrees.
|
void setDisplaySurface (Surface surface)
Sets the surface to be used for displaying the video received from the remote device.
Handled by onSetDisplaySurface(Surface).
| Parameters | |
|---|---|
surface |
Surface:
The Surface.
|
void setPauseImage (Uri uri)
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 onSetPauseImage(Uri).
| Parameters | |
|---|---|
uri |
Uri:
URI of image to display.
|
void setPreviewSurface (Surface surface)
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 onSetPreviewSurface(Surface).
| Parameters | |
|---|---|
surface |
Surface:
The Surface.
|
void setZoom (float value)
Sets camera zoom ratio.
Handled by onSetZoom(float).
| Parameters | |
|---|---|
value |
float:
The camera zoom ratio.
|
void unregisterCallback (InCallService.VideoCall.Callback callback)
Clears the video call callback set via registerCallback(InCallService.VideoCall.Callback).
| Parameters | |
|---|---|
callback |
InCallService.VideoCall.Callback:
The video call callback to clear.
|
Developers