调整显示设置

Android 包含一些 API，可让应用在受支持的硬件上调整显示设置。在 Android TV 操作系统上，应用可以利用此功能来确保以尽可能最佳的格式显示内容，方法是匹配帧速率和色彩配置文件，从而实现理想的观看体验。

匹配内容帧速率

如果视频的帧速率与显示屏的刷新率不匹配，用户可能会因帧速率转换而遇到令人不适的运动抖动伪影。在缓慢的平移镜头中，这种效果尤为明显。因此，请务必使用 SurfaceControl.Transaction.setFrameRate() API 向框架通知内容的帧速率，并指明视频内容是否符合非无缝帧速率切换的条件。

如需了解详情，请参阅帧速率指南。

匹配首选的图片配置文件

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

以下是一些示例场景：

• 对于采用更广动态范围进行母带处理的电影和电视剧，开发者可能会请求使用电影制作人模式来准确显示内容，以达到创作者预期的效果。影院配置文件的色彩准确度更高，可呈现阴影中的细微细节，而不会提高亮度。
• 体育赛事直播通常采用较窄的动态范围进行母带处理，并且在白天观看，因此适合使用优先考虑亮度而非色彩准确度的配置文件。
• 游戏开发者可以请求低延迟配置文件，以尽量减少图像处理，从而让玩家获得最佳显示效果。

注意： OEM 可以添加其他预设，并提供让用户定义自己的画面配置的机制。此实现使用需要系统权限的 createPictureProfile() 方法。

选择系统图片个人资料

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

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

注意： 这些字符串是向 OEM 提供的建议，将来可能会在 API 级别中发生变化。