Error handling

The plugin provides an error handling events via which the App can be provided with details of errors that have occurred.

There are two events which can be used by App to get notified when the player incurs an error:

Critical Errors

Any errors where the player cannot continue playback are triggered through the onError event.

See the React Native SDK APIs for full details - especially in this case the onError event and the error codes that can be reported with that event.

HTTP Errors

Any errors occurring due to failure of HTTP requests are triggered through onHttpError event. These errors do not necessarily result in failure of playback. However, when this error finally results in a critical error, the onError shall also be triggered in addition to onHttpError.

See the React Native SDK APIs for full details - especially in this case the onHttpError event.

Critical Error Types

There are several error types that classify the set of errors into different categories of Player functionality, for example

Media type error
DRM type error
SSM type error

The full list of errors and their types is documented in the React Native SDK API documentation.

Example Code

Click here to see a minimal implementation to log errors

JS

…
import OTVPlayer from '@nagra/react-otvplayer'
…
const App: () => Node = () => {
    …
    this.otvplayer = {
        ref: OTVPlayer
    };

	this._onError = (eventData) => {
		console.log(`Error witnessed ${JSON.stringify(eventData)}`);
	};
 
    this._onHttpError = (eventData) => {
		console.log(`HTTP Error witnessed ${JSON.stringify(eventData)}`);
	};
 
    this.events = {
		onError: this._onError.bind(this),
		onHttpError: this._onHttpError.bind(this)
    };
    
    return (
        <OTVPlayer
            // You will need to retain a reference to the OTVPlayer element in order to interact with the playback on user events
            ref={otvplayer => this.otvplayer.ref = otvplayer}
            // A source can be specified in the element declaration or programmatically, specifying it in here starts the content loading immediately
            source={{
                src: "https://d3bqrzf9w11pn3.cloudfront.net/basic_hls_bbb_clear/index.m3u8"
                type: "application/x-mpegURL",
            }}
            // There are several playback events that can be hooked in to and trigger actions in the application
			onError={this.events.onError}
			onHttpError={this.events.onHttpError}
        >
        </OTVPlayer>
    );
    …
}
…