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 |
---|---|
type | 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. |
code | The following numerical representations are assigned to the notifications:
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. |
metadata | 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. |
innerNotification | 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. |