public class Camera.Parameters
extends Object
java.lang.Object | |
↳ | android.hardware.Camera.Parameters |
This class was deprecated in API level 21.
We recommend using the new android.hardware.camera2
API for new applications.
Camera service settings.
To make camera parameters take effect, applications have to call setParameters(Camera.Parameters)
.
For example, after setWhiteBalance(String)
is
called, white balance is not actually changed until setParameters(Camera.Parameters)
is
called with the changed parameters object.
让相机参数生效,利用程序必须调用setParameters(Camera.Parameters)。例如,在setWhiteBalance(String),白平衡实际上其实不是改变直到setParameters(Camera.Parameters)更改的参数对象。
Different devices may have different camera capabilities, such as picture size or flash modes. The application should query the camera capabilities before setting parameters. For example, the application should call getSupportedColorEffects()
before
calling setColorEffect(String)
. If the camera
does not support color effects, getSupportedColorEffects()
will
return null.
不同的装备有不同的相机功能,如图象大小或闪光模式。利用程序之前应当查询相机功能设置参数。例如,利用程序应当调用getSupportedColorEffects()调用之前setColorEffect(String)。如果相机不支持色彩效果,getSupportedColorEffects()将返回null。
Constants |
|
---|---|
String |
ANTIBANDING_50HZ
|
String |
ANTIBANDING_60HZ
|
String |
ANTIBANDING_AUTO
|
String |
ANTIBANDING_OFF
|
String |
EFFECT_AQUA
|
String |
EFFECT_BLACKBOARD
|
String |
EFFECT_MONO
|
String |
EFFECT_NEGATIVE
|
String |
EFFECT_NONE
|
String |
EFFECT_POSTERIZE
|
String |
EFFECT_SEPIA
|
String |
EFFECT_SOLARIZE
|
String |
EFFECT_WHITEBOARD
|
String |
FLASH_MODE_AUTO
Flash will be fired automatically when required. Flash在需要时将自动被解雇。 |
String |
FLASH_MODE_OFF
Flash will not be fired. Flash不会被解雇。 |
String |
FLASH_MODE_ON
Flash will always be fired during snapshot. Flash在快照总是会被解雇。 |
String |
FLASH_MODE_RED_EYE
Flash will be fired in red-eye reduction mode. Flash在减少红眼模式将被解雇。 |
String |
FLASH_MODE_TORCH
Constant emission of light during preview, auto-focus and snapshot. 常数光线发射在预览,自动对焦和快照。 |
int |
FOCUS_DISTANCE_FAR_INDEX
The array index of far focus distance for use with 焦点距离远的数组索引使用getFocusDistances(float[]). |
int |
FOCUS_DISTANCE_NEAR_INDEX
The array index of near focus distance for use with 焦点距离附近的数组索引使用getFocusDistances(float[])。 |
int |
FOCUS_DISTANCE_OPTIMAL_INDEX
The array index of optimal focus distance for use with 最好聚焦距离的数组索引使用getFocusDistances(float[])。 |
String |
FOCUS_MODE_AUTO
Auto-focus mode. 自动对焦模式。 |
String |
FOCUS_MODE_CONTINUOUS_PICTURE
Continuous auto focus mode intended for taking pictures. 连续自动对焦模式用于拍照。 |
String |
FOCUS_MODE_CONTINUOUS_VIDEO
Continuous auto focus mode intended for video recording. 连续自动对焦模式用于录相。 |
String |
FOCUS_MODE_EDOF
Extended depth of field (EDOF). 扩大景深(EDOF)。 |
String |
FOCUS_MODE_FIXED
Focus is fixed. 焦点是固定的。 |
String |
FOCUS_MODE_INFINITY
Focus is set at infinity. 焦点是无穷。 |
String |
FOCUS_MODE_MACRO
Macro (close-up) focus mode. |
int |
PREVIEW_FPS_MAX_INDEX
The array index of maximum preview fps for use with 最大预览fps的数组索引使用getPreviewFpsRange(int[])或getSupportedPreviewFpsRange()。 |
int |
PREVIEW_FPS_MIN_INDEX
The array index of minimum preview fps for use with 最低预览fps的数组索引使用getPreviewFpsRange(int[])或getSupportedPreviewFpsRange()。 |
String |
SCENE_MODE_ACTION
Take photos of fast moving objects. 拍摄快速移动的物体。 |
String |
SCENE_MODE_AUTO
Scene mode is off. 场景模式。 |
String |
SCENE_MODE_BARCODE
Applications are looking for a barcode. 利用程序正在寻觅1个条码。 |
String |
SCENE_MODE_BEACH
Take pictures on the beach. 在海滩上拍照。 |
String |
SCENE_MODE_CANDLELIGHT
Capture the naturally warm color of scenes lit by candles. 捕捉场景的自然暖色点燃烛炬。 |
String |
SCENE_MODE_FIREWORKS
For shooting firework displays. 拍摄焰火表演。 |
String |
SCENE_MODE_HDR
Capture a scene using high dynamic range imaging techniques. 使用高动态范围成像技术捕捉1个场景。 |
String |
SCENE_MODE_LANDSCAPE
Take pictures on distant objects. 拍摄远处的物体。 |
String |
SCENE_MODE_NIGHT
Take photos at night. 晚上拍照。 |
String |
SCENE_MODE_NIGHT_PORTRAIT
Take people pictures at night. 晚上拍摄人物照片。 |
String |
SCENE_MODE_PARTY
Take indoor low-light shot. 室内光线拍摄。 |
String |
SCENE_MODE_PORTRAIT
Take people pictures. 人们拍摄照片。 |
String |
SCENE_MODE_SNOW
Take pictures on the snow. 在雪地里拍照。 |
String |
SCENE_MODE_SPORTS
Take photos of fast moving objects. 拍摄快速移动的物体。 |
String |
SCENE_MODE_STEADYPHOTO
Avoid blurry pictures (for example, due to hand shake). 避免模糊的图片(例如,由于握手)。 |
String |
SCENE_MODE_SUNSET
Take sunset photos. 日落的照片。 |
String |
SCENE_MODE_THEATRE
Take photos in a theater. 在剧院拍照。 |
String |
WHITE_BALANCE_AUTO
|
String |
WHITE_BALANCE_CLOUDY_DAYLIGHT
|
String |
WHITE_BALANCE_DAYLIGHT
|
String |
WHITE_BALANCE_FLUORESCENT
|
String |
WHITE_BALANCE_INCANDESCENT
|
String |
WHITE_BALANCE_SHADE
|
String |
WHITE_BALANCE_TWILIGHT
|
String |
WHITE_BALANCE_WARM_FLUORESCENT
|
Public methods |
|
---|---|
String |
flatten()
Creates a single string with all the parameters set in this Parameters object. |
String |
get(String key)
Returns the value of a String parameter. |
String |
getAntibanding()
Gets the current antibanding setting. |
boolean |
getAutoExposureLock()
Gets the state of the auto-exposure lock. |
boolean |
getAutoWhiteBalanceLock()
Gets the state of the auto-white balance lock. |
String |
getColorEffect()
Gets the current color effect setting. |
int |
getExposureCompensation()
Gets the current exposure compensation index. |
float |
getExposureCompensationStep()
Gets the exposure compensation step. |
String |
getFlashMode()
Gets the current flash mode setting. |
float |
getFocalLength()
Gets the focal length (in millimeter) of the camera. |
List<Camera.Area> |
getFocusAreas()
Gets the current focus areas. |
void |
getFocusDistances(float[] output)
Gets the distances from the camera to where an object appears to be in focus. |
String |
getFocusMode()
Gets the current focus mode setting. |
float |
getHorizontalViewAngle()
Gets the horizontal angle of view in degrees. |
int |
getInt(String key)
Returns the value of an integer parameter. |
int |
getJpegQuality()
Returns the quality setting for the JPEG picture. |
int |
getJpegThumbnailQuality()
Returns the quality setting for the EXIF thumbnail in Jpeg picture. |
Camera.Size |
getJpegThumbnailSize()
Returns the dimensions for EXIF thumbnail in Jpeg picture. |
int |
getMaxExposureCompensation()
Gets the maximum exposure compensation index. |
int |
getMaxNumDetectedFaces()
Gets the maximum number of detected faces supported. |
int |
getMaxNumFocusAreas()
Gets the maximum number of focus areas supported. |
int |
getMaxNumMeteringAreas()
Gets the maximum number of metering areas supported. |
int |
getMaxZoom()
Gets the maximum zoom value allowed for snapshot. |
List<Camera.Area> |
getMeteringAreas()
Gets the current metering areas. |
int |
getMinExposureCompensation()
Gets the minimum exposure compensation index. |
int |
getPictureFormat()
Returns the image format for pictures. |
Camera.Size |
getPictureSize()
Returns the dimension setting for pictures. |
Camera.Size |
getPreferredPreviewSizeForVideo()
Returns the preferred or recommended preview size (width and height) in pixels for video recording. |
int |
getPreviewFormat()
Returns the image format for preview frames got from |
void |
getPreviewFpsRange(int[] range)
Returns the current minimum and maximum preview fps. |
int |
getPreviewFrameRate()
This method was deprecated in API level 9. replaced by |
Camera.Size |
getPreviewSize()
Returns the dimensions setting for preview pictures. |
String |
getSceneMode()
Gets the current scene mode setting. |
List<String> |
getSupportedAntibanding()
Gets the supported antibanding values. |
List<String> |
getSupportedColorEffects()
Gets the supported color effects. |
List<String> |
getSupportedFlashModes()
Gets the supported flash modes. |
List<String> |
getSupportedFocusModes()
Gets the supported focus modes. |
List<Camera.Size> |
getSupportedJpegThumbnailSizes()
Gets the supported jpeg thumbnail sizes. |
List<Integer> |
getSupportedPictureFormats()
Gets the supported picture formats. |
List<Camera.Size> |
getSupportedPictureSizes()
Gets the supported picture sizes. |
List<Integer> |
getSupportedPreviewFormats()
Gets the supported preview formats. |
List<int[]> |
getSupportedPreviewFpsRange()
Gets the supported preview fps (frame-per-second) ranges. |
List<Integer> |
getSupportedPreviewFrameRates()
This method was deprecated in API level 9. replaced by |
List<Camera.Size> |
getSupportedPreviewSizes()
Gets the supported preview sizes. |
List<String> |
getSupportedSceneModes()
Gets the supported scene modes. |
List<Camera.Size> |
getSupportedVideoSizes()
Gets the supported video frame sizes that can be used by MediaRecorder. |
List<String> |
getSupportedWhiteBalance()
Gets the supported white balance. |
float |
getVerticalViewAngle()
Gets the vertical angle of view in degrees. |
boolean |
getVideoStabilization()
Get the current state of video stabilization. |
String |
getWhiteBalance()
Gets the current white balance setting. |
int |
getZoom()
Gets current zoom value. |
List<Integer> |
getZoomRatios()
Gets the zoom ratios of all zoom values. |
boolean |
isAutoExposureLockSupported()
Returns true if auto-exposure locking is supported. |
boolean |
isAutoWhiteBalanceLockSupported()
Returns true if auto-white balance locking is supported. |
boolean |
isSmoothZoomSupported()
Returns true if smooth zoom is supported. |
boolean |
isVideoSnapshotSupported()
Returns true if video snapshot is supported. |