ExoPlayer 被大量 Android 应用使用。作为 OEM，确保 ExoPlayer 在新设备以及现有设备的新平台构建版本上都能正常运行至关重要。本页面介绍了在设备或平台 OTA 发布之前我们建议运行的兼容性测试，以及运行这些测试时遇到的一些常见故障模式。
运行测试
要运行 ExoPlayer 的播放测试，首先从 GitHub 上签出 ExoPlayer 的最新版本。然后，您可以从命令行或 Android Studio 运行测试。
命令行
在根目录中，构建并安装播放测试
./gradlew :test-exoplayer-playback:installDebug
接下来，运行 GTS 包中的播放测试
adb shell am instrument -w -r -e debug false \ -e package androidx.media3.test.exoplayer.playback.gts \ androidx.media3.test.exoplayer.playback.test/androidx.test.runner.AndroidJUnitRunner
测试结果显示在标准输出中。
Android Studio
打开 ExoPlayer 项目，导航到 playbacktests 模块，右键单击 gts 文件夹并运行测试。测试结果显示在 Android Studio 的运行窗口中。
常见故障模式
下面描述了运行 ExoPlayer 播放测试时遇到的一些常见故障模式，以及每种情况的可能根本原因。随着发现更多故障模式，我们将继续补充此列表。
意外的视频缓冲区呈现时间戳
Logcat 将包含类似于以下内容的错误
Caused by: java.lang.IllegalStateException: Expected to dequeue video buffer
with presentation timestamp: 134766000. Instead got: 134733000 (Processed
buffers since last flush: 2242).
此故障最常见的原因是受测视频解码器错误地丢弃、插入或重新排序缓冲区。在上面的示例中，测试预期从 MediaCodec.dequeueOutputBuffer 中出队一个呈现时间戳为 134766000 的缓冲区，但发现出队的是一个呈现时间戳为 134733000 的缓冲区。遇到此故障时，我们建议您检查解码器实现，特别是它是否正确处理自适应分辨率切换而不会丢弃任何缓冲区。
丢弃的缓冲区过多
Logcat 将包含类似于以下内容的错误
junit.framework.AssertionFailedError: Codec(DashTest:Video) was late decoding:
200 buffers. Limit: 25.
此故障是一个性能问题，其中受测视频解码器在解码大量缓冲区时出现延迟。在上面的示例中，ExoPlayer 丢弃了 200 个缓冲区，因为它们在出队时已延迟，而测试限制为 25 个。最明显的原因是视频解码器解码缓冲区速度过慢。如果故障仅发生在播放 Widevine 保护内容的测试子集中，则可能是平台缓冲区解密操作过慢。我们建议检查这些组件的性能，并考虑是否可以进行任何优化来加快它们的速度。
无法验证原生窗口
Logcat 将包含类似于以下内容的错误
SurfaceUtils: native window could not be authenticated
ExoPlayerImplInternal: Internal runtime error.
ExoPlayerImplInternal: android.media.MediaCodec$CodecException: Error 0xffffffff
此故障表明平台未能正确设置安全位标志。
测试超时
Logcat 将包含类似于以下内容的错误
AssertionFailedError: Test timed out after 300000 ms.
此故障最常见的原因是在测试运行期间网络连接不良。如果设备看起来具有良好的网络连接，则可能是测试在调用平台组件（例如 MediaCodec、MediaDrm 或 AudioTrack）时卡住。检查测试进程中线程的调用堆栈以确定是否如此。