语言

ControlSceneMode 枚举

定义

枚举由多个方法 ControlSceneMode返回的值。

public enum ControlSceneMode
type ControlSceneMode = 
继承
ControlSceneMode

字段

名称 值 说明
Disabled 0

指示没有为给定捕获请求设置场景模式。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_DISABLED

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

FacePriority 1

如果人脸检测支持存在,请使用人脸检测数据进行自动聚焦、自动白平衡和自动曝光例程。

如果禁用人脸检测统计信息(即 android.statistics.faceDetectMode 设置为 OFF),这仍应正常运行(但不会将人脸检测统计信息返回到框架)。

与其他场景模式不同,设置FACE_PRIORITY时,android.control.aeMode、android.control.awbMode 和 android.control.afMode 将保持活动状态。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_FACE_PRIORITY

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Action 2

针对快速移动对象的照片进行优化。

类似于体育。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_ACTION

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Portrait 3

针对人员的静止照片进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_PORTRAIT

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Landscape 4

针对遥远的宏镜对象的照片进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_LANDSCAPE

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Night 5

针对低光设置进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_NIGHT

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

NightPortrait 6

针对处于低光设置的人的照片进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_NIGHT_PORTRAIT

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Theatre 7

针对闪烁必须保持关闭的昏暗室内设置进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_THEATRE

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Beach 8

针对明亮的户外海滩设置进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_BEACH

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Snow 9

针对包含积雪的明亮户外设置进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_SNOW

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Sunset 10

针对设置阳光的场景进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_SUNSET

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Steadyphoto 11

经过优化以避免由于少量设备运动而模糊的照片(例如:由于手握)。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_STEADYPHOTO

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Fireworks 12

针对烟花的夜间照片进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_FIREWORKS

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Sports 13

针对快速移动人员的照片进行优化。

类似于 ACTION。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_SPORTS

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Party 14

针对具有多个移动人员的昏暗室内设置进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_PARTY

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Candlelight 15

针对主要光源为蜡烛的昏暗设置进行优化。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_CANDLELIGHT

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Barcode 16

针对准确捕获条形码照片进行优化,供想要读取条形码值的相机应用程序使用。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_BARCODE

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

HighSpeedVideo 17

此常量在 API 级别 23 中已弃用。 请参阅此 API 文档以查找替代方法

已弃用,请使用 CameraDevice.createConstrainedHighSpeedCaptureSession(List、StateCallback、Handler) 和 CameraConstrainedHighSpeedCaptureSession.createHighSpeedRequestList(CaptureRequest)进行高速视频录制。

针对高速视频录制(帧速率 >=60fps)用例进行优化。

android.control.availableHighSpeedVideoConfigurations 中指定了支持的高速视频大小和 fps 范围。 若要获取所需的输出帧速率,仅允许应用程序选择此静态元数据中列出的视频大小和 fps 范围组合。 fps 范围可以通过 android.control.aeTargetFpsRange 进行控制。

在此模式下,相机设备将分别覆盖 aeMode、awbMode 和 afMode 到 ON、ON 和 CONTINUOUS_VIDEO。 所有后处理块模式控件将被重写为 FAST。 因此,无法手动控制捕获和后期处理参数。 所有其他控件都与 android.control.mode == AUTO 时相同。 这意味着所有其他 android.control.* 字段将继续工作,例如:android.control.aeTargetFpsRange;android.control.aeExposureCompensation;android.control.aeLock;android.control.awbLock;android.control.effectMode;android.control.aeRegions;android.control.afRegions;android.control.awbRegions;android.control.afTrigger;android.control.aePrecaptureTrigger;android.control.zoomRatio

在 android.control.*之外,以下控件将正常工作:android.flash.mode(仍捕获的自动闪存将不起作用,因为 aeMode 为 ON):android.lens.opticalStabilizationMode(如果支持);android.scaler.cropRegion;android.statistics.faceDetectMode

对于高速录制用例,实际支持的最大帧速率可能低于相机可以输出的内容,具体取决于图像数据的目标图面。 例如,如果目标图面来自视频编码器,则应用程序需要检查视频编码器是否能够支持给定视频大小的高帧速率,或者最终会降低录制帧速率。 如果目标图面来自预览窗口,则预览帧速率将受屏幕刷新速率的约束。

在此模式下,相机设备最多支持 2 个输出高速流(在 android.request.maxNumOutputStreams 中定义的已处理非停止格式)。 仅当以下所有条件都为 true 时,此控件才有效:应用程序创建的不是 maxNumHighSpeedStreams 处理了非停止格式输出流,其中 maxNumHighSpeedStreams 的计算结果为 min(2, android.request.maxNumOutputStreams[已处理(但未停止)]] :流大小是从 android.control.availableHighSpeedVideoConfigurations 报告的大小中选择的;未配置已处理的非停止或原始流

如果上述条件不满足,则相机设备将忽略此模式和 android.control.aeTargetFpsRange 的控件,相机设备将回退到 android.control.mode == AUTO,返回的捕获结果元数据将为相机设备选择的 fps 范围。

切换到或退出此模式可能会触发某些相机 ISP/传感器重新配置,这可能会导致额外的延迟。 建议应用程序尽可能避免不必要的场景模式切换。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_HIGH_SPEED_VIDEO

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Hdr 18

打开特定于设备的高动态范围(HDR)模式。

在此场景模式下,相机设备捕获的图像,这些图像在最终图像中可保持更大的场景照明级别。 例如,在亮窗口前拍摄对象的照片时,当使用 HDR 模式时,对象和场景在使用 HDR 模式时可能可见,而在正常 AUTO 模式下,一个或另一个对象可能暴露得很差。 作为权衡,HDR 模式通常需要更长的时间来捕获单个图像,没有用户控制,并且可能具有其他项目,具体取决于所使用的 HDR 方法。

因此,HDR 捕获的运行速度比常规捕获慢得多。

在此模式下,在 LIMITED 或 FULL 设备上,当使用 android.control.captureIntent 发出STILL_CAPTURE的请求时,相机设备将使用高动态范围捕获技术捕获图像。 在 LEGACY 设备上,以 JPEG 格式输出为目标的捕获将使用 HDR 捕获,并且捕获意向不相关。

HDR 捕获可能涉及设备在内部捕获图像并将它们组合成一个图像,或者它可能涉及使用专用高动态范围捕获硬件的设备。 在所有情况下,都会生成单个图像,以响应在 HDR 模式下提交的捕获请求。

由于通常需要大量后期处理才能生成 HDR 图像,因此限制/完整设备 HDR 捕获仅支持 YUV、PRIVATE 和 JPEG 输出,而旧版 HDR 捕获仅支持 JPEG 输出。 不支持将 RAW 输出用于 HDR 捕获。

某些设备还可能支持始终启用 HDR,该 HDR 以全帧速率应用 HDR 处理。 对于这些设备,除STILL_CAPTURE以外的意向也会产生与正常操作相比没有帧速率影响的 HDR 输出,不过质量可能低于STILL_CAPTURE意向。

如果SCENE_MODE_HDR与不支持的输出类型或捕获意向一起使用,则捕获的图像将如同根本不启用SCENE_MODE一样。

Android 参考。android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_HDR

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

注解

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于