一,Vitamio 是什么?
Vitamio 是一款 Android 與 iOS 平台上的全能多媒體開發框架,全面支持硬件解碼與 GPU 渲染。Vitamio 憑借其簡潔易用的 API 接口贏得了全球眾多開發者的青睞。到目前,全球已經有超過 一萬 種應用在使用 Vitamio,覆蓋用戶超過 5億 。
Vitamio 能夠流暢播放720P甚至1080P高清MKV,FLV,MP4,MOV,TS,RMVB等常見格式的視頻,還可以在 Android 與 iOS 上跨平台支持 MMS, RTSP, RTMP, HLS(m3u8) 等常見的多種視頻流媒體協議,包括點播與直播。
流媒體支持
Vitamio 支持各種常見的流媒體協議,可以點播或者直播音頻和視頻,例如如下常見協議均能無縫支持:
- MMS
- RTSP (RTP, SDP), RTMP
- HTTP progressive streaming
- HLS - HTTP live streaming (M3U8)
音頻和視頻格式
Vitamio 使用了 FFmpeg 做為媒體解析器和最主要的解碼器,同時開發了針對不同移動平台的硬解碼方案,能夠完美支持 H.264/AVC、H.263、 MPEG4 等常見的視頻編碼,覆蓋上百種多媒體格式。下表只是一些最常見的視頻格式支持,除特殊標明,全部支持硬件加速:
- DivX/Xvid
- WMV (一般只有軟解碼)
- FLV
- TS/TP
- RMVB (只有軟解碼)
- MKV
- MOV
- M4V
- AVI
- MP4
- 3GP
字幕支持
Vitamio 對字幕的支持很優秀,包括各種常見外掛字幕與很多視頻格式的內嵌字幕,同多個字幕等特性的支持也非常完善。比如:
- SubRip(.srt)
- Sub Station Alpha(.ssa) / Advanced Sub Station Alpha(.ass)
- SAMI(.smi/.sami)
- MicroDVD(.sub/.txt)
- SubViewer2.0(.sub)
- MPL2(.mpl/.txt)
- Matroska (.mkv) 內置字幕
更多特性
除了上面列出的常見功能之外,Vitamio 還做了相當多人性化的工作:
- 多音軌與字幕支持
- 細致的 CPU 與 GPU 優化
- 支持手機到平板各種設備
- 流媒體播放緩沖支持
- 播放畫面比例大小隨手調節
- 自動文字編碼檢測,拒絕亂碼
還有更多新特性沒有被列出,請參考開發文檔。
二,Vitamio 新手入門
Vitamio項目發展迅猛,官方群突破800位開發者,基於Vitamio的項目突破1000個,使用Vitamio提供優質播放體驗的用戶超過1億。也歡迎大家分享你的Vitamio使用經驗,本文將進一步介紹Vitamio的簡單使用方法。
下載
目前Vitamio的項目托管在Github上面:https://github.com/yixia/VitamioBundle
提示:Github支持Git、SVN和直接下載(右側Download Zip)。
簡介
Vitamio的中文名稱為“維他蜜”
Vitamio 是一款 Android 平台上的全能多媒體開發框架。Vitamio 憑借其簡潔易用的 API 接口贏得了全球眾多開發者的青睞。到目前,全球已經有超過 1000 種應用在使用 Vitamio,覆蓋用戶超過 2億。
Vitamio 能夠流暢播放720P甚至1080P高清MKV,FLV,MP4,MOV,TS,RMVB等常見格式的視頻,還可以在 Android 上支持 MMS, RTSP, RTMP, HLS(m3u8) 等常見的多種視頻流媒體協議,包括點播與直播。
支持 ARMv6 和 ARMv7 兩種 ARM CPU,同時對 VFP, VFPv3, NEON 等指令集都做相應優化。
支持 Android 2.1+ 系統,支持超過 95% 的 Android 市場。同時 Android 2.1 之前的系統也基本支持,不過沒做詳細測試。
更多Vitamio的介紹參照這里。
導入使用
1、導入。下載回來后大家可能發現沒有.project工程文件,可以通過File -> Import -> Android -> Existing Android Code Into Workspace來導入工程,然后改一下工程名稱即可。
2、將VitamioBundle工程作為Android Library引入Demo工程使用即可。
注意:
如果是Windows用戶,請將VitamioBundle與Demo工程放在同一個文件夾下,否則添加Android Library可能失敗,其他問題一般clean一下重新編譯一下就好了。其他問題請參考錯誤大全。
關注Vitamio
官方網站/論壇:vitamio.org
Vitamio QQ 3群:283274315
其他
1、官方建議以Android Library方式使用Vitamio插件,以便后續方便升級。
2、 Vitamio最新版本為4.2.1,極力推薦使用新版本。
3、 基於Vitamio僅支持ARMv6+以上的CPU,95%以上的視頻格式支持,說明:
a). 無法播放的問題。使用VPlayer來測試鏈接,如果VPlayer沒有問題那Vitamio肯定也沒有問題。
b). 各種找不到so文件的情況只有兩種情況:不支持設備、沒有執行解壓解碼包。
4、Vitamio最終所有權為炫一下(北京)科技有限公司。
三,Vitamio測試網絡視頻地址
Vitamio支持多種流媒體格式,以下是一些視頻地址片段案例,提供給大家測試使用:
HLS - Apple HTTP live streaming - m3u8
http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8
http://devimages.apple.com/iphone/samples/bipbop/gear1/prog_index.m3u8
http://live.3gv.ifeng.com/zixun.m3u8 (直播)
HTTP
http://www.modrails.com/videos/passenger_nginx.mov
http://wsmp32.bbc.co.uk/
RTSP
http://m.livestream.com (site)
rtsp://xgrammyawardsx.is.livestream-api.com/livestreamiphone/grammyawards
MMS
mms://video.fjtv.net/setv
mms://ting.mop.com/mopradio
mms://112.230.192.196/zb12
四,Vitamio 錯誤大全
Vitamio無法使用的錯誤
Error loading libs
java.lang.UnsatisfiedLinkError: Library … libstlport_shared.so not found
java.lang.UnsatisfiedLinkError: Couldn't load vinit: findLibrary returned null
java.lang.UnsatisfiedLinkError: unloadOMX_native
Native libs libffmpeg.so not exists!
凡是此類錯誤,一般只有以下幾種情況:
1、Vitamio只支持ARMv6+以上的CPU,如果報以上錯誤,說明不支持你的機器。(注意:模擬器要使用4.0以上)
2、沒有調用檢測解碼包的代碼(即沒有解壓解碼包,Vitamio會根據當前CPU的類型自動解壓相應平台的庫),使用方法參照DEMO:
// ~~~ 檢測Vitamio是否解壓解碼包
if (!LibsChecker.checkVitamioLibs(this)) return;
3、沒有以Library的方式使用Vitamio,漏拷貝了VitamioBundle里面的類庫或代碼,例如libvinit.so、libarm.so等。
4、如果您有自己的so,請參考Vitamio的libs文件夾(armeabi、armeabi-v7a、x86)將so拷貝、新建相應的文件夾。
5、如果您是從舊版本Vitamio升級過來,尤其是早期以集成方式使用的,而現在又以Library方式使用,請刪除相關的類和文件(res/raw/libarm.so、libs下面的libvinit.so、io.vov.vitamio下面相應的類文件),最后改一下當前項目的versionCode(Vitamio根據當前項目的版本自動重新解壓升級)。最后可以嘗試卸載之前的app重新安裝。強烈建議下載最新版本,先跑通官網例子,沒有問題再自己集成,最后搞不定還可以直接在官網例子上修改。
6、極少數幾款設備,比如華為S8600、三星GT-S5830(CPU是ARMv6+,但是無法使用)
視頻無法播放的錯誤
avformat_open_input: I/O error
1、確保視頻沒有問題。先拿VLC、系統自帶的播放器或者PC上的播放器,測試一下鏈接,確保視頻是可以播放的。
2、確保調用方法沒有問題。參考官方的例子,先用官網例子測試一個可以播放的鏈接,然后再不改動其他的代碼情況下僅更改播放地址進行測試。
3、確保測試環境一致。比如拿能上網的PC測試完后拿無法上網的手機測試,那肯定不行。
4、前面都確保沒有問題后最后使用VPlayer來進行測試,如果VPlayer能夠播放,那Vitamio一定能播放,否則只有一種情況:不支持!
java.io.FileNotFoundException: No content provider
這個不是錯誤,是正常的處理。現在播放視頻是這樣做的:先把 URL 當做一個 ContentProvider 來打開,如果打不開,就直接當做 URL 來打開
java.lang.SecurityException:Not allowed to bind to service Intent … VitamioService
如果手機上安裝了VPlayer並且使用了舊版本(3.0以前)的Vitamio,可能會報這個錯,可以簡單理解為沖突,所以后續VitamioService這個類在3.0以后就沒有了,還有相關的MediaScannerService也沒有了。
java.lang.NoClassDefFoundError: io.vov.vitamio.R$raw
Vitamio 3.0默認以Android Library的方式使用,對raw的引用使用的io.vov.vitamio.R,如果不是以這種方式使用比如簡單的拷貝合並就報這個錯。建議以Android Library方式使用,便於后續升級。如果仍然堅持要拷貝合並,可以通過在本工程新建包名io.vov.vitamio,新建R類來實現:
package io.vov.vitamio;
public class R {
public static final class raw {
public static final int libarm = com.nmbb.oplayer.R.raw.libarm; public static final int pub = com.nmbb.oplayer.R.raw.pub; } }
Fatal signal 11 (SIGSEGV) at 0xb77ea280 (code=1), thread 1243 (ov.vitamio.demo)
類似Fatal signal崩潰的問題,一般是MediaPlayer的生命周期沒有使用正確。比如還沒有prepare就去調用isPlaying等其他方法都會導致這個問題,使用系統的MediaPlayer也會拋出IllegalStateException的異常。建議去Android官網看文檔:http://developer.android.com/reference/android/media/MediaPlayer.html。尤其是MediaPlayer的狀態圖。
五,Vitamio產品大全
酷6視頻
酷6視頻 Ku6Video 是酷6網竭力打造的手機視頻客戶端。酷6網作為國內最大的短視頻網站,其客戶端覆蓋了資訊、娛樂、搞笑、拍客、時尚等多個頻道的海量視頻資源,集播放、下載、上傳、分享等全新功能,讓手機受眾盡享視頻饕鬄盛宴
CNTV
CNTV中國網絡電視台為中國網絡電視台官方推出的安卓客戶端。 匯聚CCTV和CNTV精彩資源,提供最全面最豐富的中國電視直播、點播服務,全天24小時滾動更新。 精品資訊細分:國家大事、社會熱點新聞,一覽無余 實時直播頻道:王牌電視節目,隨時隨地看直播 精彩專題推薦:新聞、時政、經濟、人文和熱播影視劇在內的新聞熱點聚焦 趕緊下載玩轉2013年指尖上的春晚,CNTV中國網絡電視……
視訊中國
是一款裝機必備的免費高清電影軟件。海量收錄新片,愛情,動作,動漫,驚悚,喜劇等元素的高清電影,隨心所欲的在線觀看和下載。專為Android手機訂制的視頻娛樂客戶端產品,為用戶提供能了流暢便捷的客戶端視頻播放體驗。
321影音
321影音是android手機上功能最多、性能最好的多媒體播放軟件,集視頻播放、音頻播放、電視直播、廣播電台於一身,支持幾乎所有流行的視頻、音頻格式,它將讓您的android手機變成您的掌上享樂中心!
廈門音樂廣播
廈門音樂廣播伴隨着新世紀的到來,廈門人民廣播電台加速發展,目前已形成了智能化控制管理的高速寬帶多媒體信息網絡,技術裝備水平在全國城市電台中位居前列,電波覆蓋范圍包括廈門、泉州、龍海、南安、晉江、石獅以及金門等地區,覆蓋人口達六百多萬,收聽人數、收聽率節節上升。
聽世界
聽世界,是一款專業的有聲作品播放器,免費提供各類精彩的有聲小說、廣播劇、相聲評書、聲音故事、有聲教材、幽默笑話等內容,解放您的雙眼,讓您愛上聽的感覺!
酷雲TV是北京十分科技有限公司出品的一款電視互動產品,它可以使電視節目變得更加有趣。
酷狗音樂手機版是最受歡迎的音樂播放器,有強大的音樂搜索和高速下載功能、 全球最全音樂曲庫,最專業的音頻解碼核心技術,完美實現各種音頻格式的高保真播放。
天天動聽
天天動聽手機版是一款功能強大、完全免費的手機音樂播放軟件,[3]支持歌詞和歌曲圖片下載,皮膚隨心更換,更有炫麗震撼的可視化效果,同時預置豐富的均衡器效果,支持音效增強,簡潔人性化的操作,給追求音樂品質的呢帶來了手機聽歌的全新體驗。數據表明,天天動聽已經成為拇指一族必備的音樂播放工具!
- 1. 不支持ARMv6以下的CPU(支持ARMv6+,大部分無法播放的問題均是此問題,注意模擬器請使用4.0以上版本)
- 2. 不支持加密(例如DRM)視頻、嵌套的m3u8(如果m3u8中有無法播放的干擾鏈接也會停止而不會跳過)( Vitamio4.2.0已經解決)
- 3. 不支持獲取Audio SessionId對象
- 4. 不支持視頻縮略圖截圖(但支持對正在播放的視頻截圖,函數名:getCurrentFrame)
- 5. 不支持setSurface方法(Vitamio 4.2.1已經解決)
- 6. 設置字幕(subPath)必須是本地的字幕文件
- 7. 有些機型硬解碼不夠成熟,建議讓用戶手動切換軟解/硬解(VPlayer,MX player等主流播放器也是這樣處理的)。
- 8. 不支持華為S8600等少數幾款機型,具體表現為無法解壓解碼包(一直停留在解壓界面)。
- 9. 不支持Logcat信息輸出屏蔽(so里面輸出的,但應用層可以屏蔽掉)
- 10. 不支持自定義網絡協議(你們需要修改我們公開的 FFmpeg 代碼,在其中添加相應的 libavformat 模塊就可以了,與加密和內存中數據處理是一樣的或者通過代理來轉換協議。
- 11. 目前不支持兩個視頻同時播放
- 12. 如果mp3包含了1幀視頻(比如mp3專輯圖片),此mp3將當成視頻處理,播完這一幀就會馬上結束。(Vitamio會先檢測是否包含視頻,如果包含視頻(大於0幀)即當視頻處理,否則當音頻處理)。(Vitamio 4.2.1已解決)
- 13.由於Youku的m3u8不標准,導致Vitamio對Youku視頻支持不好,具體表現為拖拽進度條無效、突然中斷。(在Vitamio 4.0中已經解決)
- 14. rmvb不支持硬解,2.1以下的也不支持硬解(硬件限制)
- 15. hls 不支持可變碼率(在Vitamio 4.0中已經解決)
- 16. 不支持swf,但支持flv(建議安裝Adobe,然后用WebView播放)
七,Vitamio FAQ
Vitamio名字的由來
Vitamio的中文名稱為“維他蜜”。
Vitamio 來源於英文單詞Vitamin(維他命),希望Vitamio對於安卓多媒體開發者的重要性,就像Vitmain之於人體一樣不可缺少。
Vitamio與VPlayer什么關系?
Vitamio基於VPlayer開發,所以VPlayer能播放的Vitamio也能。
Vitamio支持哪些指令集的CPU?
支持 ARMv6 和 ARMv7 兩種 ARM CPU,同時對 VFP, VFPv3, NEON 等指令集都做相應優化。
Vitamio支持的Android版本
支持 Android 2.1+ 系統,支持超過 95% 的 Android 市場。同時 Android 2.1 之前的系統也基本支持,不過沒做詳細測試。
E/Vitamio(1557): java.io.FileNotFoundException: No content provider
這個不是錯誤,是正常的處理。現在播放視頻是這樣做的:先把 URL 當做一個 ContentProvider 來打開,如果打不開,就直接當做 URL 來打開。
為什么會彈出提示框要求安裝Vitamio Plugin?
因為你下載和使用的是較早的Vitamio版本!
視頻/視頻流(rtp、rtsp等)播放不了的問題!
可能存在以下幾種情況:
- 視頻本身就存在問題,你可以用其他播放器播放一下,是否能正常播放。
- 本地網速不給力/設備本身配置過低。
- 視頻源卡,本身帶寬不夠,直接訪問也很慢。
- 嵌套了m3u8地址
- 視頻被加密了
建議先使用VPlayer和其他播放器來測試視頻,確保排除外在因素。
如何調用VPlayer來播放視頻?
1
2
3
4
5
6
7
8
|
private
void
startPlayer(String url, String title) {
Intent i =
new
Intent();
i.setComponent(
new
ComponentName(
"me.abitno.vplayer.t"
,
"me.abitno.vplayer.VideoActivity"
));
i.setAction(
"me.abitno.vplayer.action.VIEW"
);
i.setData(Uri.parse(url));
i.putExtra(
"displayName"
, title);
startActivity(i);
}
|
在混淆時如何忽略Vitamio相關類庫的混淆?
1
2
|
-keep
class
io.vov.utils.** { *; }
-keep
class
io.vov.vitamio.** { *; }
|
播放時拖動進度條,拖動進度不准確?
這是正常現象,不是播放器的問題。默認seek要到最近的關鍵幀,不能保證任何時間戳上都有關鍵幀,除非你是intra-only 的編碼方式。
如何開啟硬解碼?
實例化MediaPlayer時啟用第二個參數。
1
|
public
MediaPlayer(android.content.Context ctx,
boolean
preferHWDecoder)
|
為什么每次軟件升級都會重新解壓解碼包?
為確保與當前升級軟件中Vitamio的版本保持一致。Vitamio Java層的代碼都已經公開,你可以自己改邏輯。
八,VCamera SDK Android用戶手冊
VCamera SDK Android版(短視頻拍攝SDK)是炫一下(北京)科技有限公司官方推出的Android平台使用的軟件開發工具包,為Android開發者提供簡單、快捷的接口,幫助開發者實現Android平台上的短視頻應用開發。
SDK提供視頻錄制、實時濾鏡、后期強大的FFMPEG命令行支持,可實現水印、音量控制等諸多功能。
本文檔面向所有使用該SDK的開發人員、測試人員,要求有一定的Android編程經驗。
SDK下載地址
https://www.vitamio.org/VCamera_SDK_Android_1.1.0.zip
SDK功能說明
SDK提供拍攝錄制、分段回刪、實時濾鏡、靜態/動態水印、聲音合成、本地圖片、視頻導入等功能。
SDK使用說明
1.1 運行環境
- Android 4.0及以上的所有系統(注意Demo中使用了TextureView,要支持更低版本的Android請自行修改替換成SurfaceView)
- 僅支持ARM v7的CPU
1.2 初始化
1
|
VCamera.initialize(
this
);
|
建議在Application 的onCreate 中調用,參考Demo 中的VCameraDemoApplication
開發前准備
如果您新開發一個的項目,我建議您直接在Demo上進行修改,修改AndroidManifest.xml中的package即可。
1.1 添加SDK到App工程
- 創建一個Android工程
- 將vcameralibrary.jar添加到App工程的libs目錄下
- 將libvcamera.so添加到App工程的libs目錄下的armeabi-v7a目錄
- 從Demo中拷貝需要的類、圖片等資源到App工程下
1.2 權限聲明
1.3 初始化SDK
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
//設置拍攝視頻緩存路徑
if
(DeviceUtils.isZte()) {
if
(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_ DCIM).exists()) {
VCamera.setVideoCachePath(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM) +
"/Camera/VCameraDemo/"
);
}
else
{
VCamera.setVideoCachePath(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM).getPath().replace(
"/sdcard/"
,
"/sdcard-ext/"
) +
"/Camera/VCameraDemo/"
);
}
}
else
{
VCamera.setVideoCachePath(Environment.getExternalStoragePublicDir ectory(Environment.DIRECTORY_DCIM) +
"/Camera/VCameraDemo/"
);
}
//開啟log輸出,ffmpeg輸出到logcat
VCamera.setDebugMode(
true
);
//初始化拍攝SDK,必須
VCamera.initialize(
this
);
|
1.4 初始化MediaRecorder
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
mMediaRecorder =
new
MediaRecorder();
mMediaRecorder.setOnErrorListener(
this
);
if
(NetworkUtils.isWifiAvailable(
this
)) {
mMediaRecorder.setVideoEncodingBitRate(MediaRecorder.VIDEO_BITRAT E_MEDIUM);
//WIFI下800碼率
}
else
{
mMediaRecorder.setVideoEncodingBitRate(MediaRecorder.VIDEO_BITRATE_NORMAL);
//3G、2G下600碼率
}
String recordFile = VCamera.getVideoCachePath() + System.currentTimeMillis();
// 生成文件名;
mMediaRecorder.setOutputDirectory(recordFile);
// 設置輸出路徑
mMediaRecorder.setSurfaceView(mSurfaceView);
mMediaRecorder.setCameraFilter(MediaRecorder.CAMERA_FILTER_NO);
//重置濾鏡
mMediaRecorder.prepare();
|
1.5 后期處理
UtilityAdaptert提供FFmpegRun方法用於執行ffmpeg命令
API說明
1.1 拍攝
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
/** 視頻碼率400kbps */
public
static
final
int
VIDEO_BITRATE_LOW =
400
;
/** 視頻碼率600kbps */
public
static
final
int
VIDEO_BITRATE_NORMAL =
600
;
/** 視頻碼率800kbps(默認) */
public
static
final
int
VIDEO_BITRATE_MEDIUM =
800
;
/** 視頻碼率1024kbps */
public
static
final
int
VIDEO_BITRATE_HIGH =
1024
;
/* 設置碼率,參數范圍在400 ~ 1024之間,建議WIFI下800K,其他情況600K */
public
void
setVideoEncodingBitRate(
int
bitRate)
/* 切換前后攝像頭,默認后置攝像頭 */
public
void
switchCamera()
/* 切換閃光燈,默認關閉 */
public
boolean
toggleFlashMode()
/**
* 設置視頻臨時存儲文件夾
*
*@param key 視頻輸出的名稱,同目錄下唯一,一般取系統當前時間
*@param path 文件夾路徑
*@return 錄制信息對象
*/
public
MediaObject setOutputDirectory(String key, String path)
/* 是否支持前置攝像頭 */
public
static
boolean
isSupportFrontCamera()
/* 拍攝完成,開始轉碼合成mp4臨時文件 */
public
boolean
startEncoding()
/* 開始准備 */
public
void
prepare()
/* 開始錄制,返回視頻分塊信息,與stop()成對使用 */
public
MediaPart start()
/* 停止錄制,與start()成對調用,可多次調用實現分段拍攝 */
public
void
stop()
/* 錄制完成,釋放資源 */
public
void
release()
|
1.2 MediaRecorderFilter支持實時濾鏡的錄制類
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
/** 沒有濾鏡 */
public
static
final
String CAMERA_FILTER_NO =
""
;
/** 黑白濾鏡 */
public
static
final
String CAMERA_FILTER_BLACKWHITE =
"blackWhite"
;
/** 銳化濾鏡 */
public
static
final
String CAMERA_FILTER_SHRRPEN =
"pro"
;
/** 老照片 */
public
static
final
String CAMERA_FILTER_OLD_PHOTOS =
"oldFilm"
;
/** 霓虹燈 */
public
static
final
String CAMERA_FILTER_NEON_LIGHT =
"edge"
;
/** 反色濾鏡 */
public
static
final
String CAMERA_FILTER_ANTICOLOR =
"antiColor"
;
/** 穿越濾鏡 */
public
static
final
String CAMERA_FILTER_THROUGH =
"radial"
;
/** 馬賽克濾鏡 */
public
static
final
String CAMERA_FILTER_MOSAICS =
"earlyBird"
;
/** 懷舊濾鏡 */
public
static
final
String CAMERA_FILTER_REMINISCENCE =
"lomo"
;
|
1.3 FFMpegUtils FFmpeg工具類
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
|
/** 音量 100% -vol 100 */
public
static
final
float
AUDIO_VOLUME_HIGH = 1F;
/** 音量 66% */
public
static
final
float
AUDIO_VOLUME_MEDIUM =
0
.66F;
/** 音量 33% */
public
static
final
float
AUDIO_VOLUME_LOW =
0
.33F;
/** 音量 關閉 */
public
static
final
int
AUDIO_VOLUME_CLOSE =
0
;
/**
* 視頻截圖
*
* @param videoPath 視頻路徑
* @param outputPath 截圖輸出路徑
* @param wh 截圖畫面尺寸,例如84x84
* @param ss 截圖起始時間
* @return
*/
public
static
boolean
captureThumbnails(String videoPath, String outputPath, String wh, String ss)
/**
* 綜合轉碼
*
* @param mMediaObject 視頻數據存儲對象,涵主題、小部件和視頻片段
* @param targetPath 目標路徑
* @param videoWidth 視頻寬度
* @param complexWatermark 是否合並主題(預覽頁主題和主題音樂)
* @return
*/
public
static
boolean
videoTranscoding(MediaObject mMediaObject, String targetPath,
int
videoWidth,
boolean
complexWatermark)
/**
* 圖片轉視頻(用於圖片導入)
*/
public
static
boolean
convertImage2Video(MediaPart part)
|
1.4 UtilityAdapter 底層工具類
1
2
3
4
5
6
7
8
9
10
11
12
13
|
/**
* 執行ffmpeg命令
*
* @param strtag 任務的唯一標識,如果標識為""或NULL,以阻塞方式運行,否則以
異步方式運行
* @param strcmd 命令行
* @return 返回執行結果
*/
public
static
native
int
FFmpegRun(String tag, String cmd);
/** 獲取當前轉碼完成時間 */
public
static
native
int
FFmpegVideoGetTransTime(
int
flag);
/** 獲取當前轉碼完成時間 */
public
static
native
int
VideoGetMetadataRotate(String filename);
|
開發指南
1.1 拍攝流程圖
上面是一般的拍攝流程,目前Demo只有手動拍攝(后續版本會補上本地導入),開發者可自行用ffmpeg命令行實現其他的功能和流程。
1.2 拍攝錄制模式
SDK支持三種錄制模式:
1.2.1 支持實時濾鏡的錄制模式(MediaRecorderFilter)
默認模式(也是秒拍當前使用的模式)輸出yuv裸視頻數據和pcm裸音頻數據,如下流程圖:
本模式下支持實時濾鏡,能直接輸出480x480的yuv數據,並且已經旋轉好視頻畫面,無須額外裁剪。
1.2.2 普通錄制模式(MediaRecorder)
與6.2.1類似,但是輸出的是640x480的yuv數據,后期處理需要自己增加裁剪和旋轉的命令,例如-vf "transpose=1[tran];[tran]crop=480:480:0:0"。
1.2.3 系統錄制模式(MediaRecorderSystem).
待完善.
ffmpeg命令行
1.1 視頻疊加水印(建議添加與視頻大小一致並且透明的水印,如480x480)
1
2
3
4
5
6
|
//
單水印
ffmpeg -i
in
.mp4 watermark1.png -filter_complex
"overlay=x=0:y=0"
-f mp4 out.mp4
//
動態水印,2張圖片間隔200毫秒
ffmpeg -i
in
.mp4 watermark1.png –i watermark2.png -filter_complex
"overlay=x= 'if(eq(floor(mod(t*5,2)),0), 0, -500)':y=0, overlay=x= 'if(eq(floor(mod(t*5,2)),1), 0, -500)':y=0"
-f mp4 out.mp4
//
視頻疊加gif
ffmpeg -y -i
in
.mp4 -i
in
.gif -filter_complex
"overlay=0:0"
-t 10 -acodec copy out.mp4
|
1.2 視頻裁剪
1
2
|
//
裁剪0秒到10秒視頻
ffmpeg -i
in
.mp4 -ss 0 -t 10 -vcodec copy -acodec copy out.mp4
|
1.3 格式轉換
1
2
3
4
|
//yuv
轉mp4
ffmpeg -y -f rawvideo -pix_fmt yuv420p -s 480x480 -r 15 -i
in
.yuv -vcodec libx264 -profile:
v
baseline -preset ultrafast out.mp4
//
靜態圖片轉mp4
ffmpeg -y -loop 1 -f image2 -i Goddess.png -vcodec mpeg4 -r 15 -t 10 Goddess.mp4
|
1.4 其他
1
2
3
4
5
6
7
8
9
|
//
加速視頻
ffmpeg -i input.avi -vf
"setpts=0.5*PTS"
output.avi
//
放慢視頻
ffmpeg -i input.avi -vf
"setpts=2.0*PTS"
output.avi
//
刪除視頻文件的旋轉信息
-metadata:s:
v
rotate=\"\"
//
提取視頻的yuv和pcm數據
ffmpeg -i
in
.mp4 -ss 0 -t 10 -vn -acodec pcm_s16le -f s16le -ar 44100
-ac 1 a.pcm -ss 0 -t 10 -an -vcodec rawvideo -f rawvideo -s 640x480 -pix_fmt nv21 a.yuv
|
※更多關於ffmpeg的用法請參考, www.ffmpeg.org
FAQ
-
SDK是否收費?
- 個人免費,企業收費(商務sales@yixia.com,電話座機010-6482 8682)
-
最終解釋權
- 最終解釋權歸炫一下(北京)科技有限公司所有。
- so的包很大,能優化減少嗎
- 我們也意識到了這個問題,后續版本會進行裁剪。
-
拍攝界面能和秒拍做成一樣的嗎?
- 能。歡迎為用戶提供一致的體驗!但僅限於拍攝的相關界面。
-
什么時候推出IOS版本的拍攝SDK?
- 如果你已經在上線的產品中使用了Android版的拍攝上傳SDK,可以聯系我們申請IOS版的拍攝SDK試用