Setting a priority folder

Depending on user actions, your client application may need to interrupt a synchronization in progress and begin synchronizing a new folder. The priority folder synchronization feature helps you reduce the time required for making media content from a certain folder available for viewing or playing.

Suppose your application must display up-to-date folder information in a mediastore file browser and, during a synchronization, the user selects a different folder to view or play tracks from. In this case, you should do a priority synchronization of the newly selected folder. This action displays the folder's metadata and makes the folder's media files playable ahead of files in other folders.

To start a priority folder synchronization, call mm_sync_control() or run the sync_control command with the following extended option settings:

When it receives such a request, mm-sync interrupts any synchronization in progress on the same device on which the priority folder is stored and synchronizes the priority folder's contents before resuming the original synchronization.

The priority folder feature has the following behavior: