HMS Core 視訊編輯服務開放模板能力，助力使用者一鍵Get同款酷炫視訊

HMSCore發表於2022-06-20

前言

短視訊模板，是快捷創作短視訊的一種方式，一般由專業設計師或模板創作人制作，使用者只需替換視訊模板中的部分素材，便可生成一支與模板一樣的創意視訊。這種省時省力、無需“燒腦”構思創意的“套模板”視訊創作方法，深受使用者喜愛。

應用場景

短視訊模板在短視訊APP、視訊剪輯工具、拍攝美化工具、旅遊出行、電商、新聞等垂域應用廣泛。例如：

在視訊剪輯工具、拍攝美化工具垂域，短視訊模板功能可以降低視訊剪輯門檻、激發使用者創作，進而提升應用的使用者活躍度；

在旅遊出行應用中，使用者可以通過“套模板”的方式用視訊記錄旅途中的風土人情；

在電商應用中，商家可通過套用商品展示模板的方式，快速製作商品展示視訊；

在新聞資訊應用中，使用者可套用新聞模板，快速釋出新聞訊息。

華為HMS Core視訊編輯服務模板能力

HMS Core視訊編輯服務近期開放了模板功能，並預置了一些不同場景的視訊模板供開發者測試使用，後續還將陸續豐富模板品類和數量。

接入簡單、省時省力

HMS Core視訊編輯服務提供了涵蓋模板欄目列表、模板詳情、模板工程、匯入匯出等詳細的開發介面、介面說明和接入步驟，程式碼簡單、清晰，開發省時省力。

雲端管理、高效運營

HMS Core視訊編輯服務在AGC後臺為開發者提供了編排素材的後臺，運營人員可以在web端完成模板欄目編排、標籤管理、國家/地區設定、上下架模板內容、快速檢索查詢資訊等。

整合程式碼

1. 開發準備

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

2. 編輯工程整合

2.1 設定應用的鑑權資訊

可以通過api_key或者Access Token來設定應用鑑權資訊。

通過setAccessToken方法設定Access Token，在應用啟動時初始化設定一次即可，無需多次設定。

MediaApplication.getInstance().setAccessToken("your access token");

通過setApiKey方法設定api_key，在應用啟動時初始化設定一次即可，無需多次設定。

MediaApplication.getInstance().setApiKey("your ApiKey");

2.2設定唯一標識ID，即License ID。

License ID是進行管控的有效憑證，您要保證設定License ID的唯一性。

MediaApplication.getInstance().setLicenseId("License ID");

2.2.1初始化Editor執行環境

建立編輯工程，需要首先建立Editor物件並初始化其執行環境。當離開編輯工程時，應釋放Editor例項。

(1) 建立Editor物件

HuaweiVideoEditor editor = HuaweiVideoEditor.create(getApplicationContext());

(2) 指定預覽視窗的佈局位置

預覽視窗負責視訊影像畫面的渲染，由視訊編輯原子能力SDK內部建立SurfaceView來實現。在建立視窗之前，需要在您的App中指定預覽視窗的佈局位置。

<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;
   }

3. 模板能力整合

// 獲取模板欄目列表
final HVEColumnInfo[] column = new HVEColumnInfo[1];
HVETemplateManager.getInstance().getColumnInfos(new HVETemplateManager.HVETemplateColumnsCallback() {
        @Override
        public void onSuccess(List<HVEColumnInfo> result) {
           // 獲取模板欄目列表成功
           column[0] = result.get(0);
        }

        @Override
        public void onFail(int error) {
           // 獲取模板欄目列表失敗
        }
});

// 獲取模板詳情
final String[] templateIds = new String[1];
// size為需要請求資料的數量 > 0，offset為需要請求資料的偏移量 ≥ 0，true代表強制獲取網路資料
HVETemplateManager.getInstance().getTemplateInfos(column[0].getColumnId(), size, offset, true, new HVETemplateManager.HVETemplateInfosCallback() {
        @Override
        public void onSuccess(List<HVETemplateInfo> result, boolean hasMore) {
           // 獲取模板詳情成功
           HVETemplateInfo templateInfo = result.get(0);
           // 獲取模板ID
           templateIds[0] = templateInfo.getId();
        }

        @Override
        public void onFail(int errorCode) {
           // 獲取模板詳情失敗
        }
});

// 待獲取模板詳情成功後，獲取模板ID
String templateId = templateIds[0];

// 獲取模板工程
final List<HVETemplateElement>[] editableElementList = new ArrayList[1];;
HVETemplateManager.getInstance().getTemplateProject(templateId, new HVETemplateManager.HVETemplateProjectCallback() {
        @Override
        public void onSuccess(List<HVETemplateElement> editableElements) {
           // 獲取成功後跳轉到選擇資源介面，把選中的本地資源路徑更新到editableElements
           editableElementList[0] = editableElements;
        }

        @Override
        public void onProgress(int progress) {
           // 獲取進度
        }

        @Override
        public void onFail(int errorCode) {
           // 獲取失敗
        }
});

// 準備模板工程
HVETemplateManager.getInstance().prepareTemplateProject(templateId, new HVETemplateManager.HVETemplateProjectPrepareCallback() {
        @Override
        public void onSuccess() {
            // 準備模板工程成功，可以生成HuaweiVideoEditor例項進行播放、預覽、匯出等操作         
        }
        @Override
        public void onProgress(int progress) {
            // 準備進度
        }

        @Override
        public void onFail(int errorCode) {
            // 準備失敗
        }
});

// 在模板準備成功後，生成HuaweiVideoEditor例項
// 擁有editor之後就可以進行播放或者匯出操作，詳情見播放時間線和匯出
HuaweiVideoEditor editor = HuaweiVideoEditor.create(templateId, editableElementList[0]);
try {
      editor.initEnvironment();
} catch (LicenseException e) {
      SmartLog.e(TAG, "editor initEnvironment ERROR.");
}

Demo演示

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文件
華為移動服務開源倉庫地址：GitHub、Gitee

關注我們，第一時間瞭解 HMS Core 最新技術資訊~

相關文章