CameraManager.TurnOnTorchWithStrengthLevel(String, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トーチ モードで、指定された cameraId に関連付けられている懐中電灯の明るさレベルを設定します。
[Android.Runtime.Register("turnOnTorchWithStrengthLevel", "(Ljava/lang/String;I)V", "", ApiSince=33)]
public void TurnOnTorchWithStrengthLevel (string cameraId, int torchStrength);[<Android.Runtime.Register("turnOnTorchWithStrengthLevel", "(Ljava/lang/String;I)V", "", ApiSince=33)>]
member this.TurnOnTorchWithStrengthLevel : string * int -> unitパラメーター
- cameraId
- String
フラッシュ ユニットが属しているカメラ デバイスの一意識別子。
- torchStrength
- Int32
1 ~ の範囲のフラッシュ ユニットに対して android.hardware.camera2.CameraCharacteristics#FLASH_INFO_STRENGTH_MAXIMUM_LEVEL設定する目的の明るさレベル。
- 属性
注釈
トーチ モードで、指定された cameraId に関連付けられている懐中電灯の明るさレベルを設定します。 トーチが OFF で torchStrength が >1 の場合、torchStrength で指定された強度レベルでトーチがオンになります。
カメラ デバイスがフラッシュ ユニットの強度制御をサポートしているかどうかをチェックするために使用android.hardware.camera2.CameraCharacteristics#FLASH_INFO_STRENGTH_MAXIMUM_LEVELします。 この値が 1 より大きい場合、アプリケーションはこの API を呼び出して懐中電灯の明るさレベルを制御できます。
を #turnOnTorchWithStrengthLevel 呼び出してフラッシュ ユニット CameraManager.TorchCallback#onTorchStrengthLevelChanged の明るさレベルを変更すると、呼び出されます。 新しい必要な強度レベルが以前に設定されたレベルと同じ場合、このコールバックは呼び出されません。 トーチが OFF で、 #turnOnTorchWithStrengthLevel レベル >= 1 で呼び出されると、その明るさレベルでトーチがオンになります。 この場合 CameraManager.TorchCallback#onTorchModeChanged も呼び出されます。
を介して #setTorchModeトーチをオフにすると、懐中電灯の明るさレベルが既定値 android.hardware.camera2.CameraCharacteristics#FLASH_INFO_STRENGTH_DEFAULT_LEVEL にリセットされます。この場合、 CameraManager.TorchCallback#onTorchStrengthLevelChanged は呼び出されません。
レベル N を使用してを呼び出した#turnOnTorchWithStrengthLevel後でトーチが を介して#setTorchMode有効になっている場合、フラッシュ ユニットの明るさレベルは N になります。複数のアプリケーションは自由に を呼び出#setTorchModeすので、トーチ モードをオンにした最新のアプリケーションが終了すると、トーチ モードはオフになり、この場合、明るさレベルは既定のレベルにリセットされます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。