Боке камеры — это эффект малой глубины резкости, создаваемый размытием частей сцены, чтобы они не были в фокусе. На камерах мобильных устройств боке достигается за счет информации о глубине, полученной из стереоизображения с двух камер или с двух фотодиодов (PD) одной камеры.
Начиная с Android 11, платформа Android поддерживает реализации боке и предоставляет API-интерфейсы, чтобы сделать эту функцию доступной для сторонних приложений.
Выполнение
Чтобы сделать функцию боке камеры доступной на вашем устройстве, сделайте следующее:
Реклама
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
:Этот тег имеет формат трехцелого массива кортежей, где каждый кортеж имеет формат
{mode, maxWidth, maxHeight}
. В дополнение к{ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}
в HAL камеры также должен быть указан один или оба режимаANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE
иANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS
с соответствующими максимальными размерами потоковой передачи.Реклама
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES
:Этот тег имеет формат массива
{minZoomRatio, maxZoomRatio}
, который содержит все диапазоны коэффициентов масштабирования для включенного расширенного режима сцены в том же порядке, что и вANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
. Диапазон масштабирования[1.0, 1.0]
означает, что масштабирование не поддерживается.ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
вANDROID_CONTROL_AVAILABLE_MODES
.
Чтобы приложение активировало функцию боке, оно должно установить для ANDROID_CONTROL_MODE
значение ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
, а для ANDROID_CONTROL_EXTENDED_SCENE_MODE
— один из поддерживаемых расширенных сюжетных режимов. Обратите внимание, что реализация боке может привести к дополнительному потреблению памяти из-за стереофонических вычислений.
Если поддерживаемый расширенный режим сцены не может быть применен к каждому кадру и приводит к непредвиденным задержкам при включении/отключении, ANDROID_CONTROL_EXTENDED_SCENE_MODE
в ANDROID_REQUEST_AVAILABLE_SESSION_KEYS
. В то же время реализуйте метод ICameraDeviceSession::isReconfigurationRequired()
, чтобы избежать перенастройки для расширенных режимов сцены, которые не требуют перенастройки.
Проверка
Чтобы проверить функцию боке на вашем устройстве, запустите следующие тесты CTS, VTS и CTS Verifier:
-
CtsCameraTestCases
-
VtsHalCameraProviderV2_4TargetTest
-
CameraBokehTest
в CTS Verifier