Platform DocsPlayers DocsRelease Notes
System StatusSubmit a CaseDashboard LoginCompany Site

Android SDK Errors Reference (Android)

Identify Android SDK errors

Suggest Edits


This document will cover the SDK-specific error codes. The sources for these errors include:

  • Player Javascript components, and loading of said components
  • Native ExoPlayer provider and the exceptions it may throw
  • Native features such as Picture-In-Picture

The error codes follow a specific schema:

NameDescription
Severity 
  • Setup errors are delivered via a "setupError" event and are the most severe, these errors start with a 1.
  • Fatal errors are delivered via "error" events, these errors start with a 2.
  • Warning errors are delivered via "warning" events, these errors start with a 3.
Category

Sub-category		Categories include features, providers, and other logical groups or components of the player.
TypeType of error identified by the last three digits of the error code.
CodeIdentifier for the error

Error code descriptions are listed on this page.

Use the sections below to help you troubleshoot and programmatically handle player-related issues.


Setup Errors

Miscellaneous

CodeReasonDescriptionDisplayed Message
100000An unknown setup error occurred.noneSorry, the video player failed to load.
100001Setup took longer than 60 seconds to complete.Setup Timeout Error: Setup took longer than 30 seconds to complete.Sorry, the video player failed to load.
100011Missing license key: the key was not found in the setup config or the jwplayer.key global.Error setting up player: Missing license keySorry, the video player failed to load.
100012Invalid license key.Error setting up player: Invalid license keySorry, the video player failed to load.
100013Expired license key.Error setting up player: Invalid license keySorry, the video player failed to load.
100014License key is not supported in unlimited edition.-Sorry, the video player failed to load.

Player

The player can still emit loading errors when trying to load web player assets such as jwplayer.core.js and the codes and error messages for those events are documented here: Player errors reference.

Loading JS Components

CodeReasonNameDisplayed Message
101134Native-playlistitem-callback.js failed to loadNATIVE_PLAYLISTITEM_CALLBACK_ERR_CODESorry, the video player failed to load
101136Jscontext.compatibility.js failed to loadCONTEXT_COMPATIBILITY_ERR_CODEFailed to load a component of the player.
101137Jscontext.polyfills.js failed to loadCONTEXT_POLYFILLS_ERR_CODEFailed to load a component of the player.
104163Html5_provider_mobile.js failed to loadHTML5_PROVIDER_ERR_CODESorry, the video player failed to load
104164Native_provider_pool.js failed to loadNATIVE_PROVIDER_POOL_ERR_CODESorry, the video player failed to load

Player Errors

Provider

These errors are generated due to ExoPlayer exceptions.

Miscellaneous

CodeReasonExceptionNameDisplayed Message
270000Thrown to indicate that a method has been passed an illegal or inappropriate argumentIllegalArgumentExceptionILLEGAL_ARGUMENT_ERRORThis video file cannot be played.
270001Signals that an I/O exception of some sort has occurredIOExceptionIO_ERRORThis video file cannot be played.

Exoplayer2

CodeReasonExceptionNameDisplayed Message
270100Thrown when a non-recoverable playback failure occursExoPlaybackExceptionGENERIC_PLAYBACK_ERRORThis video file cannot be played.
270101Thrown when an attempt is made to seek to a position that does not exist in the player's TimelineIllegalSeekPositionExceptionILLEGAL_SEEK_POSITION_ERRORThis video file cannot be played.
270102Thrown when an error occurs parsing media data and metadataParserExceptionPARSER_ERRORThis video file cannot be played.

DataSource

CodeReasonExceptionNameDisplayed Message
271000Thrown when an error is encountered when trying to read from a HttpDataSourceHttpDataSourceExceptionGENERIC_HTTP_DATA_SOURCE_ERRORThis video file cannot be played.
271010Thrown when cleartext HTTP traffic is not permittedCleartextNotPermittedExceptionCLEARTEXT_NOT_ALLOWED_ERRORThis video file cannot be played.
271020Thrown when the content type is invalidInvalidContentTypeExceptionINVALID_CONTENT_TYPE_ERRORThis video file cannot be played.
271XXXThrown when an attempt to open a connection results in a response code not in the 2xx range. Error code is generated by adding 271000+HttpStatusCode. HttpStatusCode is within the range of 400-599InvalidResponseCodeExceptionINVALID_RESPONSE_CODE_ERRORThis video file cannot be played
271403Thrown when an attempt to access the requested resource is forbidden

NOTE: The server throws code 271403 when the requested resource is restricted by JWP content protection. Content protection methods include:
- Geoblocking
- DRM
- URL signing
InvalidResponseCodeExceptionINVALID_RESPONSE_CODE_ERRORThis video file cannot be played
271710Thrown when an IOException is encountered reading a local asset.AssetDataSourceExceptionASSET_DATA_SOURCE_ERRORThis video file cannot be played.
271720Thrown when an IOException is encountered reading from a content URI.ContentDataSourceExceptionCONTENT_DATA_SOURCE_ERRORThis video file cannot be played.
271730Thrown when a FileDataSource encounters an error reading a file.FileDataSourceExceptionFILE_DATA_SOURCE_ERRORThis video file cannot be played.
271740Thrown when an IOException is encountered reading from a raw resource.RawResourceDataSourceExceptionRAW_DATA_SOURCE_ERRORThis video file cannot be played.

MediaCodec

CodeReasonExceptionNameDisplayed Message
272000Thrown when a failure occurs in the decoder.MediaCodecRenderer.DecoderExceptionGENERIC_DECODER_ERRORThis video file cannot be played.
272001Thrown when a failure occurs instantiating a decoder.MediaCodecRenderer.DecoderInitializationExceptionDECODER_INIT_ERRORThis video file cannot be played.
272002Thrown when a failure occurs instantiating a decoder.MediaCodecRenderer.DecoderInitializationExceptionDECODER_INIT_ERROR_UNSUPPORTEDThis video file cannot be played.
272003Thrown when an error occurs querying the device for its underlying media capabilities.MediaCodecUtil.DecoderQueryExceptionDECODER_QUERY_ERRORThis video file cannot be played

Media

Source

CodeReasonExceptionNameDisplayed Message
Thrown when a ClippingMediaSource cannot clip its wrapped source.ClippingMediaSource.IllegalClippingExceptionnone
274000Thrown when a live playback falls behind the available media window.BehindLiveWindowExceptionBEHIND_LIVE_WINDOW_ERROR
274001Thrown when a MergingMediaSource cannot merge its sources.MergingMediaSource.IllegalMergeExceptionILLEGAL_MERGE_ERROR
274002Thrown if the input format was not recognized.UnrecognizedInputFormatExceptionINPUT_FORMAT_ERROR

Audio

CodeReasonExceptionNameDisplayed Message
274100Thrown when an audio decoder error occurs.AudioDecoderExceptionAUDIO_DECODER_ERRORThis video file cannot be played.
274101Exception thrown when a processor can't be configured for a given input audio format.AudioProcessor.UnhandledAudioFormatExceptionUNHANDLED_AUDIO_FORMAT_ERROR
274001Thrown when a MergingMediaSource cannot merge its sources.MergingMediaSource.IllegalMergeExceptionILLEGAL_MERGE_ERRORThis video file cannot be played.
274102Thrown when a failure occurs configuring the sink.AudioSink.ConfigurationExceptionAUDIOSINK_CONFIG_ERRORThis video file cannot be played.
274103Thrown when a failure occurs initializing the sink.AudioSink.InitializationExceptionAUDIOSINK_INIT_ERRORThis video file cannot be played.
274104Thrown when a failure occurs writing to the sink.AudioSink.WriteExceptionAUDIOSINK_WRITE_ERRORThis video file cannot be played.
274105Thrown when the audio track has provided a spurious timestamp, if DefaultAudioSink.failOnSpuriousAudioTimestamp is set.DefaultAudioSink.InvalidAudioTrackTimestampExceptionINVALID_AUDIO_TIMESTAMP_ERRORThis video file cannot be played.

HLS

CodeReasonExceptionNameDisplayed Message
274200Thrown when it is not possible to map a TrackGroup to a SampleQueue.SampleQueueMappingExceptionSAMPLE_MAPPING_ERROR
274201Thrown when the media sequence of a new snapshot indicates the server has reset.HlsPlaylistTracker.PlaylistResetExceptionHLS_PLAYLIST_RESET_ERROR
274202Thrown when a playlist is considered to be stuck due to a server side error.HlsPlaylistTracker.PlaylistStuckExceptionHLS_PLAYLIST_STUCK_ERROR

SmoothStreaming

CodeReasonExceptionNameDisplayed Message
274300Thrown if a required field is missing.SsManifestParser.MissingFieldExceptionSS_MISSING_FIELD_ERROR

DASH

CodeReasonExceptionNameDisplayed Message
274600Thrown when a live playback's manifest is stale and a new manifest could not be loaded.DashManifestStaleExceptionDASH_MANIFEST_STALE_ERROR

DRM

CodeReasonExceptionNameDisplayed Message
276000Thrown when a non-platform component fails to decrypt data.DecryptionExceptionDRM_DECRYPTION_ERRORThere was a problem providing access to protected content.
276001Signals that the DrmInitData does not contain scheme data for the required UUID.DefaultDrmSessionManager.MissingSchemeDataExceptionDRM_MISSING_SCHEME_DATA_ERRORThere was a problem providing access to protected content.
276002Wraps the throwable which is the cause of the error state.DrmSession.DrmSessionExceptionDRM_SESSION_ERRORThere was a problem providing access to protected content.
276003Thrown when the DRM keys loaded into an open session expire.KeysExpiredExceptionDRM_KEY_EXPIRED_ERRORThere was a problem providing access to protected content.
276004Thrown when the requested DRM scheme is not supported.UnsupportedDrmExceptionDRM_UNSUPPORTED_ERRORThere was a problem providing access to protected content.
276005Thrown when a crypto error occurs while queueing a secure input buffer.CryptoExceptionDRM_CRYPTO_ERRORThere was a problem providing access to protected content.

Warnings

Loading JS Component

CodeReasonNameDisplayed Message
301138Mobile_workarounds.js failed to loadMOBILE_WORK_AROUND_ERR_CODEFailed to load a component of the player
304165Casting-provider-sdk.js failed to loadCASTING_PROVIDER_ERR_CODEFailed to load a component of the player
305010Casting-plugin-sdk.js failed to loadCASTING_PLUGIN_ERR_CODEFailed to load a component of the player
305011Dai-plugin-sdk.js failed to loadDAI_PLUGIN_ERR_CODEFailed to load a component of the player
305012Ima-plugin-sdk.js failed to loadIMA_PLUGIN_ERR_CODEFailed to load a component of the player
305013Related.js failed to loadRELATED_PLUGIN_ERR_CODEFailed to load a component of the player

Native

PiP

CodeReasonNameDisplayed Message
309100Default Pip unsupported errorERROR_PIP_UNSUPPORTED
309101Warning for when PiP can't be registered due to low API levelERROR_PIP_UNAVAILABLE_DUE_TO_API
309102PiP warning for when activity is not registeredERROR_PIP_ACTIVITY_NOT_REGISTEREDActivity was not registered for picture in picture
309103PiP warning for when entering PiP mode failedERROR_ENTERING_PIP_MODE_FAILEDThere was an error entering picture in picture
309104PiP warning for when the set aspect ratio is not within limitsERROR_PIP_ASPECT_RATIO_OUTSIDE_LIMITSThe provided aspect ratio is too extreme and must be greater then 0.41. and less than 2.39. It will be replaced with the closest viable ratio
309105PiP warning for when we attempt to enter PiP mode multiple timesERROR_PIP_MODE_ALREADY_ENABLEDAttempting to enter PiP mode while PiP mode was already enabled.

Metadata

Subtitles

CodeReasonExceptionNameDisplayed Message
373100Thrown when an error occurs decoding subtitle data.SubtitleDecoderExceptionSUBTITLE_DECODE_ERROR

Updated 6 months ago