java.lang.Object | |
↳ | com.google.android.gms.vision.CameraSource |
Manages the camera in conjunction with an underlying Detector
. This receives preview
frames from the camera at a specified rate, sending those frames to the detector as fast as it is
able to process those frames.
This camera source makes a best effort to manage processing on preview frames as fast as
possible, while at the same time minimizing lag. As such, frames may be dropped if the detector
is unable to keep up with the rate of frames generated by the camera. You should use setRequestedFps(float)
to specify a frame rate that works well with the
capabilities of the camera hardware and the detector options that you have selected. If CPU
utilization is higher than you'd like, then you may want to consider reducing FPS. If the camera
preview or detector results are too "jerky", then you may want to consider increasing FPS.
The following Android permission is required to use the camera:
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CameraSource.Builder | Builder for configuring and creating an associated camera source. | ||||||||||
CameraSource.PictureCallback | Callback interface used to supply image data from a photo capture. | ||||||||||
CameraSource.ShutterCallback | Callback interface used to signal the moment of actual image capture. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | CAMERA_FACING_BACK | ||||||||||
int | CAMERA_FACING_FRONT |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns the selected camera; one of
CAMERA_FACING_BACK or CAMERA_FACING_FRONT . | |||||||||||
Returns the preview size that is currently in use by the underlying camera.
| |||||||||||
Stops the camera and releases the resources of the camera and underlying detector.
| |||||||||||
Opens the camera and starts sending preview frames to the underlying detector.
| |||||||||||
Opens the camera and starts sending preview frames to the underlying detector.
| |||||||||||
Closes the camera and stops sending frames to the underlying frame detector.
| |||||||||||
Initiates taking a picture, which happens asynchronously.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Returns the selected camera; one of CAMERA_FACING_BACK
or CAMERA_FACING_FRONT
.
Returns | |
---|---|
int |
Returns the preview size that is currently in use by the underlying camera.
Returns | |
---|---|
Size |
Stops the camera and releases the resources of the camera and underlying detector.
Opens the camera and starts sending preview frames to the underlying detector. The supplied surface holder is used for the preview so frames can be displayed to the user.
Parameters | |
---|---|
surfaceHolder |
SurfaceHolder :
the surface holder to use for the preview frames |
Returns | |
---|---|
CameraSource |
Throws | |
---|---|
IOException |
if the supplied surface holder could not be used as the preview display |
Opens the camera and starts sending preview frames to the underlying detector. The preview frames are not displayed.
Returns | |
---|---|
CameraSource |
Throws | |
---|---|
IOException |
if the camera's preview texture or display could not be initialized |
Closes the camera and stops sending frames to the underlying frame detector.
This camera source may be restarted again by calling start()
or start(SurfaceHolder)
.
Call release()
instead to completely shut down this camera source and release the
resources of the underlying detector.
Initiates taking a picture, which happens asynchronously. The camera source should have been
activated previously with start()
or start(SurfaceHolder)
. The camera preview
is suspended while the picture is being taken, but will resume once picture taking is done.
Parameters | |
---|---|
shutter |
CameraSource.ShutterCallback :
the callback for image capture moment, or null |
jpeg |
CameraSource.PictureCallback :
the callback for JPEG image data, or null
|