Integrate External Player

to extend nativewaves' playback capabilities, our sdk allows seamless integration of an external player instance this flexibility lets you customize the playback experience to meet your specific needs while leveraging exoplayer's powerful features recognizing that every application has unique video and audio playback requirements, we provide two approaches for external player integration, giving you the freedom to use your preferred player integrating exoplayer (deprecated) integrating nwplayer (recommended) below, we provide a high level overview of both approaches to help you choose the best solution for your needs integrating exoplayer (deprecated) if you choose to inject an exoplayer instance into the sdk, you will need to initialize it with the exoplayer configuration (or optionally use our pre configured setup) once the exoplayer instance is created and injected, the sdk takes full control of the player this means limited freedom you do not have the ability to customize or control the player after injection pre configured setup (optional) the exoplayer must be initialized with our predefined settings, leaving little room for customization while this approach is straightforward, it is deprecated, and we recommend migrating to the more flexible nwplayer integration for greater control and customization integrating nwplayer (recommended) starting from sdk version 4 10 0, we introduced nwplayer , an interface that allows you to wrap your preferred player (e g , exoplayer or any other player) and inject it into the sdk this approach is the latest and recommended solution for external player integration here is what you need to know full control and customization you have complete freedom to customize the player and its behavior you can use exoplayer or any other player that fits your requirements player lifecycle management unlike the exoplayer injection approach, you are responsible for handling the player’s lifecycle the sdk will call methods like prepare , resume , pause , seekto , and release through the nwplayer interface you must ensure that your player responds correctly to these calls to avoid playback issues since you have full control, you need to carefully manage the player’s state and ensure it aligns with the sdk’s expectations this approach is ideal if you need advanced customization or want to use a player other than exoplayer which approach should you choose? if you are starting a new integration, we strongly recommend using nwplayer it provides greater flexibility and is the future proof solution for external player integration if you are currently using the exoplayer injection approach, consider migrating to nwplayer to take advantage of its enhanced capabilities and customization options for detailed implementation steps, refer to the following sections integrating nwplayer integrating exoplayer at nativewaves ag, we are committed to providing you with the tools and flexibility you need to deliver exceptional playback experiences if you have any questions or need assistance, feel free to reach out to our support team happy coding!