Skip to main content
Version: 8.1.2

Which error related events does the player expose

THEOplayer exposes different types of errors. Refer to "How to do error handling" for information on how to programmatically detect an error event through an event listener.

Note that only the error events in the "Player API" are fatal. Error events dispatched in different APIs (e.g. Ads API) are considered non-fatal, because some level of playback might still be possible, or the video player might recover from it.

APIEventUseExample/how to trigger
PlayererrorTriggered for media issues, NOT network issuesA poorly encoded segment
segmentnotfound (not on iOS + only for DASH)A segment was not foundA 404 returned on a segment
Ads APIaderrorSomething went wrong during ad handlingEmpty ad tag / Adblocker
Network API (web only)offlineThrown to indicate that the stream is offlineDASH: take whole stream offline

HLS: take 1 segment offline is enough
Chromecast APIerrorThrown to indicate that there was an error while casting / trying to castUnplugged Chromecast power cable during casting
Android Player APINoSupportedRepresentationFoundEventIndicates that none of the provided representations is supported by the playerTrying to play a 4k stream encoded in AV1