Camera.Parameters 参数

public class

Camera.Parameters

extends ​​Object​​

​​java.lang.Object​​
↳	android.hardware.Camera.Parameters

Class Overview

类概述

---

相机的服务设置。

使相机参数生效，应用程序必须调用​​setparameters（相机参数。）​​。例如，在​​setwhitebalance（字符串）​​被称为，白平衡不实际上改变了之前​​setparameters（相机参数。）​​被称为参数变化的对象。

不同的设备可能有不同的相机功能，如图片的大小或闪光模式。应用程序应该查询相机能力之前设置参数。例如，应用应该打电话​​getsupportedcoloreffects()​​在呼叫​​setcoloreffect（字符串）​​。如果相机不支持颜色的影响，​​getsupportedcoloreffects()​​将返回null。

概要

常数
​​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​​	闪光灯会自动在需要的时候被解雇。
​​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_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​​

	公共方法
​​String​​	​​flatten​​() 创建一套这个对象的所有参数的单个字符串参数。
​​String​​	​​get​​(​​String​​ key) 返回一个字符串参数的值。
​​String​​	​​getantibanding​​（） 获取当前antibanding设置。
boolean	​​getautoexposurelock​​（） 获取自动曝光锁定状态。
boolean	​​getautowhitebalancelock​​（） 获取自动白平衡锁的状态。
​​String​​	​​getcoloreffect​​（） 获取当前的颜色设置效果。
int	​​getexposurecompensation​​（） 获取当前曝光补偿指数。
float	​​getexposurecompensationstep​​（） 获取曝光补偿的步骤。
​​String​​	​​getflashmode​​（） 获取当前的闪光模式设定。
float	​​getfocallength​​（） 变焦距（毫米）的相机。
​​List​​<​​Camera.Area​​>	​​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​​（） 得到的缩放所允许的最大值为快照。
​​List​​<​​Camera.Area​​>	​​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​​（） 获取当前情景模式设置。
​​List​​<​​String​​>	​​getsupportedantibanding​​（） 获取受支持的antibanding值。
​​List​​<​​String​​>	​​getsupportedcoloreffects​​（） 获取受支持的颜色的影响。
​​List​​<​​String​​>	​​getsupportedflashmodes​​（） 获取受支持的闪光模式。
​​List​​<​​String​​>	​​getsupportedfocusmodes​​（） 获取受支持的对焦模式。
​​List​​<​​Camera.Size​​>	​​getsupportedjpegthumbnailsizes​​（） 获取受支持的JPEG缩略图的大小。
​​List​​<​​Integer​​>	​​getsupportedpictureformats​​（） 获取受支持的图片格式。
​​List​​<​​Camera.Size​​>	​​getsupportedpicturesizes​​（） 获取受支持的图片大小。
​​List​​<​​Integer​​>	​​getsupportedpreviewformats​​（） 获取受支持的预览格式。
​​List​​<int[]>	​​getsupportedpreviewfpsrange​​（） 获取受支持的预览帧（帧每秒）的范围。
​​List​​<​​Integer​​>	​​getsupportedpreviewframerates​​（） 该方法被在API级别9。取代​​​​getsupportedpreviewfpsrange()​​​​
​​List​​<​​Camera.Size​​>	​​getsupportedpreviewsizes​​（） 获取受支持的预览图片。
​​List​​<​​String​​>	​​getsupportedscenemodes​​（） 获取受支持的场景模式。
​​List​​<​​Camera.Size​​>	​​getsupportedvideosizes​​（） 获取受支持的视频帧的大小，可以通过使用 mediarecorder。
​​List​​<​​String​​>	​​getsupportedwhitebalance​​（） 获取受支持的白平衡。
float	​​getverticalviewangle​​（） 获取垂直视角度。
boolean	​​getvideostabilization​​（） 得到的视频稳定化的现状。
​​String​​	​​getwhitebalance​​（） 获取当前白平衡设置。
int	​​getzoom​​（） 获取当前的缩放值。
​​List​​<​​Integer​​>	​​getzoomratios​​（） 获取所有的变焦缩放比例值。
boolean	​​isautoexposurelocksupported​​（） 如果自动曝光锁定支持，返回true。
boolean	​​isautowhitebalancelocksupported​​（） 如果自动白平衡锁定支持返回true。
boolean	​​issmoothzoomsupported​​（） 如果顺利变焦支持返回true。
boolean	​​isvideosnapshotsupported​​（） 如果视频快照支持返回true。
boolean	​​isvideostabilizationsupported​​（） 如果视频稳定的支持，返回true。
boolean	​​iszoomsupported​​（） 如果变焦支持返回true。
void	​​拆下​​（​​字符串​​键）
void	​​removegpsdata​​（） 消除GPS纬度，经度，高度，和从参数时间戳。
void	​​配置​​（​​字符串​​关键的，​​字符串​​值） 设置一个字符串参数。
void	​​配置​​（​​字符串​​关键，int值） 设置一个整数参数。
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​​（​​字符串​​扁平） 以一个扁平的字符串参数，增加了每一个这个参数对象。

											​​[扩展]​​ 继承的方法
​​​​从阶级​​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空设置不支持。

参见

• ​​antibanding_auto​​
• ​​antibanding_50hz​​
• ​​antibanding_60hz​​
• ​​antibanding_off​​

public boolean getAutoExposureLock ()

加入​​API级别14​​

获取自动曝光锁定状态。应用程序应该检查​​isautoexposurelocksupported()​​在使用这个方法。看到​​setautoexposurelock（布尔）​​关于锁的细节。

退货

• 的自动曝光锁定状态。如果自动曝光目前锁返回真，否则为假。

参见

• ​​setautoexposurelock（布尔）​​

public boolean getAutoWhiteBalanceLock ()

加入​​API级别14​​

获取自动白平衡锁的状态。应用程序应该检查​​isautowhitebalancelocksupported()​​在使用本方法。看到​​setautowhitebalancelock（布尔）​​关于锁细节。

退货

• 锁定状态的自动白平衡。如果自动白平衡是目前锁定返回真，假否则。

参见

• ​​setautowhitebalancelock（布尔）​​

public ​​String​​ getColorEffect ()

加入​​API级别5​​

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

退货

• 当前颜色的影响。空如果颜色效果设置不支持。

参见

• ​​effect_none​​
• ​​effect_mono​​
• ​​effect_negative​​
• ​​effect_solarize​​
• ​​effect_sepia​​
• ​​effect_posterize​​
• ​​effect_whiteboard​​
• ​​effect_blackboard​​
• ​​effect_aqua​​

public int getExposureCompensation ()

加入​​API级别8​​

获取当前曝光补偿指数。

退货

• 目前的曝光补偿指数。的范围​​getminexposurecompensation()​​对​​getmaxexposurecompensation()​​。0意味着曝光不调整。

public float getExposureCompensationStep ()

加入​​API级别8​​

获取曝光补偿的步骤。

退货

• 曝光补偿步骤。应用程序可以通过增加曝光补偿EV 指标和步骤。例如：如果曝光补偿指数是6，步长为0.333333333，是2 eV的。

public ​​String​​ getFlashMode ()

加入​​API级别5​​

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

退货

• 目前的闪光模式。空如果闪光模式设置不支持。

参见

• ​​flash_mode_off​​
• ​​flash_mode_auto​​
• ​​flash_mode_on​​
• ​​flash_mode_red_eye​​
• ​​flash_mode_torch​​

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​​。

参数

输出	焦点距离米。输出必须是一个具有三个元素的数组的浮。近距离的最佳焦点，焦点距离远，焦距将填充数组。

参见

• ​​focus_distance_near_index​​
• ​​focus_distance_optimal_index​​
• ​​focus_distance_far_index​​

public ​​String​​ getFocusMode ()

加入​​API级别5​​

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

退货

• 目前的焦点模式。此方法将总是返回一个非空的价值。程序应该调用​​自动对焦（autofocuscallback）​​如果焦点模式focus_mode_auto或focus_mode_macro开始重点。

参见

• ​​focus_mode_auto​​
• ​​focus_mode_infinity​​
• ​​focus_mode_macro​​
• ​​focus_mode_fixed​​
• ​​focus_mode_edof​​
• ​​focus_mode_continuous_video​​

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检测指定的，脸型不。

退货

• 检测到的面部的相机支持的最大数量。

参见

• ​​startfacedetection()​​

public int getMaxNumFocusAreas ()

加入​​API级别14​​

得到最多支持的重点领域。这是列表的最大长度​​setfocusareas（名单）​​和​​getfocusareas()​​。

退货

• 焦点区域的相机支持的最大数量。

参见

• ​​getfocusareas()​​

public int getMaxNumMeteringAreas ()

加入​​API级别14​​

获取最大数量的计量领域的支持。这是列表的最大长度​​setmeteringareas（名单）​​和​​getmeteringareas()​​。

退货

• 最大数量的计量领域的相机支持。

参见

• ​​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。

参见

• ​​getsupportedvideosizes()​​

public int getPreviewFormat ()

加入​​API级别1​​

返回预览帧的图像格式有​​camera.previewcallback​​。

退货

• 预览格式。

参见

• ​​imageformat​​
• ​​setpreviewformat（int）​​

public void getPreviewFpsRange (int[] range)

加入​​API级别9​​

返回当前预览的帧的最大和最小。价值观是返回的元素之一​​getsupportedpreviewfpsrange()​​。

退货

• 范围的最小和最大的预览的FPS（按1000）。

参见

• ​​preview_fps_min_index​​
• ​​preview_fps_max_index​​
• ​​getsupportedpreviewfpsrange()​​

public int getPreviewFrameRate ()

加入​​API级别1​​

 

该方法使用在API级别9 。

替代的​​getpreviewfpsrange（int [ ]）​​

返回设置的速度在预览框收到。这是目标帧速率。实际帧速率取决于司机。

退货

• 帧速率设置（帧/秒）

public ​​Camera.Size​​ getPreviewSize ()

加入​​API级别1​​

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

退货

• 一个物体的大小和宽度和高度的预览图像设置

public ​​String​​ getSceneMode ()

加入​​API级别5​​

获取当前情景模式设置。

退货

• 一个scene_mode_xxx字符串常量。如果设置空场景模式不支持。

参见

• ​​scene_mode_auto​​
• ​​scene_mode_action​​
• ​​scene_mode_portrait​​
• ​​scene_mode_landscape​​
• ​​scene_mode_night​​
• ​​scene_mode_night_portrait​​
• ​​scene_mode_theatre​​
• ​​scene_mode_beach​​
• ​​scene_mode_snow​​
• ​​scene_mode_sunset​​
• ​​scene_mode_steadyphoto​​
• ​​scene_mode_fireworks​​
• ​​scene_mode_sports​​
• ​​scene_mode_party​​
• ​​scene_mode_candlelight​​
• ​​scene_mode_barcode​​

public ​​List​​<​​String​​> getSupportedAntibanding ()

加入​​API级别5​​

获取受支持的antibanding值。

退货

• 名单支持antibanding值。如果antibanding空设置不支持。

参见

• ​​getantibanding()​​

公共​​列表​​<​​字符串​​> getsupportedcoloreffects （）

加入​​API级别5​​

获取受支持的颜色的影响。

退货

• 名单支持颜色的影响。空如果颜色效果设置不支持。

参见

• ​​getcoloreffect()​​

public ​​List​​<​​String​​> getSupportedAntibanding ()

加入​​API级别5​​

获取受支持的闪光模式。

退货

• 名单支持闪光模式。空如果闪光模式设置不支持。

参见

• ​​getflashmode()​​

public ​​List​​<​​String​​> getSupportedFlashModes ()

加入​​API级别5​​

获取受支持的对焦模式。

退货

• 名单支持对焦模式。该方法将永远返回一个列表中至少一个元素。

参见

• ​​getfocusmode()​​

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​​
• ​​setpreviewformat（int）​​

public ​​List​​<int[]> getSupportedPreviewFpsRange ()

加入​​API级别9​​

获取受支持的预览帧（帧每秒）的范围。每个范围包含一个最小和最大FPS FPS。如果最低fps等于最大FPS，固定帧速率的相机输出帧。如果不是，架在汽车车架相机输出。实际帧速率的最大值和最小值之间的波动。价值观是乘以1000为整数。例如，如果框架速率是每秒26.623帧，该值为26623。

退货

• 名单支持预览帧范围。此方法返回一个列表中至少一个元素。每一个元素的数组的两个值的最小和最大FPS FPS。列表是从小到大的排序（第一最大FPS然后最低fps）。

参见

• ​​preview_fps_min_index​​
• ​​preview_fps_max_index​​

public ​​List​​<​​Integer​​> getSupportedPreviewFrameRates ()

加入​​API级别5​​

 

该方法使用在API级别9 。

替代的​​getsupportedpreviewfpsrange()​​

获取受支持的预览帧速率。

退货

• 名单支持预览帧速率。空如果预览帧速率设置不支持。

public ​​List​​<​​Camera.Size​​> getSupportedPreviewSizes ()

加入​​API级别5​​

获取受支持的预览图片。

退货

• 一个列表对象的大小。该方法将总是返回一个列表至少有一个元素。

public ​​List​​<​​String​​> getSupportedSceneModes ()

加入​​API级别5​​

获取受支持的场景模式。

退货

• 名单支持场景模式。空如果情景模式设置不支持。

参见

• ​​getscenemode()​​

public ​​List​​<​​Camera.Size​​> getSupportedVideoSizes ()

加入​​API级别11​​

获取受支持的视频帧的大小，可以通过使用 mediarecorder。

如果返回的列表是否为空，返回列表将包含在至少一个尺寸和一个在返回列表的大小必须通过mediarecorder。用于摄像机应用setvideosize()如果摄像机作为视频源。在这种情况下，预览的大小可以在视频记录是不同的从记录的视频分辨率。

退货

• 一个列表的大小的物体如果相机有单独的预览和视频输出；否则，返回null。

参见

• ​​getpreferredpreviewsizeforvideo()​​

public ​​List​​<​​String​​> getSupportedWhiteBalance ()

加入​​API级别5​​

获取受支持的白平衡。

退货

• 名单支持白平衡。如果空白平衡设置不支持。

参见

• ​​getwhitebalance()​​

public float getVerticalViewAngle ()

加入​​API级别8​​

获取垂直视角度。

退货

• 垂直的角度来看。该方法将总是返回一个有效值。

public boolean getVideoStabilization ()

加入​​API级别15​​

得到的视频稳定化的现状。看到​​setvideostabilization（布尔）​​对于视频稳像的细节。

退货

• 如果启用了视频稳定化

参见

• ​​isvideostabilizationsupported()​​
• ​​setvideostabilization（布尔）​​

public ​​String​​ getWhiteBalance ()

加入​​API级别5​​

获取当前白平衡设置。

退货

• 目前的白平衡。空如果白平衡设置不支持。

参见

• ​​white_balance_auto​​
• ​​white_balance_incandescent​​
• ​​white_balance_fluorescent​​
• ​​white_balance_warm_fluorescent​​
• ​​white_balance_daylight​​
• ​​white_balance_cloudy_daylight​​
• ​​white_balance_twilight​​
• ​​white_balance_shade​​

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（布尔）​​关于锁的细节。

退货

• 如果自动曝光锁定支持。

参见

• ​​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（布尔）​​对于视频稳像的细节。

退货

• 如果视频稳定的支持

参见

• ​​setvideostabilization（布尔）​​
• ​​getvideostabilization()​​

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价值。

参见

• ​​getantibanding()​​

public void setAutoExposureLock (boolean toggle)

加入​​API级别14​​

设置自动曝光锁定状态。应用程序应该检查​​isautoexposurelocksupported()​​在使用这个方法。

如果设置为TRUE，相机的自动曝光程序将立即暂停直至锁设置为false。曝光补偿设置变化仍然生效而自动曝光锁定。

如果自动曝光已被锁定，设置为TRUE，又有没有影响（司机不会重新计算的曝光值）。

停止预览​​stoppreview()​​，或触发仍然图像捕捉​​TakePicture（camera.shuttercallback，camera.picturecallback，相机。picturecallback）​​，不会改变锁。

曝光补偿，自动曝光锁定，和自动白平衡锁可以用来捕捉图像的曝光被爆，为。

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

参数

toggle

的自动曝光锁定新的状态。这意味着自动曝光锁定，虚假意味着自动曝光程序是免费的正常运行。

参见

• ​​getautoexposurelock()​​

public void setAutoWhiteBalanceLock (boolean toggle)

加入​​API级别14​​

设置自动白平衡锁定状态。应用程序应该检查​​isautowhitebalancelocksupported()​​在使用本方法。

如果设置为TRUE，相机自动白平衡程序将立即暂停直至锁设置为false。

如果自动白平衡已被锁定，设置为TRUE，又没有影响（司机不会重新计算白平衡值）。

停止预览​​stoppreview()​​，或触发仍然图像捕捉​​TakePicture（camera.shuttercallback，camera.picturecallback，相机。picturecallback）​​，不会改变锁。

改变白平衡模式​​setwhitebalance（字符串）​​要设置自动白平衡锁释放。

曝光补偿，自动曝光锁定，和AWB锁可以用来捕获曝光被突发的图像，例如。自动白平衡状态，包括锁定状态，不会后保持​​release()​​被称为。锁定自动白平衡后​​open()​​但在第一次调用​​startpreview()​​不允许自动白平衡的常规来运行的，并可能导致在捕获的图像颜色严重错误。

参数

toggle

的自动白平衡锁定新的状态。真是，自动白平衡是锁着的，虚假的，自动白平衡程序是免费的正常运行。

参见

• ​​getautowhitebalancelock()​​
• ​​setwhitebalance（字符串）​​

public void setColorEffect (​​String​​ value)

加入​​API级别5​​

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

参数

value

新的色彩效果。

参见

• ​​getcoloreffect()​​

public void setExposureCompensation (int value)

加入​​API级别8​​

设置曝光补偿指数。

参数

value

曝光补偿指数。有效值的范围从​​getminexposurecompensation()​​（含）至​​getmaxexposurecompensation()​​（含）。0意味着暴露不调整。应用程序应该调用 getminexposurecompensation和getmaxexposurecompensation到知道曝光补偿的支持。

public void setFlashMode (​​String​​ value)

加入​​API级别5​​

设置闪光模式。

参数

value

闪光模式。

参见

• ​​getflashmode()​​

public void setFocusAreas (​​List​​<​​Camera.Area​​> focusAreas)

加入​​API级别14​​

设置焦点区域。看到​​getfocusareas()​​文件。

参数

focusAreas

重点领域

参见

• ​​getfocusareas()​​

public void setFocusMode (​​String​​ value)

加入​​API级别5​​

设置焦点模式。

参数

value

聚焦方式。

参见

• ​​getfocusmode()​​

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	缩略图的高度，以像素为单位

参见

• ​​setpreviewsize（int，int）​​

public void setMeteringAreas (​​List​​<​​Camera.Area​​> meteringAreas)

加入​​API级别14​​

集计量范围。看到​​getmeteringareas()​​为文件。

参数

meteringareas

计量区

参见

• ​​getmeteringareas()​​

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	图片的高度，以像素为单位

参见

• ​​setpreviewsize（int，int）​​

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​​
• ​​getsupportedpreviewformats()​​

public void setPreviewFpsRange (int min, int max)

加入​​API级别9​​

最小和最大帧设置预览。该控制预览帧的速率接收​​camera.previewcallback​​。最小和最大预览帧必须是一个元素​​getsupportedpreviewfpsrange()​​。

参数

min	最小的预览的FPS（按1000）。
max	最大的预览的FPS（按1000）。

抛出

​​RuntimeException​​

如果FPS范围无效。

参见

• ​​setpreviewcallbackwithbuffer（相机。previewcallback）​​
• ​​getsupportedpreviewfpsrange()​​

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	图片的高度，以像素为单位

参见

• ​​setdisplayorientation（int）​​
• ​​getcamerainfo（int，camerainfo）​​
• ​​setpicturesize（int，int）​​
• ​​setjpegthumbnailsize（int，int）​​

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​​

如果旋转值无效。

参见

• ​​orientationeventlistener​​
• ​​getcamerainfo（int，camerainfo）​​

public void setSceneMode (​​String​​ value)

加入​​API级别5​​

设置场景模式。变化的场景模式可能会覆盖其他参数（如闪光模式，对焦模式，白平衡）。为的例子，假设原来的闪光模式是在支持Flash 模式开/关。在夜景模式，闪光模式和闪光模式支持的可更改了。在设置的场景模式，程序应该调用getparameters知道一些参数。

参数

value

场景模式。

参见

• ​​getscenemode()​​

public void setVideoStabilization (boolean toggle)

加入​​API级别15​​

启用和禁用视频稳定。使用​​isvideostabilizationsupported()​​要确定是否调用此方法是有效的。

视频稳定减少因晃动的摄像机运动在两个预览流和视频记录，包括从预览回调接收数据。它在不减少运动模糊图像​​TakePicture​​。

视频稳定可以启用在预览或记录是活跃的残疾，但切换可能导致在视频流可以在录制的视频是不可取的一跳。

参数

toggle

设置为true，使视频稳定，与假禁用视频稳定。

参见

• ​​isvideostabilizationsupported()​​
• ​​getvideostabilization()​​

public void setWhiteBalance (​​String​​ value)

加入​​API级别5​​

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

参数

value

新的白平衡。

参见

• ​​getwhitebalance()​​
• ​​setautowhitebalancelock（布尔）​​

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​​|​​法律​​|​​支持​​