MediaFacade

Facade modules for dealing with complicated MediaStore in a simple way.

Usage

Audio

Audio in MediaStore has several tables like Media, Artists, Albums, Playlists and Genres. MediaFacade provides easy accesses to those tables.

Albums

public class SampleActivity extends Activity {
  private AudioFacade facade;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ...

    facade = AudioFacade.getInstance(this);
    Cursor albums = null;
    try {
      albums = facade.album().fetchAlbum();
      // do whatever you like with the album metadata
    } finally {
      if (albums != null)
        albums.close();
    }
  }
}

Artists

public class SampleActivity extends Activity {
  private AudioFacade facade;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ...

    facade = AudioFacade.getInstance(this);
    Cursor artists = null;
    try {
      artists = facade.artist().fetchArtists();
      // do whatever you like with the album metadata
    } finally {
      if (artists != null)
        artists.close();
    }
  }
}

Genres

public class SampleActivity extends Activity {
  private AudioFacade facade;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ...

    facade = AudioFacade.getInstance(this);
    Cursor genres = null;
    try {
      genres = facade.genre().fetchGenres();
      // do whatever you like with the album metadata
    } finally {
      if (genres != null)
        genres.close();
    }
  }
}

Playlists

public class SampleActivity extends Activity {
  private AudioFacade facade;
  private EditText playlistName;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ...

    facade = AudioFacade.getInstance(this);
    Cursor playlists = null;
    try {
      playlists = facade.playlist().fetchGenres();
      // do whatever you like with the album metadata
    } finally {
      if (playlists != null)
        playlists.close();
    }
  }

  public void onNewPlaylistButtonClick(View v) {
    String name = playlistName.getText().toString();
    Uri uri = facade.playlist().createNew(name);
    // you can add music tracks with this uri
  }
}

Image and Video

Image and Video have similar structure in their tables. One noteworthy concept is Bucket, which is kind of Album for images and/or videos. Image and Video have 2 columns (BUCKET_ID and BUCKET_DISPLAY_NAME) for describing which bucket the image belongs to.

Bucket

Since there's no specific table that manages each buckets so you need to group by bucket when you query images/videos in SQL. ImageFacade and VideoFacade do grouping for you.

public class SampleActivity extends Activity {
  private ImageFacade facade;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ...

    facade = ImageFacade.getInstance(this);
    Cursor imageBuckets = null;
    try {
      imageBuckets = facade.bucket().fetch();
      if (imageBuckets == null)
        return;
      while (imageBuckets.moveToNext()) {
        long bucketId = imageBuckets.getLong(imageBuckets.getColumnIndex(MediaStore.Image.Media.BUCKET_ID));
        // you can query images in the specific bucket with this bucketId
        Cursor imagesInBucket = facade.image().fetchByBucket(bucketId);
        // ...
      }
    } finally {
      if (imageBuckets != null)
        imageBuckets.close();
    }
  }
}

Cursors

MediaFacade provides customized yet fully Android compatible Cursors for developers to access fields by just calling corresponding methods.

public class SampleActivity extends Activity {
  private ImageFacade facade;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ...

    facade = ImageFacade.getInstance(this);
    ImageCursor imageBuckets = null;
    try {
      imageBuckets = facade.bucket().fetch();
      if (imageBuckets == null)
        return;
      while (imageBuckets.moveToNext()) {
        long bucketId = imageBuckets.id();
        // you can query images in the specific bucket with this bucketId
        ImageCursor imagesInBucket = facade.image().fetchByBucket(bucketId);
        // ...
      }
    } finally {
      if (imageBuckets != null)
        imageBuckets.close();
    }
  }
}

We have following customized classes of Cursors.

• MediaItemCursor
• AlbumCursor
• AlbumItemCursor
• GenreCursor
• GenreItemCursor
• ArtistCursor
• ArtistItemCursor
• PlaylistCurosr
• PlaylistItemCurosr
• ImageCursor
• VideoCursor

These Cursors are subclasses of Cursor so that you can use them with CursorAdapter and various Cursor API.

Download

Gradle:

compile 'com.drivemode:mediafacade-audio:0.1.0@aar'
compile 'com.drivemode:mediafacade-image:0.1.0@aar'
compile 'com.drivemode:mediafacade-video:0.1.0@aar'

License

Apache v2

Copyright (C) 2016 Drivemode, Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.