Android多媒體框架OpenCore（PacketVideo）介紹之一：概覽和庫介紹

                                                        第一部分 OpenCore概述
      OpenCore的另外一個常用的稱呼是PacketVideo，它是Android的多媒體核心。PacketVideo是一家公司的名稱，OpenCore是這套多媒體框架的軟件層的名稱。在Android的開發者層次看，二者的含義基本相同。對比Android的其它程序庫，OpenCore的代碼非常龐大，它是一個基於C++的實現，定義了全功能的操作系統移植層，各種基本的功能均被封裝成類的形式，各層次之間的接口多使用繼承等方式。OpenCore是一個多媒體的框架，從宏觀上來看，它主要包含了兩大方面的內容：
     * PVPlayer：提供媒體播放器的功能，完成各種音頻（Audio）、視頻（Video）流的回放（Playback）功能
     * PVAuthor：提供媒體流記錄的功能，完成各種音頻（Audio）、視頻（Video）流的以及靜態圖像捕獲功能
PVPlayer和PVAuthor以SDK的形式提供給開發者，可以在這個SDK之上構建多種應用程序和服務。比如在移動終端中常常使用的多媒體應用程序，例如媒體播放器、照相機、錄像機、錄音機等等。
      爲了更好的組織整體的架構，OpenCore在軟件層次在宏觀上分成幾個層次：
* OSCL：Operating System Compatibility Library (操作系統兼容庫)，包含了一些操作系統底層的操作，爲了更好地在不同操作系統移植。包含了基本數據類型、配置、字符串工具、IO、錯誤處理、線程等內容，類似一個基礎的C++庫。
* PVMF：PacketVideo Multimedia Framework（PV多媒體框架），在框架內實現一個文件解析（parser）和組成（composer）、編解碼的NODE，也可以繼承其通用的接口，在用戶層實現一些NODE。
* PVPlayer Engine：PVPlayer引擎。
* PVAuthor Engine：PVAuthor引擎。
      事實上，OpenCore中包含的內容非常多：從播放的角度，PVPlayer的輸入（Source）是文件或者網絡媒體流，輸出（Sink）是音頻視頻的輸出設備，其基本功能包含了媒體流控制、文件解析、音頻視頻流的解碼（Decode）等方面的內容。除了從文件中播放媒體文件之外，還包含了與網絡相關的RTSP流（Real Time Stream Protocol,實時流協議）。在媒體流記錄的方面，PVAuthor的輸入（Source）是照相機、麥克風等設備，輸出（Sink）是各種文件，包含了流的同步、音頻視頻流的編碼（Encode）以及文件的寫入等功能。
      在使用OpenCore的SDK的時候，有可能需要在應用程序層實現一個適配器（Adaptor），然後在適配器之上實現具體的功能，對於PVMF的NODE也可以基於通用的接口，在上層實現，以插件的形式使用。

                                                      第二部分 OpenCore的代碼結構
2.1 代碼結構
      以開源Android的代碼爲例，OpenCore的代碼在以下目錄中：external/opencore/。這個目錄是OpenCore的根目錄，其中包含的子目錄如下所示：
* android：這裏面是一個上層的庫，它基於PVPlayer和PVAuthor的SDK實現了一個爲Android使用的Player和Author。
* baselibs：包含數據結構和線程安全等內容的底層庫
* codecs_v2：這是一個內容較多的庫，主要包含編解碼的實現，以及一個OpenMAX的實現
* engines：包含PVPlayer和PVAuthor引擎的實現
* extern_libs_v2：包含了khronos的OpenMAX的頭文件
* fileformats：文件格式的解析（parser）工具
* nodes：提供一些PVMF的NODE，主要是編解碼和文件解析方面的。
* oscl：操作系統兼容庫
* pvmi：輸入輸出控制的抽象接口
* protocols：主要是與網絡相關的RTSP、RTP、HTTP等協議的相關內容
* tools_v2：編譯工具以及一些可註冊的模塊。
     在external/opencore/目錄中還有2個文件，如下所示：
* Android.mk：全局的編譯文件
* pvplayer.conf：配置文件
     在external/opencore/的各個子文件夾中包含了衆多的Android.mk文件，它們之間還存在着“遞歸”的關係。例如根目錄下的Android.mk，就包含了如下的內容片斷：
include $(PV_TOP)/engines/player/test/Android.mk
include $(PV_TOP)/engines/author/test/Android.mk
include $(PV_TOP)/engines/2way/test/Android.mk
     這表示了要引用若干文件夾下面的Android.mk文件。external/opencore/的各個Android.mk文件可以按照排列組合進行使用，將幾個Android.mk內容合併在一個庫當中。

2.2 編譯結構
1．庫的層次關係：在Android的開源版本中編譯出來的內容，OpenCore編譯出來的各個庫如下所示：
    * libopencorecommon.so：OpenCore底層的公共庫
    * libopencoredownloadreg.so ：下載註冊庫
    * libopencoredownload.so：下載功能實現庫
    * libopencoremp4reg.so：MP4註冊庫
    * libopencoremp4.so：MP4功能實現庫
    * libopencorenet_support.so：網絡支持庫
    * libopencoreplayer.so：OpenCore的Player庫

    * libopencoreauthor.so：OpenCore的Author庫
    * libopencorertspreg.so：RTSP註冊庫
    * libopencorertsp.so：RTSP功能實現庫
OpenCore的各個庫之間具有如下的關係：
    libopencorecommon.so是所有的庫的依賴庫，提供了公共的功能；
    libopencoreplayer.so和libopencoreauthor.so是兩個並立的庫，分別用於回放和記錄，而且這兩個庫是OpenCore對外的接口庫；
    libopencorenet_support.so提供網絡支持的功能；
    一些功能以插件（Plug-In）的方式放入Player中使用，每個功能使用兩個庫，一個實現具體功能，一個用於註冊。
2．libopencorecommon.so庫的結構
      libopencorecommon.so是整個OpenCore的核心庫，它的編譯控制的文件的路徑爲pvcommon/Android.mk，這個文件使用遞歸的方式尋找子文件：
include $(BUILD_SHARED_LIBRARY)
include $(PV_TOP)//oscl/oscl/osclbase/Android.mk
include $(PV_TOP)//oscl/oscl/osclerror/Android.mk
include $(PV_TOP)//oscl/oscl/osclmemory/Android.mk
include $(PV_TOP)//oscl/oscl/osclutil/Android.mk
include $(PV_TOP)//oscl/pvlogger/Android.mk
include $(PV_TOP)//oscl/oscl/osclproc/Android.mk
include $(PV_TOP)//oscl/oscl/osclio/Android.mk
include $(PV_TOP)//oscl/oscl/osclregcli/Android.mk
include $(PV_TOP)//oscl/oscl/osclregserv/Android.mk
include $(PV_TOP)//oscl/unit_test/Android.mk
include $(PV_TOP)//oscl/oscl/oscllib/Android.mk
include $(PV_TOP)//pvmi/pvmf/Android.mk
include $(PV_TOP)//baselibs/pv_mime_utils/Android.mk
include $(PV_TOP)//nodes/pvfileoutputnode/Android.mk
include $(PV_TOP)//baselibs/media_data_structures/Android.mk
include $(PV_TOP)//baselibs/threadsafe_callback_ao/Android.mk
include $(PV_TOP)//codecs_v2/utilities/colorconvert/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_nb/common/Android.mk
include $(PV_TOP)//codecs_v2/video/avc_h264/common/Android.mk
       這些被包含的Android.mk文件真正指定需要編譯的文件，這些文件在Android.mk的目錄及其子目錄中。事實上，在libopencorecommon.so庫中包含了以下內容：
    * OSCL的所有內容
    * Pvmf框架部分的內容（pvmi/pvmf/Android.mk）
    * 基礎庫中的一些內容（baselibs）
    * 編解碼的一些內容
    * 文件輸出的node（nodes/pvfileoutputnode/Android.mk）
      從庫的結構中可以看出，最終生成庫的結構與OpenCore的層次關係並非完全重合。libopencorecommon.so庫中就包含了底層的OSCL的內容、PVMF的框架以及Node和編解碼的工具。
3．libopencoreplayer.so庫的結構
     libopencoreplayer.so是用於播放的功能庫，它的編譯控制的文件的路徑爲pvplayer/Android.mk，它包含了以下的內容：
include $(BUILD_SHARED_LIBRARY)
include $(PV_TOP)//engines/player/Android.mk
include $(PV_TOP)//codecs_v2/audio/aac/dec/util/getactualaacconfig/Android.mk
include $(PV_TOP)//codecs_v2/video/avc_h264/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/aac/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_nb/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_wb/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/common/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/mp3/dec/Android.mk
include $(PV_TOP)//codecs_v2/utilities/m4v_config_parser/Android.mk
include $(PV_TOP)//codecs_v2/utilities/pv_video_config_parser/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_common/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_queue/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_h264/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_aac/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_amr/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_mp3/Android.mk
include $(PV_TOP)//codecs_v2/omx/factories/omx_m4v_factory/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_proxy/Android.mk
include $(PV_TOP)//nodes/common/Android.mk
include $(PV_TOP)//pvmi/content_policy_manager/Android.mk
include $(PV_TOP)//pvmi/content_policy_manager/plugins/oma1/passthru/Android.mk
include $(PV_TOP)//pvmi/content_policy_manager/plugins/common/Android.mk
include $(PV_TOP)//pvmi/media_io/pvmiofileoutput/Android.mk
include $(PV_TOP)//fileformats/common/parser/Android.mk
include $(PV_TOP)//fileformats/id3parcom/Android.mk
include $(PV_TOP)//fileformats/rawgsmamr/parser/Android.mk
include $(PV_TOP)//fileformats/mp3/parser/Android.mk
include $(PV_TOP)//fileformats/mp4/parser/Android.mk
include $(PV_TOP)//fileformats/rawaac/parser/Android.mk
include $(PV_TOP)//fileformats/wav/parser/Android.mk
include $(PV_TOP)//nodes/pvaacffparsernode/Android.mk
include $(PV_TOP)//nodes/pvmp3ffparsernode/Android.mk
include $(PV_TOP)//nodes/pvamrffparsernode/Android.mk
include $(PV_TOP)//nodes/pvmediaoutputnode/Android.mk
include $(PV_TOP)//nodes/pvomxvideodecnode/Android.mk
include $(PV_TOP)//nodes/pvomxaudiodecnode/Android.mk
include $(PV_TOP)//nodes/pvwavffparsernode/Android.mk
include $(PV_TOP)//pvmi/recognizer/Android.mk
include $(PV_TOP)//pvmi/recognizer/plugins/pvamrffrecognizer/Android.mk
include $(PV_TOP)//pvmi/recognizer/plugins/pvmp3ffrecognizer/Android.mk
include $(PV_TOP)//pvmi/recognizer/plugins/pvwavffrecognizer/Android.mk
include $(PV_TOP)//engines/common/Android.mk
include $(PV_TOP)//engines/adapters/player/framemetadatautility/Android.mk
include $(PV_TOP)//protocols/rtp_payload_parser/util/Android.mk
include $(PV_TOP)//android/Android.mk
include $(PV_TOP)//android/drm/oma1/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_rtsp/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_rtsp/node_registry/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_net_support/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_download/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_download/node_registry/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_mp4/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_mp4/node_registry/Android.mk
libopencoreplayer.so中包含了以下內容：
    * 一些解碼工具
    * 文件的解析器（mp4）
    * 解碼工具對應的Node
    * player的引擎部分（engines/player/Android.mk）
    * 爲Android的player適配器（android/Android.mk）
    * 識別工具（pvmi/recognizer）
    * 編解碼工具中的OpenMax部分(codecs_v2/omx)
    * 對應幾個插件Node的註冊
     libopencoreplayer.so中的內容較多，其中主要爲各個文件解析器和解碼器，PVPlayer的核心功能在engines/player /Android.mk當中，而android/Android.mk的內容比較特殊，它是在PVPlayer之上構建的一個爲Android使用的播放器。
4．libopencoreauthor.so庫的結構
     libopencoreauthor.so是用於媒體流記錄的功能庫，它的編譯控制的文件的路徑爲pvauthor/Android.mk，它包含了以下的內容：
include $(BUILD_SHARED_LIBRARY)
include $(PV_TOP)//engines/author/Android.mk
include $(PV_TOP)//codecs_v2/video/m4v_h263/enc/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_nb/enc/Android.mk
include $(PV_TOP)//codecs_v2/video/avc_h264/enc/Android.mk
include $(PV_TOP)//fileformats/mp4/composer/Android.mk
include $(PV_TOP)//nodes/pvamrencnode/Android.mk
include $(PV_TOP)//nodes/pvmp4ffcomposernode/Android.mk
include $(PV_TOP)//nodes/pvvideoencnode/Android.mk
include $(PV_TOP)//nodes/pvavcencnode/Android.mk
include $(PV_TOP)//nodes/pvmediainputnode/Android.mk
include $(PV_TOP)//android/author/Android.mk
libopencoreauthor.so中包含了以下內容：
    * 一些編碼工具（視頻流H263、H264，音頻流Amr）
    * 文件的組成器（mp4）
    * 編碼工具對應的Node
    * 表示媒體輸入的Node（nodes/pvmediainputnode/Android.m）
    * author的引擎部分（engines/author/Android.mk）
    * 爲Android的author適配器（android/author/Android.mk）
     libopencoreauthor.so中主要爲各個文件編碼器和文件組成器，PVAuthor的核心功能在engines/author /Android.mk當中，而android/author/Android.mk是在PVAuthor之上構建的一個爲Android使用的媒體記錄器。

5．其他庫
另外的幾個庫的Android.mk文件的路徑如下所示：
網絡支持庫libopencorenet_support.so：
tools_v2/build/modules/linux_net_support/core/Android.mk

MP4功能實現庫libopencoremp4.so和註冊庫libopencoremp4reg.so：
tools_v2/build/modules/linux_mp4/core/Android.mk
tools_v2/build/modules/linux_mp4/node_registry/Android.mk

RTSP功能實現庫libopencorertsp.so和註冊庫libopencorertspreg.so：
tools_v2/build/modules/linux_rtsp/core/Android.mk
tools_v2/build/modules/linux_rtsp/node_registry/Android.mk

下載功能實現庫libopencoredownload.so和註冊庫libopencoredownloadreg.so：
tools_v2/build/modules/linux_download/core/Android.mk
tools_v2/build/modules/linux_download/node_registry/Android.mk