调整显示设置

Android 包含允许应用在支持的硬件上调整显示设置的 API。在 Android TV OS 上，应用可以利用此功能，通过匹配帧速率和色彩配置文件，以最佳格式显示内容，从而获得理想的观看体验。

匹配内容帧速率

当视频的帧速率与显示器的刷新率不匹配时，用户可能会经历由于帧速率转换导致的不愉快的运动抖动伪影。这在慢速平移镜头中尤其明显。因此，务必使用 SurfaceControl.Transaction.setFrameRate() API 来通知框架内容帧速率，并指示视频内容是否符合非无缝帧速率切换的条件。

如需了解更多信息，请阅读帧速率指南。

匹配首选图片配置文件

Android 16 中的 MediaQuality API 允许开发者控制图片配置文件。

一些示例场景包括

对于采用更宽动态范围制作的电影和电视剧，开发者可能会请求“电影制作人模式”以准确地显示创作者预期呈现的内容。具有更高色彩准确度的电影配置文件能够呈现阴影中的细微细节，同时提高亮度。
在白天观看的现场体育赛事，通常以窄动态范围制作，可以从优先考虑亮度而非色彩准确度的配置文件中受益。
游戏开发者可以请求低延迟配置文件，以最少的图像处理，让玩家获得显示器的最佳性能。

选择系统图片配置文件

在选择图片配置文件之前，务必首先验证设备是否支持它。

以下代码段展示了如何使用 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)
}

如果您不需要查询配置文件是否可用，可以通过 MediaFormat.KEY_PICTURE_PROFILE_INSTANCE 直接将其 ID 提供给 MediaCodec。

虽然支持的配置文件可能因设备而异，但您可以考虑与以下已知系统配置文件 ID 进行匹配

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"