OpenCore的代码结构
以开源Android 的代码为例,Open Core 的代码在Android 代码的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 等协议的相关内容。
pvcommon:pvcommon 库文件的Android.mk 文件,没有源文件。
pvplayer:pvplayer 库文件的Android.mk 文件,没有源文件。
pvauthor:pvauthor 库文件的Android.mk 文件,没有源文件。
tools_v2:编译工具以及一些可注册的模块。
在external/opencore/目录中还有2 个文件,如下所示:
Android.mk:全局的编译文件
pvplayer.conf:配置文件
在external/opencore/的各个子文件夹中包含了众多的Android.mk 文件,它们之间还存在
着“递归”的关系。例如根目录下的Android.mk,就包含了如下的内容片断:
include $(PV_TOP)/pvcommon/Android.mk
include $(PV_TOP)/pvplayer/Android.mk
include $(PV_TOP)/pvauthor/Android.mk
这表示了要引用pvcommon,pvplayer 和pvauthor等文件夹下面的Android.mk 文件。
external/opencore/的各个Android.mk 文件可以按照排列组合进行使用,将几个Android.mk
内容合并在一个库当中。
OpenCore 的编译结构
1、库的层次关系:在Android 的开源版本中编译出来的内容,OpenCore 编译出来的各个库如
下所示:
libopencoreauthor.so:OpenCore 的Author 库
libopencorecommon.so:OpenCore 底层的公共库
libopencoredownloadreg.so:下载注册库
libopencoredownload.so:下载功能实现库
libopencoremp4reg.so:MP4 注册库
libopencoremp4.so:MP4 功能实现库
libopencorenet_support.so:网络支持库
libopencoreplayer.so:OpenCore 的Player 库
libopencorertspreg.so:RTSP 注册库
libopencorertsp.so:RTSP 功能实现库
这些库的层次关系如下图所示:
OpenCore 的各个库之间具有如下的关系:
1)libopencorecommon.so 是所有的库的依赖库,提供了公共的功能;
2)libopencoreplayer.so 和libopencoreauthor.so是两个并立的库,分别用于回放和
记录,而且这两个库是OpenCore 对外的接口库;
3)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 库中包含了以下内容:
1)OSCL 的所有内容
2)Pvmf 框架部分的内容(pvmi/pvmf/Android.mk)
3)基础库中的一些内容(baselibs)
4)编解码的一些内容
5)文件输出的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 中包含了以下内容:
1)一些解码工具
2)文件的解析器(mp4)
3)解码工具对应的Node
4)player 的引擎部分(engines/player/Android.mk)
5)为Android 的player 适配器(android/Android.mk)
6)识别工具(pvmi/recognizer)
7)编解码工具中的OpenMax 部分(codecs_v2/omx)
8)对应几个插件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 中包含了以下内容:
1)一些编码工具(视频流H263、H264,音频流Amr)
2)文件的组成器(mp4)
3)编码工具对应的Node
4)表示媒体输入的Node(nodes/pvmediainputnode/Android.m)
5)author 的引擎部分(engines/author/Android.mk)
6)为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