CameraManager.SetTorchMode(String, Boolean) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在不打開相機裝置的情況下,設定閃光燈的閃光燈模式。
[Android.Runtime.Register("setTorchMode", "(Ljava/lang/String;Z)V", "", ApiSince=23)]
public void SetTorchMode(string cameraId, bool enabled);
[<Android.Runtime.Register("setTorchMode", "(Ljava/lang/String;Z)V", "", ApiSince=23)>]
member this.SetTorchMode : string * bool -> unit
參數
- cameraId
- String
閃光燈所屬相機裝置的唯一識別碼。
- enabled
- Boolean
目標相機裝置的噴燈模式期望狀態。 設定為 true 開啟手電筒模式。 設定為 false 關閉手電筒模式。
- 屬性
備註
在不打開相機裝置的情況下,設定閃光燈的閃光燈模式。
用 #getCameraIdList 來取得可用的相機裝置清單,並 #getCameraCharacteristics 檢查該相機是否有閃光燈。 請注意,即使相機裝置有閃光燈,若相機裝置或其他需要的資源正在使用中,開啟手槍模式也可能失敗。
若 #setTorchMode 成功開啟或關閉手電筒模式, CameraManager.TorchCallback#onTorchModeChanged 則會被啟動。 然而,即使成功開啟火炬模式,應用程式仍不擁有閃光燈或相機裝置的獨家所有權。 當閃光燈所屬的相機裝置無法使用,或其他用於維持手電筒開啟的相機資源無法使用時, CameraManager.TorchCallback#onTorchModeUnavailable 手電筒模式將被關閉並無法使用(會被啟動)。 另外,其他應用程式也可以呼叫 #setTorchMode 來關閉手電筒模式( CameraManager.TorchCallback#onTorchModeChanged 將會被啟動)。 如果最新開啟火炬模式的應用程式退出,火炬模式也會被關閉。
Java 文件 android.hardware.camera2.CameraManager.setTorchMode(java.lang.String, boolean)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。