PVPlayer

5.1 Player的组成

    OpenCore的Player的编译文件是pvplayer/Android.mk&＃xff0c;将生成动态库文件libopencoreplayer.so。这个库包含了两方面的内容&＃xff1a;一方是Player的engine&＃xff08;引擎&＃xff09;&＃xff0c;一方面是为 Android构件的Player&＃xff0c;这实际上是一个适配器&＃xff08;adapter&＃xff09;。engine的路径是engine/player&＃xff1b;adapter的路径是 android。

5.2 Player Engine部分

       OpenCore的Player Engine具有清晰明确的接口。在这个接口之上&＃xff0c;不同的系统可一个根据自己的情况实现不同Player。目录engines中的文件结构如下所示&＃xff1a;
engines/player/
|-- Android.mk
|-- build
|   |-- linux_nj
|   |-- make
|   &＃96;-- makefile.conf
|-- config
|   &＃96;-- linux_nj
|-- include
|   |-- pv_player_datasink.h
|   |-- pv_player_datasinkfilename.h
|   |-- pv_player_datasinkpvmfnode.h
|   |-- pv_player_datasource.h
|   |-- pv_player_datasourcepvmfnode.h
|   |-- pv_player_datasourceurl.h
|   |-- pv_player_events.h
|   |-- pv_player_factory.h
|   |-- pv_player_interface.h
|   |-- pv_player_license_acquisition_interface.h
|   |-- pv_player_registry_interface.h
|   |-- pv_player_track_selection_interface.h
|   &＃96;-- pv_player_types.h
|-- sample_app
|   |-- Android.mk
|   |-- build
|   |-- sample_player_app_release.txt
|   &＃96;-- src
|-- src
|   |-- pv_player_datapath.cpp
|   |-- pv_player_datapath.h
|   |-- pv_player_engine.cpp
|   |-- pv_player_engine.h
|   |-- pv_player_factory.cpp
|   |-- pv_player_node_registry.h
|   &＃96;-- pv_player_sdkinfo.h
&＃96;-- test
    |-- Android.mk
    |-- build
    |-- config
    &＃96;-- src
其中&＃xff0c;engines/player/include目录中是接口头文件&＃xff0c;engines/player/src目录源文件和私有头文件&＃xff0c;主要头文件的功能如下所示&＃xff1a;
pv_player_types.h&＃xff1a;定义一些数据结构和枚举值
pv_player_events.h&＃xff1a;定义UUID和一些错误值。
pv_player_datasink.h&＃xff1a;datasink是媒体数据的输出&＃xff0c;定义类PVPlayerDataSink&＃xff0c;这是媒体数据输出的基类&＃xff0c;作为接口使用
pv_player_datasinkfilename.h&＃xff1a;定义类PVPlayerDataSinkFilename继承PVPlayerDataSink。
pv_player_datasinkpvmfnode.h&＃xff1a;定义类PVPlayerDataSinkPVMFNode继承PVPlayerDataSink。
pv_player_datasource.h&＃xff1a;datasource是媒体数据的输入&＃xff0c;定义类PVPlayerDataSource&＃xff0c;这是媒体数据输入的基类&＃xff0c;作为接口使用。
pv_player_datasourcepvmfnode.h&＃xff1a;定义类PVPlayerDataSourcePVMFNode继承PVPlayerDataSource。
pv_player_datasourceurl.h&＃xff1a;定义类PVPlayerDataSourceURL继承PVPlayerDataSource。
pv_player_interface.h&＃xff1a;定义Player的接口PVPlayerInterface&＃xff0c;这是一个接口类。
pv_player_factory.h&＃xff1a;主要定义工厂类PVPlayerFactory&＃xff0c;用于创建和销毁PVPlayerInterface。
事实上&＃xff0c;在engines/player/src目录中&＃xff0c;主要实现类为pv_player_engine.cpp&＃xff0c;其中定义了类PVPlayerEngine&＃xff0c;PVPlayerEngine继承了PVPlayerInterface&＃xff0c;这是一个实现类&＃xff0c;在PVPlayerFactory创建PVPlayerInterface接口的时候&＃xff0c;实际创建的是PVPlayerEngine。

在Player Engine的实现中&＃xff0c;包含了编解码和流控制等功能&＃xff0c;而输出的介质需要从外部设置近来。PVPlayerInterface定义的接口基本是按照操作顺序的&＃xff0c;主要的接口如下所示:
在Player Engine的实现中&＃xff0c;包含了编解码和流控制等功能&＃xff0c;而输出的介质需要从外部设置近来。PVPlayerInterface定义的接口基本是按照操作顺序的&＃xff0c;主要的接口如下所示:
PVCommandId AddDataSource(PVPlayerDataSource& aDataSource, const OsclAny* aContextData &＃61; NULL);
PVCommandId Init(const OsclAny* aContextData &＃61; NULL);
PVCommandId AddDataSink(PVPlayerDataSink& aDataSink, const OsclAny* aContextData &＃61; NULL);
PVCommandId Prepare(const OsclAny* aContextData &＃61; NULL);
PVCommandId Start(const OsclAny* aContextData &＃61; NULL);
PVCommandId Pause(const OsclAny* aContextData &＃61; NULL);
PVCommandId Resume(const OsclAny* aContextData &＃61; NULL);
PVCommandId Stop(const OsclAny* aContextData &＃61; NULL);
PVCommandId RemoveDataSink(PVPlayerDataSink& aDataSink, const OsclAny* aContextData &＃61; NULL);
PVCommandId Reset(const OsclAny* aContextData &＃61; NULL);
PVCommandId RemoveDataSource(PVPlayerDataSource& aDataSource, const OsclAny* aContextData &＃61; NULL);
这里面的DataSink可能包含Video的输出和Audio的输出两者部分。在pv_player_types.h文件中&＃xff0c;定义了Player的状态机&＃xff0c;以PVP_STATE_为开头&＃xff0c;如下所示&＃xff1a;
typedef enum
{
    PVP_STATE_IDLE        &＃61; 1,
    PVP_STATE_INITIALIZED &＃61; 2,
    PVP_STATE_PREPARED    &＃61; 3,
    PVP_STATE_STARTED     &＃61; 4,
    PVP_STATE_PAUSED      &＃61; 5,
    PVP_STATE_ERROR       &＃61; 6
} PVPlayerState;
   PVPlayerInterface中的各个操作如果成功&＃xff0c;可以更改Player的状态机&＃xff1a;初始化的时候Player是PVP_STATE_IDLE状态&＃xff0c;调用Init后&＃xff0c;进入PVP_STATE_INITIALIZED状态&＃xff1b;调用AddDataSink&＃xff0c;进入PVP_STATE_PREPARED状态&＃xff1b;调用Prepare后&＃xff0c;进入PVP_STATE_PREPARED状态&＃xff1b;调用start后进入PVP_STATE_STARTED状态&＃xff0c;之后可以调用 pause进入PVP_STATE_PAUSED状态。
   PVP_STATE_STARTED和PVP_STATE_PAUSED状态是播放情况下的状态&＃xff0c;可以使用start和pause函数在这两个状态中切换。
在播放过程中&＃xff0c;调用stop可以返回PVP_STATE_INITIALIZED状态&＃xff0c;在调用RemoveDataSource返回PVP_STATE_IDLE状态。
5.3 Android Player Adapter
在android目录中定义为Player的适配器&＃xff0c;这个目录主要包含的文件如下所示&＃xff1a;
android
|-- Android.mk
|-- android_audio_mio.cpp
|-- android_audio_mio.h
|-- android_audio_output.cpp
|-- android_audio_output.h
|-- android_audio_output_threadsafe_callbacks.cpp
|-- android_audio_output_threadsafe_callbacks.h
|-- android_audio_stream.cpp
|-- android_audio_stream.h
|-- android_log_appender.h
|-- android_surface_output.cpp
|-- android_surface_output.h
|-- mediascanner.cpp
|-- metadatadriver.cpp
|-- metadatadriver.h
|-- playerdriver.cpp
|-- playerdriver.h
&＃96;-- thread_init.cpp
这个Android的Player的“适配器”需要调用OpenCore的Player Engine的接口&＃xff0c;实现Android的媒体播放器的服务所需要接口&＃xff0c;即最终实现一个PVPlayer&＃xff0c;而PVPlayer实际上是继承了 MediaPlayerInterface。
在实现过程中&＃xff0c;首先实现了一个PlayerDriver&＃xff0c;然后再使用PVPlayer&＃xff0c;PVPlayer通过调用PlayerDriver来完成具体的功能。整个实现的结构图如图所示&＃xff1a;
对PVPlayerDriver的各种操作使用各种命令来完成&＃xff0c;这些命令在playerdriver.h中进行的定义。
enum player_command_type {
    PLAYER_QUIT                     &＃61; 1,
    PLAYER_SETUP                    &＃61; 2,
    PLAYER_SET_DATA_SOURCE          &＃61; 3,
    PLAYER_SET_VIDEO_SURFACE        &＃61; 4,
    PLAYER_SET_AUDIO_SINK           &＃61; 5,
    PLAYER_INIT                     &＃61; 6,
    PLAYER_PREPARE                  &＃61; 7,
    PLAYER_START                    &＃61; 8,
    PLAYER_STOP                     &＃61; 9,
    PLAYER_PAUSE                    &＃61; 10,
    PLAYER_RESET                    &＃61; 11,
    PLAYER_SET_LOOP                 &＃61; 12,
    PLAYER_SEEK                     &＃61; 13,
    PLAYER_GET_POSITION             &＃61; 14,
    PLAYER_GET_DURATION             &＃61; 15,
    PLAYER_GET_STATUS               &＃61; 16,
    PLAYER_REMOVE_DATA_SOURCE       &＃61; 17,
    PLAYER_CANCEL_ALL_COMMANDS      &＃61; 18,
};
这些命令一般实现的是PVPlayerInterface各个接口的简单封装&＃xff0c;例如对于较为简单的暂停播放这个操作&＃xff0c;整个系统执行的过程如下所示&＃xff1a;
1&＃xff0e;在PVPlayer中的pause函数&＃xff08;在playerdriver.cpp文件中&＃xff09;
status_t PVPlayer::pause()
{
    LOGV("pause");
    return mPlayerDriver->enqueueCommand(new PlayerPause(0,0));
}
这时调用其成员mPlayerDriver&＃xff08;PlayerDriver类型&＃xff09;的函数&＃xff0c;将一个PlayerPause命令加入了命令序列&＃xff0c;具体的各种命令功能在playerdriver.h文件中。
2&＃xff0e;PlayerDriver类的enqueueCommand将间接调用各个以handle为开头的函数&＃xff0c;对于PlayerPause命令&＃xff0c;调用的函数是handlePause
void PlayerDriver::handlePause(PlayerPause* ec)
{
    LOGV("call pause");
    mPlayer->Pause(0);
    FinishSyncCommand(ec);
}
这里的mPlayer是一个PVPlayerInterface类型的指针&＃xff0c;使用这个指针调用到了OpenCore的 Player Engine中的PVPlayerEngine类。
在这个播放器适配器的实现中&＃xff0c;一个主要的工作是将Android框架中定义的媒体的输出&＃xff08;包括Audio的输出和Video的输出&＃xff09;转换成&＃xff0c;OpenCore的 Player Engine需要的形式。在这里两个重要的类是android_surface_output.cpp实现的 AndroidSurfaceOutput&＃xff0c;android_audio_output.cpp实现的AndroidAudioOutput。
对于Video输出的设置过程&＃xff0c;在类PlayerDriver中定义了3个成员&＃xff1a;
    PVPlayerDataSink        *mVideoSink;
    PVMFNodeInterface       *mVideoNode;
    PvmiMIOControl          *mVideoOutputMIO;
这里的mVideoSink 的类型为PVPlayerDataSink&＃xff0c;这是Player Engine中定义的类接口&＃xff0c;mVideoNode的类型为VMFNodeInterface&＃xff0c;在pvmi/pvmf/include的 pvmf_node_interface.h中定义&＃xff0c;这是所有的PVMF的NODE都需要继承的统一接口&＃xff0c;mVideoOutputMIO的类型为 PvmiMIOControl也在pvmi/pvmf/include中定义&＃xff0c;这是媒图输出控制的接口类。
1&＃xff0e;在PVPlayer的setVideoSurface用以设置一个Video输出的界面&＃xff0c;这里使用的参数的类型是ISurface指针&＃xff1a;
status_t PVPlayer::setVideoSurface(const sp& surface)
{
    LOGV("setVideoSurface(%p)", surface.get());
    mSurface &＃61; surface;
    return OK;
}
     setVideoSurface函数设置的是PVPlayer中的一个成员mSurface&＃xff0c;真正设置Video输出的界面的功能在run_set_video_surface()函数中实现&＃xff1a;
void PVPlayer::run_set_video_surface(status_t s, void *COOKIE)
{
    LOGV("run_set_video_surface s&＃61;%d", s);
    if (s &＃61;&＃61; NO_ERROR) {
PVPlayer *p &＃61; (PVPlayer*)COOKIE;
        if (p->mSurface &＃61;&＃61; NULL) {
            run_set_audio_output(s, COOKIE);
        } else {
            p->mPlayerDriver->enqueueCommand(new PlayerSetVideoSurface(p->mSurface, run_set_audio_output, COOKIE));
        }
    }
}
这时使用的命令是PlayerSetVideoSurface&＃xff0c;最终将调用到PlayerDriver中的handleSetVideoSurface函数。
2&＃xff0e;handleSetVideoSurface函数的实现如下所示&＃xff1a;
void PlayerDriver::handleSetVideoSurface(PlayerSetVideoSurface* ec)
{
    int error &＃61; 0;
    mVideoOutputMIO &＃61; new AndroidSurfaceOutput(ec->surface());
    mVideoNode &＃61; PVMediaOutputNodeFactory::CreateMediaOutputNode(mVideoOutputMIO);
    mVideoSink &＃61; new PVPlayerDataSinkPVMFNode;
    ((PVPlayerDataSinkPVMFNode *)mVideoSink)->SetDataSinkNode(mVideoNode);
    ((PVPlayerDataSinkPVMFNode *)mVideoSink)->SetDataSinkFormatType(PVMF_YUV420);
    OSCL_TRY(error, mPlayer->AddDataSink(*mVideoSink, ec));
    OSCL_FIRST_CATCH_ANY(error, commandFailed(ec));
}
在这里首先建立的创建成员mVideoOutputMIO&＃xff08;类型为PvmiMIOControl&＃xff09;&＃xff0c;这时建立的类是类 AndroidSurfaceOutput&＃xff0c;这个类继承了PvmiMIOControl&＃xff0c;所以可以作为PvmiMIOControl使用。然后调用 PVMediaOutputNodeFactory::CreateMediaOutputNode建立了PVMFNodeInterface 类型的mVideoNode。随后创建PVPlayerDataSinkPVMFNode类型的 mVideoSink&＃xff0c;PVPlayerDataSinkPVMFNode本身继承了PVPlayerDataSink&＃xff0c;因此可以作为 PVPlayerDataSink使用。调用SetDataSinkNode函数将mVideoNode设置为mVideoSink的数据输出节点。
事实上&＃xff0c;对于Video的输出&＃xff0c;基本的功能都是在类AndroidSurfaceOutput中完成的&＃xff0c;在这个类当中&＃xff0c;主要的工作是将Android的 ISurface输出作为Player Engine的输出。最后调用了AddDataSink将mVideoSink增加为了PVPlayerInterface的输出。
在android_surface_output.cpp文件中实现了类AndroidSurfaceOutput&＃xff0c;这个类相当于一个OpenCore Player Engine的Video输出和Android输出的“适配器”。AndroidSurfaceOutput类本身继承了类 PvmiMIOControl&＃xff0c;而其构造函数又以ISurface类型为参数。这个类的实现是使用ISurface实现PvmiMIOControl的各个接口。