com.otaliastudios.cameraview

Class CameraListener

java.lang.Object

com.otaliastudios.cameraview.CameraListener

public abstract class CameraListener
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
CameraListener()

Method Summary

Modifier and Type	Method and Description
void	onCameraClosed() Notifies that the camera session was closed.
void	onCameraError(CameraException exception) Notifies about an error during the camera setup or configuration.
void	onCameraOpened(CameraOptions options) Notifies that the camera was opened.
void	onExposureCorrectionChanged(float newValue, float[] bounds, android.graphics.PointF[] fingers) Noitifies that a finger gesture just caused the camera exposure correction to be changed.
void	onFocusEnd(boolean successful, android.graphics.PointF point) Notifies that a gesture focus event just ended, and the camera converged to a new focus (and possibly exposure and white balance).
void	onFocusStart(android.graphics.PointF point) Notifies that user interacted with the screen and started focus with a gesture, and the autofocus is trying to focus around that area.
void	onOrientationChanged(int orientation) Notifies that the device was tilted or the window offset changed.
void	onPictureTaken(byte[] jpeg) Notifies that a picture previously captured with CameraView.capturePicture() or CameraView.captureSnapshot() is ready to be shown or saved.
void	onVideoTaken(java.io.File video) Notifies that a video capture has just ended.
void	onZoomChanged(float newValue, float[] bounds, android.graphics.PointF[] fingers) Noitifies that a finger gesture just caused the camera zoom to be changed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CameraListener

public CameraListener()

Method Detail

onCameraOpened

@UiThread
public void onCameraOpened(CameraOptions options)

Notifies that the camera was opened. The CameraOptions object collects all supported options by the current camera.

Parameters:

options - camera supported options

onCameraClosed

@UiThread
public void onCameraClosed()

Notifies that the camera session was closed.

onCameraError

@UiThread
public void onCameraError(@NonNull
                                    CameraException exception)

Notifies about an error during the camera setup or configuration. At the moment, errors that are passed here are unrecoverable. When this is called, the camera has been released and is presumably showing a black preview. This is the right moment to show an error dialog to the user. You can try calling start() again, but that is not guaranteed to work - if it doesn't, this callback will be invoked again. In the future, more information will be passed through the CameraException instance.

Parameters:

exception - the error

onPictureTaken

@UiThread
public void onPictureTaken(byte[] jpeg)

Notifies that a picture previously captured with CameraView.capturePicture() or CameraView.captureSnapshot() is ready to be shown or saved. If planning to get a bitmap, you can use CameraUtils.decodeBitmap(byte[], CameraUtils.BitmapCallback) to decode the byte array taking care about orientation.

Parameters:

jpeg - captured picture

onVideoTaken

@UiThread
public void onVideoTaken(java.io.File video)

Notifies that a video capture has just ended. The file parameter is the one that was passed to CameraView.startCapturingVideo(File), if any. If not, the camera fallsback to: new File(getContext().getExternalFilesDir(null), "video.mp4");

Parameters:

video - file hosting the mp4 video

onOrientationChanged

@UiThread
public void onOrientationChanged(int orientation)

Notifies that the device was tilted or the window offset changed. The orientation passed is exactly the counter-clockwise rotation that a View should have, in order to appear correctly oriented to the user, considering the way she is holding the device, and the native activity orientation. This is meant to be used for aligning views (e.g. buttons) to the current camera viewport.

Parameters:

orientation - either 0, 90, 180 or 270

onFocusStart

@UiThread
public void onFocusStart(android.graphics.PointF point)

Notifies that user interacted with the screen and started focus with a gesture, and the autofocus is trying to focus around that area. This can be used to draw things on screen. Can also be triggered by CameraView.startAutoFocus(float, float).

Parameters:

point - coordinates with respect to CameraView.getWidth() and CameraView.getHeight()

onFocusEnd

@UiThread
public void onFocusEnd(boolean successful,
                                 android.graphics.PointF point)

Notifies that a gesture focus event just ended, and the camera converged to a new focus (and possibly exposure and white balance). This might succeed or not. Can also be triggered by CameraView.startAutoFocus(float, float).

Parameters:

successful - whether camera succeeded

point - coordinates with respect to CameraView.getWidth() and CameraView.getHeight()

onZoomChanged

@UiThread
public void onZoomChanged(float newValue,
                                    float[] bounds,
                                    android.graphics.PointF[] fingers)

Noitifies that a finger gesture just caused the camera zoom to be changed. This can be used to draw, for example, a seek bar.

Parameters:

newValue - the new zoom value

bounds - min and max bounds for newValue (fixed to 0 ... 1)

fingers - finger positions that caused the event

onExposureCorrectionChanged

@UiThread
public void onExposureCorrectionChanged(float newValue,
                                                  float[] bounds,
                                                  android.graphics.PointF[] fingers)

Noitifies that a finger gesture just caused the camera exposure correction to be changed. This can be used to draw, for example, a seek bar.

Parameters:

newValue - the new correction value

bounds - min and max bounds for newValue, as returned by CameraOptions

fingers - finger positions that caused the event