【今更だけどandroid.hardware.Cameraを使う】Camera.Parametersの設定値 フラッシュライト
android.hardware.Cameraを使うことで、Android端末にあるカメラデバイスにアクセスして使うことができます。
android.hardware.Cameraは、現在では非推奨となっていますがOpenCV等ではまだまだ使われています。
Android端末に実装されているカメラデバイスは固有の性能があります。
そのため、ある端末では出来るのに別の端末では出来ないということが多々あります。
今回はCamera.Parametersのフラッシュライトに関連する設定値を説明します。
下記の実装はすべて前回までに作ったクラスを修正しています。
フラッシュライト
カメラデバイスには幾つかのフラッシュライトモードが実装されています。Camera.Parameters内にあるフラッシュライトに関連するデータのキーは下記のとおりです。
| flash-mode-values | カメラデバイスがサポートしているフラッシュライトモードリストのキーです。 |
| flash-mode | カメラデバイスに現在設定されているフラッシュライトモードのキーです。 |
カメラデバイスがサポートしているフラッシュライトモード
カメラデバイスがサポートしているフラッシュライトモードはListフラッシュライトモードは下記のCamera.Parametersで定義された定数で表されます。
| String FLASH_MODE_OFF | フラッシュライトが点灯しないモードです。 |
| String FLASH_MODE_ON | フラッシュライトは常にスナップショット中に起動されます。プレビュー中・オートフォーカス中に点灯することがあります。 |
| String FLASH_MODE_AUTO | 必要に応じてフラッシュライトが点灯するモードです。プレビュー中・オートフォーカス中・スナップショット中に点灯することがあります。 |
| String FLASH_MODE_RED_EYE | 赤目軽減のフラッシュライトが点灯するモードです。|
| String FLASH_MODE_TORCH | フラッシュライトが常に点灯するモードです。 |
private void updateCameraParameters() {
Camera.Parameters parameters = mCamera.getParameters();
for (int i = 0; i < supportedFlashModes.size(); i++) {
Log.d(TAG, "SupportedFlashModes: " + supportedFlashModes.get(i));
}
mCamera.setParameters(parameters);
}
フラッシュライトモードの取得と変更
フラッシュライトモードはString getFlashMode()で現在の値が取得できます。また、void setFlashMode(String value)を使ってフラッシュライトモードを変更することができます。
private void updateCameraParameters() {
Camera.Parameters parameters = mCamera.getParameters();
List<String> supportedFlashModes = parameters.getSupportedFlashModes();
for (int i = 0; i < supportedFlashModes.size(); i++) {
Log.d(TAG, "SupportedFlashModes: " + supportedFlashModes.get(i));
}
Log.d(TAG, "FlashMode: " + parameters.getFlashMode());
parameters.setFlashMode(Camera.Parameters.FLASH_MODE_TORCH);
mCamera.setParameters(parameters);
}
フラッシュライトモードの注意点
フラッシュライトモードの設定値は下記の条件で例外が発生するので注意が必要です。- Camera.Parameters#getSupportedFlashModesで取得した以外の値を設定した状態でCamera#setParametersを使用すると例外が発生します。
- Camera.Parameters#removeで”flash-mode”を削除した状態でCamera#setParametersを使用するとデフォルト値が使用されるようです。
- カメラプレビューが開始された状態でフラッシュライトモードを変更すると即時に反映されます。