Opening a Black Box: A Nondescript Video Error on the Android WebView
Aug 17, 2021

Summary
This post details the debugging and resolution of a nondescript video error on Android WebView that caused a significant drop in playback score metrics. The root cause was identified as an undocumented Android behavior where an unset poster attribute on the HTMLVideoElement triggers a CORS exception, leading to a generic error without a player error code or message. The solution involved setting a minimal base64 encoded GIF to the poster attribute. The investigation involved remote debugging of Android WebViews, analysis of HLS.js and Mux data API error reporting, and collaboration between core video and mobile engineering teams.