ControlSceneMode 列舉
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
透過 的 ControlSceneMode多種方法列舉 。
public enum ControlSceneModetype ControlSceneMode = - 繼承
-
ControlSceneMode
欄位
| 名稱 | 值 | Description |
|---|---|---|
| Disabled | 0 | 表示對於特定的擷取請求，沒有設定任何場景模式。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| FacePriority | 1 | 若有臉部偵測支援，請使用臉部偵測資料進行自動對焦、自動白平衡及自動曝光程序。 如果關閉臉部偵測統計（例如 android.statistics.faceDetectMode 設定為關閉），它仍應正常運作（但不會將臉部偵測統計資料回傳給框架）。 與其他場景模式不同，android.control.aeMode、android.control.awbMode 和 android.control.afMode 在設定FACE_PRIORITY時仍會保持啟用。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Action | 2 | 優化拍攝快速移動物體的照片。 類似於體育。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Portrait | 3 | 優化為人物靜態照片。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Landscape | 4 | 優化於拍攝遠距離微觀物體的照片。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Night | 5 | 針對低光環境優化。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| NightPortrait | 6 | 優化於低光環境下的人物靜態照片。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Theatre | 7 | 針對昏暗室內環境優化，閃光燈必須關閉。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Beach | 8 | 專為明亮的戶外海灘環境優化。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Snow | 9 | 針對明亮且戶外的雪環境進行優化。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Sunset | 10 | 優化於夕陽落下的場景。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Steadyphoto | 11 | 優化以避免因裝置微小動作（例如：握手）而導致照片模糊。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Fireworks | 12 | 專為夜間煙火拍攝而優化。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Sports | 13 | 專為快速移動的人拍照而優化。 類似於行動。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Party | 14 | 優化為昏暗、室內環境，且有多人移動。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Candlelight | 15 | 優化為主光源為蠟燭的昏暗設定。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Barcode | 16 | 優化以精確捕捉條碼照片，供希望讀取條碼值的相機應用程式使用。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| HighSpeedVideo | 17 | 此常數在 API 等級 23 中被棄用。 請參考此 API 文件以尋找替代方案 此功能已不再使用，請使用 CameraDevice.createConstrainedHighSpeedCaptureSession（List， StateCallback， Handler） 和 CameraConstrainedHighSpeedCaptureSession.createHighSpeedRequestList（CaptureRequest） 進行高速錄影。 優化於高速錄影（幀率 >=60fps）使用場景。 支援的高速影片尺寸與幀率範圍由 android.control.availableHighSpeedVideoConfigurations 指定。 為了獲得所需的輸出幀率，應用程式只能選擇此靜態中繼資料中列出的影片大小與 fps 範圍組合。 fps 範圍可以透過 android.control.aeTargetFpsRange 來控制。 在此模式下，相機裝置會分別覆蓋 aeMode、awbMode 和 afMode 至 ON、ON 和 CONTINUOUS_VIDEO。 所有後製區塊模式控制都會被覆寫為快速。 因此，無法手動控制捕捉與後處理參數。 其他所有控制項的操作方式與 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 已開啟）;android.lens.opticalStabilizationMode（若支援）;android.scaler.cropRegion;android.statistics.faceDetectMode 在高速錄影的情況下，實際支援的最大幀率可能低於攝影機的輸出，這取決於影像資料的目標 Surface。 例如，若目標曲面來自視訊編碼器，應用程式需檢查視訊編碼器是否能支援特定影片尺寸下的高影格率，否則錄影幀率會較低。 如果目標表面來自預覽視窗，預覽幀率將受限於螢幕刷新率。 在此模式下，相機裝置最多支援 2 個高速輸出串流（已處理且非停頓格式，定義於 android.request.maxNumOutputStreams）。 此控制僅在以下所有條件皆成立時有效：應用程式僅產生超過 maxNumHighSpeedStreams 處理中且未停頓格式的輸出串流，其中 maxNumHighSpeedStreams 的計算為 min（2， android.request.maxNumOutputStreams[處理中（但未停頓）]）;串流大小是從 android.control.availableHighSpeedVideoConfigurations 報告的大小中選擇的;未設定處理過的非停滯或原始串流 當上述條件未被滿足時，此模式及 android.control.aeTargetFpsRange 的控制項將被相機裝置忽略，相機裝置會回退至 android.control.mode == AUTO，回傳的擷取結果元資料將顯示相機選擇的 fps 範圍。 切換或切換此模式可能會觸發某些相機 ISP/感光元件重新配置，進而增加延遲。 建議應用程式盡量避免不必要的場景模式切換。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Hdr | 18 | 開啟裝置專屬的高動態範圍（HDR）模式。 在此場景模式中，攝影機裝置捕捉的影像使最終影像中可見的場景照明層級範圍更大。 例如，在明亮窗戶前拍攝物體時，使用HDR模式時，物體與窗外場景可能同時可見;而在正常自動模式下，其中一方可能曝光不足。 作為權衡，HDR模式通常拍攝一張影像所需時間較長，且無法控制，且根據所用HDR方法可能出現其他瑕疵。 因此，HDR 拍攝的速度遠低於一般擷取。 在此模式下，無論是在有限或完整裝置上，當使用 android.control.captureIntent STILL_CAPTURE 發出請求時，攝影機裝置會使用高動態範圍捕捉技術擷取影像。 在舊有裝置上，針對 JPEG 格式輸出的擷取會以 HDR 拍攝，且擷取意圖不重要。 HDR 擷取可能涉及裝置內部擷取一組影像並合併成一組，或使用專用的高動態範圍擷取硬體。 在所有情況下，都是在 HDR 模式下回應擷取請求時產生一張單一影像。 由於製作 HDR 影像通常需要大量後製，因此 LIMITED/FULL 裝置 HDR 擷取只支援 YUV、PRIVATE 和 JPEG 輸出，LEGACY HDR 擷取則僅支援 JPEG 輸出。 不支援使用 RAW 輸出來擷取 HDR。 部分裝置也可能支援 Always on HDR，即以全影格率進行 HDR 處理。 對於這些裝置，除了STILL_CAPTURE之外，其他意圖也能產生HDR輸出，且相較於正常操作不會有幀率影響，儘管畫質可能不如STILL_CAPTURE意圖。 若SCENE_MODE_HDR在不支援的輸出類型或擷取意圖中使用，所擷取的影像將彷彿未啟用SCENE_MODE。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。