Unified API error handling

code

Number

The unique error code

details

Object

The error details

Android-specific errors

what

Number

extra

Number

message

String

1000

UNKNOWN

Any unknown error

1001-1999

SOURCE

Error in the source:

• 1001 - Source is not supported (e.g. source URI is not supported, MIME from HEAD request is not correct etc.)

• 1002 - Source is not found (e.g. source download error)

• 1003 - Manifest error such as HLS playlist errors, DASH mpd errors (incorrect/invalid manifest)

2001-2999

MEDIA

Errors parsing or processing audio or video or subtitle streams:

• 2001 - Audio/Video/Subtitle demux/decode errors which cause playback failures

• 2002 - Subtitle parsing errors which causes playback failures

• 2003 - Invalid Volume Level

• 2004 - No Text Track available

• 2005 - Invalid stream format

• 2100 - Unspecified/Unknown media error

3001-3999

NETWORK

Errors from the network stack:

• 3001 - No Network connections

• 3002 - Response is timed out for any network request.

• 3003 - HTTP generic errors (e.g. 40x, 50x, etc.)

4001-4999

OFFLINECONTENT

Errors for offline playback:

• 4001 - Offline content cannot be found

• 4002 - Offline content invalid license

5001-5999

DRM

Errors related to DRM:

• 5001 - DRM Provisioning errors

• 5002 - DRM type not supported

• 5003 - Fail to create DRM instance

• 5004 - License expired

• 5005 - License data error

• 5006 - License request timeout

• 5007 - License response error

• 5008 - Content decryption error

• 5009 - Non-specified DRM error

• 5020 - SSP-specific error

• 5021 - CONNECT-specific error

6001-6999

SSM

Errors related to SSM:

• 6001 - Setup error

• 6002 - Teardown error

• 6003 - License renewal error due to a missing/wrong heartbeat in seconds or the license server has not received the renewal request after the licence expiry.

7001-7999

PLAYER

Miscellaneous errors from the player:

• Other Native player engine errors

• 7001- Non-specific native player error

• 7002 - Invalid progressUpdateInterval

• 7003 - Invalid (audio / text) track index / Text track already disabled

• 7004 - Out of bound seek request

• 7010 - RN Player internal error

8001-8999

BROADCAST CHANNEL

Errors in playing broadcast services:

• 8001 - Broadcast channel is not supported.

• 8002 - Broadcast channel has no signal or lost signal

• 8003 - Channel tuner lock is unavailable to tune to a new channel i.e. tuner is locked in another channel.

• 8004 - Channel is under parental lock.

• 8005 - Key module is missing in the channel.

• 8006 - Unknown triplet.

• 8007 - Channel switch interrupted.

• 8008 - Channel switch not allowed since there is a recording going on in another channel/Tuner not available.

• 8009 - Unresolved/Incorrect channel URI

• 8010 - Insufficient bandwidth error

• 8011 - Next or previous channel list not available/ EPG info is missing.

• 8012 - Insufficient resource error

• 8013 - Channel not found in TS Stream

• 8014 - No channel List

• 8015 - Object is empty

• 8016 - Invalid broadcast URI.

• 8017 - OIPF unsupported.

• 8018 - Video object creation failed

• 8019 - Configuration object creation failed.

• 8100 - Unidentified broadcast channel error