學會這幾步,簡單整合視訊編輯原子能力SDK
華為視訊編輯服務6.2.0版本上線後,我們為大家帶來了兩大變化:分別是豐富多樣的AI能力和靈活選擇的整合方式。為讓開發者更快上手使用,今天小編帶來了視訊編輯原子能力SDK的具體整合方法。快來試試吧!
1 開發準備
詳細準備步驟可參考華為開發者聯盟官網:
2 程式碼開發
1.1 編輯工程
1.1.1 設定應用的鑑權資訊
可以通過api_key或者Access Token設定應用鑑權資訊。
- 使用setAccessToken方法設定Access Token,應用啟動時初始化設定一次即可,無需多次設定。
MediaApplication.getInstance().setAccessToken("your access token");
- 使用setApiKey方法設定api_key,同樣無需多次設定。
MediaApplication.getInstance().setApiKey("your ApiKey");
1.1.2 設定唯一標識ID,即License ID。
License ID是進行管控的有效憑證,開發者需保證License ID的唯一性。
MediaApplication.getInstance().setLicenseId("License ID");
1.1.3 初始化Editor執行環境
建立編輯工程,首先要建立Editor物件並初始化執行環境。離開編輯工程時,則應釋放Editor例項。
(1) 建立Editor物件
HuaweiVideoEditor editor = HuaweiVideoEditor.create(getApplicationContext());
(2) 指定預覽視窗的佈局位置
預覽視窗負責視訊影象畫面的渲染,由視訊編輯原子能力SDK內部建立SurfaceView來實現。在建立視窗之前,需要開發者在應用中指定預覽視窗的佈局位置。
<LinearLayout android:id="@+id/video_content_layout" android:layout_width="0dp" android:layout_height="0dp" android:background="@color/video_edit_main_bg_color" android:gravity="center" android:orientation="vertical" /> // 指定預覽視窗 LinearLayout mSdkPreviewContainer = view.findViewById(R.id.video_content_layout); // 設定預覽視窗承載的佈局 editor.setDisplay(mSdkPreviewContainer);
(3) 初始化執行環境,如果License鑑權失敗,會丟擲LicenseException。
建立Editor物件不會佔用實際的系統資源,開發者需要手動選擇環境初始化的時機,此時的視訊編輯原子能力SDK內部會建立必須的執行緒和定時器等。
try {
editor.initEnvironment();
} catch (LicenseException error) {
SmartLog.e(TAG, "initEnvironment failed: " + error.getErrorMsg());
finish();
return;
}
```
1.1.4 **新增視訊、圖片**
建立一條視訊泳道,通過檔案路徑在泳道上新增圖片或視訊素材。
// 獲取時間線物件
HVETimeLine timeline = editor.getTimeLine();
// 建立視訊泳道
HVEVideoLane videoLane = timeline.appendVideoLane();
// 在視訊泳道的末尾,新增視訊資源
HVEVideoAsset videoAsset = vidoeLane.appendVideoAsset("test.mp4");
// 在視訊泳道的末尾,新增圖片資源
HVEImageAsset imageAsset = vidoeLane.appendImageAsset("test.jpg");
1.1.5 **新增音樂**
建立一條音樂泳道,通過檔案路徑在泳道上新增音樂素材。
// 建立音樂泳道
HVEAudioLane audioLane = timeline.appendAudioLane();
// 在音訊泳道的末尾,建立音樂資源
HVEAudioAsset audioAsset = audioLane.appendAudioAsset("test.mp3");
**1.1.6 新增貼紙和文字**
建立一條貼紙文字泳道,通過檔案路徑在泳道上新增貼紙和文字。其中文字需要指定文字內容。
// 建立貼紙文字泳道
HVEStickerLane stickerLane = timeline.appendStickerLane();
// 在泳道的末尾新增貼紙
HVEStickerAsset stickerAsset = stickerLane.appendStickerAsset("test.png");
// 在泳道的末尾新增文字
HVEWordAsset wordAsset = stickerLane.appendWord("輸入文字",0,3000);
1.1.7 **新增特效**
特效分為外聯特效和內嵌特效兩種。
外聯特效。在特效泳道中新增,可跨多個資源、任意調節時間長度。
// 建立特效泳道
HVEEffectLane effectLane = timeline.appendEffectLane();
// 建立一個顏色調節特效,新增到0位置,時長為3000ms
HVEEffect effect = effectLane.appendEffect(new HVEEffect.Options(HVEEffect.EFFECT_COLORADJUST, "", ""), 0, 3000);
* 內嵌特效。在資源中新增,只能作用於單個資源,時間長度無法單獨調節。
// 建立一個顏色調節內嵌特效
HVEEffect effect = videoAsset.appendEffectUniqueOfType(new HVEEffect.Options(HVEEffect.EFFECT_COLORADJUST, "", ""), ADJUST);
1.1.8 **播放時間線**
播放時間線需要指定起點和終點,之後時間線會按照固定幀率向後推進,預覽畫面和聲音保持同步播放。通過註冊的播放回調,可以接收播放進度、暫停、播放完成和播放失敗事件。
// 註冊播放進度回撥
editor.setPlayCallback(callback);
// 播放完整時間線
editor.playTimeLine(timeline.getStartTime(), timeline.getEndTime());
1.1.9 **匯出**
編輯完成後,通過匯出介面將時間線上的資源生成新視訊。再設定匯出回撥,可以監聽匯出進度、完成、失敗事件,並指定匯出視訊的幀率、解析度、生成路徑。
// 匯出視訊路徑
String outputPath =
Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)
+ File.separator + Constant.LOCAL_VIDEO_SAVE_PATH
+ File.separator + VideoExportActivity.getTime() + ".mp4";
// 匯出解析度
HVEVideoProperty videoProperty = new HVEVideoProperty(1920, 1080);
// 匯出視訊
HVEExportManager.exportVideo(targetEditor, callback, videoProperty, outputPath);
### 1.2 工程草稿
通過HVEProjectManager管理器可以查詢本地草稿列表,並對草稿進行復制、刪除、重新命名的操作。
**1.2.1 儲存草稿**
// 將editor儲存到本地
editor.saveProject();
**1.2.2 恢復草稿**
// 通過草稿ID,建立Editor例項
HuaweiVideoEditor editor = HuaweiVideoEditor.create(getApplicationContext(), projectId);
### 1.3 素材管理
在AGC編排好素材欄目後,採用素材管理模組提供的介面,查詢下載指定素材。具體步驟請參考:
https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/material_management-0000001166392852?ha_source=hms1
### 1.4 AI演算法整合
視訊編輯原子能力SDK提供專屬濾鏡、人物追蹤、人像復活、AI著色等多個AI演算法,開發者可自由選擇接入整合。各AI能力整合步驟可參考:
https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/ai_algorithm_integration-0000001166552824?ha_source=hms1
**1.4.1 專屬濾鏡**
支援使用者自定義濾鏡,對輸入視訊及影象應用自定義濾鏡效果,支撐場景多樣化的影象美化需求。
專屬濾鏡展示.gif![](https://img2020.cnblogs.com/other/2396482/202112/2396482-20211208154128390-345268267.gif)
// 建立專屬濾鏡演算法引擎
HVEExclusiveFilter filterEngine = new HVEExclusiveFilter();
// 初始化專屬濾鏡演算法引擎
mFilterEngine.initExclusiveFilterEngine(new HVEAIInitialCallback() {
@Override
public void onProgress(int progress) {
// 初始化進度回撥
}
@Override
public void onSuccess() {
// 初始化成功
}
@Override
public void onError(int errorCode, String errorMessage) {
// 初始化失敗
}
});
// 建立單圖濾鏡,指定一個Bitmap和濾鏡的名字
// 返回濾鏡ID,通過此ID,可以在資料庫中查詢濾鏡相關的所有資訊
String effectId = mFilterEngine.createExclusiveEffect(bitmap, "自定義濾鏡01");
// 將濾鏡新增到特效泳道中,起始位置0, 時長3000ms
effectLane.appendEffect(new HVEEffect.Options(
HVEEffect.CUSTOM_FILTER + mSelectName, effectId, ""), 0, 3000);
```
1.4.2 一鍵染髮
輸入一張單人或多人照片,檢測人物並基於參考色卡樣式,實現一鍵式染髮,染色程度可拉動調節。
一鍵染髮.gif
// 一鍵染髮AI演算法初始化
asset.initHairDyeingEngine(new HVEAIInitialCallback() {
@Override
public void onProgress(int progress) {
// 初始化進度
}
@Override
public void onSuccess() {
// 初始化成功
}
@Override
public void onError(int errorCode, String errorMessage) {
// 初始化失敗
}
});
// 新增一鍵染髮特效,指定色卡和預設強度。
asset.addHairDyeingEffect(new HVEAIProcessCallback() {
@Override
public void onProgress(int progress) {
// 一鍵染髮處理進度。
}
@Override
public void onSuccess() {
// 一鍵染髮處理成功
}
@Override
public void onError(int errorCode, String errorMessage) {
// 一鍵染髮處理失敗
}
}, colorPath, defaultStrength);
// 移除一鍵染髮特效
asset.removeHairDyeingEffect();
1.4.3 人像復活
輸入一張單人或多人照片,驅動照片中的人物做出微笑、點頭等動作,達到人像復活效果。
人像復活.gif
// 新增人像復活特效
asset.addFaceReenactAIEffect(new HVEAIProcessCallback() {
@Override
public void onProgress(int progress) {
// 人像復活處理進度
}
@Override
public void onSuccess() {
// 人像復活處理成功
}
@Override
public void onError(int errorCode, String errorMessage) {
// 人像復活處理失敗
}
});
// 移除人像復活特效
asset.removeFaceReenactAIEffect();
瞭解更多詳情>>
訪問華為開發者聯盟官網
獲取開發指導文件
華為移動服務開源倉庫地址:GitHub、Gitee
關注我們,第一時間瞭解 HMS Core 最新技術資訊~