public classCamera.Parameters
extends Objectjava.lang.Object
↳
android.hardware.Camera.Parameters
Class Overview
类概述
相机的服务设置。
使相机参数生效，应用程序必须调用setparameters（相机参数。）
。例如，在setwhitebalance（字符串）
被称为，白平衡不实际上改变了之前setparameters（相机参数。）
被称为参数变化的对象。
不同的设备可能有不同的相机功能，如图片的大小或闪光模式。应用程序应该查询相机能力之前设置参数。例如，应用应该打电话getsupportedcoloreffects()
在呼叫setcoloreffect（字符串）
。如果相机不支持颜色的影响，getsupportedcoloreffects()
将返回null。
概要
常数
String
flash_mode_auto
闪光灯会自动在需要的时候被解雇。
String
flash_mode_off
闪光灯不会被解雇。
String
flash_mode_on
闪光总是会被解雇的快照。
String
flash_mode_red_eye
Flash将红眼模式发射。
String
flash_mode_torch
在预览灯不断涌出，自动对焦和快照。
int
focus_distance_far_index
数组中的远距使用getfocusdistances（浮[ ]）
。
int
focus_distance_near_index
数组中的近距离使用的焦点getfocusdistances（浮[ ]）
。
int
focus_distance_optimal_index
使用的最佳焦点距离的数组索引getfocusdistances（浮[ ]）
。
String
focus_mode_auto
自动对焦模式。
String
focus_mode_continuous_picture
用于拍照的连续自动对焦模式。
String
focus_mode_continuous_video
用于视频记录的连续自动对焦模式。
String
focus_mode_edof
扩展景深（EDOF）。
String
focus_mode_fixed
的焦点是固定的。
String
focus_mode_infinity
重点是无穷的。
String
focus_mode_macro
宏观（特写）对焦模式。
int
preview_fps_max_index
使用最大预览帧数组索引getpreviewfpsrange（int [ ]）
或getsupportedpreviewfpsrange()
。
int
preview_fps_min_index
使用最小预览帧数组索引getpreviewfpsrange（int [ ]）
或getsupportedpreviewfpsrange()
。
String
scene_mode_action
以快速移动的物体的照片。
String
scene_mode_auto
场景模式关闭。
String
scene_mode_barcode
应用程序正在寻找一个条码。
String
scene_mode_beach
拍照的海滩上。
String
scene_mode_candlelight
捕获场景的自然温暖的颜色，点燃蜡烛。
String
scene_mode_fireworks
拍摄焰火。
String
scene_mode_hdr
用高动态范围成像技术的现场捕获。
String
scene_mode_landscape
在远处的物体图片。
String
scene_mode_night
在晚上拍照。
String
scene_mode_night_portrait
在晚上吃的人的照片。
String
scene_mode_party
采取室内弱光拍摄。
String
scene_mode_portrait
以人的照片。
String
scene_mode_snow
拍照的雪。
String
scene_mode_sports
以快速移动的物体的照片。
String
scene_mode_steadyphoto
避免模糊的图片（例如，由于握手）。
String
scene_mode_sunset
采取日落的照片。
String
scene_mode_theatre
在剧场的照片。
String
white_balance_cloudy_daylight
String
white_balance_fluorescent
String
white_balance_incandescent
String
white_balance_warm_fluorescent
公共方法
flatten()创建一套这个对象的所有参数的单个字符串参数。
String
getantibanding（）
获取当前antibanding设置。
boolean
getautoexposurelock（）
获取自动曝光锁定状态。
boolean
getautowhitebalancelock（）
获取自动白平衡锁的状态。
String
getcoloreffect（）
获取当前的颜色设置效果。
int
getexposurecompensation（）
获取当前曝光补偿指数。
float
getexposurecompensationstep（）
获取曝光补偿的步骤。
String
getflashmode（）
获取当前的闪光模式设定。
float
getfocallength（）
变焦距（毫米）的相机。
getfocusareas（）
获取当前的重点领域。
void
getfocusdistances（浮动[ ]输出）
从摄像机到一个对象似乎是焦点得距离。
String
getfocusmode（）
获取当前的焦点模式设置。
float
gethorizontalviewangle（）
获取水平角度来看。
int
int
getjpegquality（）
收益质量的JPEG图像设置。
int
getjpegthumbnailquality（）
返回质量的JPEG图片EXIF缩略图设置。
Camera.Size
getjpegthumbnailsize（）
返回EXIF缩略图的JPEG图片的尺寸。
int
getmaxexposurecompensation（）
得到的最大曝光补偿指数。
int
getmaxnumdetectedfaces（）
获取人脸支持的最大数量。
int
getmaxnumfocusareas（）
得到最多支持的重点领域。
int
getmaxnummeteringareas（）
获取最大数量的计量领域的支持。
int
getmaxzoom（）
得到的缩放所允许的最大值为快照。
getmeteringareas（）
获取当前计量范围。
int
getminexposurecompensation（）
获得最小的曝光补偿指数。
int
getpictureformat（）
返回的照片图像格式。
Camera.Size
getpicturesize（）
返回设置图片尺寸。
Camera.Size
getpreferredpreviewsizeforvideo（）
返回优先推荐或预览大小（宽度和高度）像素的视频。
int
getpreviewformat（）
返回预览帧的图像格式有camera.previewcallback
。
void
getpreviewfpsrange（int [ ]范围）
返回当前预览的帧的最大和最小。
int
getpreviewframerate（）
*该方法被在API级别9。取代getpreviewfpsrange（int [ ]）
Camera.Size
getpreviewsize（）
返回的尺寸设置预览图片。
String
getscenemode（）
获取当前情景模式设置。
getsupportedantibanding（）
获取受支持的antibanding值。
getsupportedcoloreffects（）
获取受支持的颜色的影响。
getsupportedflashmodes（）
获取受支持的闪光模式。
getsupportedfocusmodes（）
获取受支持的对焦模式。
getsupportedjpegthumbnailsizes（）
获取受支持的JPEG缩略图的大小。
getsupportedpictureformats（）
获取受支持的图片格式。
getsupportedpicturesizes（）
获取受支持的图片大小。
getsupportedpreviewformats（）
获取受支持的预览格式。
List<int[]>
getsupportedpreviewfpsrange（）
获取受支持的预览帧（帧每秒）的范围。
getsupportedpreviewframerates（）
*该方法被在API级别9。取代getsupportedpreviewfpsrange()
getsupportedpreviewsizes（）
获取受支持的预览图片。
getsupportedscenemodes（）
获取受支持的场景模式。
getsupportedvideosizes（）
获取受支持的视频帧的大小，可以通过使用 mediarecorder。
getsupportedwhitebalance（）
获取受支持的白平衡。
float
getverticalviewangle（）
获取垂直视角度。
boolean
getvideostabilization（）
得到的视频稳定化的现状。
String
getwhitebalance（）
获取当前白平衡设置。
int
getzoom（）
获取当前的缩放值。
getzoomratios（）
获取所有的变焦缩放比例值。
boolean
isautoexposurelocksupported（）
如果自动曝光锁定支持，返回true。
boolean
isautowhitebalancelocksupported（）
如果自动白平衡锁定支持返回true。
boolean
issmoothzoomsupported（）
如果顺利变焦支持返回true。
boolean
isvideosnapshotsupported（）
如果视频快照支持返回true。
boolean
isvideostabilizationsupported（）
如果视频稳定的支持，返回true。
boolean
iszoomsupported（）
如果变焦支持返回true。
void
removegpsdata（）
消除GPS纬度，经度，高度，和从参数时间戳。
void
配置（字符串关键的，字符串值）
设置一个字符串参数。
void
setantibanding（字符串antibanding）
设置antibanding。
void
setautoexposurelock（布尔切换）
设置自动曝光锁定状态。
void
setautowhitebalancelock（布尔切换）
设置自动白平衡锁定状态。
void
setcoloreffect（字符串值）
设置当前的颜色设置效果。
void
setexposurecompensation（int值）
设置曝光补偿指数。
void
setflashmode（字符串值）
设置闪光模式。
void
setfocusareas（列表<相机。面积>重点领域）
设置焦点区域。
void
setfocusmode（字符串值）
设置焦点模式。
void
setgpsaltitude（双高度）
集GPS高程。
void
setgpslatitude（双纬度）
集GPS经纬度坐标。
void
setgpslongitude（双经度）
集GPS经纬度坐标。
void
setgpsprocessingmethod（字符串processing_method）
集GPS处理方法。
void
setgpstimestamp（长时间）
集GPS时间戳。
void
setjpegquality（int质量）
捕获的图像集的JPEG质量。
void
setjpegthumbnailquality（int质量）
套在JPEG图片EXIF缩略图质量。
void
setjpegthumbnailsize（int，int宽度，高度）
集的EXIF缩略图的JPEG图片的尺寸。
void
setmeteringareas（列表<相机。面积> meteringareas）
集计量范围。
void
setpictureformat（int pixel_format）
设置图片的图像格式。
void
setpicturesize（int，int宽度，高度）
设置图片的尺寸。
void
setpreviewformat（int pixel_format）
设置预览照片的图像格式。
void
setpreviewfpsrange（int，int max）
最小和最大帧设置预览。
void
setpreviewframerate（int FPS）
*该方法被在API级别9。取代setpreviewfpsrange（int，int）
void
setpreviewsize（int，int宽度，高度）
设置预览照片的尺寸。
void
setrecordinghint（布尔提示）
集记录模式的提示。
void
setrotation（int旋转）
集度相对于相机的方向顺时针旋转角度。
void
setscenemode（字符串值）
设置场景模式。
void
setvideostabilization（布尔切换）
启用和禁用视频稳定。
void
setwhitebalance（字符串值）
设置白平衡。
void
setzoom（int值）
设置缩放值。
void
unflatten（字符串扁平）
以一个扁平的字符串参数，增加了每一个这个参数对象。
[扩展]继承的方法
[图片上传中。。。（1）]从阶级java.lang.Object
常数
public static final String antibanding_50hz
加入API级别5
定值： “50”
public static final String
antibanding_60hz
加入API级别5
定值： “统一”
public static final String
antibanding_auto
加入API级别5
定值： “自动”
public static final String
antibanding_off
加入API级别5
定值： 半价50%。
public static final String
effect_aqua
加入API级别5
定值： “水”
public static final String
effect_blackboard
加入API级别5
定值： “黑板”
public static final String
effect_mono
加入API级别5
定值： “单”
public static final String
effect_negative
加入API级别5
定值： “消极的”
public static final String
effect_none
加入API级别5
定值： “不”
public static final String
effect_posterize
加入API级别5
定值： “色调分离”
public static final String
effect_sepia
加入API级别5
定值： “墨”
public static final String
effect_solarize
加入API级别5
定值： “晒太阳”
public static final String
effect_whiteboard
加入API级别5
定值： “白板”
public static final String
flash_mode_auto
加入API级别5
闪光灯会自动在需要的时候被解雇。闪光会被解雇预览时，自动对焦，或快照取决于驱动。
定值： “自动”
public static final String
flash_mode_off
加入API级别5
闪光灯不会被解雇。
定值： 半价50%。
public static final String
flash_mode_on
加入API级别5
闪光总是会被解雇的快照。Flash还可以解雇在预览或自动对焦依赖司机。
定值： “上”
public static final String
flash_mode_red_eye
加入API级别5
Flash将红眼模式发射。
定值： “红眼”
public static final String
flash_mode_torch
加入API级别5
在预览灯不断涌出，自动对焦和快照。这也可用于视频。
定值： “火炬”
public static final int
focus_distance_far_index
加入API级别9
数组中的远距使用getfocusdistances（浮[ ]）
。
定值： 2 （0x00000002
public static final int
focus_distance_near_index
加入API级别9
数组中的近距离使用的焦点getfocusdistances（浮[ ]）
。
定值： 0 （0x00000000
public static final int
focus_distance_optimal_index
加入API级别9
使用的最佳焦点距离的数组索引getfocusdistances（浮[ ]）
。
定值： 1 （0x00000001
public static final String FOCUS_MODE_AUTO
加入API级别5
自动对焦模式。程序应该调用自动对焦（autofocuscallback）
在这个模式下启动的重点。
定值： “自动”
public static final String FOCUS_MODE_CONTINUOUS_PICTURE
加入API级别14
用于拍照的连续自动对焦模式。相机不断致力。焦点改变的速度更是比攻击focus_mode_continuous_video
。自动对焦开始时的参数设置。
应用程序可以调用自动对焦（autofocuscallback）
在这种模式。如果对焦是在中东的扫描，重点回调函数将返回时完成。如果对焦是不扫描，重点回调将立即返回一个布尔值，指示是否焦点是否清晰。应用程序可以决定是否要立即采取图片或改变聚焦模式自动对焦，并运行一个完整的周期。重点位置自动对焦锁定后的电话。如果应用程序需要恢复持续的注意力，cancelautofocus必须调用。重启预览将不会恢复连续。对停止连续集中，应用程序应该改变焦点模式其他模式。
参见
focus_mode_continuous_video
定值： “连续拍摄”
public static final String FOCUS_MODE_CONTINUOUS_VIDEO
加入API级别9
用于视频记录的连续自动对焦模式。相机不断致力。这是视频记录最好的选择，因为焦点变化。应用程序还可以呼叫TakePicture（camera.shuttercallback，camera.picturecallback，相机。picturecallback）
在这种模式下，但对象可能不会成为焦点。自动对焦启动时的参数集。
由于API级别14，应用程序可以调用自动对焦（autofocuscallback）
在这种模式下。重点回调将立即返回一个布尔值，指示是否重点是尖锐或不。焦点位置后自动电话锁。如果程序要恢复持续的注意力，cancelautofocus 必须调用。重启预览将不会恢复连续自动对焦。停止持续的注意力，应用程序应该改变对焦模式，其他模式。
参见
focus_mode_continuous_picture
定值： “连续视频”
public static final String FOCUS_MODE_EDOF
加入API级别8
扩展景深（EDOF）。重点是数字化和不断。应用程序不应调用自动对焦（autofocuscallback）
在这种模式下。
定值： “褚”
public static final String FOCUS_MODE_FIXED
加入API级别5
的焦点是固定的。摄像机一直在这种模式下，如果不是重点调。如果相机自动对焦，这种方式可以解决焦点，这通常是在超焦距。应用程序应该不叫自动对焦（autofocuscallback）
在这种模式下。
定值： “固定”
public static final String FOCUS_MODE_INFINITY
加入API级别5
重点是无穷的。应用程序不应调用自动对焦（autofocuscallback）
在这种模式下。
定值： “无限”
public static final String FOCUS_MODE_MACRO
加入API级别5
宏观（特写）对焦模式。程序应该调用自动对焦（autofocuscallback）
在这模式启动的重点。
定值： “宏”
public static final int PREVIEW_FPS_MAX_INDEX
加入API级别9
使用最大预览帧数组索引getpreviewfpsrange（int [ ]）
或getsupportedpreviewfpsrange()
。
定值： 1 （0x00000001
public static final int PREVIEW_FPS_MIN_INDEX
加入API级别9
使用最小预览帧数组索引getpreviewfpsrange（int [ ]）
或getsupportedpreviewfpsrange()
。
定值： 0 （0x00000000
public static final String
scene_mode_action
加入API级别5
以快速移动的物体的照片。相同scene_mode_sports
。
定值： “行动”
public static final String scene_mode_auto
加入API级别5
场景模式关闭。
定值： “自动”
public static final String scene_mode_barcode
加入API级别8
应用程序正在寻找一个条码。摄像头驱动程序将阅读信息的优化。
定值： “条码”
public static final String scene_mode_beach
加入API级别5
拍照的海滩上。
定值： “海滩”
public static final String scene_mode_candlelight
加入API级别5
捕获场景的自然温暖的颜色，点燃蜡烛。
定值： “烛光”
public static final String scene_mode_fireworks
加入API级别5
拍摄焰火。
定值： “烟花”
public static final String scene_mode_hdr
加入API级别17
用高动态范围成像技术的现场捕获。该相机将有一个扩展的动态范围的图像相比，定期捕获。捕获这样的图像可能会比普通的捕获时间。
定值： “人类”
public static final String scene_mode_landscape
加入API级别5
在远处的物体图片。
定值： “景观”
public static final String scene_mode_night
加入API级别5
在晚上拍照。
定值： “夜晚”
public static final String scene_mode_night_portrait
加入API级别5
在晚上吃的人的照片。
定值： 夜景人像
public static final String scene_mode_party
加入API级别5
采取室内弱光拍摄。
定值： “派对”
public static final String scene_mode_portrait
加入API级别5
以人的照片。
定值： “画像”
public static final String scene_mode_snow
加入API级别5
拍照的雪。
定值： “雪”
public static final String scene_mode_sports
加入API级别5
以快速移动的物体的照片。相同scene_mode_action
。
定值： “体育”
public static final String scene_mode_steadyphoto
加入API级别5
避免模糊的图片（例如，由于握手）。
定值： “steadyphoto”
public static final String scene_mode_sunset
加入API级别5
采取日落的照片。
定值： “日落”
public static final String scene_mode_theatre
加入API级别5
在剧场的照片。闪光灯关闭。
定值： “戏剧”
public static final String white_balance_auto
加入API级别5
定值： “自动”
public static final String white_balance_cloudy_daylight
加入API级别5
定值： “多云的白天”
public static final String white_balance_daylight
加入API级别5
定值： “日光”
public static final String white_balance_fluorescent
加入API级别5
定值： “荧光”
public static final String white_balance_incandescent
加入API级别5
定值： “白炽灯”
public static final String white_balance_shade
加入API级别5
定值： “阴影”
public static final String white_balance_twilight
加入API级别5
定值： 《暮光之城”
public static final String white_balance_warm_fluorescent
加入API级别5
定值： “温暖的日光”
公共方法
public String flatten ()
加入API级别1
创建一套这个对象的所有参数的单个字符串参数。
的unflatten（字符串）
方法有相反的。
退货
一个从这个参数对象的所有值的字符串，在分号分隔的键-值对
public String get (String key)
加入API级别1
返回一个字符串参数的值。
参数
钥匙
为参数的关键的名字
退货
参数的字符串值
public String getAntibanding ()
加入API级别5
获取当前antibanding设置。
退货
目前antibanding。如果antibanding空设置不支持。
public boolean getAutoExposureLock ()
加入API级别14
获取自动曝光锁定状态。应用程序应该检查isautoexposurelocksupported()
在使用这个方法。看到setautoexposurelock（布尔）
关于锁的细节。
退货
的自动曝光锁定状态。如果自动曝光目前锁返回真，否则为假。
public boolean getAutoWhiteBalanceLock ()
加入API级别14
获取自动白平衡锁的状态。应用程序应该检查isautowhitebalancelocksupported()
在使用本方法。看到setautowhitebalancelock（布尔）
关于锁细节。
退货
锁定状态的自动白平衡。如果自动白平衡是目前锁定返回真，假否则。
参见
setautowhitebalancelock（布尔）
public String getColorEffect ()
加入API级别5
获取当前的颜色设置效果。
退货
当前颜色的影响。空如果颜色效果设置不支持。
参见
effect_none
public int getExposureCompensation ()
加入API级别8
获取当前曝光补偿指数。
退货
目前的曝光补偿指数。的范围getminexposurecompensation()
对getmaxexposurecompensation()
。0意味着曝光不调整。
public float getExposureCompensationStep ()
加入API级别8
获取曝光补偿的步骤。
退货
曝光补偿步骤。应用程序可以通过增加曝光补偿EV 指标和步骤。例如：如果曝光补偿指数是6，步长为0.333333333，是2 eV的。
public String getFlashMode ()
加入API级别5
获取当前的闪光模式设定。
退货
目前的闪光模式。空如果闪光模式设置不支持。
public float getFocalLength ()
加入API级别8
变焦距（毫米）的相机。
退货
焦距。此方法将总是返回一个有效的价值。
public List<Camera.Area> getFocusAreas ()
加入API级别14
获取当前的重点领域。摄像头驱动程序使用区来决定焦点。
在使用这个API或setfocusareas（名单）
应用程序应该调用，getmaxnumfocusareas()
了解最大数量的重点领域第一。如果该值为0，重点区域是不支持。
每个重点领域是一个具有特定重量的矩形。方向相对于传感器的方向，即，所看到的方向传感器。受到旋转或镜像不setdisplayorientation（int）
。坐标的矩形范围从1000到1000。（1000，1000）是左上角的点。（1000，1000）下的权利。宽度和高度集中地区不能0或负。
的重量范围从1到1000。重量应该解释为每一个像素的权重在该地区的所有像素具有指定的重量。这意味着一个小面积相同的重量为较大的地区会对聚焦比地区影响较小。重点领域可以部分重叠，司机会在重叠区域中添加权重。
一个特殊的情况空
重点地区名单意味着司机是自由选择的重点目标，它希望。例如，司机可以使用更多的信号选择重点领域和改变他们动态。应用程序可以将焦点设置地区列表空
如果他们想让司机完全控制聚焦。
重点领域是相对于当前场视图getzoom()
）。无论缩放级别是什么，（1000，1000）顶部的当前可见的相机代表。重点地区不能设置在目前来看，即使当使用变焦。
重点地区仅影响当前的焦点模式如果focus_mode_auto
，focus_mode_macro
，focus_mode_continuous_video
，或focus_mode_continuous_picture
。
退货
列出当前的重点领域
public void getFocusDistances (float[] output)
加入API级别9
从摄像机到一个对象似乎是焦点得距离。该对象是在最佳的聚焦距离最大。场的深度远焦距离减去接近焦点距离。
焦距可以改变后调用自动对焦（autofocuscallback）
，cancelautofocus()
，或startpreview()
。应用程序可以调用getparameters()
该方法可随时获得最新的焦点距离。如果聚焦模式焦距可以改变 focus_mode_continuous_video，不时。
这种方法的目的是估计摄像机和主体之间的距离。在自动对焦，主体的距离可在远近焦点距离。然而，其精度取决于相机硬件，自聚焦算法，重点地区，和场景。误差可以很大，它只能作为一个。
远距> =最佳焦点距离> =近焦点的距离。如果焦点距离为无穷大，价值float.positive_infinity
。
参数
输出
焦点距离米。输出必须是一个具有三个元素的数组的浮。近距离的最佳焦点，焦点距离远，焦距将填充数组。
public String getFocusMode ()
加入API级别5
获取当前的焦点模式设置。
退货
目前的焦点模式。此方法将总是返回一个非空的价值。程序应该调用自动对焦（autofocuscallback）
如果焦点模式focus_mode_auto或focus_mode_macro开始重点。
public float getHorizontalViewAngle ()
加入API级别8
获取水平角度来看。
退货
看水平角。该方法将总是返回一个有效值。
public int getInt (String key)
加入API级别1
返回一个整数参数的值。
参数
钥匙
为参数的关键的名字
退货
参数的初始值
public int getJpegQuality ()
加入API级别5
收益质量的JPEG图像设置。
退货
JPEG图像质量设置。
public int getJpegThumbnailQuality ()
加入API级别5
返回质量的JPEG图片EXIF缩略图设置。
退货
JPEG的EXIF缩略图设置。
public Camera.Size getJpegThumbnailSize ()
加入API级别5
返回EXIF缩略图的JPEG图片的尺寸。
退货
一个物体的大小与高度和宽度的EXIF 缩略图设置
public int getMaxExposureCompensation ()
加入API级别8
得到的最大曝光补偿指数。
退货
最大曝光补偿指数（＞＝0）。如果这方法getminexposurecompensation()
返回0，曝光补偿是不。
public int getMaxNumDetectedFaces ()
加入API级别14
获取人脸支持的最大数量。这是列表的返回的最大长度camera.facedetectionlistener
。如果返回值是0检测指定的，脸型不。
退货
检测到的面部的相机支持的最大数量。
public int getMaxNumFocusAreas ()
加入API级别14
得到最多支持的重点领域。这是列表的最大长度setfocusareas（名单）
和getfocusareas()
。
退货
焦点区域的相机支持的最大数量。
public int getMaxNumMeteringAreas ()
加入API级别14
获取最大数量的计量领域的支持。这是列表的最大长度setmeteringareas（名单）
和getmeteringareas()
。
退货
最大数量的计量领域的相机支持。
public int getMaxZoom ()
加入API级别8
得到的缩放所允许的最大值为快照。这是最大的值，应用程序可以设置为setzoom（int）
应用程序。iszoomsupported()
在使用本方法。这个值可能会在不同的预览大小的变化。应用应调用此后再设置预览大小。
退货
由相机支持的最大的缩放值。
public List<Camera.Area> getMeteringAreas ()
加入API级别14
获取当前计量范围。摄像头驱动程序使用这些地区决定曝光。
在使用这个API或setmeteringareas（名单）
应用程序应该调用，getmaxnummeteringareas()
要知道计量领域第一的最大数量。如果该值为0，计量面积不支持。
每个测光区域是一个矩形指定重量。该方向相对于传感器的方向，即，传感器看到什么。方向不受旋转或镜像setdisplayorientation（int）
。坐标的矩形范围从1000到1000。（1000，1000）是左上点。（1000，1000）是右下点。宽度和高度计量范围不能0或负。
的重量范围从1到1000，并表示每个像素在该地区的一个重。这意味着一个有相同重量的一个较小的区域大计量的地区将在计量结果有更多的影响。计量领域可以部分地重叠和司机将重叠区域中添加量。
一个特殊的情况空
计量区列表意味着司机自由表选择。例如，驱动程序可以使用更多的信号选择计量领域，动态地改变他们。应用程序可以设置计量面积列表空
如果他们想驾驶员完全控制计量。
测光区域相对于查看当前场getzoom()
）。无论缩放级别是什么，（1000，1000）顶部的当前可见的相机代表。该计量面积不能设置在目前来看，即使使用。
无论是计量领域是什么，最终曝光补偿的setexposurecompensation（int）
。
退货
列出当前计量范围
public int getMinExposureCompensation ()
加入API级别8
获得最小的曝光补偿指数。
退货
最小的曝光补偿指数（＜＝0）。如果这方法getmaxexposurecompensation()
返回0，曝光补偿是不。
public int getPictureFormat ()
加入API级别1
返回的照片图像格式。
退货
图片格式
参见
imageformat
public Camera.Size getPictureSize ()
加入API级别1
返回设置图片尺寸。
退货
一个高度和宽度设置图片大小的物体
public Camera.Size getPreferredPreviewSizeForVideo ()
加入API级别11
返回优先推荐或预览大小（宽度和高度）像素的视频。摄像机的应用程序应该设置预览尺寸值不大于优先预览大小。换句话说，对预览大小宽度和高度产品不应大于首选预览大小。此外，我们建议选择一个预览大小具有相同的纵横比为视频的分辨率要记录。
退货
优选的预览大小（宽度和高度）的像素中录像如果getsupportedvideosizes()不返回空；否则，返回null。
public int getPreviewFormat ()
加入API级别1
返回预览帧的图像格式有camera.previewcallback
。
退货
预览格式。
参见
imageformat
public void getPreviewFpsRange (int[] range)
加入API级别9
返回当前预览的帧的最大和最小。价值观是返回的元素之一getsupportedpreviewfpsrange()
。
退货
范围的最小和最大的预览的FPS（按1000）。
public int getPreviewFrameRate ()
加入API级别1
该方法使用在API级别9 。替代的getpreviewfpsrange（int [ ]）
返回设置的速度在预览框收到。这是目标帧速率。实际帧速率取决于司机。
退货
帧速率设置（帧/秒）
public Camera.Size getPreviewSize ()
加入API级别1
返回的尺寸设置预览图片。
退货
一个物体的大小和宽度和高度的预览图像设置
public String getSceneMode ()
加入API级别5
获取当前情景模式设置。
退货
一个scene_mode_xxx字符串常量。如果设置空场景模式不支持。
public List<String> getSupportedAntibanding ()
加入API级别5
获取受支持的antibanding值。
退货
名单支持antibanding值。如果antibanding空设置不支持。
公共列表<字符串> getsupportedcoloreffects （）
加入API级别5
获取受支持的颜色的影响。
退货
名单支持颜色的影响。空如果颜色效果设置不支持。
public List<String> getSupportedAntibanding ()
加入API级别5
获取受支持的闪光模式。
退货
名单支持闪光模式。空如果闪光模式设置不支持。
public List<String> getSupportedFlashModes ()
加入API级别5
获取受支持的对焦模式。
退货
名单支持对焦模式。该方法将永远返回一个列表中至少一个元素。
public List<Camera.Size> getSupportedJpegThumbnailSizes ()
加入API级别8
获取受支持的JPEG缩略图的大小。
退货
一个列表对象的大小。该方法将总是返回一个列表至少有两个元素。大小0（无缩略图）总是支持。
public List<Integer> getSupportedPictureFormats ()
加入API级别5
获取受支持的图片格式。
退货
支持的图片格式。该方法将总是返回一个列表中至少一个元素。
参见
imageformat
public List<Camera.Size> getSupportedPictureSizes ()
加入API级别5
获取受支持的图片大小。
退货
名单支持图片大小。该方法将永远返回一个列表中至少一个元素。
public List<Integer> getSupportedPreviewFormats ()
加入API级别5
获取受支持的预览格式。nv21
总是支持。YV12
总是支持API级别12以来。
退货
名单支持预览格式。该方法将永远返回一个列表中至少一个元素。
参见
imageformat
public List<int[]> getSupportedPreviewFpsRange ()
加入API级别9
获取受支持的预览帧（帧每秒）的范围。每个范围包含一个最小和最大FPS FPS。如果最低fps等于最大FPS，固定帧速率的相机输出帧。如果不是，架在汽车车架相机输出。实际帧速率的最大值和最小值之间的波动。价值观是乘以1000为整数。例如，如果框架速率是每秒26.623帧，该值为26623。
退货
名单支持预览帧范围。此方法返回一个列表中至少一个元素。每一个元素的数组的两个值的最小和最大FPS FPS。列表是从小到大的排序（第一最大FPS然后最低fps）。
public List<Integer> getSupportedPreviewFrameRates ()
加入API级别5
该方法使用在API级别9 。替代的getsupportedpreviewfpsrange()
获取受支持的预览帧速率。
退货
名单支持预览帧速率。空如果预览帧速率设置不支持。
public List<Camera.Size> getSupportedPreviewSizes ()
加入API级别5
获取受支持的预览图片。
退货
一个列表对象的大小。该方法将总是返回一个列表至少有一个元素。
public List<String> getSupportedSceneModes ()
加入API级别5
获取受支持的场景模式。
退货
名单支持场景模式。空如果情景模式设置不支持。
public List<Camera.Size> getSupportedVideoSizes ()
加入API级别11
获取受支持的视频帧的大小，可以通过使用 mediarecorder。
如果返回的列表是否为空，返回列表将包含在至少一个尺寸和一个在返回列表的大小必须通过mediarecorder。用于摄像机应用setvideosize()如果摄像机作为视频源。在这种情况下，预览的大小可以在视频记录是不同的从记录的视频分辨率。
退货
一个列表的大小的物体如果相机有单独的预览和视频输出；否则，返回null。
参见
getpreferredpreviewsizeforvideo()
public List<String> getSupportedWhiteBalance ()
加入API级别5
获取受支持的白平衡。
退货
名单支持白平衡。如果空白平衡设置不支持。
public float getVerticalViewAngle ()
加入API级别8
获取垂直视角度。
退货
垂直的角度来看。该方法将总是返回一个有效值。
public boolean getVideoStabilization ()
加入API级别15
得到的视频稳定化的现状。看到setvideostabilization（布尔）
对于视频稳像的细节。
退货
如果启用了视频稳定化
参见
isvideostabilizationsupported()
public String getWhiteBalance ()
加入API级别5
获取当前白平衡设置。
退货
目前的白平衡。空如果白平衡设置不支持。
white_balance_warm_fluorescent
public int getZoom ()
加入API级别8
获取当前的缩放值。这也可以在平滑变焦是在进步。应用程序应该检查iszoomsupported()
在使用这种方法。
退货
当前的缩放值。范围是0到getmaxzoom()
。0意味着相机不放大。
public List<Integer> getZoomRatios ()
加入API级别8
获取所有的变焦缩放比例值。应用程序应该检查iszoomsupported()
在使用这个方法。
退货
1 / 100的增量缩放比例。例如：一个变焦3.2是返回320。元素的数目getmaxzoom()
1。列表是从小到大的排序。第一个元素是100的。最后一个元素的最大值缩放缩放比。
public boolean isAutoExposureLockSupported ()
加入API级别14
如果自动曝光锁定支持，返回true。应用应调用此之前试图锁定自动曝光。看到setautoexposurelock（布尔）
关于锁的细节。
退货
如果自动曝光锁定支持。
public boolean isAutoWhiteBalanceLockSupported ()
加入API级别14
如果自动白平衡锁定支持返回true。应用应调用此之前试图锁定自动白平衡。看到setautowhitebalancelock（布尔）
关于锁的细节。
退货
如果自动白平衡锁的支持。
参见
setautowhitebalancelock（布尔）
public boolean isSmoothZoomSupported ()
加入API级别8
如果顺利变焦支持返回true。程序应该调用这才使用其他顺畅的缩放方法。
退货
如果是支持平滑缩放。
public boolean isVideoSnapshotSupported ()
加入API级别14
如果视频快照支持返回true。那是，应用程序可以调用TakePicture（camera.shuttercallback，camera.picturecallback，camera.picturecallback，相机。picturecallback）
在记录期间。应用程序不需要打电话startpreview()
拍照后。预览仍将活跃。除此之外，拍照时记录是以图片通常相同。所有设置和方法TakePicture同相关工作。前：getpicturesize()
，getsupportedpicturesizes()
，setjpegquality（int）
，setrotation（int）
，等图片会有EXIF标题。flash_mode_auto
和flash_mode_on
同时还在工作，但视频记录闪光。
应用程序可以设置快门回调为避免快门声。它还建议将原图像和后视图回调无效避免预览显示中断。
对记录的视频领域的可能是不同的拍摄的照片。一个视频快照的最大大小可能小于定期仍然捕捉。如果当前的图片尺寸设定为比可以通过视频快照支持的图片，将在最大负载大小而被捕。
退货
如果视频快照支持。
public boolean isVideoStabilizationSupported ()
加入API级别15
如果视频稳定的支持，返回true。看到setvideostabilization（布尔）
对于视频稳像的细节。
退货
如果视频稳定的支持
public boolean isZoomSupported ()
加入API级别8
如果变焦支持返回true。应用程序应该使用其他的变焦方法之前调用此。
退货
如果变焦的支持。
public void remove (String key)
加入API级别1
public void removeGpsData ()
加入API级别5
消除GPS纬度，经度，高度，和从参数时间戳。
public void set (String key, String value)
加入API级别1
设置一个字符串参数。
参数
key
为参数的关键的名字
value
参数的字符串值
public void set (String key, int value)
加入API级别1
设置一个整数参数。
参数
key
为参数的关键的名字
value
参数的初始值
public void setAntibanding (String antibanding)
加入API级别5
设置antibanding。
参数
antibanding
新的antibanding价值。
public void setAutoExposureLock (boolean toggle)
加入API级别14
设置自动曝光锁定状态。应用程序应该检查isautoexposurelocksupported()
在使用这个方法。
如果设置为TRUE，相机的自动曝光程序将立即暂停直至锁设置为false。曝光补偿设置变化仍然生效而自动曝光锁定。
如果自动曝光已被锁定，设置为TRUE，又有没有影响（司机不会重新计算的曝光值）。
停止预览stoppreview()
，或触发仍然图像捕捉TakePicture（camera.shuttercallback，camera.picturecallback，相机。picturecallback）
，不会改变锁。
曝光补偿，自动曝光锁定，和自动白平衡锁可以用来捕捉图像的曝光被爆，为。
自动曝光锁定状态，包括状态，不会后保持相机release()
被称为。自动曝光锁定后open()
但在第一次调用startpreview()
不允许自动曝光程序运行的，并可能导致严重的过度或曝光不足的图像。
参数
toggle
的自动曝光锁定新的状态。这意味着自动曝光锁定，虚假意味着自动曝光程序是免费的正常运行。
public void setAutoWhiteBalanceLock (boolean toggle)
加入API级别14
设置自动白平衡锁定状态。应用程序应该检查isautowhitebalancelocksupported()
在使用本方法。
如果设置为TRUE，相机自动白平衡程序将立即暂停直至锁设置为false。
如果自动白平衡已被锁定，设置为TRUE，又没有影响（司机不会重新计算白平衡值）。
停止预览stoppreview()
，或触发仍然图像捕捉TakePicture（camera.shuttercallback，camera.picturecallback，相机。picturecallback）
，不会改变锁。
改变白平衡模式setwhitebalance（字符串）
要设置自动白平衡锁释放。
曝光补偿，自动曝光锁定，和AWB锁可以用来捕获曝光被突发的图像，例如。自动白平衡状态，包括锁定状态，不会后保持release()
被称为。锁定自动白平衡后open()
但在第一次调用startpreview()
不允许自动白平衡的常规来运行的，并可能导致在捕获的图像颜色严重错误。
参数
toggle
的自动白平衡锁定新的状态。真是，自动白平衡是锁着的，虚假的，自动白平衡程序是免费的正常运行。
public void setColorEffect (String value)
加入API级别5
设置当前的颜色设置效果。
参数
value
新的色彩效果。
public void setExposureCompensation (int value)
加入API级别8
设置曝光补偿指数。
参数
value
曝光补偿指数。有效值的范围从getminexposurecompensation()
（含）至getmaxexposurecompensation()
（含）。0意味着暴露不调整。应用程序应该调用 getminexposurecompensation和getmaxexposurecompensation到知道曝光补偿的支持。
public void setFlashMode (String value)
加入API级别5
设置闪光模式。
参数
value
闪光模式。
)" style="color: rgb(255, 153, 0); text-decoration: none;">
public void setFocusAreas (List<Camera.Area> focusAreas)
加入API级别14
设置焦点区域。看到getfocusareas()
文件。
参数
focusAreas
重点领域
public void setFocusMode (String value)
加入API级别5
设置焦点模式。
参数
value
聚焦方式。
public void setGpsAltitude (double altitude)
加入API级别5
集GPS高程。这将被存储在JPEG的EXIF标题。
参数
altitude
GPS海拔高度。
public void setGpsLatitude (double latitude)
加入API级别5
集GPS经纬度坐标。这将被存储在JPEG的EXIF 头。
参数
latitude
GPS经纬度坐标。
public void setGpsLongitude (double longitude)
加入API级别5
集GPS经纬度坐标。这将被存储在JPEG的EXIF 头。
参数
longitude
GPS经纬度坐标。
public void setGpsProcessingMethod (String processing_method)
加入API级别8
集GPS处理方法。它将存储多达32个字符 JPEG的EXIF标题。
参数
processing_method
得到这个位置的处理方法。
public void setGpsTimestamp (long timestamp)
加入API级别5
集GPS时间戳。这将被存储在JPEG的EXIF标题。
参数
timestamp（自一月一日以来， 1970秒UTC）。
public void setJpegQuality (int quality)
加入API级别5
捕获的图像集的JPEG质量。
参数
质量
捕获的图像JPEG质量。范围是1 100，100是最好的。
public void setJpegThumbnailQuality (int quality)
加入API级别5
套在JPEG图片EXIF缩略图质量。
参数
quality
的EXIF缩略图JPEG质量。范围是1 100，100是最好的。
public void setJpegThumbnailSize (int width, int height)
加入API级别5
集的EXIF缩略图的JPEG图片的尺寸。如果应用设置宽度和高度为0，不含 EXIF缩略图。
应用需要考虑的显示方向。看到setpreviewsize（int，int）
参考。
参数
width
缩略图的宽度，以像素为单位
height
缩略图的高度，以像素为单位
)" style="color: rgb(255, 153, 0); text-decoration: none;">
public void setMeteringAreas (List<Camera.Area> meteringAreas)
加入API级别14
集计量范围。看到getmeteringareas()
为文件。
参数
meteringareas
计量区
public void setPictureFormat (int pixel_format)
加入API级别1
设置图片的图像格式。
参数
pixel_format
所需的图片格式imageformat.nv21
，imageformat.rgb_565
，或imageformat.jpeg
）
参见
imageformat
public void setPictureSize (int width, int height)
加入API级别1
设置图片的尺寸。
应用需要考虑的显示方向。看到setpreviewsize（int，int）
参考。
参数
width
图片的宽度，以像素为单位
height
图片的高度，以像素为单位
public void setPreviewFormat (int pixel_format)
加入API级别1
设置预览照片的图像格式。
如果这不叫，默认的格式将nv21
，这使用nv21编码格式。
使用getsupportedpreviewformats()
得到的列表可预览格式。
这是强烈建议要么nv21
或YV12
使用，因为他们的相机设备支持。
以YV12，接收到的图像缓冲区不一定紧凑，有可能在每一行的像素数据的端填充物，如YV12
。相机的回调数据，可以假设步幅的Y和紫外，数据是尽可能满足对齐。那就是，如果预览的大小宽度x高度
然后，方程描述缓冲指数为行开始Y
为Y平面和行C
为U和V 飞机：
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;
参数
pixel_format
所需的预览图片格式，通过一个定义imageformat
常数。（例如，imageformat.nv21
（默认），或imageformat.yv12
）
参见
imageformat
public void setPreviewFpsRange (int min, int max)
加入API级别9
最小和最大帧设置预览。该控制预览帧的速率接收camera.previewcallback
。最小和最大预览帧必须是一个元素getsupportedpreviewfpsrange()
。
参数
min
最小的预览的FPS（按1000）。
max
最大的预览的FPS（按1000）。
抛出
RuntimeException
如果FPS范围无效。
参见
setpreviewcallbackwithbuffer（相机。previewcallback）
public void setPreviewFrameRate (int fps)
加入API级别1
该方法使用在API级别9 。替代的setpreviewfpsrange（int，int）
设置预览的帧被接收的速率。这是目标帧速率。实际帧速率取决于驱动程序。
参数
FPS
帧速率（帧每秒）
public void setPreviewSize (int width, int height)
加入API级别1
设置预览照片的尺寸。如果预览已经开始，应用程序应该停止预览先改变预览大小。两侧的宽度和高度都是基于 。这是，预览的大小是在由显示方向旋转的大小。这样的应用需要而设置预览大小考虑显示方向。例如，假设相机支持两480x320和块的预览图片。应用程序要比3:2 预览。如果显示方向设置为0或180，预览大小应设置为480x320。如果显示方向设置为90或270 ，预览大小应设置为320x480。显示取向也应同时设置图片的大小和缩略图大小考虑。
参数
width
图片的宽度，以像素为单位
height
图片的高度，以像素为单位
public void setRecordingHint (boolean hint)
加入API级别14
集记录模式的提示。这告诉相机，应用的目的是记录视频start()
，不采取照片TakePicture（camera.shuttercallback，camera.picturecallback，camera.picturecallback，相机。picturecallback）
。使用这个提示可以允许mediarecorder。start()启动得更快或在输出毛刺少。这应该是在最好的结果开始预览称，但可以预览时活性变化。默认值为false。 应用程序仍然可以takepicture()当呼叫提示是真的还是叫 start()时mediarecorder提示。但是性能可能更糟。
参数
hint
如果应用程序打算录制视频的使用mediarecorder
。
public void setRotation (int rotation)
加入API级别5
集度相对于相机的方向顺时针旋转角度。这会影响 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); }
参数
rotation
度的旋转角度相对于相机的取向。旋转只能是0， 90，180或270。
抛出
illegalargumentexception
如果旋转值无效。
public void setSceneMode (String value)
加入API级别5
设置场景模式。变化的场景模式可能会覆盖其他参数（如闪光模式，对焦模式，白平衡）。为的例子，假设原来的闪光模式是在支持Flash 模式开/关。在夜景模式，闪光模式和闪光模式支持的可更改了。在设置的场景模式，程序应该调用getparameters知道一些参数。
参数
value
场景模式。
public void setVideoStabilization (boolean toggle)
加入API级别15
启用和禁用视频稳定。使用isvideostabilizationsupported()
要确定是否调用此方法是有效的。
视频稳定减少因晃动的摄像机运动在两个预览流和视频记录，包括从预览回调接收数据。它在不减少运动模糊图像TakePicture
。
视频稳定可以启用在预览或记录是活跃的残疾，但切换可能导致在视频流可以在录制的视频是不可取的一跳。
参数
toggle
设置为true，使视频稳定，与假禁用视频稳定。
参见
isvideostabilizationsupported()
public void setWhiteBalance (String value)
加入API级别5
设置白平衡。改变的设置将释放锁自动白平衡。建议不要同时变白平衡AWB锁。
参数
value
新的白平衡。
public void setZoom (int value)
加入API级别8
设置缩放值。如果相机放大（值＞0），图片的实际大小可能小于图片大小设置。应用尺寸后，图片是返回可以检查实际的图片camera.picturecallback
。预览的大小保持在相同的变焦。应用程序应该检查iszoomsupported()
在使用这个方法。
参数
value
变焦值。有效的范围是0到getmaxzoom()
。
public void unflatten (String flattened)
加入API级别1
以一个扁平的字符串参数，增加了每一个这个参数对象。
的flatten()
方法有相反的。
参数
flattened
一个字符串参数（键-值配对），是分号分隔
除特别说明外，此内容的许可下Apache 2。细节和限制，见内容许可证。
Android 4.4 R1—20 May 2014 18:19
关于Android|法律|支持
