資料來源：mimi軟體與專案管理的世界Blog

最近都在研究如何才能在接收端用buffer控制多媒體串流，平台已經換了很多種從最早的sunplus spce3200換到google android到現在的wince

以下內容是轉載的，似乎對trace TCPMP source code的人很有幫助

TCPMP是一個功能強大開放式的開源多媒體播放器，播放器主要由核心框架模塊（common工程）和解碼器分離器插件組成。

TCPMP的插件非常多，、libmad我們聯合幾個最常用的插件（ffmpeg、splitter）來說明，其中interface插件實現TCPMP的界面，由於他和媒體播放沒有什麼關係，這部分可以完全被替換掉，替換成自己的界面。

ffmpeg工程是系統主要的音視頻解碼模塊，ffmpeg是一個集錄製、轉換、音/視頻編碼解碼功能為一體的完整的開源解決方案。FFmpeg的開發是基於Linux操作系統，但是可以在大多數操作系統中編譯和使用。

ffmpeg支持MPEG、DivX、MPEG4、AC3、DV、FLV等40多種編碼，AVI、MPEG、OGG、Matroska、ASF等90多種解碼。

很多開源播放器都用到了ffmpeg。但是ffmpeg程序解碼效率不是很高，系統僅僅使用了FFmpeg的部分解碼功能。
ffmpeg主目錄下主要有libavcodec、libavformat和libavutil等子目錄。其中libavcodec用於存放各個encode/decode模塊，libavformat用於存放muxer/demuxer模塊，libavutil用於存放內存操作等常用模塊。本系統的媒體文件分離器有單獨的splitter模塊完成所以不需要libavformat子目錄。ffmpeg目錄下libavcodec、libavutil保留子目錄。

libmad工程用於MP3文件解碼，該工程包含兩個功能模塊，一個負責解析MP3文件格式，包括MPEG1音頻文件 (MP1,MP2,MP3,MPA)，讀取每一幀音頻數據；另一個負責解碼MPEG1音頻數據，解碼代碼在libmad子目錄中。
libmad是一個開源的高精度 MPEG1音頻解碼庫，支持 MPEG-1（Layer I, Layer II 和 LayerIII，也就是MP3）。libmad提供 24-bit 的 PCM 輸出，完全是定點計算，非常適合沒有浮點支持的平台上使用。使用 libmad 提供的一系列API，就可以非常簡單地實現 MP3 數據解碼工作。在 libmad 的源代碼文件目錄下的 mad.h文件中，可以看到絕大部分該庫的數據結構和 API等。libmad是用的fixed-integer，通過整數模擬小數計算的，精度只能保證到小數點後第9位（大於0的最小值0.00000000372529），雖然解碼精度會有損失，但是極大提高瞭解碼效率，特別是在嵌入式設備上也可以實現高碼率MP3文件的解碼。

splitter工程用於解析多種音視頻文件格式。可以解析的文件格式包括：ASF媒體文件，視頻文件 (AVI,DIVX)，Windows波形文件(WAV,RMP)，MPEG電影文件 (MPEG,MPG,MPV)，MPEG4文件(MP4,3GP,M4A,M4B,K3G)。以上格式可以被解析但是數據編碼不一定能正確解碼，需要依賴系統的解碼器。

common工程是核心模塊，是一個開放的集數據輸入、轉換、音/視頻解碼、信號輸出等功能為一體的完整的多媒體播放框架。這個框架自身不包含任何的Decode和Split功能，這些功能由插件實現，核心模塊以一個樹狀結構管理所有的功能模塊和插件模塊，實現數據Render功能，對輸入、轉換、輸出流程的控制，接受播放過程中的操作和對事件進行處理，同時也實現系統運行中經常使用的一些共用函數，比如解碼過程中經常使用的逆離散餘弦變換，內存操作，界面中需要使用的多語言字符處理等。common工程的主目錄下主要有：blit、dyncode、overlay、pcm、softidct、win32、zlib等子目錄。其中blit和overlay存放是視頻信號渲染模塊，pcm存放PCM音頻信號轉換模塊，softidct存放逆離散餘弦變換函數，win32存放內存操作等常用模塊，dyncode這個目錄的代碼比較晦澀，存放的是程序運行是動態生成代碼模塊，針對不同的CPU指令集，PCM數據數據聲道和採樣率不同，視頻渲染數據格式和色深等不同情況動態生成不同的優化代碼（這段代碼非常精彩，不能不讓人佩服TCPMP作者的高超水平）。核心模塊有一個上下文對象context，該對象在初始化函數bool_tContext_Init(……)中候創建了一個該對象實例。該對象實例記錄管理各個功能模塊，用戶界面可以通過該對象和核心模塊交互，管理控制播放過程。
Context對象說明：
typedef struct context
{
int Version; //版本信息
uint32_t ProgramId;
const tchar_t* ProgramName;  //應用程序名稱
const tchar_t* ProgramVersion; //程序版本號，字符串
const tchar_t* CmdLine;   //程序命令行信息
void* Wnd;   //視頻渲染窗口句柄
void* NodeLock;  //功能模塊訪問臨界區互斥變量
array Node;   //功能模塊數據對象數組
array NodeClass;  //功能模塊定義對象數組，按照系統邏輯關係組織
array NodeClassPri; //功能模塊定義對象數組，按照系統邏輯關係和模塊優先級排列
array NodeModule;  //外部插件模塊數組
int LoadModuleNo;  //當前正在裝載的外部插件序號
void* LoadModule;
array StrTable[2];  //字符串資源數組，字符串分為
//給底層使用的標準字符串資源和
//給界面使用的顯示字符串資源，兩種資源用兩個數組表示
array StrBuffer;
array StrModule;  //未使用
void* StrLock;  //字符串數組訪問臨界區互斥變量
uint32_t Lang;   //當前使用語言標誌
int CodePage;   //當前使用代碼頁標誌
struct pcm_soft* PCM; //PCM音頻信號轉換模塊
struct blitpack* Blit; //視頻信號渲染模塊
struct node* Platform; //得到平台相關信息
struct node* Advanced; //得到播放模塊高級信息
struct node* Player;  //播放控制模塊
notify Error;   //信息錯誤回調函數
//屏幕旋轉信息，在某些系統中屏幕可以旋轉90度或180度
int (*HwOrientation)(void*);
void *HwOrientationContext;
bool_t TryDynamic;  //未使用
int SettingsPage;   //未使用
size_t StartUpMemory;  //可以使用的有效內存數
bool_t InHibernate;   //是否進入休眠狀態
bool_t WaitDisable;   //未使用
int FtrId;     //未使用
bool_t LowMemory;  //可以使用的有效內存數是否小於系統要求的最低要求
//動態代碼生成中間狀態及數據
bool_t CodeFailed;
bool_t CodeMoveBack;
bool_t CodeDelaySlot;
void* CodeLock;
void* CodeInstBegin;
void* CodeInstEnd;
int NextCond;
bool_t NextSet;
bool_t NextByte;
bool_t NextHalf;
bool_t NextSign;

uint32_t* FlushCache;  //未使用
void* CharConvertUTF8; //未使用
void* CharConvertCustom; //未使用
int CustomCodePage;  //未使用
void* CharConvertAscii; //未使用
void* Application;
void* Logger;    //未使用
bool_t KeepDisplay;  //是否保持背光長亮
int DisableOutOfMemory; //未使用

} context;
核心模塊上下文指針可以通過全局函數獲得context* Context();
初始化上下文對象的全局函數 是bool_t Context_Init(const tchar_t* Name,const tchar_t*Version,int Id,const tchar_t* CmdLine,void*Application);其中Name參數為應用程序名稱，Version為版本信息字符串。
釋放上下文對象的全局函數是void Context_Done();。
void Context_Wnd(void*);函數將視頻播放窗口句柄初始化給設備上下文。

功能模塊包含定義對象和數據對象，定義對象描述功能模塊相互間的邏輯結構，數據對象記錄模塊屬性和方法。
所有的功能模塊結構按一個樹狀結構來組織，結構關係如下，NODE是整個結構的根結點，其下為子節點，節點按類型可分為實節點，全局節點，設置節點，抽象節點。
#define CF_SIZE   0x00FFFFFF
#define CF_GLOBAL  0x01000000
#define CF_SETTINGS  0x02000000
#define CF_ABSTRACT  0x08000000
抽象節點沒有對應的對象實例，類似C++的抽象基類，為了按照邏輯關係組織系統結構而存在，例如NODE就是抽象節點。全局節點全局只有一個對象的實例，如播放控制模塊PLAYER_ID。設置節點表示和系統播放設置相關，比如聲音均衡器模塊EQUALIZER_ID，顏色控制模塊COLOR_ID。實節點與抽象節點不同，指可以生成對象實例的節點，實節點沒有特殊標識，一般以數據對象佔用內存大小表示是否是一個實節點，創建節點時要根據該信息分配內存單元，實節點也可以有子節點，例如：MMS_ID的父節點是HTTP_ID。全局節點，設置節點和實節點可以相互組合，比如播放控制節點同時是全局節點，設置節點和實節點。節點名稱後帶_ID的就是實節點，否則就是抽象節點。

NODE （根節點）
├─FLOW （流控制模塊）
│  ├─CODEC （解碼模塊）
│  │  ├─EQUALIZER_ID （聲音均衡器模塊）
│  │  ├─VBUFFER_ID （視頻緩衝模塊）
│  │  ├─DMO （DirectX Media Object）
│  │  │  ├─WMV_ID
│  │  │  ├─WMS_ID
│  │  │  ├─WMVA_ID
│  │  │  ├─WMA_ID
│  │  │  └─WMAV_ID
│  │  ├─FFMPEG VIDEO （FFMpeg 解碼模塊）
│  │  └─LIBMAD_ID （Libmad Mp3解碼模塊）
│  ├─OUT （信號渲染模塊）
│  │  ├─AOUT （音頻信號渲染）
│  │  │  ├─NULLAUDIO_ID
│  │  │  └─WAVEOUT_ID
│  │  └─VOUT （視頻信號渲染）
│  │      ├─NULLVIDEO_ID
│  │      └─OVERLAY
│  ├─IDCT （離散餘弦解碼模塊）
│  │  └─SOFTIDCT_ID
│  └─CODECIDCT（離散餘弦解碼模塊，函數比IDCT要少）
│      └─MPEG1_ID
├─MEDIA （媒體文件格式編碼解析模塊）
│  ├─FORMAT （格式解析模塊）
│  │  └─FORMATBASE
│  │      ├─RAWAUDIO
│  │      │  └─MP3_ID
│  │      ├─RAWIMAGE
│  │      ├─ASF_ID
│  │      ├─AVI_ID
│  │      ├─MP4_ID
│  │      ├─MPG_ID
│  │      ├─NSV_ID
│  │      └─WAV_ID
│  ├─PLAYLIST （播放列表模塊）
│  │  ├─ASX_ID
│  │  ├─M3U_ID
│  │  └─PLS_ID
│  └─STREAMPROCESS （數據流處理模塊）
├─STREAM （數據輸入模塊）
│  ├─MEMSTREAM_ID （內存數據流模塊）
│  ├─FILE_ID （文件IO模塊）
│  └─HTTP_ID （網絡數據獲取模塊）
├─TIMER （定時器模塊）
│  └─SYSTIMER_ID
├─ASSOCIATION_ID （文件擴展名自動關聯模塊）
├─ADVANCED_ID （高級設置模塊）
├─COLOR_ID （顏色控制模塊）
├─PLATFORM_ID （平台信息模塊）
├─XSCALEDRIVER_ID （Intel XScale CPU 信息模塊）
├─PLAYER_ID （播放控制模塊）
└─PLAYER_BUFFER_ID （播放緩衝模塊）

節點樹狀結構由若干個靜態定義對象(nodedef)實例實現，
typedef struct nodedef
{
int    Flags;
int    Class;
int    ParentClass;
int    Priority;
nodecreate  Create;
nodedelete  Delete;
} nodedef;
Flags表示當前節點的類型：抽象、實節點、全局、設置。
Class表示當前節點的標識，如MEDIA_CLASS或ASF_ID等等。
ParentClass表示當前節點的父節點標識，如SYSTIMER_ID對象的父節點是TIMER_CLASS。
Priority表示當前節點優先級。
Create和Delete是兩個函數指針，表示該節點的創建函數和銷毀函數。
如播放控制模塊的結構定義是
static const nodedef Player =
{
sizeof(player_base)|CF_GLOBAL|CF_SETTINGS,
PLAYER_ID,
NODE_CLASS,
PRI_MAXIMUM+600,
(nodecreate)Create,
(nodedelete)Delete,
};

絕大多數節點都有一個對應的數據對象，記錄該節點的數據和方法，每一個子節點對象都是以父節點對象作為該節點一個元素，類似C++的封裝繼承機制。如果子節點的父節點沒有數據對象，該節點可以從node節點直接繼承。每一個節點都可以看成Node節點的直接或間接子節點，所以所有節點頭以一個相同的node結構開頭，子節點可能還有自己的屬性，在繼承父對象後就是子節點自己的元素。
typedef struct node
{
int   Class;
nodeenum Enum;
nodeget  Get;
nodeset  Set;
} node;
Class表示該對象的標識，如PLAYER_ID。
Enum是一個函數指針，指向一個函數用於枚舉當前節點的屬性。
Get是一個函數指針，得到當前節點某一屬性值。
Set是一個函數指針，設置當前節點的某一屬性數值。

節點的屬性值數據特性在一個static const datatable xxxParams[] = {……};的靜態數組裡定義。
typedef struct datatable
{
int No;
int Type;
int Flags;
int Format1;
int Format2;
} datatable;

No表示屬性的標識，如播放控制模塊的#define PLAYER_PLAY 0x32 就表示控制播放器播放或暫停。
Type表示屬性的數據類型，可用值在node.h中定義。
Flags是屬性數據的標誌，表示該數據是不是只讀數據，是否有最大最小值等等，可用值在node.h中定義，如果該標誌包含DF_SETUP同時不包含DF_NOSAVE和DF_RDONLY屬性，該屬性會被記錄在註冊表中，下次啟動時用註冊表的數據初始化該屬性。
Format1和Format2是可選標誌與Flags配合使用，比如如果Flags表示該屬性存在最大最小值，Format1和Format2可以分別表示最小和最大數值。

在在系統上下文對象中有兩個元素記錄節點信息array Node;和array NodeClass;，array是數組數據類型，Node是節點數據對象的數組，NodeClass節點對象的數組，按照系統邏輯關係組織。
創建節點時傳入nodedef對象到節點創建函數，函數會根據nodedef信息生成對應nodeclass對象添加到NodeClass數組，同時根據nodedef信息分配數據對象的內存空間。在該節點的Create函數裡面再初始化該節點的數據對象。

在所有功能模塊中和界面加交互的主要就是播放控制模塊struct node* Player;使用方法如下：
context* p = Context();
player* myplayer = NULL;
if(p) myplayer = (player*)(p->Player);
控制播放參數使用Set(void* This,int No,const void* Data,intSize);函數，第一個參數是播放模塊指針，第二個參數是控制代碼，即要進行什麼操作，第三個參數是需要賦值給控制代碼的數值，最後一個參數是所賦數值的佔用內存的大小。
例如開始播放的代碼是：
myplayer->Set(myplayer,PLAYER_PLAY,1,sizeof(int));
PLAYER_PLAY為控制代碼，表示當前控制的是播放暫停功能，數值為1表示播放為0表示暫停。
得到某一控制屬性使用Get(void* This,int No,void* Data,int Size);函數，參數含義和Set函數相同。
控制代碼是一組宏，定義在player.h文件中。比較重要的控制參數有
// play or pause (bool_t)
#define PLAYER_PLAY   0x32
// position in fraction (fraction)
#define PLAYER_PERCENT  0x25
// position in time (tick_t)
#define PLAYER_POSITION  0x28
// current format (format*)
#define PLAYER_FORMAT  0x2B
// current file in playlist (int)
#define PLAYER_LIST_CURRENT 0x2F
// current file index (suffled) in playlist (int)
#define PLAYER_LIST_CURRIDX 0xA2
// fullscreen mode (bool_t)
#define PLAYER_FULLSCREEN 0x3E
// stop
#define PLAYER_STOP   0xB2
// skin viewport rectangle (rect)
#define PLAYER_SKIN_VIEWPORT 0x3C
播放控制模塊所有可用參數見static const datatable PlayerParams[]結構。

添加一個媒體文件到播放模塊使用int PlayerAdd(player* Player,int Index, const tchar_t* Path, const tchar_t* Title);
第一個參數為播放模塊指針，第二個參數是添加到播放模塊文件隊列的序號，如果是使文件成為第一個文件該參數設為0，第三個參數是媒體文件的目錄和名稱，第四個參數為媒體文件標題，該參數可以忽略。

核心模塊也管理多語言字符串，使用函數const tchar_t* LangStr(int Class, int Id);和consttchar_t* LangStrDef(int Class, intId)可以得到對應字符串，系統字符串資源有兩種，標準字符串和特殊字符集字符串。標準字符串資源文件是工程目錄下的lang_std.txt文件，該文件字符串為ASCII字符，可與其他代碼頁字符兼容。該文件記錄的是核心模塊運行時需要使用的字符串，Decode和Splite模塊可以處理的編碼格式和文件格式也在這個文件中記錄，例如lang_std.txt文件中的
MP3_0001=audio/mpeg
MP3_0002=mp1:A;mp2:A;mp3:A;mpa:A
MP3_0200=acodec/0x0055
紀錄了MP3文件分離器對應的文件類型、擴展名和文件特徵碼。
要得到標準字符串使用函數LangStrDef，第一個參數表示字符類別，第二個參數表示字符ID。界面相關的是特殊字符集的字符串，使用函數LangStr，第一個參數表示字符類別，第二個參數表示字符ID。關於字符串資源文件結構含義將在以後的文檔中說明。