Media application error codes

by Retired on ‎02-16-2010 01:37 PM - edited on ‎07-05-2011 03:21 PM by Retired (4,085 Views)

Summary

 

This article applies to the following:

 

  • BlackBerry® Device Software 4.2 and later
  • BlackBerry smartphone


Details

 

When monitoring media application events using a PlayerListener, the playerUpdate() method can receive an error event and an integer for the eventData. These integers are range from 1 to 29 and have the following meanings:

 

Error Code

Error Description

Recoverable?

1

Media player busy: The media player is currently performing an operation that precludes the requested operation.

Yes, stop other players and try again.

2

Invalid parameter: A parameter was specified with an invalid value.

No, check the parameters used.

3

Insufficient memory: There is insufficient memory to perform the requested operation.

Yes, free memory and try again.  Can also happen if the file metadata contains an image that is too large.

4

Need more data: Playback cannot proceed until the streaming source provides more data.

Yes, provide more data on restart.

5

Unspecified: Some error occurred which does not fit into any other category.

Depends on the issue.  Since this error is a catch-all, it is likely there is a problem with the media which would be unrecoverable.

6

Format: An error in the media file was detected.

No, the file format cannot be played.

7

No server response: A server has stopped responding.

Depends on the Network Issue.

8

Connection lost: The current connection has been dropped.

Depends on the Network Issue.  Radio could have been turned off as well.

9

DNS resolve error: An invalid URL has been detected.

No, the URL provided is invalid.

10

Unseekable: The media player needs to seek in the file in order to access headers, but can't since the file being played is unseekable.

Yes, change your DataSource seek type to a seekable one if you can.  If you can’t, then no.

11

Connection timeout: the (streaming) server is unreachable.

Depends on the Network Issue.

12

No rights:
    * The DRM agent wasn't able to find a valid digital right in the media
    * RTSP error 401 has occurred

Yes, if the DRM issue is resolved.

13

General client error:
    * The streaming server rejected the streaming request
    * RTSP error 4xx not covered by another error code has occurred

Depends on the issue, likely the URL is incorrect.

14

Server error:
    * An error occured on the streaming server while streaming
    * RTSP error 5xx has occurred

Depends on the Network Issue, 5xx error codes denote server-side errors.

15

Payment required:
    * Payment is required to stream this item from the server
    * RTSP error 402 has occurred

Yes, pay up.

16

Forbidden:
    * The streaming server has rejected the streaming request for security reasons
    * RTSP error 403 has occurred

Depends on the issue.

17

Client file not found:
    * The item required to stream doesn't exist or has been removed from the server
    * RTSP error 404 has occurred

Depends on the issue, likely the URL is incorrect.  If it is correct, this is unrecoverable.

18

Client proxy authentication required:
    * Device needs to authenticate with a proxy server before streaming
    * RTSP error 407 has occurred

Yes, use the net.rim.device.api.media.control.AuthernticationControl

19

Client request URI too large:
    * The request URI sent to the server is too large
    * RTSP error 414 has occurred

Yes, modify the request and retry the request.

20

Not enough bandwidth:
    * There is not enough bandwidth to support streaming
    * RTSP error 453 has occurred

Depends on the issue.  You may be able to try an alternate low-bandwidth stream, or move to better network coverage (such as Wi-Fi).

21

Client session not found:
    * Streaming session has been removed by the server (e.g.: when paused for too long)
    * RTSP error 454 has occurred

Yes, stop the player and move it to REALIZED, then try again to re-initialize a new session.

22

Unsupported transport:
    * The streaming server/network doesn't support UDP/TCP streaming
    * RTSP error 461 has occurred

No.

23

Indicates the (data) connectivity has been suspended.

Depends on the issue.

24

Indicates that the media player is currently suspended that precludes the requested operation.

Similar to error code 1, but specific to the RTSP streaming case.

25

Indicates that the wrong License DB was detected.

Check your RTSP parameters in your URL and the credentials passed into the AuthenticationControl.

26

Indicates the device does not have a reliable time source and a time source is required to play the content.

No.

27

Indicates the media cannot be played because it uses DRM and a DRM session is not available.

Yes, retry the request.

28

Indicates the media cannot be played because it is not really media at all, it contains a redirection URL.

No.

29

RTSP Fast-Content Switch attempt failed:
   * The server indicates it supports the ability to switch RTSP streams but for some unknown reason it did not fulfill the request

Depends on the issue.  Retrying the request may work, but if the issue continues it’s likely a server problem.