明辉站/网站教程/内容

使用ATL完成QuickTime多媒体文件播放

网站教程2024-02-06 阅读
[摘要]摘要 本文主要介绍了Windows平台上Visual C++ 6利用ATL库和QuickTime SDK开发播放QuickTime多媒体软件。为从事多媒体播放开发工作者提供借鉴和参考。关键词 多媒体 播放 QuickTime ATL 1 前言在当今多媒体播放软件主要有Windows media...
摘要  本文主要介绍了Windows平台上Visual C++ 6利用ATL库和QuickTime SDK开发播放QuickTime多媒体软件。为从事多媒体播放开发工作者提供借鉴和参考。

关键词  多媒体 播放 QuickTime ATL



1 前言

在当今多媒体播放软件主要有Windows media player、Real player和QuickTime。 Apple公司的QuickTime于1991年登台亮相,是Apple公司面向专业视频编辑、Web网站创建和CD-ROM内容制作领域开发的多媒体技术平台,QuickTime支持几乎所有主流的个人计算机平台,是数字媒体领域事实上的工业标准,是创建3D动画、实时效果、虚拟现实、A/V和其他数字流媒体的重要基础。

由于众多企业有对QuickTime player应用的需求,在国内外相关资料中有用Windows SDK或MFC的相关应用,本文试用小巧的ATL库和QuickTime SDK开发定制QuickTime 多媒体播放软件做了分析。



2 QuickTime Windows程序的开发概述

2.1开发前的准备

登陆Apple官方网站下载QuickTime SDK和了解有关技术资料。

由于QuickTime原先是为Mac OS设计,所以它里面的许多概念和函数的调用都是面向Mac。

表1 Windows and QTML 术语比较

Windows 术语
QTML 对应术语

Message ( MSG )
Event ( EventRecord )

Graphics Device Interface (GDI)
QuickDraw

Device context ( DC )
Graphics port ( CGrafPort )

Window handle ( HWND )
Window pointer ( CWindowPtr )

Common Dialog Box Library
Standard File Package


对于一个原来是Windows程序员必须对于一些QuickTime概念有些最基本的了解才能比较快的掌握典型QuickTime Windows程序的开发。

2.2开发基本步骤

开发一个简单的QuickTime Windows程序必须采取下面基本步骤加入到Windows应用中。

2.2.1在程序的开头初始化QuickTime媒体层(InitializQTML)和QuickTime(EnterMovies)。

2.2.2和电影窗口建立图形端口的关联(CreatePortAssociation)。

2.2.3打开电影(OpenMovieFile)和得到电影的句柄(NewMovieFromFile)。

2.2.4创建在屏幕上显示电影图像的控件(NewMovieController)。

2.2.5在Windows处理函数中,将接收的Windows消息转换为QTML事件(WinEventToMacEvent)并将它们传到电影控件处理(MCIsPlayerEvent)。

2.2.6如果不在用到,释放电影句柄(DisposeMovie)和电影控件(DisPoseMovieController)。

2.2.7当销毁窗口时,破坏电影图形端口的关联(DestroyPortAssociation)。



3 在ATL上实现播放

3.1用ATL创建Windows窗口

     以CWindowImpl为基类,编写自己的窗口类CQTVideoWnd。并且定义宏来接收窗口消息。

#define MY_QT_MSG_HANDLE(func)   \

     {    \

         BOOL bHandled = TRUE;     \

          lResult; \

          func(uMsg,wParam,lParam,bHandled);  \

         if(bHandled)     \

             return TRUE;     \

     }



class CQTVideoWnd:

     public CWindowImpl<CVideoPlayerQT>

{

  public:

    CQTVideoWnd(HWND hParent, RECT& rc, IVideoPlayerNotifySink* pVPSink);

    virtual ~ CQTVideoWnd();



  public:

  BEGIN_MSG_MAP(CVideoPlayerQT)

    MY_QT_MSG_HANDLE (NewProc)

  END_MSG_MAP()



protected:

    LRESULT NewProc(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled);

  ……

  CQuickTime             m_QT;

……

}



CQuickTime为笔者调用QuickTime API的辅助类,后面将介绍。

NewProc成员函数根据接收不同的窗口消息分别调用不同的成员函数处理。

LRESULT CQTVideoWnd::NewProc(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled)

{

     if(uMsg == WM_ERASEBKGND)

     {

       bHandled = FALSE;

       LRESULT theResult = DefWindowProc(uMsg, wParam, lParam);

       m_QT.ProcessMovieEvent (m_hWnd, uMsg, wParam, lParam);

       return theResult;

     }

     else

     {

       m_QT.ProcessMovieEvent (m_hWnd, uMsg, wParam, lParam);

       switch(uMsg)

         {

           case WM_CREATE:

             OnCreate(uMsg, wParam, lParam,bHandled);

                break;

           case WM_PAINT:

             OnPaint(uMsg, wParam, lParam,bHandled);

                break;

           case WM_DESTROY:

             OnDestroy(uMsg, wParam, lParam,bHandled);

                break;

           default:

             bHandled = FALSE;

                break;

         }

     }

     return 0;

     

}

其中OnCreate、OnPaint、OnDestroy等成员函数将根据2.2,分别调用辅助类CQuickTime处理。如

LRESULT CQTVideoWnd::OnCreate(UINT uMsg, WPARAM wParam , LPARAM lParam, BOOL& bHandled)

{

     m_QT.OnMovieWindowCreate(m_hWnd,NULL);

     return 0;

}



3.2 CQuickTime

     CQuickTime为调用QuickTime API函数的辅助类。

3.2.1初始化和退出应用

InitializeQT和Terminate分别为初始化QuickTime媒体层和退出QuickTime媒体层。它们可以在程序的开始和结束。我们在CQTVideoWnd的构造函数和析构函数中调用它们。

     BOOL CQuickTime::InitializeQT(IQTEventSink* pQTEventSink /*= NULL*/)

{

……

     OSErr Err = noErr;        

     // Initialize QuickTime Media Layer

     Err = InitializeQTML(0);

     // Initialize QuickTime

     if(Err == noErr)

     {

         Err = EnterMovies();

     }

     else

     {

         Err = QT_NOPLAYER;

     }



     if(Err == noErr)

     {

//Because we can not distinguish the error from which object

//So we marked SetMoviesErrorProc

//        SetMoviesErrorProc(MoviesErrorProc,(long)this);

     }

         

     else

         Err = QT_INITIAL_ERR;

……

     return Err == noErr ? TRUE : FALSE;

}

如果要得到QuickTime的错误代码,我们可以在初始化完后调用SetMoviesErrorProc函数,但是假如一个应用中有多个QuickTime的电影对象。我们将不能区分错误来自哪个对象。



void CQuickTime::Terminate()

{

     // Clean up

     ExitMovies();

     TerminateQTML();

     DebugInfo("CQuickTime::Terminate this = %p,m_pQTEventSink = %p",this,m_pQTEventSink);

}



3.2.2得到电影的句柄

如果是本地文件调用OpenLocalMovie,得到句柄后保存在成员变量里m_Movie。该函数打开电影后创建Movie Controller。Apple公司推荐一般用Movie Controller来播放电影。

BOOL CQuickTime::OpenLocalMovie(LPCSTR fullPath)

{

     _ASSERTE(fullPath && m_hViewWnd);

     if(!fullPath !m_hViewWnd)

         return FALSE;



     VIDEO_STATUE oldState = m_enState;

     

     if ( strlen ((char*)fullPath ) != 0)

     {

         OSErr                   err;

         short                   nTheFile = 0;

         long               lControllerFlags = 0L;

         FSSpec                   sfFile;

         short                   nMovieResFile;

         short                   nMovieResId;

         char               theFullPath[255];



         // Close any previously opened movie

          CloseMovie();

     

         // make a copy of our full path name

         strcpy ( (char *)theFullPath, (const char *) fullPath );        

     

         // convert theFullPath to pstring

          c2pstr( (char*)theFullPath );



         // Make a FSSpec with a pascal string filename

          FSMakeFSSpec(0,0L,(unsigned char*)theFullPath, &sfFile);

         

         // Set the port

          SetGWorld((CGrafPtr)GetHWNDPort(m_hViewWnd), nil);



         // Open the movie file

         err = OpenMovieFile(&sfFile, &nMovieResFile, fsRdPerm);

         if (err == noErr)

         {

              // Get the Movie from the file

              nMovieResId = 0;

              err = NewMovieFromFile(&m_Movie,nMovieResFile,

                                          &nMovieResId,

                                          nil,

                                          newMovieActive, /* flags */

                                          nil);

         

              // Close the movie file

              CloseMovieFile(nMovieResFile);           



              if (err == noErr)

              {

                   SetMovieTimeScale(m_Movie,1000);

                   

                   m_bBegineDownload = TRUE;



                   // Create the movie controller

                      CreateNewMovieController(m_hViewWnd,m_Movie,&m_MC);

                   p2cstr((unsigned char*)theFullPath);



                   if(m_MC)

                   {

                       return TRUE;

                   }

                   

              }                   

         }

     }



     CloseMovie();

         

     return FALSE;

}



如果是URL文件,调用OpenURLMovie,该函数跟OpenLocalMovie区别主要在于不用NewMovieFromFile而用NewMovieFromDataRef来得到句柄。



     一般电影在创建完Movie Controller后最好调用PrePrerollMovie。

void CQuickTime::CreateNewMovieController(HWND hwnd, Movie theMovie, MovieController *theMC)

{

     ……

PrePrerollMovie(theMovie, GetMovieTime(theMovie, NULL), GetMoviePreferredRate(theMovie), NewMoviePrePrerollCompleteProc(QTPrePrerollCompleteProc), (void *)m_hViewWnd);

}



3.2.3关闭电影

     void CQuickTime::CloseMovie(void)

{

    if (m_MC)

    {

        DisposeMovieController(m_MC);

    }

         if (m_Movie)

          {

              DisposeMovie(m_Movie);

          }

          m_Movie = NULL;

          m_MC = NULL;

}



3.2.4建立和取消电影窗口关联

int CQuickTime::OnMovieWindowCreate(HWND hWnd, CREATESTRUCT *lpCreateStruct)

{



     if ( hWnd != NULL)

     {

          m_hViewWnd = hWnd;                     // the view's hwnd

         

         // Create GrafPort <-> HWND association

          CreatePortAssociation(m_hViewWnd, NULL, kQTMLHandlePortEvents);  

     }



     return 0;

}

void CQuickTime::OnMovieWindowDestroy()

{

     if(m_Movie)

          AbortPrePrerollMovie(m_Movie,noErr);

     



     CGrafPtr     windowPort = NULL;

     

     // close any movies   before destroying PortAssocation

     CloseMovie();



     // Destroy the view's GrafPort <-> HWND association

     if (m_hViewWnd)

          windowPort = (CGrafPtr)GetHWNDPort(m_hViewWnd);

     

     if (windowPort)

          DestroyPortAssociation(windowPort);



}



3.2.5控制电影播放

笔者用控制MCDoAction来控制播放,这样可以得到播放的状态,当然也可以调用StartMovie、StopMovie等api函数。例如,

void CQuickTime::Play()

{

if(m_Movie)

{

     MCDoAction (m_MC, mcActionPlay, (void *)GetMoviePreferredRate(m_Movie));

     long     controllerFlags;

     MCGetControllerInfo(m_MC,&controllerFlags);

     if((controllerFlags&mcInfoIsPlaying))             

          //Now this is playing state.

}

}



4 综述

  通过上面较为详细的讨论对于建立一个QuickTime的窗口,打开和控制QuickTime电影文件的播放的基本概念和基本过程,我认为QuickTime Player在Windows的平台的应用将更为宽广。同时为Apple公司在多媒体播放上的努力而致敬。

……

相关阅读