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);
    }