ApsaraVideo VOD:ビデオの編集

ビデオソース管理

// 1. ビデオソースマネージャーを取得します。
AliyunIClipConstructor contructor = AliyunIEditor.getSourcePartManager();


// 2. ビデオまたは画像を追加します。この手順はオプションです。

// タイムラインの最後にビデオまたは画像を追加します。 AliyunVideoClip を呼び出してビデオを追加するか、AliyunImageClip を呼び出して画像を追加できます。
contructor.addMediaClip(AliyunClip clip);

// 指定した位置にビデオまたは画像を追加します。 AliyunVideoClip を呼び出してビデオを追加するか、AliyunImageClip を呼び出して画像を追加できます。
contructor.addMediaClip(int index, AliyunClip clip);

// 3. ビデオまたは画像を削除します。この手順はオプションです。

// 最後のビデオまたは画像を削除します。
contructor.deleteMediaClip();

// 指定したビデオまたは画像を削除します。
contructor.deleteMediaClip(int index);

// 4. ビデオまたは画像を置き換えます。この手順はオプションです。
// 指定した位置にあるビデオまたは画像を置き換えます。
contructor.updateMediaClip(int index, AliyunClip clip);

// すべてのビデオまたは画像を置き換えます。
contructor.updateAllClips(List<AliyunClip> clips);


// 5. 更新を適用します。メディアファイルの構成が完了したら、次のメソッドを呼び出してこれらの更新を適用し、変更を有効にします。
AliyunIEditor.applySourceChange();

その他の操作

// メディアファイルの位置を調整します。    
contructor.swap(int pos1, int pos2);

// メディアファイルの数を取得します。    
contructor.getMediaPartCount();

// メディアファイルのリストを取得します。    
contructor.getAllClips();

フィルター、トランジション効果、MV などのカスタムビデオ効果を構成および作成できます。詳細については、「フィルターとトランジション効果」および「MV」をご参照ください。コードで使用されているパラメーターの詳細については、「関連クラス」をご参照ください。

• フィルターには、ルックアップテーブル（LUT）フィルター、静的フィルター、アニメーションフィルターが含まれます。

  • LUT フィルター: ルックアップテーブルを使用してピクセルを置き換えます。

  • 静的フィルター: シェーディング言語を記述することでピクセルを計算します。アニメーション効果はサポートされていません。静的フィルターの Bean は EffectBean です。詳細については、EffectBean をご参照ください。

  • アニメーションフィルター: シェーディング言語を記述することでピクセルを計算します。アニメーション効果がサポートされています。アニメーションフィルターの Bean は EffectFilter です。詳細については、「EffectFilter」をご参照ください。

• ショートビデオ SDK は、次のトランジション効果を提供します。TransitionCircle (アイリスラウンド)、TransitionFade (フェードインとフェードアウト)、TransitionFiveStar (スター)、TransitionShutter (ブラインド)、TransitionTranslate (スライド)。

LUT フィルター

LUTEffectBean bean = new LUTEffectBean();
bean.setPath("image_01.png");
bean.setIntensity(1.f);

// LUT フィルターを追加します。
mAliyunIEditor.applyLutFilter(bean);
// LUT フィルターを削除します。
mAliyunIEditor.applyLutFilter(null);

静的フィルター

EffectBean effect = new EffectBean();
effect.setId(id)
effect.setSource(new Souce(filePath));

// フィルターを追加します。
AliyunIEditor.applyFilter(effect);
// フィルターを削除します。
AliyunIEditor.applyFilter(new EffectBean());

アニメーションフィルター

EffectFilter effectFilter = new EffectFilter(new Souce(filePath));
effectFilter.setStartTime(startTime);
effectFilter.setDuration(duration);

// アニメーションフィルターを追加します。
AliyunIEditor.addAnimationFilter(effectFilter);

// アニメーションフィルターを削除します。
AliyunIEditor.removeAnimationFilter(effectFilter);
// すべてのアニメーションフィルターを削除します。
AliyunIEditor.clearAllAnimationFilter();

トランジション効果

// 1. トランジション効果を構成します。
// トランジション効果を構成します。 index は、トランジションが開始される再生タイムライン上の位置を指定します。 index が 0 に設定されている場合、トランジションは最初のビデオの終わりに開始されます。トランジションをキャンセルするには、パラメーターを null に設定します。
AliyunEditor.setTransition(int index, TransitionBase transition); 

// 一度に複数のトランジション効果を構成します。トランジションをキャンセルするには、パラメーターを null に設定します。
AliyunEditor.setTransition(Map<Integer, TransitionBase> transitions); // 複数のトランジション効果を構成します。


// 2. トランジション効果を更新します。
// 別のトランジション効果を使用して、トランジション効果を更新します。パラメーターを null に設定することはできません。
AliyunEditor.updateTransition(int index, TransitionBase transition); 

カスタム MV を作成できます。詳細については、「MV」をご参照ください。

// MV を追加します。
AliyunIEditor.applyMV(EffectBean effect);

// MV を削除します。
AliyunIEditor.applyMV(null);

ショートビデオ SDK は、次の効果音を提供し、オーディオストリームに効果音を追加できます。

• AudioEffectType.EFFECT_TYPE_LOLITA (活発な女性の声)

• AudioEffectType.EFFECT_TYPE_REVERB (残響)

• AudioEffectType.EFFECT_TYPE_UNCLE (ハスキーな男性の声)

• AudioEffectType.EFFECT_TYPE_ECHO (エコー)

• AudioEffectType.EFFECT_TYPE_ROBOT (ロボット)

• AudioEffectType.EFFECT_TYPE_BIG_DEVIL (不吉な)

• AudioEffectType.EFFECT_TYPE_MINIONS (ミニオン)

• AudioEffectType.EFFECT_TYPE_DIALECT (中国の方言)

PiP 機能を使用すると、既存のメイントラックに 1 つ以上の PiP 効果を追加できます。

• メイントラック: 編集ページのデフォルトトラック。メイントラックは 1 つだけ許可されます。メイントラックには複数のビデオストリームを含めることができます。

• PiP: 複数の PiP 効果を追加し、位置、スケーリング、回転などの PiP 効果の設定を構成できます。デフォルトでは、PiP 効果を作成すると、PiP トラックが自動的に作成されます。 PiP 効果は、異なる PiP トラックで移動できます。

字幕を追加または削除する

Source fontSouce = null;
long startTime = 0L;
long duration = 20000L;

// 1. 字幕を追加します。
AliyunPasterControllerCompoundCaption captionController=pasterManager.addCaptionWithStartTime ('テキスト', null, fontSouce, startTime,duration);

// 2. 字幕を削除します。
controller.remove()

AliyunPasterControllerCompoundCaption を使用して、字幕に関連するすべての操作を呼び出すことができます。詳細については、API リファレンスをご参照ください。字幕のプロパティを変更するたびに、AliyunPasterControllerCompoundCaption.apply() を呼び出して変更を有効にする必要があります。

// 背景色を指定します。
captionController.setColor(AliyunColor color);
// フォントを指定します。
captionController.setFontPath(ISouce fontPath);
// 上記の変更を適用します。
captionController.apply();

プロジェクト構成を取得する

// エディターを初期化します。
AliyunIEditor.init(SurfaceView surfaceView, Context context);
// プロジェクト構成を取得します。
AliyunEditorProject project = AliyunIEditor.getEditorProject();

ドラフトマネージャーを初期化する

AliyunDraftManager draftManager = AliyunDraftManager.getInstance(context);

ドラフトリストを取得する

// ドラフトリストを非同期で取得します。
AliyunDraftManager.getInstance(getContext())
                          .getDraftListByAsync(new AliyunDraftListCallback() {
                              @Override
                              public void onFailure(final String msg) {
                                  // ドラフトリストの取得に失敗しました。
                              }

                              @Override
                              public void onSuccess(final List<AliyunDraft> draftList) {
                                  // ドラフトリストの取得に成功しました。
                              }
                          });

ドラフト ID に基づいてドラフトを削除する

// ドラフトを削除します。ドラフトはドラフトリスト内のアイテムです。関連メソッドを呼び出すことで、ドラフトリストを取得できます。
AliyunDraftManager.getInstance(v.getContext()).deleteDraft(draft.getId());

ドラフトの名前を変更する

// ドラフトの名前を変更します。ドラフトはドラフトリスト内のアイテムです。関連メソッドを呼び出すことで、ドラフトリストを取得できます。
AliyunDraftManager.getInstance(v.getContext()).rename(draft.getId(), newName);

ドラフトをコピーする

// ドラフトをコピーした後、新しいドラフトが生成されます。ドラフトはドラフトリスト内のアイテムです。関連メソッドを呼び出すことで、ドラフトリストを取得できます。
AliyunDraft newDraft = AliyunDraftManager.getInstance(v.getContext()).copy(draft.getId());

ドラフトを読み込む

// ドラフトはドラフトリスト内のアイテムです。関連メソッドを呼び出すことで、ドラフトリストを取得できます。
AliyunDraftManager.getInstance(v.getContext()).preLoadDraft(draft, new AliyunDraftResourceLoader() {

                @Override
                public void onHandleResourceTasks(final List<AliyunDraftResTask> tasks) {
                    // 関連リソースがないため、処理するリソースタスクが返されます。タスクを修復、無視、または削除できます。
                    HashMap<String, List<AliyunDraftResTask>> map = new HashMap<>();
                    for (AliyunDraftResTask task : tasks) {
                        if (task.getSource() != null && !StringUtils.isEmpty(task.getSource().getURL())) {
                            if (map.containsKey(task.getSource().getURL())) {
                                map.get(task.getSource().getURL()).add(task);
                            } else {
                                List<AliyunDraftResTask> list = new ArrayList<>();
                                list.add(task);
                                map.put(task.getSource().getURL(), list);
                            }
                        } else {
                            // タスクを修復、無視、または削除できます。
                            if (task.getResModuleType() == AliyunResModuleType.MAIN_VIDEO) {
                                task.getSource().setPath(EditorCommon.SD_DIR + "svideo_res/image/aliyun_svideo_failed.jpg");
                                task.onHandleCallback(task.getSource());
                            } else if(task.getResModuleType() == AliyunResModuleType.TRANSITION) {
                                // タスクを削除します。
                                task.onRemove();
                            } else {
                                // タスクを無視します。
                                task.onIgnore();
                            }
                        }
                        for (final Map.Entry<String, List<AliyunDraftResTask>> entry : map.entrySet()) {
                            // Key の値はリソースの URL です。 Value の値は、リソースの URL を使用して処理するタスクです。
                            final List<AliyunDraftResTask> list = entry.getValue();
                            try {
                                final String url = entry.getKey();
                                // リソースがプラットフォームリソースかどうかを確認します。
                                if (url.startsWith(AlivcResUtil.SCHEME)) {
                                    // プラットフォームリソースを読み込むための コールバック。
                                    AlivcResUtil.LoadCallback callback = new AlivcResUtil.LoadCallback() {
                                        @Override
                                        public void onSuccess(String path) {
                                            for (AliyunDraftResTask task : list) {
                                                Source source = task.getSource();
                                                source.setPath(path);
                                                task.onHandleCallback(source);
                                            }
                                        }

                                        @Override
                                        public void onFailure(String type, String msg) {
                                            Log.d("CloudDraft", "loadRes>Failure>type>" + type + ">msg>" + msg);
                                            for (AliyunDraftResTask task : list) {
                                                task.onIgnore();
                                            }
                                        }
                                    };
                                    // プラットフォームリソースを読み込みます。完全なサンプルコードについては、デモをご参照ください。
                                    AlivcResUtil.loadRes(context, url, callback);
                                } else {
                                    // ユーザーリソースをダウンロードします。完全なサンプルコードについては、デモをご参照ください。
                                    downloadRes(url, new File(item.getEditorProjectUri()).getParent(), list);
                                }
                            } catch (Exception e) {
                                // エラーが発生しました。
                                for (AliyunDraftResTask item : list) {
                                    item.onIgnore();
                                }
                            }
                        }
                    }
                }

                @Override
                public void onFailure(final String msg) {
                    // プリロードに失敗しました。
                    Toast.makeText(v.getContext(), "プリロードに失敗しました", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void onSuccess() {
                    // プリロードが完了したら、編集ページに移動できます。ドラフトはドラフトリスト内のアイテムです。関連 API 操作を呼び出すことで、ドラフトリストを取得できます。 draft.getEditorProjectUri() を使用してドラフトを読み込むことができます。
                    EditorActivity.startEdit(v.getContext(), draft);
                }
            });

ドラフトをアップロードするには、ドラフトサーバーを使用します。サンプルコードをクリックして、サーバーのサンプルコードをダウンロードします。

// ドラフトはドラフトリスト内のアイテムです。関連メソッドを呼び出すことで、ドラフトリストを取得できます。
AliyunDraftManager.getInstance(context)
                          .uploadDraft(draft, new AliyunDraftResourceUploader() {
                              @Override
                              public void onHandleResourceTasks(final List<AliyunDraftResTask> tasks) {
                                  // 処理する必要があるリソースアップロードタスク。
                                  HashMap<String, List<AliyunDraftResTask>> map = new HashMap<>();
                                  // 重複するリソースをフィルターします。
                                  for (AliyunDraftResTask task : tasks) {
                                      if (task.getSource() == null) {
                                          task.onIgnore();
                                          continue;
                                      }
                                      // URL が空であるか、URL が alivc_resource で始まっていない場合は、URL を処理する必要があります。
                                      String url = task.getSource().getURL();
                                      if (StringUtils.isEmpty(url) || !url.startsWith("alivc_resource")) {
                                          if (map.containsKey(task.getSource().getPath())) {
                                              map.get(task.getSource().getPath()).add(task);
                                          } else {
                                              List<AliyunDraftResTask> list = new ArrayList<>();
                                              list.add(task);
                                              map.put(task.getSource().getPath(), list);
                                          }
                                      } else {
                                          // エラーを無視します。
                                          task.onIgnore();
                                      }
                                  }
                                  for (Map.Entry<String, List<AliyunDraftResTask>> entry : map.entrySet()) {
                                      try {
                                          for (AliyunDraftResTask task : tasks) {
                                              Source source = task.getSource();
                                              // アップロード完了後の コールバック URL を構成します。
                                              source.setURL();
                                              task.onHandleCallback(source);
                                          }
                                      } catch (Exception e) {
                                          // エラーを無視します。
                                          List<AliyunDraftResTask> list = entry.getValue();
                                          for (AliyunDraftResTask item:list){
                                              item.onIgnore();
                                          }
                                      }
                                  }
                              }

                              @Override
                              public void onSuccess(final String projectPath, String coverUrl) {
                                  // すべてのリソースがアップロードされると、プロジェクト構成の URL とサムネイルの URL が返されます。
                                  // リソースをクラウドにアップロードできます。他のユーザーは、プロジェクト構成の URL を使用してドラフトを編集状態に復元できます。
                              }

                              @Override
                              public void onFailure(final String msg) {
                                  Toast.makeText(context,"バックアップに失敗しました",Toast.LENGTH_SHORT).show();
                              }
                          });

ドラフトをダウンロードするには、ドラフトサーバーを使用します。サンプルコードをクリックして、サーバーのサンプルコードをダウンロードします。

// ドラフトのプロジェクト構成に基づいて、ドラフト関連リソースをダウンロードします。 file は、ドラフトをバックアップした後にサーバーからダウンロードできるプロジェクト構成ファイルです。
AliyunDraftManager.getInstance(context).downloadDraft(file, new AliyunDraftResourceDownloader() {
            @Override
            public void onHandleResourceTasks(final String projectDir, final List<AliyunDraftResTask> tasks) {
                // 処理する必要があるドラフトリソースタスク。ドラフト内のリソースをダウンロードする必要があります。
                HashMap<String, List<AliyunDraftResTask>> map = new HashMap<>();
                // 重複するリソースをフィルターします。
                for (AliyunDraftResTask task : tasks) {
                    if (task.getSource() == null || StringUtils.isEmpty(task.getSource().getURL())) {
                        task.onIgnore();
                    } else if (map.containsKey(task.getSource().getURL())) {
                        map.get(task.getSource().getURL()).add(task);
                    } else {
                        List<AliyunDraftResTask> list = new ArrayList<>();
                        list.add(task);
                        map.put(task.getSource().getURL(), list);
                    }
                }
                for (final Map.Entry<String, List<AliyunDraftResTask>> entry : map.entrySet()) {
                    final List<AliyunDraftResTask> list = entry.getValue();
                    try {
                        final String url = entry.getKey();
                        // URL を使用してドラフトリソースをダウンロードします。
                        for (AliyunDraftResTask task : list) {
                            Source source = task.getSource();
                            // ダウンロード完了後にリソースのローカル URL を指定します。
                            source.setPath(path);
                            // リソースが MV の場合は、ID を取得し、MV を表示するために ID を Source の値として指定します。
                            if (task.getResModuleType() == AliyunResModuleType.MV) {
                                try {
                                    source.setId(Uri.parse(url).getQueryParameter("gid"));
                                }catch (Exception ignored){
                                }
                            }
                            task.onHandleCallback(source);
                        }
                    } catch (Exception e) {
                        // エラーが発生しました。
                        for (AliyunDraftResTask item : list) {
                            item.onIgnore();
                        }
                    }
                }

            }

            @Override
            public void onSuccess(final AliyunDraft draft) {
                // すべてのリソースをダウンロードした後、サーバーの ProjectID パラメーターを構成します。 ProjectID を使用して、ローカルドラフトをクラウドドラフトに関連付けることができます。
                AliyunDraftManager.getInstance(context).setProjectId(draft.getId(), projectId);
                Toast.makeText(context,"ドラフトはローカル PC に復元されました",Toast.LENGTH_SHORT).show();
                // ドラフトをローカル PC に復元した後、ローカルドラフトリストでドラフトを表示できます。
            }

            @Override
            public void onFailure(final String msg) {
                Toast.makeText(context,"ドラフトをローカル PC に復元できませんでした",Toast.LENGTH_SHORT).show();
            }
        });

タイムエフェクト

// 1. 速度ランプを構成します。
// SDK V3.7.0 以降を使用すると、このメソッドを呼び出して、複数のビデオまたは画像の再生速度を調整できます。
int effectId;
effectId = AliyunIEditor.rate(float rate, long startTime, long duration, boolean needOriginDuration);

// 2. 繰り返し設定を構成します。
effectId = AliyunIEditor.repeat(int times, long startTime, long duration, boolean needOriginDuration);

//3. 逆再生を構成します。
// 注: 逆再生を実行する前に、グループオブピクチャ (GOP) サイズが 5 より大きいビデオをトランスコードします。 NativeParser.getMaxGopSize() メソッドを呼び出して、ビデオの GOP サイズを表示できます。トランスコード中に、CropParam.setGop(1) メソッドを呼び出して GOP サイズを 1 に設定します。
effectId = AliyunIEditor.invert();


// タイムエフェクトを削除します。
AliyunIEditor.deleteTimeEffect(effectId);

ウォーターマークには、一般的なウォーターマークと終了ウォーターマークがあります。一般的なウォーターマークは、ビデオストリームの全期間にわたって表示されます。終了ウォーターマークは、ビデオストリームの最後に表示されます。

// ウォーターマークのサンプル。 sizeX と sizeY は、表示領域の幅に対するウォーターマークの幅の比率と、表示領域の高さに対するウォーターマークの高さの比率を指定します。比率に注意してください。そうしないと、ウォーターマークが不完全に表示される場合があります。
// posX と posY は、表示領域におけるウォーターマークの中心の座標を指定します。たとえば、0,0 は左上隅を示し、1,1 は右下隅を示します。

// 一般的なウォーターマークを構成します。
AliyunIEditor.applyWaterMark(String imgPath, float sizeX, float sizeY, float posX, float posY);

// 終了ウォーターマークを構成します。
AliyunIEditor.addTailWaterMark(String imagePath, float sizeX, float sizeY, float posX, float posY, long durationUs);

ショートビデオ SDK は、キャンバスとペイントブラシの構成操作を含む、一連の落書き操作を提供します。 AliyunICanvasController を使用して、落書き構成を管理できます。

• キャンバス: 落書き用に提供される UI インタラクションビュー。 UI インタラクションビューを UI インタラクションビューグループに追加できます。

• ペイントブラシ: android.graphics.Paint オブジェクト。カスタムペイントブラシを構成するか、デフォルトのペイントブラシを使用できます。