================================================================================
Stagefright插件
================================================================================

1. 基于Android多媒体框架提供额外的插件给用户集成
2. FFmpeg提供demux和音视频解码器
3. NamExtractor属于Stagefright的一个demux(extractor)插件，它将随着Stagefright的
   启动而加载。NamExtractor后续会加载FFmpegExtractor插件做真正的demux操作，它将
   Stagefright的智能指针DataSource传给FFmpeg，FFmpeg基于此指针封装URLProtocol，
   便于兼容FFmpeg本身的框架，同时，Stagefright的所有Source都可以这样导入FFmpeg
   便于扩展。FFmpegExtractor是参考ffmpeg官方代码ffplay.c文件实现
4. libstagefright_soft_ffmpegvdec是一个视频解码器插件
5. libstagefright_soft_ffmpegadec是一个音频解码器插件
6. 任何FFmpegExtractor demux后的视频都优先选用视频硬件解码，充分发挥硬件特性

================================================================================
为何起名为nam[NamExtractor]?
================================================================================

纳木措是西藏三大圣湖之一，是每一个去西藏的旅行者不容错过的景点。在藏语中，
"纳木措"是“天上之湖”的意思。纳木错以其高海拔和令人窒息的美景而声名远扬。

我曾经于2011年9月到过此湖，于是便起此名

================================================================================
需要条件
================================================================================

CyanogenMod 9.x (Ice Cream Sandwich)
http://wiki.cyanogenmod.com/wiki/Galaxy_Nexus_(GSM):_Compile_CyanogenMod_(Linux)

FFMPEG-1.0 release
http://ffmpeg.org
ref: git://android.git.linaro.org/platform/external/ffmpeg.git

================================================================================
如何编译
================================================================================

1. 获取源码
   从CyanogenMod git仓库中克隆cm-9.1.0代码
       repo init -u git://github.com/CyanogenMod/android.git -b cm-9.1.0
   请参考: http://wiki.cyanogenmod.com/wiki/Galaxy_Nexus_(GSM):_Compile_CyanogenMod_(Linux)

   从我的 omxcodec{github} 仓库中克隆代码!
   进入你的Android源码目录 "android/external", 运行如下命令:
   stagefright-plugins:
       git clone git@github.com:omxcodec/stagefright-plugins.git stagefright-plugins
   ffmpeg:
       git clone git@github.com:omxcodec/android_external_ffmpeg.git ffmpeg -b omxcodec-1.0

   进入"android/external" 目录, 运行如下命令:
   cp stagefright-plugins/repo/local_manifest.xml ../.repo
   cd ..      // 进入Android源码根目录
   repo sync  // 同步我的 "frameworks_base" 代码!

   这里的"repo sync"命令负责同步我的 "frameworks_base"仓库! 当然，你也可以对比我的代码，
   通过对比，你也很容易合并入我修改部分的代码，因为，修改部分很少，而且非常有规律，需要
   使用"USES_NAM"这个宏定义区分原有代码。修改的代码仅仅在"android/frameworks/base"目录
 
2. 编译
   Android系统:
   增加"USES_NAM"标识到Android编译系统中的编译参数"COMMON_GLOBAL_CFLAGS"
       编辑 vendor/samsung/maguro/BoardConfigVendor.mk 增加如下几行
           USES_NAM := true
           ifdef USES_NAM
               COMMON_GLOBAL_CFLAGS += -DUSES_NAM
           endif

   ffmpeg:
       进入android/external/ffmpeg
       mm ffmpeg  // 不是命令"mm", FIXME

   stagefright-plugins:
       进入android/external/stagefright-plugins
       mm

3. 安装
   adb root
   adb remount
   adb sync // 与手机或者平板同步系统，一般系统会选择更改的文件或库进行同步
   reboot   // 重启你的手机或者平板

4. 运行
   获取测试文件:
       wget http://movies.apple.com/media/us/ipad/2012/tv-spots/apple-ipad-this_good-us-20120307_848x480.mov
       wget http://movies.apple.com/media/us/ipad/2012/80ba527a-1a34-4f70-aae8-14f87ab76eea/tours/apple-ipad-feature-us-20120307_848x480.mp4

   假设你视频测试文件放在目录 "/sdcard/Movies/".
   开启一个linux终端，运行:
       adb logcat -c //清空先前所有的log
       adb logcat
   开启另外一个linux终端, 分情况运行:
   测试 NamExtractor 和 FFmpegExtractor 插件:
       adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-this_good-us-20120307_848x480.mov -t video/*
       adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-feature-us-20120307_848x480.mp4 -t video/*
   测试 SoftFFmpegVideo 视频解码器插件:
       进入目录android/external/stagefright-plugins/tools, 运行:
       adb root
       ./install // 安装测试脚本
       adb root && adb shell set-vdec-sw1 // 让Stagefright优先选用视频软件解码器
       adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-this_good-us-20120307_848x480.mov -t video/*
       adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-feature-us-20120307_848x480.mp4 -t video/*

   希望你一切顺利

================================================================================
功能
================================================================================
输入格式:
    MP4 / MOV / 3GP
    TS / PS
    AVI
    ASF / WMV / WMA
    Matroska (MKV)
    Real(RM,RMVB)
    WAV
    FLV(H.264+AAC)

视频格式:
    MPEG-1/2
    MPEG-4
    H.263
    H.264 / MPEG-4 AVC
    WMV 1/2
    WMV 3 / WMV-9 / VC-1
    Real Video

音频格式:
    MPEG Layer 1/2
    MP3 - MPEG Layer 3
    AAC - MPEG-4 part3
    AC3 - A/52 (Dolby Digital)
    WMA 1/2
    WMA 3
    Real Audio
    AMR (3GPP)
    APE
    DTS
    FLAC
    
================================================================================
存在问题
================================================================================
1. 一些mov文件，当seek后，音视频不能迅速同步
2. 一些文件正在seek时，退出程序
3. 需要集成更多的音视频编解码器
4. 需要集成更多的文件格式解析器

如果这个项目对您有帮助，或者您想讨论跟此相关相关的话题，请联系本人：
Michael Chen (omxcodec@gmail.com)