{"id":71244,"date":"2025-03-31T22:20:36","date_gmt":"2025-03-31T16:50:36","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=71244"},"modified":"2025-04-01T11:18:53","modified_gmt":"2025-04-01T05:48:53","slug":"migrating-from-exoplayer-2-to-media3-a-fun-practical-guide","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/migrating-from-exoplayer-2-to-media3-a-fun-practical-guide\/","title":{"rendered":"Migrating from ExoPlayer 2 to Media3: A Fun & Practical Guide"},"content":{"rendered":"

Why Migrate? (Besides Google Telling You To\ud83d\ude1c)<\/strong><\/h2>\n

Google has spoken\u2014ExoPlayer 2 is old news, and Media3 is the new standard for Android media playback. It\u2019s modular,<\/p>\n

Jetpack-aligned, and designed for the long haul. If your app still relies on ExoPlayer 2, this migration ensures modern API design, better lifecycle handling, and compatibility with Android\u2019s latest updates. Plus, who doesn\u2019t love a fresh start?<\/p>\n

Let\u2019s dive into the key changes and how to migrate with minimal headaches (and maximum fun).<\/p>\n

\n

Major Changes in Media3 (What You Need to Know)<\/h2>\n

1. Package Reshuffle: Out with the Old, In with the New\ud83d\udd04<\/h3>\n

Your ExoPlayer 2 imports:<\/p>\n\n\n\n
\"Exoplayer<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Now become Media3 imports:<\/p>\n\n\n\n
\n

\"Media

Media 3 imports<\/p><\/div><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Yep, SimpleExoPlayer is now just ExoPlayer. Simple, right? \ud83d\ude06<\/p>\n

2. Player Initialization (Same, But Shinier\u2728)<\/h3>\n

ExoPlayer 2:<\/p>\n

\"Player

Player Initialization Exoplayer
<\/strong><\/p><\/div>\n

Media3:<\/p>\n

 <\/p>\n

\"Player

Player Initialization Media 3<\/p><\/div>\n

If you were expecting something earth-shattering, sorry. But hey, at least it\u2019s cleaner!<\/p>\n

<\/h3>\n

3. Setting Up Media Items (A Tiny Bit Different)<\/h3>\n

Before:<\/p>\n

\"Setting

Setting up Media Item Exoplayer 2<\/p><\/div>\n

Now:<\/p>\n

\"Setting

Setting up Media Item Media 3<\/p><\/div>\n

Now you get to use a Builder, which makes it easier to expand media item configurations.<\/p>\n

<\/h3>\n

4. MediaSession and MediaController (Because Your App Deserves System Controls)<\/h3>\n

Instead of MediaSessionConnector, use MediaSession:<\/p>\n

\"Use

Use Media Session in Media 3<\/p><\/div>\n

Want playback controls? \ud83d\udd79\ufe0f<\/p>\n

\"Use

Use Media Controller in Media 3<\/p><\/div>\n

More modern, more Jetpack-y. \ud83c\udfce\ufe0f<\/p>\n

<\/h3>\n

 <\/p>\n

5. UI Components (Yes, You Need to Update Your XML)<\/h3>\n

If your XML looks like this:<\/p>\n

\"Exoplayer

Exoplayer 2 Player VIew<\/p><\/div>\n

 <\/p>\n

Change it to this:<\/p>\n

\"Media

Media 3 Player VIew<\/p><\/div>\n

 <\/p>\n

Not a huge deal, but forget this and your UI won\u2019t be happy. \ud83d\ude05<\/p>\n

 <\/p>\n

6. Event Handling (No More EventListener )<\/h3>\n

If you were using EventListener, update to Listener:<\/p>\n

\"EventListener,

EventListener, update to Listener:<\/p><\/div>\n

It\u2019s cleaner, and it works just the same. \ud83e\uddfc<\/p>\n

 <\/p>\n

7. Subtitles (Now More Elegant )<\/h3>\n

Subtitle setup in ExoPlayer 2:<\/p>\n

\"Subtitle

Subtitle setup in ExoPlayer 2:<\/p><\/div>\n

In Media3, just update the MIME type to MimeTypes.TEXT_VTT for better compatibility. \ud83c\udfa5<\/p>\n

 <\/p>\n

8. @UnstableApi (Handle With Care! )<\/h3>\n

Some APIs are now marked @UnstableApi, meaning Google might break them in a future update.<\/p>\n

\"@UnstableApi

@UnstableApi usage<\/p><\/div>\n

9. Dependency Updates (Don\u2019t Forget These! \ud83d\udee0\ufe0f)<\/p>\n

Make sure your build.gradle includes:<\/p>\n

\"Media

Media 3 Dependencies<\/p><\/div>\n

Without this, your app won\u2019t build, and you\u2019ll spend hours wondering why. \u23f3\ud83d\udc80<\/p>\n

\n

 <\/p>\n

Final Thoughts (Aka TL;DR )<\/h1>\n