CameraMetadata 類別

定義

命名空間:: Android.Hardware.Camera2

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

攝影機控制與資訊的基底類別。

[Android.Runtime.Register("android/hardware/camera2/CameraMetadata", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "TKey" })]
public abstract class CameraMetadata : Java.Lang.Object

[<Android.Runtime.Register("android/hardware/camera2/CameraMetadata", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "TKey" })>]
type CameraMetadata = class
    inherit Object

繼承: Object

JavaObject

Object
CameraMetadata

衍生: Android.Hardware.Camera2.CameraCharacteristics

Android.Hardware.Camera2.CaptureRequest

Android.Hardware.Camera2.CaptureResult

屬性: RegisterAttribute JavaTypeParametersAttribute

備註

攝影機控制與資訊的基底類別。

此類別定義了用於查詢相機特性或捕捉結果，以及設定相機請求參數的基本鍵值映射。

所有 CameraMetadata 實例皆為不可變。從 API 等級 32 開始，回 #getKeys() 傳的金鑰清單可能會根據裝置的狀態而改變，任何金 #get 鑰回傳的值也會隨物件生命週期中變動。關於特定值是否固定，請參閱其鍵的文件。

Java 文件 android.hardware.camera2.CameraMetadata。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
CameraMetadata(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
AutomotiveLensFacingExteriorFront	已淘汰. 攝影機裝置面向車輛車身框架的前方。
AutomotiveLensFacingExteriorLeft	已淘汰. 攝影機裝置面向車輛車身框架的左側。
AutomotiveLensFacingExteriorOther	已淘汰. 攝影機裝置面向車輛車身框架的外側，但並非正好面向此列舉所定義的外部側邊。
AutomotiveLensFacingExteriorRear	已淘汰. 攝影機裝置面向車輛車身後方。
AutomotiveLensFacingExteriorRight	已淘汰. 攝影機裝置面向車輛車身框架的右側。
AutomotiveLensFacingInteriorOther	已淘汰. 攝影機裝置面向車輛車身框架內側，但並非本單元所描述的座椅之一。
AutomotiveLensFacingInteriorSeatRow1Center	已淘汰. 攝影機面向第一排的中央座位。
AutomotiveLensFacingInteriorSeatRow1Left	已淘汰. 攝影機面向第一排左側座位。
AutomotiveLensFacingInteriorSeatRow1Right	已淘汰. 攝影機面向第一排右側座位。
AutomotiveLensFacingInteriorSeatRow2Center	已淘汰. 攝影機面向第二排的中央座位。
AutomotiveLensFacingInteriorSeatRow2Left	已淘汰. 攝影機裝置面向第二排左側座椅。
AutomotiveLensFacingInteriorSeatRow2Right	已淘汰. 攝影機裝置面向第二排右側座位。
AutomotiveLensFacingInteriorSeatRow3Center	已淘汰. 攝影機面向第三排的中央座位。
AutomotiveLensFacingInteriorSeatRow3Left	已淘汰. 攝影機面向第三排左側座椅。
AutomotiveLensFacingInteriorSeatRow3Right	已淘汰. 攝影機面向第三排右側座位。
AutomotiveLocationExteriorFront	已淘汰. 攝影機裝置位於車身框架外側，位於前側。
AutomotiveLocationExteriorLeft	已淘汰. 攝影機裝置位於車身框架的外部左側。
AutomotiveLocationExteriorOther	已淘汰. 攝影機存在於車輛車身框架之外，但不完全位於本單元定義的外部位置。
AutomotiveLocationExteriorRear	已淘汰. 攝影機裝置位於車身框架外側，位於車身後方。
AutomotiveLocationExteriorRight	已淘汰. 攝影機裝置位於車身框架的外部右側。
AutomotiveLocationExtraFront	已淘汰. 攝影機裝置位於額外車輛車身框架外側，位於前方。
AutomotiveLocationExtraLeft	已淘汰. 攝影機裝置位於額外車輛車體的外部左側。
AutomotiveLocationExtraOther	已淘汰. 攝影機裝置存在於另一輛車上，例如拖車，但不一定在前方、後方、左側或右側。
AutomotiveLocationExtraRear	已淘汰. 攝影機裝置位於額外車輛車身框架外側的後方。
AutomotiveLocationExtraRight	已淘汰. 攝影機裝置位於額外車輛車體的外部右側。
AutomotiveLocationInterior	已淘汰. 攝影機裝置設於車內。
ColorCorrectionModeCct	已淘汰. 使用 `CaptureRequest#COLOR_CORRECTION_COLOR_TEMPERATURE android.colorCorrection.colorTemperature` 和 `CaptureRequest#COLOR_CORRECTION_COLOR_TINT android.colorCorrection.colorTint` 根據相關色溫調整白平衡。
ControlAeModeOnLowLightBoostBrightnessPriority	已淘汰. 就像是「開啟」狀態，但在低光環境下會額外提升亮度。
ControlAePriorityModeOff	已淘汰. 關閉 AE 優先模式。
ControlAePriorityModeSensorExposureTimePriority	已淘汰. 相機裝置的自動曝光程序處於啟動狀態，並優先執行應用程式選擇的曝光時間（`CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime`）。
ControlAePriorityModeSensorSensitivityPriority	已淘汰. 相機裝置的自動曝光程序已啟動，並優先選擇應用程式選擇的 ISO`CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity`（）。
ControlAfSceneChangeDetected	場景轉換會在自動對焦區域內偵測到。
ControlAfSceneChangeNotDetected	場景轉換在自動對焦區域內無法偵測到。
ControlAutoframingOff	已淘汰. 關閉自動框架。
ControlAutoframingOn	已淘汰. 啟用自動框架功能，讓人們保持在畫面視野內。
ControlAutoframingStateConverged	已淘汰. 自動構圖已經達到穩定狀態（畫面/視野沒有被調整）。
ControlAutoframingStateFraming	已淘汰. 自動構圖正在進行中——要麼是放大、縮小，要麼是平移。
ControlAutoframingStateInactive	已淘汰. 自動框架是非啟用的。
ControlExtendedSceneModeBokehContinuous	已淘汰. 散景效果不得相對於感測器原始輸出減慢捕捉速率，且該效果適用於所有處理過的串流，且不大於最大串流維度。
ControlExtendedSceneModeBokehStillCapture	已淘汰. 當擷取意圖STILL_CAPTURE時，所有非 RAW 串流（包括 YUV、JPEG 和 IMPLEMENTATION_DEFINED）都會啟用高品質散景模式。
ControlExtendedSceneModeDisabled	已淘汰. 延長場景模式已關閉。
ControlLowLightBoostStateActive	已淘汰. AE 模式的「ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY」已啟用並套用。
ControlLowLightBoostStateInactive	已淘汰. AE 模式的「ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY」已啟用但未套用。
ControlModeUseExtendedSceneMode	已淘汰. 使用特定的延伸場景模式。
ControlSettingsOverrideOff	已淘汰. 在對攝影機裝置套用 CaptureRequest 設定時，沒有鍵會比其他鍵更早被套用。
ControlSettingsOverrideZoom	已淘汰. Zoom 相關金鑰會比 CaptureRequest 中其他金鑰更早被套用。
ControlVideoStabilizationModePreviewStabilization	已淘汰. 啟用預覽穩定，即預覽與所有非 RAW 串流一樣以相同品質穩定。
ControlZoomMethodAuto	已淘汰. 攝影機裝置會自動偵測應用程式是否會以或來縮放`CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegionCaptureRequest#CONTROL_ZOOM_RATIO android.control.zoomRatio`，並決定哪個元資料標籤能反映有效縮放等級。
ControlZoomMethodZoomRatio	已淘汰. 應用程式打算透過 `CaptureRequest#CONTROL_ZOOM_RATIO android.control.zoomRatio`來控制縮放，而有效縮放等級會反映 `CaptureRequest#CONTROL_ZOOM_RATIO android.control.zoomRatio` 在擷取結果中。
DistortionCorrectionModeFast	鏡頭畸變校正在不降低相對於感光元件輸出的影格率的情況下進行。
DistortionCorrectionModeHighQuality	採用高品質失真校正，但相較感測器輸出可能會降低影格率。
DistortionCorrectionModeOff	不進行失真校正。
ExtensionNightModeIndicatorOff	已淘汰. 相機偵測到足夠明亮的光線條件。
ExtensionNightModeIndicatorOn	已淘汰. 相機偵測到低光環境。
ExtensionNightModeIndicatorUnknown	已淘汰. 相機無法準確評估場景光線，判斷夜間模式相機延伸是否能改善照片品質。
InfoDeviceTypeBuiltIn	這個攝影機裝置實際上是 Android 裝置的一部分，產生的資料在到達請求應用程式之前，始終在裝置的控制之下。
InfoDeviceTypeExternal	此相機裝置並未永久連接於此 Android 裝置。
InfoDeviceTypeUnknown	此相機裝置的分類不明。
InfoDeviceTypeVirtual	此攝影機裝置產生純虛擬影像，儘管在某些情況下可能基於真實硬體攝影機的輸出。
LensPoseReferenceAutomotive	的 `CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation` 值相對於汽車感測器座標系的原點，該座標系位於後軸中心。
LensPoseReferenceGyroscope	的 `CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation` 值是相對於這台 Android 裝置主陀螺儀的位置。
LensPoseReferencePrimaryCamera	的 `CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation` 值相對於面向同一方向的最大相機裝置的光學中心而言。
LensPoseReferenceUndefined	相機裝置無法準確地呈現和 `CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslationCameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation` 的數值。
LogicalMultiCameraSensorSyncTypeApproximate	透過軟體機制來同步實體攝影機。
LogicalMultiCameraSensorSyncTypeCalibrated	相機裝置在硬體層級支援影格時間戳同步，且實體串流影像的時間戳能準確反映其開始曝光時間。
RequestAvailableCapabilitiesColorSpaceProfiles	已淘汰. 該裝置支援查詢相機支援的色彩空間、影像格式及動態範圍設定檔的可能組合，並透過請求特定色彩空間以執行任務。`android.hardware.camera2.params.SessionConfiguration#setColorSpace`
RequestAvailableCapabilitiesDynamicRangeTenBit	已淘汰. 該裝置支援一個或多個 10 位元相機輸出，依照中指定的 `android.hardware.camera2.params.DynamicRangeProfiles#getSupportedProfiles` 動態範圍設定檔。
RequestAvailableCapabilitiesOfflineProcessing	已淘汰. 相機裝置支援OFFLINE_PROCESSING的使用情境。
RequestAvailableCapabilitiesRemosaicReprocessing	已淘汰. 該裝置支援從 `RAW_SENSOR` 由（m x n 像素群組且相同色彩濾鏡）給出 `CameraCharacteristics#SENSOR_INFO_BINNING_FACTOR android.sensor.info.binningFactor` 的拜耳圖案格式重新處理成重新馬賽克的常規拜耳圖案。
RequestAvailableCapabilitiesStreamUseCase	已淘汰. 攝影機裝置支援透過以下方式選擇每個串流的使用情境 `android.hardware.camera2.params.OutputConfiguration#setStreamUseCase` 因此裝置能針對特定使用者情境優化相機管線參數，如調校、感測器模式或ISP設定。
RequestAvailableCapabilitiesSystemCamera	已淘汰. 該相機裝置僅能透過 Android 的系統元件及特權應用程式存取。
RequestAvailableCapabilitiesUltraHighResolutionSensor	已淘汰. 此相機裝置除了具備上述 `CameraCharacteristics#SCALER_STREAM_CONFIGURATION_MAP android.scaler.streamConfigurationMap`影像尺寸外，還能產生超高解析度影像。
ScalerAvailableStreamUseCasesCroppedRaw	已淘汰. 當客戶端選擇裁切視野時，裁切了 RAW 串流。
ScalerAvailableStreamUseCasesDefault	已淘汰. 預設串流使用情境。
ScalerAvailableStreamUseCasesPreview	已淘汰. 直播會顯示給使用者。
ScalerAvailableStreamUseCasesPreviewVideoStill	已淘汰. 單一串流用於預覽、影片和靜態拍攝的綜合用途。
ScalerAvailableStreamUseCasesStillCapture	已淘汰. 靜態照片捕捉。
ScalerAvailableStreamUseCasesVideoCall	已淘汰. 長時視訊通話優化於能源效率與影像品質。
ScalerAvailableStreamUseCasesVideoRecord	已淘汰. 錄製影片片段。
ScalerRotateAndCrop180	已淘汰. 經過處理的影像會旋轉180度。
ScalerRotateAndCrop270	已淘汰. 處理後的影像會順時針旋轉270度，然後裁切回原始長寬比。
ScalerRotateAndCrop90	已淘汰. 處理後的影像會順時針旋轉90度，然後裁切回原始長寬比。
ScalerRotateAndCropAuto	已淘汰. 相機 API 會根據應用程式對可調整大小的支援及目前多視窗模式，自動選擇最佳的旋轉與裁切具體值。
ScalerRotateAndCropNone	已淘汰. 沒有旋轉，也不會裁切。
SensorPixelModeDefault	已淘汰. 這是預設的感光元件像素模式。
SensorPixelModeMaximumResolution	已淘汰. 在此模式下，感測器通常不會分區像素，因此能提供較大的影像尺寸。
SensorReadoutTimestampHardware	已淘汰. 此相機裝置支援 onReadoutStarted 回撥，並輸出讀取時間戳記。
SensorReadoutTimestampNotSupported	已淘汰. 這台相機不支援讀取時間戳記和 onReadoutStarted 回撥。
StatisticsOisDataModeOff	擷取結果中不應包含OIS資料。
StatisticsOisDataModeOn	在擷取結果中加入 OIS 資料。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
JniPeerMembers	攝影機控制與資訊的基底類別。
Keys	回傳此映射中包含的鍵列表。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
Equals(Object)	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	攝影機控制與資訊的基底類別。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	攝影機控制與資訊的基底類別。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於