Notification codes

Last update: 2023-10-02

The TVSDK notification system produces various error, warning, and informational notices that provide diagnostic metadata.

Notification objects provide information that is related to the player’s status. TVSDK provides a chronologically sorted list of notification objects. Each notification contains the following metadata:

Element Description

The notification type.

Depending on the platform, this property is an enumerated type with possible values of INFO, WARN, and ERROR. This is the top-level grouping for notifications.


The following numerical representations are assigned to the notifications:

  • Error notification events, from 100000 to 199999
  • Warning notification events, from 200000 to 299999
  • Information notification events, from 300000 to 399999

Each top-level range, such as errors, is divided into subranges, such as 101000 through 101999 representing playback errors.

name A string that contains a human-readable description of the notification event, such as SEEK_ERROR.

Key/value pairs that contain additional relevant information about the notification.

For example, a key named URL would provide a value that is a URL related to the notification, such as an invalid URL that caused an error.


A reference to another MediaPlayerNotification object that directly impacted this notification.

An example might be a notification about an ad-insertion failure that directly corresponds to a time-line insertion conflict. Not all notifications provide an inner notification.

On this page