Intent API for video playback

Mizuu includes an amount of extra meta data when playing video files. This data is available to video players through Intent extras, and can be used to provide users with an enhanced video viewing experience.

This page will provide developers of video players with an overview of which data is available when playing files from Mizuu. The data is available with Mizuu 2.2 or newer.

Important: Always perform null-checks to see if the Intent extras are available. Also, please note that local cover paths in some cases may point to non-existing images, so you should always check if the file exists before decoding it.

General videos

• “title” (String)

  Get the title of the video, movie or TV show episode.

Movies

• “plot” (String)

  Get the plot / description of the movie.

• “date” (String)

  Get the release date of the movie. Formatted as YYYY-MM-DD, if available.

• “rating” (Double)

  Get the rating of the movie as a Double value between 0.0 and 10.0.

• “cover” (String)

  Get the file path to the cover art of the movie. The path can be both local and to a server, so check if the path starts with “http” to determine which kind it is.

• “genres” (String)

  Get the genres of the movie. Genres are comma-separated if there are more than one.

TV show episodes

• “plot” (String)

  Get the plot / description of the TV show episode.

• “date” (String)

  Get the air date of the TV show episode. Formatted as YYYY-MM-DD, if available.

• “rating” (Double)

  Get the rating of the TV show episode as a Double value between 0.0 and 10.0.

• “cover” (String)

  Get the file path to the episode photo. The path can be both local and to a server, so check if the path starts with “http” to determine which kind it is.

• “episode” (String)

  Get the episode number of the TV show episode. Represented as “##”, even if the number is a single digit, hence a String rather than an integer.

• “season” (String)

  Get the season number of the TV show episode. Represented as “##”, even if the number is a single digit, hence a String rather than an integer.

Retrieving data from Intent extras

This simple example will show you how to get the title of a video through Intent extras:

Intent intent = getIntent();
String title = intent.getStringExtra("title", "fallback"); // use a fallback value if nothing is found

This simple example will show you gow to get the rating of a video through Intent extras:

Intent intent = getIntent();
Double rating = intent.getDoubleExtra("rating", 0.0); // Fallback to 0.0 if nothing is found

Video players using data from Mizuu

The following listed applications make use of some or all of the extra metadata provided by Mizuu's Intent API:

• BubbleUPnP
• MX Player (ad-supported and pro)
• VLC for Android (beta)

Is your application missing? Feel free to add it!