Настройте параметры дисплея

Android включает API, позволяющие приложениям настраивать параметры отображения на поддерживаемом оборудовании. В операционной системе Android TV приложения могут использовать это для обеспечения наилучшего отображения контента, подбирая частоту кадров и цветовой профиль для идеального просмотра.

Соответствие частоте кадров контента

Когда частота кадров видео не соответствует частоте обновления дисплея, пользователи могут столкнуться с неприятными артефактами в виде дрожания изображения, вызванными преобразованием частоты кадров. Это особенно заметно при медленном панорамировании. Поэтому используйте API Surface.setFrameRate() , чтобы сообщить фреймворку о частоте кадров контента и указать, подходит ли видеоконтент для переключения частоты кадров с плавным переходом.

Для получения более подробной информации ознакомьтесь с руководством по частоте кадров .

Сопоставление предпочтительных профилей изображений

API MediaQuality в Android 16 позволяет разработчикам контролировать профили изображений.

В качестве примеров можно привести следующие ситуации:

  • Для фильмов и сериалов, созданных с более широким динамическим диапазоном, разработчики могут запросить режим Filmmaker для точного отображения контента в соответствии с замыслом создателя. Кинопрофиль с большей точностью цветопередачи позволяет лучше рассмотреть тонкие детали в тенях за счет увеличения яркости.
  • Для прямых трансляций спортивных событий, которые часто проходят в условиях узкого динамического диапазона и смотрятся при дневном свете, может быть полезен профиль, отдающий предпочтение яркости, а не точности цветопередачи.
  • Разработчики игр могут запросить профиль с низкой задержкой и минимальной обработкой изображения, чтобы игроки могли получить максимальную производительность от своего дисплея.

Выбор профиля системного изображения

Перед выбором профиля изображения важно убедиться, что устройство его поддерживает.

В следующем фрагменте кода показано, как использовать функцию getAvailablePictureProfiles() для запроса всех поддерживаемых профилей изображений и применения спортивного профиля:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
    val mediaQualityManager: MediaQualityManager =
        context.getSystemService(MediaQualityManager::class.java)
    val profiles = mediaQualityManager.getAvailablePictureProfiles(null)
    for (profile in profiles) {
        // If we have a system sports profile, apply it to our media codec
        if (profile.profileType == PictureProfile.TYPE_SYSTEM
            && profile.name == NAME_SPORTS
        ) {
            val bundle = Bundle().apply { 
                putParcelable(MediaFormat.KEY_PICTURE_PROFILE_INSTANCE, profile)
            }
            mediaCodec.setParameters(bundle)
        }
    }
}

Чтобы получить доступ к конкретному профилю по имени, используйте getPictureProfile() :

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
    val profile = mediaQualityManager.getPictureProfile(
        PictureProfile.TYPE_SYSTEM, NAME_SPORTS, null)
}

Если вам не нужно проверять наличие профиля, профили можно передавать непосредственно в MediaCodec по их идентификатору, используя MediaFormat.KEY_PICTURE_PROFILE_INSTANCE .

Хотя поддерживаемые профили могут различаться в зависимости от устройства, вы можете рассмотреть возможность сопоставления со следующими известными идентификаторами системных профилей:

const val NAME_STANDARD: String = "standard"
const val NAME_VIVID: String = "vivid"
const val NAME_SPORTS: String = "sports"
const val NAME_GAME: String = "game"
const val NAME_MOVIE: String = "movie"
const val NAME_ENERGY_SAVING: String = "energy_saving"
const val NAME_USER: String = "user"