Players

Using mm-player, media applications can create and configure players to browse media sources, retrieve track metadata, and control playback. All media operations in mm-player must be applied to a particular player.

Each player operates independently of the others, so the browsing and playback commands that you send it affect only its own tracksession and media playback. You can assign to players whatever names you want to use to distinguish them, and you can create as many players as you need. Using multiple players lets you direct media output to different zones (i.e., groups of output devices). For instance, you can use separate players for the front and rear speakers of a vehicle.

Before you can browse or play media content, you must create at least one player so you have somewhere to direct your media commands. When it creates a player, the mm-player service returns a player handle, which you must provide in subsequent commands to indicate which player the command is applied to. When you're finished using a player, you must tell mm-player to destroy it.