调整显示设置

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

匹配内容帧速率

如果视频的帧速率与显示屏的刷新率不匹配,用户可能会因帧速率转换而遇到令人不适的运动抖动伪影。在缓慢的平移镜头中,这种效果尤为明显。因此,请务必使用 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"