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:
Name
Description
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.
Type
Type of error identified by the last three digits of the error code.
Code
Identifier 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
Code
Reason
Description
Displayed Message
100000
An unknown setup error occurred.
none
Sorry, the video player failed to load.
100001
Setup 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.
100011
Missing license key: the key was not found in the setup config or the jwplayer.key global.
Error setting up player: Missing license key
Sorry, the video player failed to load.
100012
Invalid license key.
Error setting up player: Invalid license key
Sorry, the video player failed to load.
100013
Expired license key.
Error setting up player: Invalid license key
Sorry, the video player failed to load.
100014
License 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
Code
Reason
Name
Displayed Message
101134
Native-playlistitem-callback.js failed to load
NATIVE_PLAYLISTITEM_CALLBACK_ERR_CODE
Sorry, the video player failed to load
101136
Jscontext.compatibility.js failed to load
CONTEXT_COMPATIBILITY_ERR_CODE
Failed to load a component of the player.
101137
Jscontext.polyfills.js failed to load
CONTEXT_POLYFILLS_ERR_CODE
Failed to load a component of the player.
104163
Html5_provider_mobile.js failed to load
HTML5_PROVIDER_ERR_CODE
Sorry, the video player failed to load
104164
Native_provider_pool.js failed to load
NATIVE_PROVIDER_POOL_ERR_CODE
Sorry, the video player failed to load
Player Errors
Provider
These errors are generated due to ExoPlayer exceptions.
Miscellaneous
Code
Reason
Exception
Name
Displayed Message
270000
Thrown to indicate that a method has been passed an illegal or inappropriate argument
IllegalArgumentException
ILLEGAL_ARGUMENT_ERROR
This video file cannot be played.
270001
Signals that an I/O exception of some sort has occurred
IOException
IO_ERROR
This video file cannot be played.
Exoplayer2
Code
Reason
Exception
Name
Displayed Message
270100
Thrown when a non-recoverable playback failure occurs
ExoPlaybackException
GENERIC_PLAYBACK_ERROR
This video file cannot be played.
270101
Thrown when an attempt is made to seek to a position that does not exist in the player's Timeline
IllegalSeekPositionException
ILLEGAL_SEEK_POSITION_ERROR
This video file cannot be played.
270102
Thrown when an error occurs parsing media data and metadata
ParserException
PARSER_ERROR
This video file cannot be played.
DataSource
Code
Reason
Exception
Name
Displayed Message
271000
Thrown when an error is encountered when trying to read from a HttpDataSource
HttpDataSourceException
GENERIC_HTTP_DATA_SOURCE_ERROR
This video file cannot be played.
271010
Thrown when cleartext HTTP traffic is not permitted
CleartextNotPermittedException
CLEARTEXT_NOT_ALLOWED_ERROR
This video file cannot be played.
271020
Thrown when the content type is invalid
InvalidContentTypeException
INVALID_CONTENT_TYPE_ERROR
This video file cannot be played.
271XXX
Thrown 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-599
InvalidResponseCodeException
INVALID_RESPONSE_CODE_ERROR
This video file cannot be played
271403
Thrown 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
InvalidResponseCodeException
INVALID_RESPONSE_CODE_ERROR
This video file cannot be played
271710
Thrown when an IOException is encountered reading a local asset.
AssetDataSourceException
ASSET_DATA_SOURCE_ERROR
This video file cannot be played.
271720
Thrown when an IOException is encountered reading from a content URI.
ContentDataSourceException
CONTENT_DATA_SOURCE_ERROR
This video file cannot be played.
271730
Thrown when a FileDataSource encounters an error reading a file.
FileDataSourceException
FILE_DATA_SOURCE_ERROR
This video file cannot be played.
271740
Thrown when an IOException is encountered reading from a raw resource.
RawResourceDataSourceException
RAW_DATA_SOURCE_ERROR
This video file cannot be played.
MediaCodec
Code
Reason
Exception
Name
Displayed Message
272000
Thrown when a failure occurs in the decoder.
MediaCodecRenderer.DecoderException
GENERIC_DECODER_ERROR
This video file cannot be played.
272001
Thrown when a failure occurs instantiating a decoder.
MediaCodecRenderer.DecoderInitializationException
DECODER_INIT_ERROR
This video file cannot be played.
272002
Thrown when a failure occurs instantiating a decoder.
MediaCodecRenderer.DecoderInitializationException
DECODER_INIT_ERROR_UNSUPPORTED
This video file cannot be played.
272003
Thrown when an error occurs querying the device for its underlying media capabilities.
MediaCodecUtil.DecoderQueryException
DECODER_QUERY_ERROR
This video file cannot be played
Media
Source
Code
Reason
Exception
Name
Displayed Message
Thrown when a ClippingMediaSource cannot clip its wrapped source.
ClippingMediaSource.IllegalClippingException
none
274000
Thrown when a live playback falls behind the available media window.
BehindLiveWindowException
BEHIND_LIVE_WINDOW_ERROR
274001
Thrown when a MergingMediaSource cannot merge its sources.
MergingMediaSource.IllegalMergeException
ILLEGAL_MERGE_ERROR
274002
Thrown if the input format was not recognized.
UnrecognizedInputFormatException
INPUT_FORMAT_ERROR
Audio
Code
Reason
Exception
Name
Displayed Message
274100
Thrown when an audio decoder error occurs.
AudioDecoderException
AUDIO_DECODER_ERROR
This video file cannot be played.
274101
Exception thrown when a processor can't be configured for a given input audio format.
AudioProcessor.UnhandledAudioFormatException
UNHANDLED_AUDIO_FORMAT_ERROR
274001
Thrown when a MergingMediaSource cannot merge its sources.
MergingMediaSource.IllegalMergeException
ILLEGAL_MERGE_ERROR
This video file cannot be played.
274102
Thrown when a failure occurs configuring the sink.
AudioSink.ConfigurationException
AUDIOSINK_CONFIG_ERROR
This video file cannot be played.
274103
Thrown when a failure occurs initializing the sink.
AudioSink.InitializationException
AUDIOSINK_INIT_ERROR
This video file cannot be played.
274104
Thrown when a failure occurs writing to the sink.
AudioSink.WriteException
AUDIOSINK_WRITE_ERROR
This video file cannot be played.
274105
Thrown when the audio track has provided a spurious timestamp, if DefaultAudioSink.failOnSpuriousAudioTimestamp is set.