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

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

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

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

Более подробную информацию можно найти в руководстве по частоте кадров .

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

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

Вот несколько примеров сценариев:

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

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

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

В следующем фрагменте показано, как использовать 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"