CameraCharacteristics.AvailableSessionKeys Свойство

Определение

Пространство имен:

Android.Hardware.Camera2

Сборка:

Mono.Android.dll

Возвращает подмножество ключей #getAvailableCaptureRequestKeys , которые устройство камеры может передавать в рамках инициализации сеанса записи.

public System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>? AvailableSessionKeys { [Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)] get; }

[<get: Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)>]
member this.AvailableSessionKeys : System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>

Значение свойства

IList<Key>

Список ключей, которые можно передать во время инициализации сеанса записи. Если устройство камеры не поддерживает такие ключи, список может иметь значение NULL.

Атрибуты

RegisterAttribute

Комментарии

Возвращает подмножество ключей #getAvailableCaptureRequestKeys , которые устройство камеры может передавать в рамках инициализации сеанса записи.

Этот список включает в себя ключи, которые трудно применять для каждого кадра и могут привести к непредвиденным задержкам при изменении во время существования сеанса записи. Типичные примеры включают параметры, для которых требуется повторное изменение аппаратного оборудования или внутреннего конвейера камеры. По соображениям производительности мы рекомендуем клиентам передавать свои начальные значения в рамках SessionConfiguration#setSessionParameters. После включения сеанса захвата камеры также рекомендуется избежать их изменения с начальных значений, заданных в SessionConfiguration#setSessionParameters . Управление параметрами сеанса по-прежнему может быть выполнено в запросах записи, но клиенты должны знать и ожидать задержки во время своего приложения. Пример сценария использования может выглядеть следующим образом:

<ul><li>Клиент камеры начинается с запроса списка ключей параметров сеанса с помощью android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys .</li li>><Перед активацией последовательности создания сеанса записи запрос на запись необходимо создать с помощью CameraDevice#createCaptureRequest соответствующего шаблона, соответствующего конкретному варианту использования.</li><>Клиент должен перейти по списку параметров сеанса и проверить, совпадают ли некоторые ключи с параметрами, которые они намерены изменить в рамках первого запроса на запись.</li li>><, если такого совпадения нет, запрос на запись может быть передан неизмен.< SessionConfiguration#setSessionParameters /li li><,>если совпадения существуют, клиент должен обновить соответствующие значения и передать запросSessionConfiguration#setSessionParameters .</li li><>После завершения инициализации сеанса записи список ключей параметров сеанса может продолжать служить ссылкой при публикации или обновлении дальнейших запросов. Как упоминалось выше, в идеале следует избегать дальнейших изменений параметров сеанса, если обновления необходимы, однако клиенты могут ожидать задержку или сбой во время переключения параметров.</li></ul>

Возвращенный список не изменяется, поэтому любые попытки изменить его вызовет UnsupportedOperationException.

Каждый ключ указан только один раз в списке. Порядок ключей не определен.

Документация по Java для android.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys().

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.