Music代码结构

Music是Android源码中自带的一个音乐播放器，算是一个轻量级的应用，如下图所示。

Music首页

  在Music源码分析的第一篇，我们首先看一看Music源码在android中的结构：

源码结构.png

MusicBrowserActivity

首先我们从AndroidManifest.xml中找到如下一段代码，很容易就能确定入口的Activity是MusicBrowserActivity。其中android:exported="true"表明可以由其他程序访问。

    <activity android:name="com.android.music.MusicBrowserActivity"
        android:theme="@android:style/Theme.NoTitleBar"
        android:exported="true"
    >
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <action android:name="android.intent.action.MUSIC_PLAYER" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>

这里可以注意一下，MusicBrowserActivity实现了MusicUtils.Defs接口，这个接口实质上是一系列常量：

public interface Defs {
    public final static int OPEN_URL = 0;
    public final static int ADD_TO_PLAYLIST = 1;
    public final static int USE_AS_RINGTONE = 2;
    public final static int PLAYLIST_SELECTED = 3;
    public final static int NEW_PLAYLIST = 4;
    public final static int PLAY_SELECTION = 5;
    public final static int GOTO_START = 6;
    public final static int GOTO_PLAYBACK = 7;
    public final static int PARTY_SHUFFLE = 8;
    public final static int SHUFFLE_ALL = 9;
    public final static int DELETE_ITEM = 10;
    public final static int SCAN_DONE = 11;
    public final static int QUEUE = 12;
    public final static int EFFECTS_PANEL = 13;
    public final static int CHILD_MENU_BASE = 14; // this should be the last item
}

接下来我们看向MusicBrowserActivity，其代码结构如下：

MusicBrowserActivity代码结构.jpeg

  可以看到这个Activity下面包含一个构造函数，两个成员方法和两个成员变量。其中，构造函数是个空方法，我们主要研究其他的部分。
  首先关注一下成员变量。

private ServiceToken mToken;

点进去以后可以发现，ServiceToken是一个定义在MusicUtils中的静态内部类。

public static class ServiceToken {
    ContextWrapper mWrappedContext;
    ServiceToken(ContextWrapper context) {
        mWrappedContext = context;
    }
}

可以看到，ServiceToken的实质就是ContextWrapper，即Context的一个装饰器（装饰模式）。
  接下来是另一个内部类autoshuffle的定义。显然，这是一个典型的AIDL的客户端实现，它绑定了一个远程服务。这个远程服务已在本地定义，我们下一章会具体分析服务端的实现。

private ServiceConnection autoshuffle = new ServiceConnection() {
    public void onServiceConnected(ComponentName classname, IBinder obj) {
        // we need to be able to bind again, so unbind
        try {
            unbindService(this);
        } catch (IllegalArgumentException e) {
        }
        IMediaPlaybackService serv = IMediaPlaybackService.Stub.asInterface(obj);
        if (serv != null) {
            try {
                serv.setShuffleMode(MediaPlaybackService.SHUFFLE_AUTO);
            } catch (RemoteException ex) {
            }
        }
    }

    public void onServiceDisconnected(ComponentName classname) {
    }
}; 

在这个Acitivity中，它重写了onCreate和onDestory。其中，onCreate中主要做了两件事情。我们首先先看这一段代码：

    int activeTab = MusicUtils.getIntPref(this, "activetab",     R.id.artisttab);
    if (activeTab != R.id.artisttab
            && activeTab != R.id.albumtab
            && activeTab != R.id.songtab
            && activeTab != R.id.playlisttab) {
        activeTab = R.id.artisttab;
    }
    MusicUtils.activateTab(this, activeTab);

首先，我们跟踪getIntPref方法。如下所示，这里调用的实质是获取了一个SharedPreferences,并得到其中存储的activeTab值。

static int getIntPref(Context context, String name, int def) {
    SharedPreferences prefs =
        context.getSharedPreferences(context.getPackageName(), Context.MODE_PRIVATE);
    return prefs.getInt(name, def);
}

接下来确定activeTab的取值，默认设为R.id.artisttab。很容易发现，这里是用于设置当前显示的选项卡信息。完成这一步后，又会调用MusicUtils中的activateTab方法，这个方法具体代码如下：

static void activateTab(Activity a, int id) {
    //设置action
    Intent intent = new Intent(Intent.ACTION_PICK);
     //根据id设置URI和mimeType
    switch (id) {
        case R.id.artisttab:
            intent.setDataAndType(Uri.EMPTY, "vnd.android.cursor.dir/artistalbum");
            break;
        case R.id.albumtab:
            intent.setDataAndType(Uri.EMPTY, "vnd.android.cursor.dir/album");
            break;
        case R.id.songtab:
            intent.setDataAndType(Uri.EMPTY, "vnd.android.cursor.dir/track");
            break;
        case R.id.playlisttab:
            intent.setDataAndType(Uri.EMPTY, MediaStore.Audio.Playlists.CONTENT_TYPE);
            break;
        case R.id.nowplayingtab:
            intent = new Intent(a, MediaPlaybackActivity.class);
            a.startActivity(intent);
            // fall through and return
        default:
            return;
    }
    intent.putExtra("withtabs", true);
    //设置标记。拥有这个标记的Activity在启动时，同一个任务栈中所有位于它上面的Activity都要出栈。此时如果Activity为singleTask启动模式，则重启时系统会调用onNewIntent；若是默认的standard模式，则它连同它上面的Activity都要出栈，系统会创建新的Activity实例并放入栈顶。
    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
    a.startActivity(intent);
    a.finish();
    //设置切换activity动画。这里是没有动画
    a.overridePendingTransition(0, 0);
}

首先吐槽一下这个Acticity a的命名……我估计我如果这么命名会被老大骂死=。=……好了，这部分代码采用了activity的隐式调用，通过匹配各类字段启动相应的Activity。下面的一小段代码以为示例（可以对比action和mimeType）。

    <activity android:name="com.android.music.ArtistAlbumBrowserActivity" android:exported="false" >
        <intent-filter>
            <action android:name="android.intent.action.PICK" />
            <category android:name="android.intent.category.DEFAULT" />
            <data android:mimeType="vnd.android.cursor.dir/artistalbum"/>
        </intent-filter>
    </activity>

onCreate方法的第二部分和onDestory对应，分别对应着绑定和解绑service，代码如下：

    //onCreate中第二部分绑定service代码
    String shuf = getIntent().getStringExtra("autoshuffle");
    if ("true".equals(shuf)) {
        mToken = MusicUtils.bindToService(this, autoshuffle);
    }
   //onDestory中解绑service代码
    if (mToken != null) {
        MusicUtils.unbindFromService(mToken);
    }