Camera.Parameters

ANTIBANDING_50HZ

String ANTIBANDING_50HZ

常数值：“50hz”

ANTIBANDING_60HZ

String ANTIBANDING_60HZ

常数值：“60hz”

ANTIBANDING_AUTO

String ANTIBANDING_AUTO

常数值：“自动”

ANTIBANDING_OFF

String ANTIBANDING_OFF

常数值：“off”

EFFECT_AQUA

String EFFECT_AQUA

常数值：“aqua”

EFFECT_BLACKBOARD

String EFFECT_BLACKBOARD

常数值：“黑板”

EFFECT_MONO

String EFFECT_MONO

常数值：“单声道”

EFFECT_NEGATIVE

String EFFECT_NEGATIVE

常数值：“负值”

EFFECT_NONE

String EFFECT_NONE

常数值：“无”

EFFECT_POSTERIZE

String EFFECT_POSTERIZE

常数值：“posterize”

EFFECT_SEPIA

String EFFECT_SEPIA

常数值：“棕褐色”

EFFECT_SOLARIZE

String EFFECT_SOLARIZE

常数值：“solarize”

EFFECT_WHITEBOARD

String EFFECT_WHITEBOARD

常数值：“白板”

FLASH_MODE_AUTO

String FLASH_MODE_AUTO

Flash会在需要时自动启动。 在预览，自动对焦或快照期间，闪光灯可能会被触发，具体取决于驱动程序。

常数值：“自动”

FLASH_MODE_OFF

String FLASH_MODE_OFF

Flash不会被解雇。

常数值：“off”

FLASH_MODE_ON

String FLASH_MODE_ON

快照期间，Flash将始终被触发。 根据驱动程序的不同，预览或自动对焦期间也可能会触发闪光灯。

常数值：“on”

FLASH_MODE_RED_EYE

String FLASH_MODE_RED_EYE

闪光灯将在消除红眼模式下闪光。

恒定值：“红眼”

FLASH_MODE_TORCH

String FLASH_MODE_TORCH

在预览，自动对焦和快照期间持续发光。 这也可以用于录像。

常值：“火炬”

FOCUS_DISTANCE_FAR_INDEX

int FOCUS_DISTANCE_FAR_INDEX

与 getFocusDistances(float[])一起使用的远焦距阵列索引。

常量值：2（0x00000002）

FOCUS_DISTANCE_NEAR_INDEX

int FOCUS_DISTANCE_NEAR_INDEX

用于 getFocusDistances(float[])的近焦距阵列索引。

常量值：0（0x00000000）

FOCUS_DISTANCE_OPTIMAL_INDEX

int FOCUS_DISTANCE_OPTIMAL_INDEX

与 getFocusDistances(float[])一起使用的最佳焦点距离阵列索引。

常数值：1（0x00000001）

FOCUS_MODE_AUTO

String FOCUS_MODE_AUTO

自动对焦模式。 应用程序应该调用autoFocus(AutoFocusCallback)以在此模式下启动焦点。

常数值：“自动”

FOCUS_MODE_CONTINUOUS_PICTURE

String FOCUS_MODE_CONTINUOUS_PICTURE

连续自动对焦模式用于拍摄照片。 相机不断尝试对焦。 焦点变化的速度比FOCUS_MODE_CONTINUOUS_VIDEO更具侵略性。 自动对焦在参数设置时开始。

应用程序可以在此模式下调用autoFocus(AutoFocusCallback) 。 如果自动对焦正在扫描中，则焦点回调将在完成时返回。 如果自动对焦未扫描，焦点回调将立即返回一个布尔值，指示焦点是否清晰。 应用程序可以决定是要立即拍摄照片还是将对焦模式更改为自动，并运行完整的自动对焦周期。 自动对焦后，焦点位置锁定。 如果应用程序想要恢复连续对焦，则必须调用cancelAutoFocus。 重新启动预览将不会恢复连续的自动对焦。 要停止连续对焦，应用程序应将对焦模式更改为其他模式。

常数值：“连续图片”

FOCUS_MODE_CONTINUOUS_VIDEO

String FOCUS_MODE_CONTINUOUS_VIDEO

适用于视频录制的连续自动对焦模式。 相机不断尝试对焦。 这是视频录制的最佳选择，因为焦点变化平稳。 应用程序仍然可以在此模式下调用takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback) ，但主题可能不重点。 自动对焦在参数设置时开始。

由于API级别14，应用程序可以在此模式下调用autoFocus(AutoFocusCallback) 。 焦点回调将立即返回一个布尔值，指示焦点是否清晰。 自动对焦后，焦点位置锁定。 如果应用程序想要恢复连续对焦，则必须调用cancelAutoFocus。 重新启动预览将不会恢复连续的自动对焦。 要停止连续对焦，应用程序应将对焦模式更改为其他模式。

常数值：“连续视频”

FOCUS_MODE_EDOF

String FOCUS_MODE_EDOF

扩展景深（EDOF）。 聚焦是数字化和连续完成的。 在这种模式下，应用程序不应该调用autoFocus(AutoFocusCallback) 。

常数值：“edof”

FOCUS_MODE_FIXED

String FOCUS_MODE_FIXED

重点是固定的。 如果焦点不可调节，相机始终处于此模式。 如果相机具有自动对焦功能，此模式可以固定焦距，通常在超焦距范围内。 应用程序不应在此模式下调用autoFocus(AutoFocusCallback) 。

常数值：“固定”

FOCUS_MODE_INFINITY

String FOCUS_MODE_INFINITY

焦点设置在无穷远处。 在这种模式下，应用程序不应该调用autoFocus(AutoFocusCallback) 。

常数值：“无限”

FOCUS_MODE_MACRO

String FOCUS_MODE_MACRO

微距（近摄）对焦模式。 应用程序应该调用autoFocus(AutoFocusCallback)以在此模式下启动焦点。

常数值：“宏”

PREVIEW_FPS_MAX_INDEX

int PREVIEW_FPS_MAX_INDEX

用于 getPreviewFpsRange(int[])或 getSupportedPreviewFpsRange()的最大预览fps数组索引。

常数值：1（0x00000001）

PREVIEW_FPS_MIN_INDEX

int PREVIEW_FPS_MIN_INDEX

用于 getPreviewFpsRange(int[])或 getSupportedPreviewFpsRange()的最小预览fps数组索引。

常量值：0（0x00000000）

SCENE_MODE_ACTION

String SCENE_MODE_ACTION

拍摄快速移动的物体。 与SCENE_MODE_SPORTS相同。

常数值：“动作”

SCENE_MODE_AUTO

String SCENE_MODE_AUTO

场景模式关闭。

常数值：“自动”

SCENE_MODE_BARCODE

String SCENE_MODE_BARCODE

应用程序正在寻找条形码。 相机驱动程序将针对条码读取进行优化。

常数值：“条形码”

SCENE_MODE_BEACH

String SCENE_MODE_BEACH

在沙滩上拍照。

恒定值：“沙滩”

SCENE_MODE_CANDLELIGHT

String SCENE_MODE_CANDLELIGHT

捕捉蜡烛点亮的场景的自然暖色。

恒定值：“烛光”

SCENE_MODE_FIREWORKS

String SCENE_MODE_FIREWORKS

用于拍摄烟花汇演。

常数值：“烟火”

SCENE_MODE_HDR

String SCENE_MODE_HDR

使用高动态范围成像技术捕捉场景。 与常规捕捉相比，相机将返回具有扩展动态范围的图像。 捕获这样的图像可能需要比常规捕获更长的时间。

常数值：“hdr”

SCENE_MODE_LANDSCAPE

String SCENE_MODE_LANDSCAPE

拍摄远处的物体。

常数值：“风景”

SCENE_MODE_NIGHT

String SCENE_MODE_NIGHT

晚上拍照。

恒定值：“晚上”

SCENE_MODE_NIGHT_PORTRAIT

String SCENE_MODE_NIGHT_PORTRAIT

晚上拍人照。

恒值：“夜景”

SCENE_MODE_PARTY

String SCENE_MODE_PARTY

采取室内低光照射。

常值：“派对”

SCENE_MODE_PORTRAIT

String SCENE_MODE_PORTRAIT

拍人照片。

常数值：“肖像”

SCENE_MODE_SNOW

String SCENE_MODE_SNOW

在雪地上拍照。

恒值：“雪”

SCENE_MODE_SPORTS

String SCENE_MODE_SPORTS

拍摄快速移动的物体。 与SCENE_MODE_ACTION相同。

常值：“运动”

SCENE_MODE_STEADYPHOTO

String SCENE_MODE_STEADYPHOTO

避免模糊的图片（例如，由于握手）。

常数值：“steadyphoto”

SCENE_MODE_SUNSET

String SCENE_MODE_SUNSET

拍日落照片。

恒定值：“日落”

SCENE_MODE_THEATRE

String SCENE_MODE_THEATRE

在剧院拍照。 闪光灯熄灭。

常值：“剧场”

WHITE_BALANCE_AUTO

String WHITE_BALANCE_AUTO

常数值：“自动”

WHITE_BALANCE_CLOUDY_DAYLIGHT

String WHITE_BALANCE_CLOUDY_DAYLIGHT

常数值：“阴天”

WHITE_BALANCE_DAYLIGHT

String WHITE_BALANCE_DAYLIGHT

常数值：“日光”

WHITE_BALANCE_FLUORESCENT

String WHITE_BALANCE_FLUORESCENT

常数值：“荧光灯”

WHITE_BALANCE_INCANDESCENT

String WHITE_BALANCE_INCANDESCENT

恒定值：“白炽灯”

WHITE_BALANCE_SHADE

String WHITE_BALANCE_SHADE

常数值：“阴影”

WHITE_BALANCE_TWILIGHT

String WHITE_BALANCE_TWILIGHT

常值：“暮光之城”

WHITE_BALANCE_WARM_FLUORESCENT

String WHITE_BALANCE_WARM_FLUORESCENT

恒定值：“温暖的荧光”

flatten

String flatten ()

创建一个包含此Parameters对象中设置的所有参数的单个字符串。

unflatten(String)方法正好相反。

get

String get (String key)

返回String参数的值。

getAntibanding

String getAntibanding ()

获取当前的抗菌设置。

getAutoExposureLock

boolean getAutoExposureLock ()

获取自动曝光锁的状态。 应用程序应该在使用此方法之前检查isAutoExposureLockSupported() 。 有关setAutoExposureLock(boolean)的详细信息，请参阅setAutoExposureLock(boolean) 。

getAutoWhiteBalanceLock

boolean getAutoWhiteBalanceLock ()

获取自动白平衡锁定的状态。 在使用此方法之前，应用程序应检查isAutoWhiteBalanceLockSupported() 。 有关该锁的详细信息，请参阅setAutoWhiteBalanceLock(boolean) 。

getColorEffect

String getColorEffect ()

获取当前的颜色效果设置。

getExposureCompensation

int getExposureCompensation ()

获取当前的暴露补偿指数。

getExposureCompensationStep

float getExposureCompensationStep ()

获取曝光补偿步骤。

getFlashMode

String getFlashMode ()

获取当前的闪光模式设置。

getFocalLength

float getFocalLength ()

获取相机的焦距（以毫米为单位）。

getFocusAreas

List<Camera.Area> getFocusAreas ()

获取当前的重点领域。 相机驱动程序使用这些区域来决定焦点。

在使用此API或setFocusAreas(List)之前，应用程序应首先调用getMaxNumFocusAreas()以了解最大重点区域数量。 如果值为0，则不支持焦点区域。

每个焦点区域都是一个具有指定重量的矩形。 方向与传感器方向有关，也就是传感器看到的方向。 方向不受setDisplayOrientation(int)的旋转或镜像setDisplayOrientation(int) 。 矩形的坐标范围从-1000到1000.（-1000，-1000）是左上角的点。 （1000，1000）是右下角的点。 焦点区域的宽度和高度不能为0或负值。

重量必须介于1到1000之间。重量应解释为每像素重量 - 该区域中的所有像素都具有指定的重量。 这意味着与较大面积相同重量的小面积对于聚焦的影响将小于较大面积。 焦点区域可以部分重叠，司机会在重叠区域添加权重。

null焦点区域列表的特殊情况意味着驾驶员可以自由选择焦点目标。 例如，驾驶员可以使用更多的信号来选择焦点区域并动态改变它们。 如果应用程序希望驱动程序完全控制对焦，则应用程序可以将焦点区域列表设置为null 。

重点领域是相对于当前视野（ getZoom() ）。 无论缩放级别如何，（-1000，-1000）代表当前可见摄像机帧的顶部。 即使使用变焦，焦点区域也不能设置在当前视野外。

对焦区域只有影响，如果当前的对焦模式为 FOCUS_MODE_AUTO ， FOCUS_MODE_MACRO ， FOCUS_MODE_CONTINUOUS_VIDEO ，或 FOCUS_MODE_CONTINUOUS_PICTURE 。

getFocusDistances

void getFocusDistances (float[] output)

获取从相机到物体看起来聚焦的位置的距离。 物体在最佳焦距处最锐利。 景深是远焦点距离减去焦距附近。

焦距可以调用后更改autoFocus(AutoFocusCallback) ， cancelAutoFocus() ，或startPreview() 。 应用程序可以随时调用getParameters()并使用此方法获取最新的焦点距离。 如果对焦模式为FOCUS_MODE_CONTINUOUS_VIDEO，则焦距可能会随时变化。

此方法旨在估计相机和拍摄对象之间的距离。 自动对焦后，被摄体距离可能在近距离和远距离范围内。 但是，精度取决于相机硬件，自动对焦算法，对焦区域和场景。 该错误可能很大，应该仅用作参考。

远对焦距离> =最佳对焦距离> =近对焦距离。 如果焦距为无穷大，则值将为Float.POSITIVE_INFINITY 。

getFocusMode

String getFocusMode ()

获取当前的对焦模式设置。

getHorizontalViewAngle

float getHorizontalViewAngle ()

以度数获取水平视角。

getInt

int getInt (String key)

返回整数参数的值。

getJpegQuality

int getJpegQuality ()

返回JPEG图片的质量设置。

getJpegThumbnailQuality

int getJpegThumbnailQuality ()

返回Jpeg图片中EXIF缩略图的质量设置。

getJpegThumbnailSize

Camera.Size getJpegThumbnailSize ()

返回Jpeg图片中EXIF缩略图的尺寸。

getMaxExposureCompensation

int getMaxExposureCompensation ()

获取最大曝光补偿指数。

getMaxNumDetectedFaces

int getMaxNumDetectedFaces ()

获取支持的最大检测面数。 这是从Camera.FaceDetectionListener返回的列表的最大长度。 如果返回值为0，则不支持指定类型的脸部检测。

getMaxNumFocusAreas

int getMaxNumFocusAreas ()

获取支持的最大焦点区域数量。 这是setFocusAreas(List)和getFocusAreas()列表的最大长度。

getMaxNumMeteringAreas

int getMaxNumMeteringAreas ()

获取支持的测量区域的最大数量。 这是setMeteringAreas(List)和getMeteringAreas()列表的最大长度。

getMaxZoom

int getMaxZoom ()

获取快照允许的最大缩放值。 这是应用程序可以设置为setZoom(int) 。 在使用此方法之前，应用程序应该调用isZoomSupported() 。 此值可能会在不同的预览大小中更改。 应用程序应该在设置预览大小后再次调用它。

getMeteringAreas

List<Camera.Area> getMeteringAreas ()

获取当前的测光区域。 相机驱动程序使用这些区域来决定曝光。

在使用此API或setMeteringAreas(List)之前，应用程序应首先调用getMaxNumMeteringAreas()以了解计量区域的最大数量。 如果该值为0，则不支持测光区域。

每个测光区域都是一个具有指定重量的矩形。 方向与传感器方向有关，也就是传感器看到的方向。 方向不受setDisplayOrientation(int)的旋转或镜像setDisplayOrientation(int) 。 矩形的坐标范围从-1000到1000.（-1000，-1000）是左上角的点。 （1000，1000）是右下角的点。 计量区域的宽度和高度不能为0或负值。

重量必须在1到1000之间，并且表示该区域中每个像素的权重。 这意味着与较小面积相同重量的大型计量区域将对计量结果产生更大的影响。 测量区域可以部分重叠，司机将在重叠区域添加权重。

null测量区域列表的一个null意味着驾驶员可以自由选择仪表。 例如，驾驶员可以使用更多的信号来选择测量区域并动态改变它们。 如果应用程序希望驱动程序完全控制测光，则应用程序可以将测光区域列表设置为null 。

测光区域相对于当前视野（ getZoom() ）。 无论缩放级别如何，（-1000，-1000）代表当前可见摄像机帧的顶部。 即使使用变焦，测光区域也不能设置在当前视场之外。

无论测量区域是什么，最终的曝光量都由 setExposureCompensation(int)补偿。

getMinExposureCompensation

int getMinExposureCompensation ()

获取最低曝光补偿指数。

getPictureFormat

int getPictureFormat ()

返回图片的图片格式。

getPictureSize

Camera.Size getPictureSize ()

返回图片的尺寸设置。

getPreferredPreviewSizeForVideo

Camera.Size getPreferredPreviewSizeForVideo ()

返回视频录制的首选或推荐预览大小（宽度和高度）（以像素为单位）。 摄像机应用程序应将预览大小设置为不大于首选预览大小的值。 换句话说，预览尺寸的宽度和高度的乘积不应大于首选预览尺寸的乘积。 另外，我们建议选择与要录制的视频分辨率相同的预览尺寸。

getPreviewFormat

int getPreviewFormat ()

返回从 Camera.PreviewCallback获得的预览帧的图像格式。

getPreviewFpsRange

void getPreviewFpsRange (int[] range)

返回当前最小和最大预览fps。 这些值是由getSupportedPreviewFpsRange()返回的元素getSupportedPreviewFpsRange() 。

getPreviewFrameRate

int getPreviewFrameRate ()

此方法在API级别9中已弃用。
由getPreviewFpsRange(int[])取代

返回接收预览帧的速率设置。 这是目标帧速率。 实际的帧速率取决于驱动程序。

getPreviewSize

Camera.Size getPreviewSize ()

返回预览图片的尺寸设置。

getSceneMode

String getSceneMode ()

获取当前场景模式设置。

getSupportedAntibanding

List<String> getSupportedAntibanding ()

获取支持的抗菌值。

getSupportedColorEffects

List<String> getSupportedColorEffects ()

获取支持的颜色效果。

getSupportedFlashModes

List<String> getSupportedFlashModes ()

获取支持的闪光灯模式。

getSupportedFocusModes

List<String> getSupportedFocusModes ()

获取支持的对焦模式。

getSupportedJpegThumbnailSizes

List<Camera.Size> getSupportedJpegThumbnailSizes ()

获取支持的jpeg缩略图大小。

getSupportedPictureFormats

List<Integer> getSupportedPictureFormats ()

获取支持的图片格式。

getSupportedPictureSizes

List<Camera.Size> getSupportedPictureSizes ()

获取支持的图片大小。

getSupportedPreviewFormats

List<Integer> getSupportedPreviewFormats ()

获取支持的预览格式。 始终支持NV21 。 自API级别12以来，始终支持YV12 。

getSupportedPreviewFpsRange

List<int[]> getSupportedPreviewFpsRange ()

获取支持的预览fps（帧每秒）范围。 每个范围都包含最低fps和最高fps。 如果最小fps等于最大fps，则摄像机以固定帧速率输出帧。 如果不是，则摄像机以自动帧速率输出帧。 实际帧速率在最小值和最大值之间波动。 这些值乘以1000并以整数表示。 例如，如果帧速率是每秒26.623帧，则该值是26623。

getSupportedPreviewFrameRates

List<Integer> getSupportedPreviewFrameRates ()

此方法在API级别9中已弃用。
由getSupportedPreviewFpsRange()取代

获取支持的预览帧速率。

getSupportedPreviewSizes

List<Camera.Size> getSupportedPreviewSizes ()

获取支持的预览大小。

getSupportedSceneModes

List<String> getSupportedSceneModes ()

获取支持的场景模式。

getSupportedVideoSizes

List<Camera.Size> getSupportedVideoSizes ()

获取MediaRecorder可以使用的支持的视频帧大小。

如果返回的列表不为空，则返回的列表将包含至少一个Size，并且如果摄像机用作视频源，则返回列表中的其中一个大小必须传递给摄像机应用程序的MediaRecorder.setVideoSize（）。 在这种情况下，预览的大小可能与视频录制过程中录制的视频的分辨率不同。

getSupportedWhiteBalance

List<String> getSupportedWhiteBalance ()

获取支持的白平衡。

getVerticalViewAngle

float getVerticalViewAngle ()

以度数获得垂直视角。

getVideoStabilization

boolean getVideoStabilization ()

获取视频稳定的当前状态。 有关视频稳定性的详细信息，请参阅setVideoStabilization(boolean) 。

getWhiteBalance

String getWhiteBalance ()

获取当前的白平衡设置。

getZoom

int getZoom ()

获取当前缩放值。 这也适用于平稳缩放进行中。 使用此方法之前，应用程序应检查isZoomSupported() 。

getZoomRatios

List<Integer> getZoomRatios ()

获取所有缩放值的缩放比例。 在使用此方法之前，应用程序应检查isZoomSupported() 。

isAutoExposureLockSupported

boolean isAutoExposureLockSupported ()

如果支持自动曝光锁定，则返回true。 在尝试锁定自动曝光之前，应用程序应调用此设置。 有关setAutoExposureLock(boolean)的详细信息，请参阅setAutoExposureLock(boolean) 。

isAutoWhiteBalanceLockSupported

boolean isAutoWhiteBalanceLockSupported ()

如果支持自动白平衡锁定，则返回true。 在尝试锁定自动白平衡之前，应用程序应调用此设置。 有关该锁的详细信息，请参阅setAutoWhiteBalanceLock(boolean) 。

isSmoothZoomSupported

boolean isSmoothZoomSupported ()

如果支持平滑缩放，则返回true。 应用程序应在使用其他平滑缩放方法之前调用此方法

isVideoSnapshotSupported

boolean isVideoSnapshotSupported ()

如果支持视频快照，则返回true。 也就是说，应用程序在录制过程中可以调用takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback) 。 拍摄照片后，应用程序不需要拨打startPreview() 。 预览将仍然有效。 除此之外，在拍摄过程中拍摄照片与正常拍摄照片相同。 与takePicture相关的所有设置和方法的工作原理完全相同。 例： getPictureSize() ， getSupportedPictureSizes() ， setJpegQuality(int) ， setRotation(int) ，和等等的图象将有EXIF报头。 FLASH_MODE_AUTO和FLASH_MODE_ON也仍然有效，但视频会记录闪光灯。

应用程序可以将快门回叫设置为空以避免快门声。 还建议将原始图片和视图回调设置为空以避免预览显示的中断。

所记录的视频的视野可能与所拍摄的图片的视野不同。 视频快照的最大大小可能小于常规静态捕捉的最大大小。 如果当前图片尺寸设置为高于视频快照可以支持的尺寸，则会以最大支持尺寸捕获图片。

isVideoStabilizationSupported

boolean isVideoStabilizationSupported ()

如果支持视频稳定，则返回true。 有关视频稳定性的详细信息，请参阅setVideoStabilization(boolean) 。

isZoomSupported

boolean isZoomSupported ()

如果支持缩放，则返回true。 应用程序应该在使用其他缩放方法之前调用它

remove

void remove (String key)

removeGpsData

void removeGpsData ()

从参数中删除GPS纬度，经度，高度和时间戳。

set

void set (String key, 
                String value)

设置一个String参数。

set

void set (String key, 
                int value)

设置一个整数参数。

setAntibanding

void setAntibanding (String antibanding)

设置抗菌。

setAutoExposureLock

void setAutoExposureLock (boolean toggle)

设置自动曝光锁定状态。 使用此方法之前，应用程序应检查isAutoExposureLockSupported() 。

如果设置为true，相机自动曝光例程将立即暂停，直到锁定设置为false。 自动曝光锁定时，曝光补偿设置更改仍然生效。

如果自动曝光已被锁定，则将其设置为true将不起作用（驱动程序不会重新计算曝光值）。

停止预览与 stopPreview() ，或触发静态图像捕捉与 takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback) ，不会改变锁。

例如，曝光补偿，自动曝光锁定和自动白平衡锁定可用于拍摄曝光包围的图像。

相机release()被调用后，包括锁定状态在内的自动曝光状态将不会保持。 在open()之后锁定自动曝光，但在第一次调用startPreview()将不允许自动曝光程序运行，并可能导致严重曝光过度或曝光不足的图像。

setAutoWhiteBalanceLock

void setAutoWhiteBalanceLock (boolean toggle)

设置自动白平衡锁定状态。 在使用此方法之前，应用程序应检查isAutoWhiteBalanceLockSupported() 。

如果设置为true，相机自动白平衡例程将立即暂停，直到锁定设置为false。

如果自动白平衡已经锁定，再次将其设置为true将不起作用（驱动程序不会重新计算白平衡值）。

停止预览与 stopPreview() ，或触发静态图像捕捉与 takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback) ，不会改变的锁。

如果设置了白平衡模式，则使用 setWhiteBalance(String)更改白平衡模式会释放自动白平衡锁。

例如，曝光补偿，自动曝光锁定和自动白平衡锁定可用于拍摄曝光包围的图像。 摄像机release()被调用后，自动白平衡状态（包括锁定状态）将不会保持。 锁定后自动白平衡open() ，但在第一次调用之前startPreview()不允许自动白平衡程序在所有运行，并可能导致拍摄的图像严重不正确的颜色。

setColorEffect

void setColorEffect (String value)

设置当前的颜色效果设置。

setExposureCompensation

void setExposureCompensation (int value)

设置曝光补偿索引。

setFlashMode

void setFlashMode (String value)

设置闪光灯模式。

setFocusAreas

void setFocusAreas (List<Camera.Area> focusAreas)

设置重点领域。 有关文档，请参见getFocusAreas() 。

setFocusMode

void setFocusMode (String value)

设置对焦模式。

setGpsAltitude

void setGpsAltitude (double altitude)

设置GPS高度。 这将被存储在JPEG EXIF标头中。

setGpsLatitude

void setGpsLatitude (double latitude)

设置GPS纬度坐标。 这将被存储在JPEG EXIF标头中。

setGpsLongitude

void setGpsLongitude (double longitude)

设置GPS经度坐标。 这将被存储在JPEG EXIF标头中。

setGpsProcessingMethod

void setGpsProcessingMethod (String processing_method)

设置GPS处理方法。 该方法将存储在JPEG EXIF标头中长达31个字节的UTF-8字符串中。

setGpsTimestamp

void setGpsTimestamp (long timestamp)

设置GPS时间戳。 这将被存储在JPEG EXIF标头中。

setJpegQuality

void setJpegQuality (int quality)

设置拍摄图片的Jpeg质量。

setJpegThumbnailQuality

void setJpegThumbnailQuality (int quality)

设置JPEG图片中EXIF缩略图的质量。

setJpegThumbnailSize

void setJpegThumbnailSize (int width, 
                int height)

在Jpeg图片中设置EXIF缩略图的尺寸。 如果应用程序将宽度和高度都设置为0，EXIF将不包含缩略图。

应用程序需要考虑显示方向。 请参阅setPreviewSize(int, int)以供参考。

setMeteringAreas

void setMeteringAreas (List<Camera.Area> meteringAreas)

设置测光区域。 有关文档，请参见getMeteringAreas() 。

setPictureFormat

void setPictureFormat (int pixel_format)

设置图片的图片格式。

setPictureSize

void setPictureSize (int width, 
                int height)

设置图片的尺寸。

应用程序需要考虑显示方向。 请参阅setPreviewSize(int, int)以供参考。

setPreviewFormat

void setPreviewFormat (int pixel_format)

设置预览图片的图像格式。

如果从未调用过，则默认格式为 NV21 ，它使用NV21编码格式。

使用 getSupportedPreviewFormats()获取可用预览格式的列表。

强烈建议使用 NV21或 YV12 ，因为它们受所有相机设备支持。

对于YV12，接收到的图像缓冲区不必紧密排列，因为每行像素数据的末尾可能会有填充，如YV12 。 对于相机回调数据，可以假定Y和UV数据的步幅是尽可能最小的，以满足对准要求。 也就是说，如果预览大小是宽度x高度 ，则以下等式描述Y平面的行y的开始和U和V平面的行c的缓冲区索引：

yStride   = (int) ceil(width / 16.0) * 16;
 uvStride  = (int) ceil( (yStride / 2) / 16.0) * 16;
 ySize     = yStride * height;
 uvSize    = uvStride * height / 2;
 yRowIndex = yStride * y;
 uRowIndex = ySize + uvSize + uvStride * c;
 vRowIndex = ySize + uvStride * c;
 size      = ySize + uvSize * 2;
 

setPreviewFpsRange

void setPreviewFpsRange (int min, 
                int max)

设置最小和最大预览fps。 这控制了Camera.PreviewCallback收到的预览帧的速率。 最小和最大预览fps必须是来自getSupportedPreviewFpsRange()其中一个元素。

setPreviewFrameRate

void setPreviewFrameRate (int fps)

此方法在API级别9中已弃用。
由setPreviewFpsRange(int, int)取代

设置接收预览帧的速率。 这是目标帧速率。 实际的帧速率取决于驱动程序。

setPreviewSize

void setPreviewSize (int width, 
                int height)

设置预览图片的尺寸。 如果预览已经开始，应用程序应该在更改预览大小之前先停止预览。 宽度和高度的侧面基于相机的方向。 也就是说，预览大小是按显示方向旋转之前的大小。 因此，应用程序需要在设置预览大小时考虑显示方向。 例如，假设相机同时支持480x320和320x480预览尺寸。 该应用程序需要3：2预览比例。 如果显示方向设置为0或180，则应将预览尺寸设置为480x320。 如果显示方向设置为90或270，则应将预览尺寸设置为320x480。 设置图片尺寸和缩略图尺寸时，还应考虑显示方向。

setRecordingHint

void setRecordingHint (boolean hint)

设置录制模式提示。 这告诉相机应用程序的目的是记录视频start() ，而不是拍摄静止图片takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback) 。 使用此提示可以使MediaRecorder.start（）启动得更快，或者输出上的毛刺更少。 这应该在开始预览以获得最佳结果之前调用，但可以在预览处于活动状态时进行更改。 默认值是false。 当提示为true时，应用程序仍然可以调用takePicture（），或者当提示为false时调用MediaRecorder.start（）。 但表现可能会更糟。

setRotation

void setRotation (int rotation)

设置相对于摄像机方向的顺时针旋转角度。 这会影响从JPEG Camera.PictureCallback返回的图片。 相机驱动程序可以在不旋转图片的情况下在EXIF标头中设置方向。 或者驱动程序可能会旋转图片和EXIF缩略图。 如果旋转Jpeg图片，则EXIF标题中的方向将丢失或1（第0行为顶部，第＃0列为左侧）。

如果应用程序想旋转图片以匹配用户看到的方向，应用程序应该使用OrientationEventListener和Camera.CameraInfo 。 OrientationEventListener的值与设备的自然方向有关。 CameraInfo.orientation是相机方向与自然设备方向之间的角度。 两者的总和就是后置摄像头的旋转角度。 两者的区别在于前置摄像头的旋转角度。 请注意，前置摄像头的JPEG图像不会像预览显示中那样被镜像。

例如，假设设备的自然方向是纵向。 该设备顺时针旋转270度，因此设备方向为270.假设背面照相机传感器安装在横向上，并且照相机传感器的顶部与自然方向的显示器右边缘对齐。 因此相机方向为90.旋转角度应设为0（270 + 90）。

参考代码如下。

 public void onOrientationChanged(int orientation) {
     if (orientation == ORIENTATION_UNKNOWN) return;
     android.hardware.Camera.CameraInfo info =
            new android.hardware.Camera.CameraInfo();
     android.hardware.Camera.getCameraInfo(cameraId, info);
     orientation = (orientation + 45) / 90 * 90;
     int rotation = 0;
     if (info.facing == CameraInfo.CAMERA_FACING_FRONT) {
         rotation = (info.orientation - orientation + 360) % 360;
     } else {  // back-facing camera
         rotation = (info.orientation + orientation) % 360;
     }
     mParameters.setRotation(rotation);
 }
 

setSceneMode

void setSceneMode (String value)

设置场景模式。 更改场景模式可能会覆盖其他参数（如闪光模式，对焦模式，白平衡）。 例如，假设最初的闪光模式开启，并且支持的闪光模式开启/关闭。 在夜景模式下，闪光灯模式和支持的闪光灯模式可能会更改为关闭。 设置场景模式后，应用程序应调用getParameters以了解是否更改了某些参数。

setVideoStabilization

void setVideoStabilization (boolean toggle)

启用和禁用视频稳定。 使用isVideoStabilizationSupported()来确定调用此方法是否有效。

视频稳定功能可减少由于摄像头在预览视频流和录制的视频中的移动而产生的震动，包括从预览回调中收到的数据。 它不会减少用takePicture拍摄的图像中的运动模糊。

在预览或录制处于活动状态时，可以启用和禁用视频稳定功能，但切换它可能会导致视频流中的跳转，这可能在录制的视频中不受欢迎。

setWhiteBalance

void setWhiteBalance (String value)

设置白平衡。 改变设置将释放自动白平衡锁定。 建议不要同时更改白平衡和AWB锁定。

setZoom

void setZoom (int value)

设置当前的缩放值。 如果照相机变焦（数值> 0），实际的照片尺寸可能会小于照片尺寸设置。 从Camera.PictureCallback返回图片后，应用程序可以检查实际的图片大小。 预览尺寸在缩放中保持不变。 在使用此方法之前，应用程序应检查isZoomSupported() 。

unflatten

void unflatten (String flattened)

采用扁平化的参数串并将每个参数添加到此参数对象。

flatten()方法正好相反。