1. References
  2. Android SDK
  3. hardware
  4. ICameraManager
Rate this page:

ICameraManager

Interface that provides API to manage cameras on an Android device.

Methods

addCameraEventsListener

Copy URL
void
 addCameraEventsListener(
ICameraEventsListener
 cameraEventsListener)

Adds an ICameraEventsListener to be notified about camera events

Parameters

Returns

  • type:

    void

enableCameraFlash

Since ver. 2.18.0
Copy URL
void
 enableCameraFlash(
boolean
 enable)

Whether to enable camera flash if it exists.

Camera flash is disabled by default.

Can be called in any camera state.

Parameters

  • enable:

    boolean

    True, if the camera flash should be enabled.

Returns

  • type:

    void

getCameraDeviceNames

Copy URL
String[]
 getCameraDeviceNames()

Gets available camera device names.

Returns

  • type:

    String[]

getCameraSupportedResolutions

Copy URL
List<CameraResolution>
 getCameraSupportedResolutions(
String
 cameraName)

Gets all supported resolutions of the specified camera.

Parameters

  • cameraName:

    String

    Camera name to request supported resolutions

Returns

removeCameraEventsListener

Copy URL
void
 removeCameraEventsListener(
ICameraEventsListener
 cameraEventsListener)

Removes a previously added ICameraEventsListener

Parameters

Returns

  • type:

    void

setCamera

Copy URL
void
 setCamera(
int
 cameraIndex, 
VideoQuality
 quality)

Selects a camera and the local video frame resolution quality.

Parameters

  • cameraIndex:

    int

    Should be 0 for a back facing camera and 1 for a front facing camera

  • quality:

    VideoQuality

    Quality for local video

Returns

  • type:

    void

Throws

IllegalArgumentException if a camera with the specified index does not exist on the device

setCamera

Since ver. 2.30.0
Copy URL
void
 setCamera(
String
 cameraName, 
VideoQuality
 quality)

Selects a camera and the local video frame resolution quality.

Limitation for SDK versions below 2.41.0:

If a camera is open and is currently capturing the video, it is not possible to switch to another camera of the same type. If no camera is used at the moment, it is possible to select any camera and the selected camera starts in a video call.

For example, if a device has multiple back cameras and one of them is currently capturing the video in a call, it is not possible to switch to another back camera. The same is applied to a front facing cameras. However, it is allowed to change an active back camera to front camera with a specific name (or vice verse).

Parameters

  • cameraName:

    String

    Camera name from the list of available cameras on a device

  • quality:

    VideoQuality

    Quality for local video

Returns

  • type:

    void

Throws

IllegalArgumentException if a camera with the specified name does not exist on a device

setCamera

Copy URL
void
 setCamera(
int
 cameraIndex, 
int
 frameWidth, 
int
 frameHeight)

Selects a camera and the local video frame resolution.

The camera captures frames in a format that is as close as possible to frameWidth x frameHeight

Parameters

  • cameraIndex:

    int

    Should be 0 for a back facing camera or 1 for a front facing camera

  • frameWidth:

    int

    Camera resolution width.

  • frameHeight:

    int

    Camera resolution height

Returns

  • type:

    void

Throws

IllegalArgumentException if a camera with the specified index does not exist on the device

setCamera

Since ver. 2.30.0
Copy URL
void
 setCamera(
String
 cameraName, 
int
 frameWidth, 
int
 frameHeight)

Selects a camera and the local video frame resolution.

Camera captures frames in a format that is as close as possible to frameWidth x frameHeight

Limitation for SDK versions below 2.41.0:

If a camera is open and is currently capturing the video, it is not possible to switch to another camera of the same type. If no camera is used at the moment, it is possible to select any camera and the selected camera starts in a video call.

For example, if a device has multiple back cameras and one of them is currently capturing the video in a call, it is not possible to switch to another back camera. The same is applied to a front facing cameras. However, it is allowed to change an active back camera to front camera with a specific name (or vice verse).

Parameters

  • cameraName:

    String

    Camera name from the list of available cameras on a device

  • frameWidth:

    int

    Camera resolution width

  • frameHeight:

    int

    Camera resolution height

Returns

  • type:

    void

Throws

IllegalArgumentException if a camera with the specified name does not exist on a device

useOrientationEventListener

Since ver. 2.26.0
Copy URL
void
 useOrientationEventListener(
boolean
 use)

Enables OrientationEventListener to detect the device rotation and to rotate camera frames according to device orientation.

By default, display rotation is used to determine the device rotation.

The way how the device orientation is detected, affects camera frames rotation on local and remote side if auto-rotate is disabled on a mobile phone:

  • OrientationEventListener detects landscape orientation
  • Display rotation always reports portrait orientation

The method should be called in idle camera state, i.e. video is currently not sending in a call.

Parameters

  • use:

    boolean

    True, if OrientationEventListener should be used to detect the device orientation, otherwise Display rotation is used.

Returns

  • type:

    void