When something goes wrong, the SDK displays an error overlay on the player surface. This page lists every error code your users or your integration code may encounter, explains the cause, and describes what, if anything, you need to do.
Error codes fall into two groups:
Inkrypt errors: specific to SDK authentication, configuration, security, and session management.
Media errors (1000–7001+): originate from the underlying ExoPlayer/Media3 engine and reflect device or network conditions.
Inkrypt Errors
Integration / Configuration
These errors fire before playback begins and indicate a problem in how the SDK was called.
Code
Name
Cause
What to do
100
Missing OTP
setOtp() was not called on InkInitParams.Builder before setParams().
Ensure every setParams() call includes a non-null OTP.
200
Missing Video ID
setVideoId() was not called on InkInitParams.Builder before setParams().
Ensure every setParams() call includes a non-null video ID.
Network
Code
Name
Cause
What to do
20
Network Error
A network failure prevented a request from completing (no connectivity, unreachable host, or closed connection).
Check device connectivity. If intermittent, the SDK retries automatically.
21
SSL Error
An SSL/TLS handshake error occurred during a network request.
Verify the device's system time is correct and that no network proxy is intercepting TLS.
30
Resource Not Found
The server returned an unexpected empty or null response for the video.
Verify the video ID is correct and the video exists in your Inkrypt account.
Authentication & Authorization
Code
Name
Cause
What to do
9101
API Error
The server returned an HTTP 400 response (e.g. account deactivated or malformed request).
Check your Inkrypt Dashboard for account status.
9102
Unauthenticated
The video ID or OTP is invalid (HTTP 401).
Double-check the videoId and otp values passed to setParams().
9104
Access Forbidden
The server returned HTTP 403 on the request, the OTP may not be authorized for this video or has been revoked.
Re-generate a fresh OTP from your backend.
9311
Invalid OTP
The OTP was rejected by the server.
Verify the OTP generation logic and that the correct videoId is paired with the OTP.
9312
Expired OTP
The OTP has expired (HTTP 403 on video metadata fetch).
Re-generate a fresh OTP. OTPs are time-limited; generate them close to the point of playback.
Server Errors
Code
Name
Cause
What to do
9310
Server Error 500
The Inkrypt server returned an HTTP 500.
Transient issue, retry. If persistent, contact Inkrypt support.
9320
Other Server Error
An unclassified HTTP error from the video-info endpoint.
Check the error message for details. Retry or contact support.
Session & Security
Code
Name
Cause
What to do
9201
Developer Mode Enabled
The device has Developer Options turned on. The SDK blocks playback when this is detected.
Nothing, A dialog is displayed to the user instruction him to disable Developer Mode. Use setTolerateDeveloperMode(true) to bypass this check.
9202
USB Debugging Enabled
ADB / USB Debugging is enabled on the device. The SDK blocks playback.
Nothing, A dialog is displayed to the user instruction him to disable USB Debugging. Use setTolerateDeveloperMode(true) during development.
9301
Session Forced Expiration
The server forcibly ended the playback session, e.g. the OTP was revoked or the user's account was deactivated while the video was playing.
The error overlay is shown automatically. No action required in your app; the user will need to re-authenticate.
Installation & Version
Code
Name
Cause
What to do
3201
Unsupported Installation
The app was not installed from the Google Play Store (or another authorized distribution channel).
The error overlay is shown automatically instructing the user to download the app from an official source.
21201
Update Required
The SDK version in the installed app is out of date and the server has rejected it.
The SDK shows an in-player update prompt with a link to the Play Store. No action required in your code.
Media Errors (ExoPlayer / Media3)
These error codes originate from the underlying ExoPlayerPlaybackException engine. The SDK displays a localized message for the most common ones; the rest show a generic error.
General
Code
Description
1000
Unspecified error, cause could not be identified.
1001
Remote player error in a process other than the current one.
1002
Live playback position fell behind the sliding window of available content.
1003
Generic timeout.
1004
Failed runtime check, invalid argument or illegal player state. The SDK attempts an automatic L3 DRM fallback before surfacing this.
I/O
Code
Description
2000
Unspecified I/O error.
2001
Network connection failed (no connectivity, unreachable host, or closed connection).
2002
Network timeout, the server took too long to respond.
2003
Invalid HTTP Content-Type header from the media server.
2004
Unexpected HTTP status code from the media server.
2005
Media file not found.
2006
Missing INTERNET permission.
2007
Cleartext HTTP traffic blocked by the app's Network Security Configuration.
2008
Read position is outside the valid data range.
Parsing
Code
Description
3000
Malformed media container, manifest, or unsupported format.
Decoder
Code
Description
4001
Decoder initialization failed. The SDK attempts an automatic L3 DRM fallback before surfacing this.
4002
Decoder query failed.
4003
Failure while decoding media samples. The SDK attempts an automatic L3 DRM fallback before surfacing this.
4004
Media content exceeds the device's decoder capabilities.
4005
Unsupported decoding format.
4006
Decoder resources were reclaimed by a higher-priority task (e.g. a phone call).
Audio
Code
Description
5001
AudioTrack initialization failed.
5002
AudioTrack write operation failed.
5003
AudioTrack write operation failed in offload mode.
5004
AudioTrack initialization failed in offload mode.
DRM / Widevine
Code
Description
6001
DRM protection scheme not supported by the device.
6002
Device DRM provisioning failed.
6003
Incompatible DRM-protected content.
6004
DRM license acquisition failed. The SDK retries automatically before surfacing this.
6005
Operation disallowed by the DRM license policy.
6006
DRM system error. The SDK attempts an automatic L3 fallback before surfacing this.
6007
DRM privileges revoked on this device.
6008
DRM license has expired.
Video Frame Processing
Code
Description
7000
VideoFrameProcessor initialization failed.
7001
Failure during video frame processing.
Automatic DRM Recovery
The SDK includes built-in resilience for certain DRM and decoder errors. When errors 6006, 4001, 4003, or 1004 occur, the SDK automatically retries playback using Widevine L3 (software DRM) before showing an error to the user. After 10 cumulative such failures on a device, L3 mode is persisted — subsequent sessions on that device will start in L3 directly.
The user only sees an error if the automatic recovery also fails.