學會這幾步，簡單集成影片編輯原子能力SDK

  • 2021 年 12 月 8 日
  • 筆記

華為影片編輯服務6.2.0版本上線後，我們為大家帶來了兩大變化：分別是豐富多樣的AI能力和靈活選擇的集成方式。為讓開發者更快上手使用，今天小編帶來了影片編輯原子能力SDK的具體集成方法。快來試試吧！

1 開發準備

詳細準備步驟可參考華為開發者聯盟官網：

//developer.huawei.com/consumer/cn/doc/development/Media-Guides/config-agc-0000001101108580?ha_source=hms1

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編排好素材欄目後，採用素材管理模組提供的介面，查詢下載指定素材。具體步驟請參考：
//developer.huawei.com/consumer/cn/doc/development/Media-Guides/material_management-0000001166392852?ha_source=hms1

### 1.4	AI演算法集成

影片編輯原子能力SDK提供專屬濾鏡、人物追蹤、人像復活、AI著色等多個AI演算法，開發者可自由選擇接入集成。各AI能力集成步驟可參考：
//developer.huawei.com/consumer/cn/doc/development/Media-Guides/ai_algorithm_integration-0000001166552824?ha_source=hms1

**1.4.1 專屬濾鏡**

支援用戶自定義濾鏡，對輸入影片及影像應用自定義濾鏡效果，支撐場景多樣化的影像美化需求。

專屬濾鏡展示.gif![](//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 最新技術資訊~

VirMach 便宜 VPS

QNews

QNews