README.cn

   1 ================================================================================
   2 Stagefright插件
   3 ================================================================================
   4
   5 1. 基于Android多媒体框架提供额外的插件给用户集成
   6 2. FFmpeg提供demux和音视频解码器
   7 3. NamExtractor属于Stagefright的一个demux(extractor)插件，它将随着Stagefright的
   8    启动而加载。NamExtractor后续会加载FFmpegExtractor插件做真正的demux操作，它将
   9    Stagefright的智能指针DataSource传给FFmpeg，FFmpeg基于此指针封装URLProtocol，
  10    便于兼容FFmpeg本身的框架，同时，Stagefright的所有Source都可以这样导入FFmpeg
  11    便于扩展。FFmpegExtractor是参考ffmpeg官方代码ffplay.c文件实现
  12 4. libstagefright_soft_ffmpegvdec是一个视频解码器插件
  13 5. libstagefright_soft_ffmpegadec是一个音频解码器插件
  14 6. 任何FFmpegExtractor demux后的视频都优先选用视频硬件解码，充分发挥硬件特性
  15
  16 ================================================================================
  17 为何起名为nam[NamExtractor]?
  18 ================================================================================
  19
  20 纳木措是西藏三大圣湖之一，是每一个去西藏的旅行者不容错过的景点。在藏语中，
  21 "纳木措"是“天上之湖”的意思。纳木错以其高海拔和令人窒息的美景而声名远扬。
  22
  23 我曾经于2011年9月到过此湖，于是便起此名
  24
  25 ================================================================================
  26 需要条件
  27 ================================================================================
  28
  29 CyanogenMod 9.x (Ice Cream Sandwich)
  30 http://wiki.cyanogenmod.com/wiki/Galaxy_Nexus_(GSM):_Compile_CyanogenMod_(Linux)
  31
  32 FFMPEG-1.0 release
  33 http://ffmpeg.org
  34 ref: git://android.git.linaro.org/platform/external/ffmpeg.git
  35
  36 ================================================================================
  37 如何编译
  38 ================================================================================
  39
  40 1. 获取源码
  41    从CyanogenMod git仓库中克隆cm-9.1.0代码
  42        repo init -u git://github.com/CyanogenMod/android.git -b cm-9.1.0
  43    请参考: http://wiki.cyanogenmod.com/wiki/Galaxy_Nexus_(GSM):_Compile_CyanogenMod_(Linux)
  44
  45    从我的 omxcodec{github} 仓库中克隆代码!
  46    进入你的Android源码目录 "android/external", 运行如下命令:
  47    stagefright-plugins:
  48        git clone git@github.com:omxcodec/stagefright-plugins.git stagefright-plugins
  49    ffmpeg:
  50        git clone git@github.com:omxcodec/android_external_ffmpeg.git ffmpeg -b omxcodec-1.0
  51
  52    进入"android/external" 目录, 运行如下命令:
  53    cp stagefright-plugins/repo/local_manifest.xml ../.repo
  54    cd ..      // 进入Android源码根目录
  55    repo sync  // 同步我的 "frameworks_base" 代码!
  56
  57    这里的"repo sync"命令负责同步我的 "frameworks_base"仓库! 当然，你也可以对比我的代码，
  58    通过对比，你也很容易合并入我修改部分的代码，因为，修改部分很少，而且非常有规律，需要
  59    使用"USES_NAM"这个宏定义区分原有代码。修改的代码仅仅在"android/frameworks/base"目录
  60
  61 2. 编译
  62    Android系统:
  63    增加"USES_NAM"标识到Android编译系统中的编译参数"COMMON_GLOBAL_CFLAGS"
  64        编辑 vendor/samsung/maguro/BoardConfigVendor.mk 增加如下几行
  65            USES_NAM := true
  66            ifdef USES_NAM
  67                COMMON_GLOBAL_CFLAGS += -DUSES_NAM
  68            endif
  69
  70    ffmpeg:
  71        进入android/external/ffmpeg
  72        mm ffmpeg  // 不是命令"mm", FIXME
  73
  74    stagefright-plugins:
  75        进入android/external/stagefright-plugins
  76        mm
  77
  78 3. 安装
  79    adb root
  80    adb remount
  81    adb sync // 与手机或者平板同步系统，一般系统会选择更改的文件或库进行同步
  82    reboot   // 重启你的手机或者平板
  83
  84 4. 运行
  85    获取测试文件:
  86        wget http://movies.apple.com/media/us/ipad/2012/tv-spots/apple-ipad-this_good-us-20120307_848x480.mov
  87        wget http://movies.apple.com/media/us/ipad/2012/80ba527a-1a34-4f70-aae8-14f87ab76eea/tours/apple-ipad-feature-us-20120307_848x480.mp4
  88
  89    假设你视频测试文件放在目录 "/sdcard/Movies/".
  90    开启一个linux终端，运行:
  91        adb logcat -c //清空先前所有的log
  92        adb logcat
  93    开启另外一个linux终端, 分情况运行:
  94    测试 NamExtractor 和 FFmpegExtractor 插件:
  95        adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-this_good-us-20120307_848x480.mov -t video/*
  96        adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-feature-us-20120307_848x480.mp4 -t video/*
  97    测试 SoftFFmpegVideo 视频解码器插件:
  98        进入目录android/external/stagefright-plugins/tools, 运行:
  99        adb root
 100        ./install // 安装测试脚本
 101        adb root && adb shell set-vdec-sw1 // 让Stagefright优先选用视频软件解码器
 102        adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-this_good-us-20120307_848x480.mov -t video/*
 103        adb shell am start -a android.intent.action.VIEW -d file:///mnt/sdcard/Movies/apple-ipad-feature-us-20120307_848x480.mp4 -t video/*
 104
 105    希望你一切顺利
 106
 107 ================================================================================
 108 功能
 109 ================================================================================
 110 输入格式:
 111     MP4 / MOV / 3GP
 112     TS / PS
 113     AVI
 114     ASF / WMV / WMA
 115     Matroska (MKV)
 116     Real(RM,RMVB)
 117     WAV
 118     FLV(H.264+AAC)
 119
 120 视频格式:
 121     MPEG-1/2
 122     MPEG-4
 123     H.263
 124     H.264 / MPEG-4 AVC
 125     WMV 1/2
 126     WMV 3 / WMV-9 / VC-1
 127     Real Video
 128
 129 音频格式:
 130     MPEG Layer 1/2
 131     MP3 - MPEG Layer 3
 132     AAC - MPEG-4 part3
 133     AC3 - A/52 (Dolby Digital)
 134     WMA 1/2
 135     WMA 3
 136     Real Audio
 137     AMR (3GPP)
 138     APE
 139     DTS
 140     FLAC
 141
 142 ================================================================================
 143 存在问题
 144 ================================================================================
 145 1. 一些mov文件，当seek后，音视频不能迅速同步
 146 2. 一些文件正在seek时，退出程序
 147 3. 需要集成更多的音视频编解码器
 148 4. 需要集成更多的文件格式解析器
 149
 150 如果这个项目对您有帮助，或者您想讨论跟此相关相关的话题，请联系本人：
 151 Michael Chen (omxcodec@gmail.com)