Android平台的音樂資源管理與播放

    Android平台基於Linux和開放手機聯盟（OHA）系統，經過中國移動的創新研發，設計出擁有新穎獨特的用戶操作界面，增強了瀏覽器能力和WAP 兼容性，優化了多媒體領域的OpenCORE、瀏覽器領域的WebKit等業內眾多知名引擎，增加了包括游戲、Widget、Java ME等在內的先進平台中間件。本文主要介紹如何利用OPhone平台提供的多媒體編程環境進行音樂資源的管理與播放。

MediaScanner與音樂信息掃描
    Android系統在SD卡插入后，MediaScanner服務會在后台自動掃描SD上的文件資源，將SD上的音樂媒體信息加入到MediaStore數據庫中。程序可以直接從MediaStore中讀取相應的媒體信息。通過注冊監聽MediaScanner廣播的Intent，可以獲知MediaScanner服務是否在進行后台的掃描工作：

    Intent.ACTION_MEDIA_SCANNER_STARTED   表示MeidaScanner開始掃描；
    Intent.ACTION_MEDIA_SCANNER_FINISHED  表示MediaScanner掃描結束；

    當程序從網絡下載媒體文件到終端后，MediaScanner服務並不會自動掃描剛剛下載的文件，需要程序主動去掃描這些新添加的媒體文件信息到MediaStore數據庫中。在Android系統中有兩種方式去主動掃描音樂媒體文件信息到MediaStore數據庫：

1．啟動MediaScanner服務，掃描媒體文件：
    程序通過發送下面的Intent啟動MediaScanner服務掃描指定的文件或目錄：

    Intent.ACTION_MEDIA_SCANNER_SCAN_FILE：掃描指定文件

       public void scanFileAsync(Context ctx, String filePath) {
              Intent scanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
              scanIntent.setData(Uri.fromFile(new File(filePath)));
              ctx.sendBroadcast(scanIntent);
       }

    "android.intent.action.MEDIA_SCANNER_SCAN_DIR"：掃描指定目錄

       public static final String ACTION_MEDIA_SCANNER_SCAN_DIR = "android.intent.action.MEDIA_SCANNER_SCAN_DIR";
       public void scanDirAsync(Context ctx, String dir) {
              Intent scanIntent = new Intent(ACTION_MEDIA_SCANNER_SCAN_DIR);
              scanIntent.setData(Uri.fromFile(new File(dir)));
              ctx.sendBroadcast(scanIntent);
       }

    這種掃描方式中，由於掃描工作是在MediaScanner服務中進行的，因此不會阻塞當前程序進程。當掃描大量媒體文件且實時性要求不高的情況下，適合使用該掃描方式。

2．通過MediaScanner提供的API接口，掃描媒體文件。
    這種掃描媒體文件的方式是同步的，掃描工作將會阻塞當前的程序進程。當掃描少量文件，且要求立即獲取掃描結果的情況下，適合使用該掃描方式。
    在掃描媒體文件前，程序應該根據終端當前的語言環境正確設置MediaScanner的語言環境設置, 避免產生編解碼的錯誤:
    MediaScanner scanner = new MediaScanner(ctx);
    Locale locale   = ctx.getResources().getConfiguration().locale;
    String language = locale.getLanguage();
    String country  = locale.getCountry();
    scanner.setLocale(language + \"_\" + country);
    媒體文件可以存儲在手機終端的內存中，也可以存儲在SD卡中，Android平台中稱手機終端內存為內部存儲空間，稱SD卡為外部存儲空間。針對內部和外部存儲空間中的媒體文件信息是分開管理的，各自有獨立的數據庫管理。因此在掃描媒體文件時，要明確指明掃描的媒體文件是位於內部存儲空間還是外部存儲空間。外部存儲空間和內部存儲空間對應的卷標為"external"和"internal"。
    scanner.scanSingleFile(filePath, volumeName, mimeType);
    scanner.scanDirectories(directories, volumeName);

MediaStore與音樂信息查詢
    MediaScanner將掃描媒體文件獲得的信息全部存儲在MediaStore數據庫中。MediaStore是基於SQLite數據庫系統的，通過ContentProvider方式，程序可以對MediaStore數據庫進行增刪查改等操作。
    MediaStore的數據庫文件位於/data/data/com.android.providers/databases, 通常可以發現兩個數據庫文件
    internal.db：對應內部存儲空間的媒體數據庫文件；
    external-xxxxxxxx.db：對應外部存儲空間的媒體數據文件，由於同一個手機終端可能使用多個SD卡，針對每一個SD卡，OPhone平台都會生成對應的媒體數據庫文件。
    兩個數據庫文件除了管理的文件所存儲的位置不同外，沒有其他區別。本文后續將默認以外部存儲為例進行介紹。
    使用SQLite命令打開數據庫文件，可以看到Android多媒體數據庫的基本結構:
    >sqlite3 external-xxx.db
    >.tables
    >.schema
    感興趣的讀者可以自己查看，本文不再一一列舉。

    MediaStore類是Android平台的多媒體數據庫，它包含了音頻，視頻，圖片等所有多媒體文件信息。本文將重點介紹如何管理和獲取音頻信息，視頻和圖片等信息的獲取與管理與音頻類似。
    MediaStore以ContentProvider的形式向外提供媒體數據庫信息。通過Android平台提供的ContentProvider接口，可以方便的訪問數據庫信息。
    public Cursor query(Contex ctx, Uri _uri, String[] prjs, String selections, String[] selectArgs, String order) {
        ContentResolver resolver = ctx.getContentResolver();
        if (resolver == null) {
            return null;
        }
        return resolver.query(_uri, prjs, selections, selectArgs, order);
    }

    _uri：指明要查詢的數據庫名稱加上表的名稱，從MediaStore中我們可以找到相應信息的參數，具體請參考SDK開發文檔。
    prjs: 指定查詢數據庫表中的哪幾列，返回的游標中將包括相應的信息。Null則返回所有信息。      
    selection: 指定查詢條件     
    selectionArgs：參數selection里有？這個符號時，這里可以以實際值代替這個問號。如果selection這個沒有？的話，那么這個String數組可以為null
    order：指定查詢結果的排列順序

    MediaStore.Audio.Media類定義了媒體數據庫中的歌曲信息
    MediaStore.Audio.Artists類定義了媒體數據庫中的歌手信息
    MediaStore.Audio.Albums類定義了媒體數據庫中的專輯信息
    MediaStore.Audio.Playlists類定義了媒體數據庫中的播放列表信息

    讀者可以通過OPhone SDK開發文檔找到詳細的信息，結合ContentProvider的查詢接口，可以獲取所有媒體信息。
    MediaPlayer與音樂播放MediaPlayer是Android多媒體編程中最核心的類。它提供了一個多媒體播放器常用的基本操作如播放，暫停，停止，獲取文件播放長度等等。它向下通過JNI封裝，獲取系統提供的多媒體播放能力。
    MeidaPlayer提供了設計良好的多媒體接口，播放一個音頻文件的步驟非常簡單：
    1.創建播放器： new MediaPlayer()
    2.設置音頻源： setDataSource(Audio_PATH)
    3.准備音頻源： prepare()
    4.播放音頻：   start()
    5.停止播放：   stop()
    6.釋放資源：   release();
    其他MediaPlayer常用接口例如pause(), getDuration(), seekTo()等，大家可以自己查閱SDK文檔，這里不在一一介紹。
    音頻的播放過程也就是MediaPlayer對象的狀態轉換過程。深入理解MediaPlayer的狀態機是靈活駕馭Android多媒體編程的基礎。讀者在Android SDK 開發文檔中可以查看到MediaPlayer的狀態轉換圖。程序有必要監聽這些變化，判斷播放器所處的狀態，Android平台提供了多種監聽器，來監視 MediaPlayer的狀態變化：
    MediaPlayer.OnBufferingUpdateListener
    MediaPlayer.OnCompletionListener
    MediaPlayer.OnErrorListener
    MediaPlayer.OnPreparedListener
    MediaPlayer.OnSeekCompleteListener

    Android平台可以從資源文件、文件系統和網絡三種方式來播放多媒體文件。無論使用哪種播放方式，基本的流程都是類似的。

從資源文件播放
    多媒體文件可以放在資源文件夾/res/raw目錄下，然后通過MediaPlayer.create(Context ctx, int file)方法創建MediaPlayer對象，獲得MediaPlayer對象后直接調用start()方法即可播放音樂。

從文件系統播放
    從文件系統播放音樂，需要使用new操作符創建MediaPlayer對象。獲得MediaPlayer對象之后，需要依次調用setDataSource() 和prepare()方法，以便設置數據源，讓播放器完成准備工作，然后調用start()方法播放音樂。

從網絡播放
    Android平台支持在線播放媒體音樂，通過 progress download的方式播放在線音頻資源。Progress download的支持由底層的OpenCore多媒體庫提供支持，應用開發者不必關心具體實現細節，只需要設置網絡音頻資源的地址，就可以完成在線播放的工作，極大提高了開發效率。由於從網絡下載播放音頻資源需要較長的時間，在准備音頻資源的時候，需要使用prepareAsync()方法，這個方法是異步執行的，不會阻塞程序的主進程。MediaPlayer通過MediaPlayer.OnPreparedListener通知 MediaPlayer的准備狀態。
    在特定的情況下，程序需要通過代理服務器訪問在線資源，例如，通過APN CMWAP訪問網絡時，需要設置CMWAP的代理地址（10.0.0.172:80）。Android平台提供了非常方便的解決方案，使開發者可以非常簡單的通知OpenCore使用指定的代理來訪問網絡音頻資源：在網絡媒體的url后，通過“x-http-proxy”指定代理服務器地址。另外，由於 Android平台支持Multi PDP，可以同時建立多個APN連接，所以開發者必須指明哪個連接端口需要使用代理服務器，通過“x-net-interface”指定連接端口（如何建立CMWAP數據連接，獲取連接端口名，本文不再詳細敘述，請讀者查看相關的Android技術文章），下面的程序簡單說明了通過代理服務器播放音頻資源的步驟：
private void playFromNetwork() {
    String path = "http://website/path/test.mp3";
    String CMWAP_HOST = "10.0.0.172";
    String CMWAP_PORT = "80";

    //假設CMWAP連接的端口名
    String SOCKET_INTERFACE = "cminnet0";

    String urlWithProxy = path + "?x-http-proxy=" + CMWAP_HOST + ":" + CMWAP_PORT + "&" + "x-net-interface=" + SOCKET_INTERFACE ;
    try {
        MediaPlayer player = new MediaPlayer();
        player.setDataSource(path);
        player.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
             public void onPrepared(MediaPlayer player) {
                 player.start();
             }
        });
        player.prepareAsync();
    } catch (Exception e) {
        e.printStackTrace();
    }
}