Camera.Parameters 参数

来源：互联网发布：哔哩哔哩 for mac 编辑：程序博客网时间：2024/04/29 13:47

转载来自:http://blog.csdn.net/aiqing0119/article/details/27680137

public class

Camera.Parameters

extends Objectjava.lang.Object ↳android.hardware.Camera.Parameters

Class Overview

类概述

相机的服务设置。

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

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

概要

常数Stringantibanding_50hz Stringantibanding_60hz Stringantibanding_auto Stringantibanding_off Stringeffect_aqua Stringeffect_blackboard Stringeffect_mono Stringeffect_negative Stringeffect_none Stringeffect_posterize Stringeffect_sepia Stringeffect_solarize Stringeffect_whiteboard Stringflash_mode_auto闪光灯会自动在需要的时候被解雇。Stringflash_mode_off闪光灯不会被解雇。Stringflash_mode_on闪光总是会被解雇的快照。Stringflash_mode_red_eyeFlash将红眼模式发射。Stringflash_mode_torch在预览灯不断涌出，自动对焦和快照。intfocus_distance_far_index数组中的远距使用getfocusdistances（浮[ ]）。intfocus_distance_near_index数组中的近距离使用的焦点getfocusdistances（浮[ ]）。intfocus_distance_optimal_index使用的最佳焦点距离的数组索引getfocusdistances（浮[ ]）。Stringfocus_mode_auto自动对焦模式。Stringfocus_mode_continuous_picture用于拍照的连续自动对焦模式。Stringfocus_mode_continuous_video用于视频记录的连续自动对焦模式。Stringfocus_mode_edof扩展景深（EDOF）。Stringfocus_mode_fixed的焦点是固定的。Stringfocus_mode_infinity重点是无穷的。Stringfocus_mode_macro宏观（特写）对焦模式。intpreview_fps_max_index使用最大预览帧数组索引getpreviewfpsrange（int [ ]）或getsupportedpreviewfpsrange()。intpreview_fps_min_index使用最小预览帧数组索引getpreviewfpsrange（int [ ]）或getsupportedpreviewfpsrange()。Stringscene_mode_action以快速移动的物体的照片。Stringscene_mode_auto场景模式关闭。Stringscene_mode_barcode应用程序正在寻找一个条码。Stringscene_mode_beach拍照的海滩上。Stringscene_mode_candlelight捕获场景的自然温暖的颜色，点燃蜡烛。Stringscene_mode_fireworks拍摄焰火。Stringscene_mode_hdr用高动态范围成像技术的现场捕获。Stringscene_mode_landscape在远处的物体图片。Stringscene_mode_night在晚上拍照。Stringscene_mode_night_portrait在晚上吃的人的照片。Stringscene_mode_party采取室内弱光拍摄。Stringscene_mode_portrait以人的照片。Stringscene_mode_snow拍照的雪。Stringscene_mode_sports以快速移动的物体的照片。Stringscene_mode_steadyphoto避免模糊的图片（例如，由于握手）。Stringscene_mode_sunset采取日落的照片。Stringscene_mode_theatre在剧场的照片。Stringwhite_balance_auto Stringwhite_balance_cloudy_daylight Stringwhite_balance_daylight Stringwhite_balance_fluorescent Stringwhite_balance_incandescent Stringwhite_balance_shade Stringwhite_balance_twilight Stringwhite_balance_warm_fluorescent 公共方法Stringflatten()

创建一套这个对象的所有参数的单个字符串参数。

Stringget(String key)

返回一个字符串参数的值。

Stringgetantibanding（）

获取当前antibanding设置。

booleangetautoexposurelock（）

获取自动曝光锁定状态。

booleangetautowhitebalancelock（）

获取自动白平衡锁的状态。

Stringgetcoloreffect（）

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

intgetexposurecompensation（）

获取当前曝光补偿指数。

floatgetexposurecompensationstep（）

获取曝光补偿的步骤。

Stringgetflashmode（）

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

floatgetfocallength（）

变焦距（毫米）的相机。

List<Camera.Area>getfocusareas（）

获取当前的重点领域。

voidgetfocusdistances（浮动[ ]输出）

从摄像机到一个对象似乎是焦点得距离。

Stringgetfocusmode（）

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

floatgethorizontalviewangle（）

获取水平角度来看。

int返回一个值（字符串键）

返回一个整数参数的值。

intgetjpegquality（）

收益质量的JPEG图像设置。

intgetjpegthumbnailquality（）

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

Camera.Sizegetjpegthumbnailsize（）

返回EXIF缩略图的JPEG图片的尺寸。

intgetmaxexposurecompensation（）

得到的最大曝光补偿指数。

intgetmaxnumdetectedfaces（）

获取人脸支持的最大数量。

intgetmaxnumfocusareas（）

得到最多支持的重点领域。

intgetmaxnummeteringareas（）

获取最大数量的计量领域的支持。

intgetmaxzoom（）

得到的缩放所允许的最大值为快照。

List<Camera.Area>getmeteringareas（）

获取当前计量范围。

intgetminexposurecompensation（）

获得最小的曝光补偿指数。

intgetpictureformat（）

返回的照片图像格式。

Camera.Sizegetpicturesize（）

返回设置图片尺寸。

Camera.Sizegetpreferredpreviewsizeforvideo（）

返回优先推荐或预览大小（宽度和高度）像素的视频。

intgetpreviewformat（）

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

voidgetpreviewfpsrange（int [ ]范围）

返回当前预览的帧的最大和最小。

intgetpreviewframerate（）

该方法被在API级别9。取代getpreviewfpsrange（int [ ]）

Camera.Sizegetpreviewsize（）

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

Stringgetscenemode（）

获取当前情景模式设置。

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（）

获取受支持的白平衡。

floatgetverticalviewangle（）

获取垂直视角度。

booleangetvideostabilization（）

得到的视频稳定化的现状。

Stringgetwhitebalance（）

获取当前白平衡设置。

intgetzoom（）

获取当前的缩放值。

List<Integer>getzoomratios（）

获取所有的变焦缩放比例值。

booleanisautoexposurelocksupported（）

如果自动曝光锁定支持，返回true。

booleanisautowhitebalancelocksupported（）

如果自动白平衡锁定支持返回true。

booleanissmoothzoomsupported（）

如果顺利变焦支持返回true。

booleanisvideosnapshotsupported（）

如果视频快照支持返回true。

booleanisvideostabilizationsupported（）

如果视频稳定的支持，返回true。

booleaniszoomsupported（）

如果变焦支持返回true。

void拆下（字符串键）voidremovegpsdata（）

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

void配置（字符串关键的，字符串值）

设置一个字符串参数。

void配置（字符串关键，int值）

设置一个整数参数。

voidsetantibanding（字符串antibanding）

设置antibanding。

voidsetautoexposurelock（布尔切换）

设置自动曝光锁定状态。

voidsetautowhitebalancelock（布尔切换）

设置自动白平衡锁定状态。

voidsetcoloreffect（字符串值）

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

voidsetexposurecompensation（int值）

设置曝光补偿指数。

voidsetflashmode（字符串值）

设置闪光模式。

voidsetfocusareas（列表<相机。面积>重点领域）

设置焦点区域。

voidsetfocusmode（字符串值）

设置焦点模式。

voidsetgpsaltitude（双高度）

集GPS高程。

voidsetgpslatitude（双纬度）

集GPS经纬度坐标。

voidsetgpslongitude（双经度）

集GPS经纬度坐标。

voidsetgpsprocessingmethod（字符串processing_method）

集GPS处理方法。

voidsetgpstimestamp（长时间）

集GPS时间戳。

voidsetjpegquality（int质量）

捕获的图像集的JPEG质量。

voidsetjpegthumbnailquality（int质量）

套在JPEG图片EXIF缩略图质量。

voidsetjpegthumbnailsize（int，int宽度，高度）

集的EXIF缩略图的JPEG图片的尺寸。

voidsetmeteringareas（列表<相机。面积> meteringareas）

集计量范围。

voidsetpictureformat（int pixel_format）

设置图片的图像格式。

voidsetpicturesize（int，int宽度，高度）

设置图片的尺寸。

voidsetpreviewformat（int pixel_format）

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

voidsetpreviewfpsrange（int，int max）

最小和最大帧设置预览。

voidsetpreviewframerate（int FPS）

该方法被在API级别9。取代setpreviewfpsrange（int，int）

voidsetpreviewsize（int，int宽度，高度）

设置预览照片的尺寸。

voidsetrecordinghint（布尔提示）

集记录模式的提示。

voidsetrotation（int旋转）

集度相对于相机的方向顺时针旋转角度。

voidsetscenemode（字符串值）

设置场景模式。

voidsetvideostabilization（布尔切换）

启用和禁用视频稳定。

voidsetwhitebalance（字符串值）

设置白平衡。

voidsetzoom（int值）

设置缩放值。

voidunflatten（字符串扁平）

以一个扁平的字符串参数，增加了每一个这个参数对象。

[扩展]

继承的方法

定值： “自动”

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

加入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

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

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 飞机：

<code><span class="pln">yStride   </span><span class="pun">=</span><span class="pln"> </span><span class="pun">(</span><span class="kwd">int</span><span class="pun">)</span><span class="pln"> ceil</span><span class="pun">(</span><span class="pln">width </span><span class="pun">/</span><span class="pln"> </span><span class="lit">16.0</span><span class="pun">)</span><span class="pln"> </span><span class="pun">*</span><span class="pln"> </span><span class="lit">16</span><span class="pun">;</span><span class="pln"> uvStride  </span><span class="pun">=</span><span class="pln"> </span><span class="pun">(</span><span class="kwd">int</span><span class="pun">)</span><span class="pln"> ceil</span><span class="pun">(</span><span class="pln"> </span><span class="pun">(</span><span class="pln">yStride </span><span class="pun">/</span><span class="pln"> </span><span class="lit">2</span><span class="pun">)</span><span class="pln"> </span><span class="pun">/</span><span class="pln"> </span><span class="lit">16.0</span><span class="pun">)</span><span class="pln"> </span><span class="pun">*</span><span class="pln"> </span><span class="lit">16</span><span class="pun">;</span><span class="pln"> ySize     </span><span class="pun">=</span><span class="pln"> yStride </span><span class="pun">*</span><span class="pln"> height</span><span class="pun">;</span><span class="pln"> uvSize    </span><span class="pun">=</span><span class="pln"> uvStride </span><span class="pun">*</span><span class="pln"> height </span><span class="pun">/</span><span class="pln"> </span><span class="lit">2</span><span class="pun">;</span><span class="pln"> yRowIndex </span><span class="pun">=</span><span class="pln"> yStride </span><span class="pun">*</span><span class="pln"> y</span><span class="pun">;</span><span class="pln"> uRowIndex </span><span class="pun">=</span><span class="pln"> ySize </span><span class="pun">+</span><span class="pln"> uvSize </span><span class="pun">+</span><span class="pln"> uvStride </span><span class="pun">*</span><span class="pln"> c</span><span class="pun">;</span><span class="pln"> vRowIndex </span><span class="pun">=</span><span class="pln"> ySize </span><span class="pun">+</span><span class="pln"> uvStride </span><span class="pun">*</span><span class="pln"> c</span><span class="pun">;</span><span class="pln"> size      </span><span class="pun">=</span><span class="pln"> ySize </span><span class="pun">+</span><span class="pln"> uvSize </span><span class="pun">*</span><span class="pln"> </span><span class="lit">2</span><span class="pun">;</span></code>

参数

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

参考代码如下。

<span class="pln"></span><span class="kwd">public</span><span class="pln"> </span><span class="kwd">void</span><span class="pln"> onOrientationChanged</span><span class="pun">(</span><span class="kwd">int</span><span class="pln"> orientation</span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span><span class="pln">     </span><span class="kwd">if</span><span class="pln"> </span><span class="pun">(</span><span class="pln">orientation </span><span class="pun">==</span><span class="pln"> ORIENTATION_UNKNOWN</span><span class="pun">)</span><span class="pln"> </span><span class="kwd">return</span><span class="pun">;</span><span class="pln">     android</span><span class="pun">.</span><span class="pln">hardware</span><span class="pun">.</span><span class="typ">Camera</span><span class="pun">.</span><span class="typ">CameraInfo</span><span class="pln"> info </span><span class="pun">=</span><span class="pln">            </span><span class="kwd">new</span><span class="pln"> android</span><span class="pun">.</span><span class="pln">hardware</span><span class="pun">.</span><span class="typ">Camera</span><span class="pun">.</span><span class="typ">CameraInfo</span><span class="pun">();</span><span class="pln">     android</span><span class="pun">.</span><span class="pln">hardware</span><span class="pun">.</span><span class="typ">Camera</span><span class="pun">.</span><span class="pln">getCameraInfo</span><span class="pun">(</span><span class="pln">cameraId</span><span class="pun">,</span><span class="pln"> info</span><span class="pun">);</span><span class="pln">     orientation </span><span class="pun">=</span><span class="pln"> </span><span class="pun">(</span><span class="pln">orientation </span><span class="pun">+</span><span class="pln"> </span><span class="lit">45</span><span class="pun">)</span><span class="pln"> </span><span class="pun">/</span><span class="pln"> </span><span class="lit">90</span><span class="pln"> </span><span class="pun">*</span><span class="pln"> </span><span class="lit">90</span><span class="pun">;</span><span class="pln">     </span><span class="kwd">int</span><span class="pln"> rotation </span><span class="pun">=</span><span class="pln"> </span><span class="lit">0</span><span class="pun">;</span><span class="pln">     </span><span class="kwd">if</span><span class="pln"> </span><span class="pun">(</span><span class="pln">info</span><span class="pun">.</span><span class="pln">facing </span><span class="pun">==</span><span class="pln"> </span><span class="typ">CameraInfo</span><span class="pun">.</span><span class="pln">CAMERA_FACING_FRONT</span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span><span class="pln">         rotation </span><span class="pun">=</span><span class="pln"> </span><span class="pun">(</span><span class="pln">info</span><span class="pun">.</span><span class="pln">orientation </span><span class="pun">-</span><span class="pln"> orientation </span><span class="pun">+</span><span class="pln"> </span><span class="lit">360</span><span class="pun">)</span><span class="pln"> </span><span class="pun">%</span><span class="pln"> </span><span class="lit">360</span><span class="pun">;</span><span class="pln">     </span><span class="pun">}</span><span class="pln"> </span><span class="kwd">else</span><span class="pln"> </span><span class="pun">{</span><span class="pln">  </span><span class="com">// back-facing camera</span><span class="pln">         rotation </span><span class="pun">=</span><span class="pln"> </span><span class="pun">(</span><span class="pln">info</span><span class="pun">.</span><span class="pln">orientation </span><span class="pun">+</span><span class="pln"> orientation</span><span class="pun">)</span><span class="pln"> </span><span class="pun">%</span><span class="pln"> </span><span class="lit">360</span><span class="pun">;</span><span class="pln">     </span><span class="pun">}</span><span class="pln">     mParameters</span><span class="pun">.</span><span class="pln">setRotation</span><span class="pun">(</span><span class="pln">rotation</span><span class="pun">);</span><span class="pln"> </span><span class="pun">}</span><span class="pln"></span><span class="pln"></span>

参数

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一个字符串参数（键-值配对），是分号分隔

0 0