Android MediaPlayer架构 -- 前言小知识点（一）

　　在Android中可以使用MediaPlayer+SurfaceView来实现一个简单的多媒体播放器。

一  构造函数

　　java MediaPlayer class 的源码位置：frameworks\base\media\java\android\media\MediaPlayer.java

　　首先看一下其构造函数：

     public MediaPlayer() {

         Looper looper;
         if ((looper = Looper.myLooper()) != null) {
             mEventHandler = new EventHandler(this, looper);
         } else if ((looper = Looper.getMainLooper()) != null) {
             mEventHandler = new EventHandler(this, looper);
         } else {
             mEventHandler = null;
         }

         mTimeProvider = new TimeProvider(this);
         mOpenSubtitleSources = new Vector<InputStream>();
         IBinder b = ServiceManager.getService(Context.APP_OPS_SERVICE);
         mAppOps = IAppOpsService.Stub.asInterface(b);

         /* Native setup requires a weak reference to our object.
          * It's easier to create it here than in C++.
          */
         native_setup(new WeakReference<MediaPlayer>(this)); // 在实例化MediaPlayer对象时，会调用一个native_setup方法
     }

　　在实例化MediaPlayer对象时，会调用一个native_setup方法：

 private native final void native_setup(Object mediaplayer_this);

　　在JNI代码（frameworks\base\media\jni\android_media_MediaPlayer.cpp）中可以找到对应的native函数：

 static void
 android_media_MediaPlayer_native_setup(JNIEnv *env, jobject thiz, jobject weak_this)
 {
     ALOGV("native_setup");
     sp<MediaPlayer> mp = new MediaPlayer(); // 实例化一个native MediaPlayer(frameworks\av\media\libmedia\mediaplayer.cpp)
     if (mp == NULL) {
         jniThrowException(env, "java/lang/RuntimeException", "Out of memory");
         return;
     }

     // create new listener and give it to MediaPlayer
     sp<JNIMediaPlayerListener> listener = new JNIMediaPlayerListener(env, thiz, weak_this);
     mp->setListener(listener);

     // Stow our new C++ MediaPlayer in an opaque field in the Java object.
     setMediaPlayer(env, thiz, mp);
 }

　　在JNI可以看到，sp<MediaPlayer> mp = new MediaPlayer() 这个native MediaPlayer会去和media service进行交互实现真正的播放功能。

二  设置Listener

　　在JNI 函数 android_media_MediaPlayer_native_setup 中有为MediaPlayer设置listener，目的就是通过callback的方式将player的事件上传至java层，以便用户做出对应的处理

     // create new listener and give it to MediaPlayer
     sp<JNIMediaPlayerListener> listener = new JNIMediaPlayerListener(env, thiz, weak_this);
     mp->setListener(listener);

　　从上面这两行代码可以看到，首先我们实例化一个JNIMediaPlayerListener对象，然后将这个对象传递给了C++ MediaPlayer，在frameworks\av\include\media\mediaplayer.h中定义了listener的接口形式：

 // ref-counted object for callbacks
 class MediaPlayerListener: virtual public RefBase
 {
 public:
     virtual void notify(int msg, int ext1, int ext2, const Parcel *obj) = ;
 };

　　在JNI代码中，JNIMediaPlayerListener class 正是一个MediaPlayerListener的子类，实现了notify函数，其定义如下：

// ref-counted object for callbacks
class JNIMediaPlayerListener: public MediaPlayerListener
{
public:
    JNIMediaPlayerListener(JNIEnv* env, jobject thiz, jobject weak_thiz);
    ~JNIMediaPlayerListener();
    virtual void notify(int msg, int ext1, int ext2, const Parcel *obj = NULL);
private:
    JNIMediaPlayerListener();
    jclass      mClass;     // Reference to MediaPlayer class
    jobject     mObject;    // Weak ref to MediaPlayer Java object to call on
};

　　callback事件的传递主要是通过notify函数来完成的，下面看一下这个函数的具体实现过程：

void JNIMediaPlayerListener::notify(int msg, int ext1, int ext2, const Parcel *obj)
{
    JNIEnv *env = AndroidRuntime::getJNIEnv();
    if (obj && obj->dataSize() > ) {
        jobject jParcel = createJavaParcelObject(env);
        if (jParcel != NULL) {
            Parcel* nativeParcel = parcelForJavaObject(env, jParcel);
            nativeParcel->setData(obj->data(), obj->dataSize());
            env->CallStaticVoidMethod(mClass, fields.post_event, mObject,
                    msg, ext1, ext2, jParcel);
            env->DeleteLocalRef(jParcel);
        }
    } else {
        env->CallStaticVoidMethod(mClass, fields.post_event, mObject,
                msg, ext1, ext2, NULL);
    }
    if (env->ExceptionCheck()) {
        ALOGW("An exception occurred while notifying an event.");
        LOGW_EX(env);
        env->ExceptionClear();
    }
}

• msg, ext1, ext2, obj 携带着事件相关信息及数据；

• 通过env->CallStaticVoidMethod()方法去回调MediaPlayer(java)的 fields.post_event 方法，并将事件信息及数据传递过去；

• fields.post_event对应于MediaPlayer的java 方法 postEventFromNative；

• fields.post_event是在MediaPlayer第一次加载时在android_media_MediaPlayer_native_init中初始化的；

三  小结

　　这一篇介绍的内容很简单，主要是对java层的MediaPlayer， JNI层，及native层的MediaPlayer如何关联起来的有个基本的认识与了解。

　　简单两点概述：

1. java层的MediaPlayer提供了java API供用户调用实现playback功能，但其功能的实现还会串接到JNI层，在JNI层会去实例化一个native MediaPlayer，这个native MediaPlayer会和MediaPlayerService进行交互实现真正的播放功能；
2. 设置listener的目的就是通过回调的方式将来自native的事件进行上传，以便用户在java层做出处理，就这篇而言可以暂时这样理解流程: MediaPlayerService-->native MediaPlayer-->JNI->java MediaPlayer ;