Brightcove Player Error Reference

Types of errors

There are six main types of errors which are briefly described in this section. You can click on the error type to see the specific errors for each type, if applicable.

• Standard errors dispatched from the Errors Plugin: These error names start with MEDIA_ERR.
• Custom errors defined by Brightcove and dispatched from the Errors Plugin: These error names start with PLAYER_ERR.
• Errors dispatched from the Video Cloud catalog: These error names start with VIDEO_CLOUD_ERR. Of course, Brightcove Player customers will never see these errors.
• Errors dispatched from the HLS plugin: All of these errors have the same type, APPEND_BUFFER_ERR, and the message is retrieved from the browser's native error.
• Errors reported in the browser Development Tools Console: These errors are developer oriented as they will only be see in a browser's Console.
• Custom errors that are user defined and dispatched by the Errors Plugin: These error names are defined by the user, for example AGE_GATE_ERROR.
• Network security errors

Standard errors

Very generally, media errors occur when issues arise trying to retrieve or playback the media. For instance, if your network connection is lost, or you get an encrypted video that cannot be decrypted, you will get a media error. For complete details see the Standard errors section of the Display Error Messages Plugin document.

Custom errors

Very generally, player errors occur when the video has been loaded, for some reason cannot be played. For instance, if domain, geo or IP restrictions prevent viewing a video, player errors will occur. For complete details see the Custom errors section of the Display Error Messages Plugin document.

Catalog errors

Very generally, the catalog will throw errors when there are issues retrieving or initially playing the video or playlist. For instance, if you use a non-existent ID, or an ID from a different account in which the player exists, to retrieve a video you will get a catalog error. For complete details see the Catalog errors section of the Player Catalog document.

HLS plugin errors

For complete details see the Errors section of the HLS Plugin document.

QoE analytics module ios errors

Playback Restriction errors

For errors associated with Brightcove Playback Restrictions, see the Playback Restrictions Error Reference document.

If you are new to playback restrictions, see the Overview: Brightcove Playback Restrictions document.

Console errors

These errors would appear in a console looking something like this:

Custom user errors

For complete details see the Adding custom errors section of the Display Error Messages Plugin document. There are no standard custom user errors.

Network security errors

These errors occur when your network security blocks some Brightcove domains and ports.

Listening for errors

You can also listen for all errors using the on() method, using the following:

myPlayer.on('error'), function () {
  ...
}

If you are playing ads and want to catch all errors, you need to use this:

myPlayer.on(['error','aderror')], function () {
  ...
}