阅读mediaplayer源代码(first)

第一次阅读mediaplayer源代码

 

2006-1-3

 

mediaplayer源代码是BREW SDK 3.1.4中自带的，一个简单的多媒体应用，2000多行代码，实现了一个支持音频、视频和图片播放，还支持录音的程序。该程序出自高通公司内部开发人员之手，其与高通BREW平台的其他底层应用的实现有异曲同工之妙。该程序的实现充分利用了贯穿于BREW平台的QInterface宏，用C语言巧妙地模仿了面向对象中的多态，继承等特点。感兴趣的朋友，可以在高通的网站上下载最新的SDK安装后，在BREW 3.1.4/sdk/examples/mediaplayer中可以找到对应的源代码。

由于是第一次阅读，很多东西理解还不深刻，叙述难免有偏差，希望大虾们人过留言，帮忙指出错误。

给出下载SDK的地址： https://brewx.qualcomm.com/brew/sdk/download.jsp

/
下面是一些结构体的展开，从阅读代码的角度来说，莫名其妙的宏定义给阅读带来了不少麻烦，但是对于程序开发人员来说，精致的宏定义又给开发带来不小的渐变性，从阅读的角度来说，把宏展开，可以清晰地看到程序设计的脉络，不过在开发的过程中，可以直接使用宏，减少代码的输入量，同时也能保证伴随BREW平台升级所带来的兼容性问题。

原定义
typedef struct _IWindow  IWindow;
QINTERFACE(IWindow)
{
   void     (*Enable)(IWindow * po, boolean bEnable);

   void     (*Redraw)(IWindow * po);

   boolean  (*HandleEvent)(IWindow * po, AEEEvent eCode, uint16 wParam, uint32 dwParam);

   void     (*Delete)(IWindow * po);
};

展开后实际定义
typedef struct _IWindow IWindow;

struct _IWindow
{ 
 struct IWindowVtbl *pvt;
};

typedef struct IWindowVtbl IWindowVtbl;
struct IWindowVtbl
{
    void     (*Enable)(IWindow * po, boolean bEnable);

   void     (*Redraw)(IWindow * po);

     boolean  (*HandleEvent)(IWindow * po, AEEEvent eCode, uint16 wParam, uint32 dwParam);

    void     (*Delete)(IWindow * po);
};

//注意，其实以下的两者是一样的。
#define VTBL(iname)   iname##Vtbl
#define AEEVTBL(iname)  iname##Vtbl

 

/
定义了枚举类型MPWindow（程序窗口类型）和MPPlayerWin（播放窗口类型：play,record,image）

/
关于内部几个关键结构体的创建。

#define INHERIT_CWindow(iname) /
   DECLARE_VTBL(iname) /
   CMediaPlayer * m_pOwner; /
   IShell *       m_pIShell; /
   IDisplay *     m_pIDisplay; /
   flg            m_bActive:1
从命名的角度来看，主要是用来继承父类，虽然是C不过仍然用C++的思想来设计。CWindow是一个基类，其他所有显示的window都是根据这个基类派生出来的。用INHERIT_CWindow这个宏来完成派生功能。

// Base class of all IWindow objects.
struct CWindow
{
   IWindow vtIWindow;
   CMediaPlayer * m_pOwner;
   IShell *       m_pIShell;
   IDisplay *     m_pIDisplay;
   flg            m_bActive:1;
};
对应创建函数CWindow_New

// Main window: Displays main menu.
struct CMainWin
{
   //从这个地方，我们就简单的认为，CMainWin是从CWindow派生出来的，它继承了CWindow的所有数据成员和IWindow的函数指针
   IWindow vtIWindow;
   CMediaPlayer * m_pOwner;
   IShell *       m_pIShell;
   IDisplay *     m_pIDisplay;
   flg            m_bActive:1;

 

   IImage *       m_pLogo;
   AEERect        m_rectLogo;
   IMenuCtl *     m_pMainMenu;

   flg            m_bAbout:1;  //?为什么会有两个flg，如何使两者不冲突
};

对应创建函数CMainWin_New

对应创建函数CMainWin_New

同样的道理适用于：CFileListWin（对应创建函数CFileListWin_New）、CPlayerWin（对应创建函数CPlayerWin_New）

CProgCtl这个结构体是表示进程条和标题。

子类的创建函数xxx_new()，会调用父类的创建函数CWindow_New，先创建CWindow，然后再实例化其自身的成员。
/
关于消息传递，大概是这样，消息产生，系统调用CMediaPlayer_HandleEvent来处理消息，对于一些可以被处理的消息：EVT_APP_START、EVT_APP_BROWSE_FILE、EVT_APP_STOP、EVT_APP_SUSPEND、EVT_APP_RESUME，函数会调用相关的函数相应消息，对于一些在本函数内无法被处理的消息：EVT_KEY、EVT_COMMAND、EVT_CREATEMEDIA、EVT_CREATEMEDIA_QCP、EVT_COPYRIGHT_END则会调用IWINDOW_HandleEvent来处理消息。

而IWINDOW_HandleEvent只是个宏，实际上它是：
GET_PVTBL(p, IWindow)->HandleEvent(p, e, w, dw)
实际上就是：
((IWindow *)p)->pvt->HandleEvent(p, e, w, dw)
对应的p指针所指向的地址的不同，消息会分发的不同的HandleEvent函数里头，作相应的处理，然后返回TRUE

/
HandleEvent函数指针的初始化，对于父类CWindow，其Vtbl的初始化是从CWindow_New函数的第三个参数传递进来的，对于CWindow他无法选择自己的Vtbl。而对于其子类和子类对应的XXX_New函数，首先它会申请一个 VTBL(IWindow)的vtbl，然后用MP_IWINDOW_SETVTBL宏给这个vtbl初始化，然后调用CWindow_New，把整个vtbl当成第三个参数传递进去，那么对应于不同的子类，虽然都调用的是IWindow->HandleEvent函数，不过却有了不同的行为，这就是对面向对象多态的精致模仿。