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的準備狀態。
    在特定的情況下，程式需要通過Proxy 伺服器訪問線上資源，例如，通過APN CMWAP訪問網路時，需要設定CMWAP的Proxy 位址（10.0.0.172:80）。Android平台提供了非常方便的解決方案，使開發人員可以非常簡單的通知OpenCore使用指定的代理來訪問網路音頻資源：在網路媒體的url後，通過“x-http-proxy”指定Proxy 伺服器地址。另外，由於 Android平台支援Multi PDP，可以同時建立多個APN串連，所以開發人員必須指明哪個串連連接埠需要使用Proxy 伺服器，通過“x-net-interface”指定串連連接埠（如何建立CMWAP資料連線，擷取串連連接埠名，本文不再詳細敘述，請讀者查看相關的Android技術文章），下面的程式簡單說明了通過Proxy 伺服器播放音頻資源的步驟：
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();
    }
}