OEM 测试

ExoPlayer 被大量 Android 应用所使用。作为 OEM,请务必确保 ExoPlayer 既能在新设备上正常运行,也能在现有设备的新平台 build 上正常运行。本页面介绍了我们建议在发布设备或平台 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

测试结果会显示在 STDOUT 中。

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)时卡住。检查测试进程中线程的调用堆栈,以确定是否属于这种情况。