Android SDK errors reference

Identify Android SDK errors

The Android SDK has an ErrorCodes class that includes all possible errors that may be thrown by the SDK.

In this article, a subset of the errors of the ErrorCodes class are listed. 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



Player Errors

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.


Player Events

Loading Core JS Component

Code ErrorCode Constant Reason Displayed Message
101134 NATIVE_PLAYLISTITEM_CALLBACK_ERR_CODE Native-playlistitem-callback.js failed to load. Sorry, the video player failed to load.
101136 CONTEXT_COMPATIBILITY_ERR_CODE Jscontext.compatibility.js failed to load. Failed to load a component of the player.
101137 CONTEXT_POLYFILLS_ERR_CODE Jscontext.polyfills.js failed to load. Failed to load a component of the player.

Loading Provider JS Component

Code ErrorCode Constant Reason Displayed Message
104163 HTML5_PROVIDER_ERR_CODE Html5_provider_mobile.js failed to load. Sorry, the video player failed to load.
104164 NATIVE_PROVIDER_POOL_ERR_CODE Native_provider_pool.js failed to load. Sorry, the video player failed to load.


ExoPlayer Errors

These errors are generated due to ExoPlayer exceptions.


Miscellaneous

General

Code ErrorCode Constant Reason Displayed Message
270000 ILLEGAL_ARGUMENT_ERROR Thrown to indicate that a method has been passed an illegal or inappropriate argument. This video file cannot be played.
270001 IO_ERROR Signals that an I/O exception of some sort has occurred. This video file cannot be played.

ExoPlayer2

Code ErrorCode Constant Reason Displayed Message
270100 GENERIC_PLAYBACK_ERROR Thrown when a non-recoverable playback failure occurs. This video file cannot be played.
270101 ILLEGAL_SEEK_POSITION_ERROR Thrown when an attempt is made to seek to a position that does not exist in the player's Timeline. This video file cannot be played.
270102 PARSER_ERROR Thrown when an error occurs parsing media data and metadata. This video file cannot be played.

DataSource

Remote

Code ErrorCode Constant Reason Displayed Message
271000 GENERIC_HTTP_DATA_SOURCE_ERROR Thrown when an error is encountered when trying to read from a HttpDataSource. This video file cannot be played.
271010 CLEARTEXT_NOT_ALLOWED_ERROR Thrown when cleartext HTTP traffic is not permitted. This video file cannot be played.
271020 INVALID_CONTENT_TYPE_ERROR Thrown when the content type is invalid. This video file cannot be played.
271XXX INVALID_RESPONSE_CODE_ERROR 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.
This video file cannot be played.

Local

Code ErrorCode Constant Reason Displayed Message
271710 ASSET_DATA_SOURCE_ERROR Thrown when an IOException is encountered reading a local asset. This video file cannot be played.
271720 CONTENT_DATA_SOURCE_ERROR Thrown when an IOException is encountered reading from a content URI. This video file cannot be played.
271730 FILE_DATA_SOURCE_ERROR Thrown when a FileDataSource encounters an error reading a file. This video file cannot be played.
271740 RAW_DATA_SOURCE_ERROR Thrown when a FileDataSource encounters an error reading a file. This video file cannot be played.

MediaCodec

Code ErrorCode Constant Reason Displayed Message
272000 GENERIC_DECODER_ERROR Thrown when a failure occurs in the decoder. This video file cannot be played.
272001 DECODER_INIT_ERROR Thrown when a failure occurs instantiating a decoder. This video file cannot be played.
272002 DECODER_INIT_ERROR_UNSUPPORTED Thrown when a failure occurs instantiating a decoder. This video file cannot be played.
272003 DECODER_QUERY_ERROR Thrown when an error occurs querying the device for its underlying media capabilities. This video file cannot be played.

Media

Source

Code ErrorCode Constant Reason Displayed Message
274000 BEHIND_LIVE_WINDOW_ERROR Thrown when a live playback falls behind the available media window.
This video cannot be played because of a problem with your internet connection.
274002 INPUT_FORMAT_ERROR Thrown if the input format was not recognized.
This video file cannot be played.

Audio

Code ErrorCode Constant Reason Displayed Message
274100 AUDIO_DECODER_ERROR Thrown when an audio decoder error occurs. This video cannot be played because of a technical error.
274101 UNHANDLED_AUDIO_FORMAT_ERROR Exception thrown when a processor can't be configured for a given input audio format. This video cannot be played because of a technical error.
274102 AUDIOSINK_CONFIG_ERROR Thrown when a failure occurs configuring the sink. This video file cannot be played because of a technical error.
274103 AUDIOSINK_INIT_ERROR Thrown when a failure occurs initializing the sink. This video cannot be played because of a technical error.
274104 AUDIOSINK_WRITE_ERROR Thrown when a failure occurs writing to the sink. This video cannot be played because of a technical error.
274105 INVALID_AUDIO_TIMESTAMP_ERROR Thrown when the audio track has provided a spurious timestamp, if DefaultAudioSink .failOnSpuriousAudioTimestamp is set. Name This video cannot be played because of a technical error.

HLS

Code ErrorCode Constant Reason Displayed Message
274200 SAMPLE_MAPPING_ERROR Thrown when it is not possible to map a TrackGroup to a SampleQueue.
This video cannot be played because of a technical error.
274201 HLS_PLAYLIST_RESET_ERROR Thrown when the media sequence of a new snapshot indicates the server has reset.
This video cannot be played because of a technical error.
274202 HLS_PLAYLIST_STUCK_ERROR Thrown when a playlist is considered to be stuck due to a server side error.
The live stream is either down or has ended.

SmoothStreaming

Code ErrorCode Constant Reason Displayed Message
274300 SS_MISSING_FIELD_ERROR Thrown if a required field is missing.
This video cannot be played because of a technical error.

DASH

Code ErrorCode Constant Reason Displayed Message
274600 DASH_MANIFEST_STALE_ERROR Thrown when a live playback's manifest is stale and a new manifest could not be loaded.
The live stream is either down or has ended


DRM

Code ErrorCode Constant Reason Displayed Message
276000 DRM_DECRYPTION_ERROR Thrown when a non-platform component fails to decrypt data. There was a problem providing access to protected content.
276001 DRM_MISSING_SCHEME_DATA_ERROR Signals that the DrmInitData does not contain scheme data for the required UUID. There was a problem providing access to protected content.
276002 DRM_SESSION_ERROR Wraps the throwable which is the cause of the error state. There was a problem providing access to protected content.
276003 DRM_KEY_EXPIRED_ERROR Thrown when the DRM keys loaded into an open session expire. There was a problem providing access to protected content.
276004 DRM_UNSUPPORTED_ERROR Thrown when the requested DRM scheme is not supported. There was a problem providing access to protected content.
276005 DRM_CRYPTO_ERROR Thrown when a crypto error occurs while queueing a secure input buffer. There was a problem providing access to protected content.


Player Warnings


Player Events

Loading JS Component

Code ErrorCode Constant Reason Console Message
301138 MOBILE_WORK_AROUND_ERR_CODE Mobile_workarounds.js failed to load. Failed to load a component of the player.

Loading Provider JS Component

Code ErrorCode Constant Reason Console Message
304165 CASTING_PROVIDER_ERR_CODE Casting-provider-sdk.js failed to load. Failed to load a component of the player.

Loading Plugin JS Component

Code ErrorCode Constant Reason Console Message
305010 CASTING_PLUGIN_ERR_CODE Casting-plugin-sdk.js failed to load. Failed to load a component of the player.
305011 DAI_PLUGIN_ERR_CODE Dai-plugin-sdk.js failed to load. Failed to load a component of the player.
305012 IMA_PLUGIN_ERR_CODE Ima-plugin-sdk.js failed to load. Failed to load a component of the player.
305013 RELATED_PLUGIN_ERR_CODE Related.js failed to load. Failed to load a component of the player.

Native Player Events

Picture in Picture

Code ErrorCode Constant Reason Console Message
309100 ERROR_PIP_UNSUPPORTED Default Pip unsupported error.
---
309101 ERROR_PIP_UNAVAILABLE_DUE_TO_API Error for when Pip can't be registered due to low API level.
---
309102 ERROR_PIP_ACTIVITY_NOT_REGISTERED Pip error for when activity is not registered. Activity was not registered for picture in picture.
309103 ERROR_ENTERING_PIP_MODE_FAILED Pip error for when entering pip mode failed. There was an error entering picture in picture.
309104 ERROR_PIP_ASPECT_RATIO_OUTSIDE_LIMITS Pip error for when the set aspect ratio is not within limits. The 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.


ExoPlayer Warnings


Metadata

Subtitles

Code ErrorCode Constant Reason Console Message
373100 SUBTITLE_DECODE_ERROR Thrown when an error occurs decoding subtitle data.
---


Did this page help you?