DocumentationPrimetimePrimetime Programming Help

PSDK Error Codes psdk-error-codes

Last update: Mon Oct 02 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Read on to know about PSDK error codes, warnings, and native error codes.

Errors

The following table provides detailed information about ERROR type notifications. Most errors contain relevant metadata; for example, URL of the resource that failed to download. Some notifications contain metadata to specify whether the problem occurred in the main video content, in the alternate audio content, or in an ad.

PSDK Error Name
PSDK Error Code
Description
SUCCESS
0
Operation performed by underlying API is successful.
INVALID_ARGUMENT
1
Data or format of argument provided to underlying API is invalid.
NULL_POINTER
2
One of the argument passed in is NULL Or one of the internal members was not initialized.
ILLEGAL_STATE
3
The operation is not supported in current player state.
INTERFACE_NOT_FOUND
4
The interfaceCast method throws this error when the requested interface is not implemented/inherited by this.
CREATION_FAILED
5
Creation of one of the internal resources failed.
UNSUPPORTED_OPERATION
6
The requested operation is currently not supported.
DATA_NOT_AVAILABLE
7
The requested data is currently not available.
SEEK_ERROR
8
An error has occurred while performing a seek operation.
UNSUPPORTED_FEATURE
9
This feature/function is not supported.
RANGE_ERROR
10
Specified value is out of range.
CODEC_NOT_SUPPORTED
11
Given stream's Audio/Video Codec is not supported by TVSDK or by underlying device.
MEDIA_ERROR
12
The specified media is not found.
NETWORK_ERROR
13
An Error has occurred while downloading a fragment or segment(both video and audio).
GENERIC_ERROR
14
Generic error event. Not actually issued by TVSDK. This is only a marker for the end of the range of numerical codes corresponding to TVSDK error events.
INVALID_SEEK_TIME
15
The seek time provided is invalid.
AUDIO_TRACK_ERROR
16
An error related to an audio track occurred (Alternate Audio)
ACCESS_FROM_DIFFERENT_THREAD
17
PSDK API is called from different thread than the thread in which PSDK was initialized.
ELEMENT_NOT_FOUND
18
The element is not found.
NOT_IMPLEMENTED
19
Feature not implemented.
PRE_ROLL_DISABLED
20
The preroll has been disabled via AdvertisingMetadata.
PLAYBACK_NOT_AUTHORIZED
57
HLS playback has not been enabled in the Flash Player. See AuthorizedFeatures.enableMediaPlayerHLSPlayback().
NETWORK_TIMEOUT
58
Network Timed out while fetching a resource/connecting server.

Warnings

The following table provides detailed information about WARN type notifications.
Most warnings contain relevant metadata; for example, the URL of the resource that failed to download. Some notifications contain metadata to specify whether the problem occurred in the main video content, in the alternate audio content, or in an ad.

Error Name
Code
Description
PLAYBACK_OPERATION_FAILED
200
There was an error during playback operation. A playback-related operation has failed
NATIVE_WARNING
201
The low-level AVE library issued an error.
AD_RESOLVER_FAILED
202
Ad plugin failed to resolve ads.
AD_MANIFEST_LOAD_FAILED
203
Failed to load the Ad manifest.
AD_RESOLUTION_IN_PROGRESS
204
Operation for Resolving Ads is in progress.

Info

Error Name
Code
Description
REVENUE_OPTIMIZATION_REPORTING
300
TVSDK detailed Notifications for further reporting and analysis.

Native Error Codes

The Video Encoder interface of the AVE returns these video playback notifications in the NATIVE_ERROR metadata object.

Error Name
Code
Description
END_OF_PERIOD
-1
End of period.
SUCCESS
0
Operation successful.
ASYNC_OPERATION_IN_PROGRESS
1
Asynchronous operation. The operation request has been made. Success/ failure information will be available later.
EOF
2
Operation not possible due to end of file (EOF) condition.
DECODER_FAILED
3
The decoder failed at runtime.
DEVICE_OPEN_ERROR
4
Failed to open hardware decoder.
FILE_NOT_FOUND
5
Resource cannot be located.
GENERIC_ERROR
6
Generic error.
IRRECOVERABLE_ERROR
7
An error condition that the Video Engine cannot recover from.
LOST_CONNECTION_RECOVERABLE
8
Network error, trying to recover.
NO_FIXED_SIZE
9
The size of the resource cannot be determined.
NOT_IMPLEMENTED
10
Feature not implemented.
OUT_OF_MEMORY
11
Out of memory.
PARSE_ERROR
12
Error while parsing the media file.
SIZE_UNKNOWN
13
The resource has a size, but it is unknown.
UNDER_FLOW
14
Underflow condition.
UNSUPPORTED_CONFIG
15
Configuration is not supported.
UNSUPPORTED_OPERATION
16
Operation is not supported.
WAITING_FOR_INIT
17
Not yet initialized.
INVALID_PARAMETER
18
Invalid parameter.
INVALID_OPERATION
19
Operation not permitted.
OP_ONLY_ALLOWED_IN_PAUSED_STATE
20
The operation is allowed only while paused.
OP_INVALID_WITH_AUDIO_ONLY_FILE
21
Operation cannot be used on audio only files.
PREVIOUS_STEP_SEEK_IN_PROGRESS
22
Previous seek operation is still in progress.
SOURCE_NOT_SPECIFIED
23
Resource not specified.
RANGE_ERROR
24
Specified value is out of range.
INVALID_SEEK_TIME
25
Invalid seek time.
FILE_STRUCTURE_INVALID
26
The file specified does not conform to the expected syntax.
COMPONENT_CREATION_FAILURE
27
An essential component could not be created.
DRM_INIT_ERROR
28
Failed to create DRM context.
CONTAINER_NOT_SUPPORTED
29
Container type is not supported.
SEEK_FAILED
30
Seek failed.
CODEC_NOT_SUPPORTED
31
Unsupported codec.
NETWORK_UNAVAILABLE
32
Network is not available.
NETWORK_ERROR
33
Error getting data from the Network.
OVERFLOW
34
Overflow.
VIDEO_PROFILE_NOT_SUPPORTED
35
Unsupported video profile.
PERIOD_NOT_LOADED
36
An operation was attempted on a HOLD period or a period that has not yet been loaded.
INVALID_REPLACE_DURATION
37
The replace duration specified is invalid or extends past the end of the stream.
CALLED_FROM_WRONG_THREAD
38
API can't be called from the wrong thread. Mostly, for API elements that should be called from Main thread only.
FRAGMENT_READ_ERROR
39
Fragment read error. No failover present. Engine will try to read the next fragment.
ABORTED
40
The operation was aborted by an explicit Abort or Destroy call.
UNSUPPORTED_HLS_VERSION
41
Cannot play this version of HLS media.
CANNOT_FAIL_OVER
42
Cannot fail over.
HTTP_TIME_OUT
43
HTTP download has timed out.
NETWORK_DOWN
44
The user's network connection is down. Playback could stop any moment and will resume when the connection is available.
NO_USABLE_BITRATE_PROFILE
45
No usable bit rate profile found in the stream.
BAD_MANIFEST_SIGNATURE
46
The manifest has a bad signature. It failed the manifest signing test.
CANNOT_LOAD_PLAYLIST
47
Cannot load a playlist.
REPLACEMENT_FAILED
48
Replacement specified in an Insert API could not succeed. This means that the insertion succeeded but replacement did not. Replacement could fail if the manifest to be replaced has been removed from the timeline.
SWITCH_TO_ASYMMETRIC_PROFILE
49
DRM is switching to an asymmetric profile. All the profiles are expected to be aligned in duration. If not, this warning will be thrown, and there may be jumps in the playback.
LIVE_WINDOW_MOVED_BACKWARD
50
Live window is expected to move forward only. If not, this warning will be thrown, and the window will not be read. Because of that, there may be jumps (or stop / long pause) in the playback.
CURRENT_PERIOD_EXPIRED
51
Live window moved beyond the current period.
CONTENT_LENGTH_MISMATCH
52
The content-length reported by the HTTP server did not match the actual media size.
PERIOD_HOLD
53
The media reader is unable to read further because it has reached the time set by setHoldAt API.
LIVE_HOLD
54

The media reader is unable to load segments because it has reached the end of the live window. Segment loading will resume when the server ads new media to the live window. This state is usually reached if:

  • The bufferTime is too high (equal to or higher than the live window duration).
  • A combination of one or more of insert/ erase API replaced more media than it added.
  • The next period is a live period with a pending media replacement (due to InsertBy API call)
BAD_MEDIA_INTERLEAVING
55
The audio and video interleaving in the media is not done properly. This is a packaging error. The warning is dispatched when the difference exceeds two seconds.
DRM_NOT_AVAILABLE
56
PLAYBACK_NOT_AUTHORIZED
57
HLS playback has not been enabled in the Flash Player. See AuthorizedFeatures.enableHLSPlayback.
BAD_MEDIA_SAMPLE_FOUND
58
The decoder received a bad sample that cannot be decoded. This is usually not a fatal error but indicates that there may be glitches in the audio/video. Too many instances of this error indicate a bad encoding or bad file.
RANGE_SPANS_READ_HEAD
59
After playback has started, the Insert/Replace range should not contain the read head.
POSTROLL_WITH_LIVE_NOT_ALLOWED
60
Post-roll insertions are not allowed on a live media. They are, however, allowed after the server marks the media as complete.
INTERNAL_ERROR
61
A very rare issue that should never happen.
SPS_PPS_FOUND_OUTSIDE_AVCC
62
The stream does not follow the packaging recommendation of always putting H264 SPS/PPS in an AVCC. Seek / playback issues might be seen.
PARTIAL_REPLACEMENT
63
Replacement specified in an Insert API was only partially done. This happens when replaceDuration spans over the timeline duration.
RENDITION_M3U8_ERROR
64
Rendition playlist had an error loading. This is only for AVE, not for FlashPlayer.
NULL_OPERATION
65
Operation does not do anything.
SEGMENT_SKIPPED_ON_FAILURE
66
Segment cannot be played and is skipped on failure.
INCOMPATIBLE_RENDER_MODE
67
Incompatible render mode.
PROTOCOL_NOT_SUPPORTED
68
The Web protocol used in the URL is not supported.
PARSE_ERROR_INCOMPATIBLE_VERSION
69
Error while parsing media file.
MANIFEST_FILE_UNEXPECTEDLY_CHANGED
70
Manifest file was changed in an unexpected manner.
CANNOT_SPLIT_TIMELINE
71
Cannot perform a split operation on a timeline.
CANNOT_ERASE_TIMELINE
72
Cannot perform an erase operation on a timeline.
DID_NOT_GET_NEXT_FRAGMENT
73
Did not get the next fragment.
NO_TIMELINE
74
No timeline present in an internal data structure.
LISTENER_NOT_FOUND
75
No listener found in an internal data structure.
AUDIO_START_ERROR
76
Unable to start audio.
NO_AUDIO_SINK
77
No audio sink present in an internal data structure.
FILE_OPEN_ERROR
78
Unable to open file.
FILE_WRITE_ERROR
79
Unable to write to a file.
FILE_READ_ERROR
80
Unable to read from a file.
ID3PARSE_ERROR
81
There was an error parsing ID3 data.
SECURITY_ERROR
82
Loading the content failed because of security restrictions.
TIMELINE_TOO_SHORT
83
The timeline duration is too short. If this is a live stream, frequent buffering may happen.
AUDIO_ONLY_STREAM_START
84
The stream has been switched to an audio-only stream.
AUDIO_ONLY_STREAM_END
85
The stream has been switched from audio-only to a stream with video.
KEY_NOT_FOUND
87
Key cannot be found.
INVALID_KEY
88
The key is invalid.
KEY_SERVER_NOT_FOUND
89
Key server does not return a key.
MAIN_MANIFEST_UPDATE_TO_BE_HANDLED
90
Cannot handle main manifest update.
UNREPORTED_TIME_DISCONTINUITY_FOUND
91
Unreported time (PTS) discontinuity found.
UNMATCHED_AV_DISCONTINUITY_FOUND
92
Unmatched Audio and Video discontinuity found.
TRICKPLAY_ENDED_DUE_TO_ERROR
93
There was an error while playing media in trick play mode. Trick play mode is ended and the stream is paused. Call Play() to play the media in normal mode.
LIVE_WINDOW_MOVED_AHEAD
95
The player is out of the live window and must seek forward to catch up.
recommendation-more-help
6586e11cff95af3ee5405886