使用媒體處理常式和工作流程處理資產

Adobe Experience Manager Assets 隨附一組預設工作流程和媒體處理常式，用於處理資產。工作流程會定義要在資產上執行的任務，然後將特定任務委派給媒體處理常式，例如縮圖產生或中繼資料擷取。

工作流程可設定為在上傳特定MIME類型的資產時自動執行。 處理步驟是根據一系列Assets介質處理程式定義的。 Experience Manager 提供一 些內置處理程式 ，而其他處理程式可以是自訂 開 發程式，或是透過將處理程式委派至命令列工 具來定義。

媒體處理常式是Assets中對資產執行特定動作的服務。 例如，當MP3音頻檔案上傳到Experience Manager時，工作流將觸發MP3處理程式，該處理程式提取元資料並生成縮略圖。 媒體處理常式通常與工作流程結合使用。 Experience Manager內支援最常見的MIME類型。 您可以透過擴充/建立工作流程、擴充/建立媒體處理常式或停用/啟用媒體處理常式，對資產執行特定工作。

預設媒體處理常式

下列媒體處理常式可在Assets內使用，並處理最常見的MIME類型：

所有處理程式都執行下列任務：

• 從資產擷取所有可用的中繼資料。
• 建立資產的縮圖影像。

要查看活動媒體處理程式：

1. 在您的瀏覽器中，導覽至https://localhost:4502/system/console/components。
2. 按一下 com.day.cq.dam.core.impl.store.AssetStoreImpl.
3. 將顯示包含所有活動媒體處理程式的清單。 例如：

在工作流程中使用媒體處理常式，對資產執行工作

媒體處理常式是與工作流程結合使用的服務。

Experience Manager 有一些處理資產的預設工作流程。要查看它們，請開啟工作流控制台，然後按一下​Models​頁簽：以Assets開頭的工作流程標題是資產專屬標題。

可擴充現有的工作流程，並建立新的工作流程，以根據特定需求處理資產。

下列範例說明如何增強 AEM Assets Synchronization (AEM Assets同步化) 工作流程，以便為除PDF檔案外的所有資產產生子資產。

禁用或啟用媒體處理程式

媒體處理常式可透過Apache Felix Web Management Console停用或啟用。 停用媒體處理常式時，不會對資產執行其工作。

要啟用/禁用媒體處理程式：

1. 在您的瀏覽器中，導覽至https://<host>:<port>/system/console/components。
2. 按一下媒體處理程式名稱旁的​停用 。 例如：com.day.cq.dam.handler.standard.mp3.Mp3Handler。
3. 重新整理頁面：媒體處理程式旁會顯示圖示，指出其已停用。
4. 要啟用媒體處理程式，請按一下媒體處理程式名稱旁的​啟用。

建立新的媒體處理常式

若要支援新媒體類型或對資產執行特定工作，必須建立新媒體處理常式。 本節說明如何繼續。

重要類和介面

開始實作的最佳方式是繼承所提供抽象實作的內容，這種實作會處理大部分內容，並提供合理的預設行為：com.day.cq.dam.core.AbstractAssetHandler類。

此類已提供抽象服務描述符。 因此，如果您從此類繼承並使用maven-sling-plugin，請務必將繼承標幟設為true。

實作下列方法：

• extractMetadata():擷取所有可用的中繼資料。
• getThumbnailImage():從傳遞的資產中建立縮圖影像。
• getMimeTypes():傳回資產MIME類型。

範本範例如下：

package my.own.stuff; /** * @scr.component inherit="true" * @scr.service */ public class MyMediaHandler extends com.day.cq.dam.core.AbstractAssetHandler { // implement the relevant parts }

介面和類包括：

• com.day.cq.dam.api.handler.AssetHandler 介面：此介面描述添加對特定MIME類型支援的服務。新增新的MIME類型需要實作此介面。 該介麵包含用於導入和導出特定文檔、用於建立縮略圖和提取元資料的方法。
• com.day.cq.dam.core.AbstractAssetHandler 類別：此類別可做為所有其他資產處理常式實施的基礎，並提供常用功能。
• com.day.cq.dam.core.AbstractSubAssetHandler 類別：
  • 此類別可做為所有其他資產處理常式實施的基礎，並提供常用功能以及子資產擷取的常用功能。
  • 開始實作的最佳方式是繼承所提供抽象實作的內容，這種實作會處理大部分內容，並提供合理的預設行為：com.day.cq.dam.core.AbstractAssetHandler類。
  • 此類已提供抽象服務描述符。 因此，如果您從此類別繼承並使用maven-sling-plugin，請務必將繼承標幟設為true。

需要實作下列方法：

• extractMetadata():此方法會擷取所有可用的中繼資料。
• getThumbnailImage():此方法會從傳遞的資產中建立縮圖影像。
• getMimeTypes():此方法會傳回資產MIME類型。

範本範例如下：

package my.own.stuff;/*&ast*@scr.component inherit="true" *@scr.service */公用類MyMediaHandler延伸com.day.cq.dam.core.AbstractAssetHandler

介面和類包括：

• com.day.cq.dam.api.handler.AssetHandler 介面：此介面描述添加對特定MIME類型支援的服務。新增新的MIME類型需要實作此介面。 該介麵包含用於導入和導出特定文檔、用於建立縮略圖和提取元資料的方法。
• com.day.cq.dam.core.AbstractAssetHandler 類別：此類別可做為所有其他資產處理常式實施的基礎，並提供常用功能。
• com.day.cq.dam.core.AbstractSubAssetHandler 類別：此類別可做為所有其他資產處理常式實施的基礎，並提供常用功能以及子資產擷取的常用功能。

範例：建立特定文字處理常式

在本節中，將建立特定的文本處理程式，該處理程式將生成帶有水印的縮略圖。

按如下步驟進行：

請參閱開發工具以使用Maven外掛程式安裝和設定Eclipse，以及設定Maven專案所需的相依性。

執行以下過程後，將TXT檔案上載到Experience Manager時，將提取該檔案的元資料並生成兩個帶水印的縮略圖。

1. 在Eclipse中，建立myBundle Maven專案：

   1. 在菜單欄中，按一下​檔案 > 新建 > 其他。

   2. 在對話方塊中，展開Maven資料夾，選取Maven專案，然後按一下​Next。

   3. 勾選「建立簡單專案」方塊和「使用預設工作區位置」方塊，然後按一下「Next」。

   4. 定義Maven專案：

      • 組Id:com.day.cq5.myhandler。
      • 工件Id:myBundle。
      • 名稱：我的Experience Manager套件組合。
      • 說明：這是我的Experience Manager套件組合。

   5. 按一下​完成。

2. 將Java編譯器設定為1.5版：

   1. 按一下右鍵myBundle項目，選擇屬性。

   2. 選擇Java編譯器並將以下屬性設定為1.5:

      • 編譯器合規性級別
      • 生成的.class檔案相容性
      • 源相容性

   3. 按一下​「確定」。在對話框窗口中，按一下「是」。

3. 將pom.xml檔案中的代碼替換為以下代碼：

   <project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!-- ====================================================================== -->
    <!-- P A R E N T P R O J E C T D E S C R I P T I O N -->
    <!-- ====================================================================== -->
    <parent>
     <groupId>com.day.cq.dam</groupId>
     <artifactId>dam</artifactId>
     <version>5.2.14</version>
     <relativePath>../parent</relativePath>
    </parent>
    <!-- ====================================================================== -->
    <!-- P R O J E C T D E S C R I P T I O N -->
    <!-- ====================================================================== -->
    <groupId>com.day.cq5.myhandler</groupId>
    <artifactId>myBundle</artifactId>
    <name>My CQ5 bundle</name>
    <version>0.0.1-SNAPSHOT</version>
    <description>This is my CQ5 bundle</description>
    <packaging>bundle</packaging>
    <!-- ====================================================================== -->
    <!-- B U I L D D E F I N I T I O N -->
    <!-- ====================================================================== -->
    <build>
     <plugins>
      <plugin>
       <groupId>org.apache.felix</groupId>
       <artifactId>maven-scr-plugin</artifactId>
      </plugin>
      <plugin>
       <groupId>org.apache.sling</groupId>
       <artifactId>maven-sling-plugin</artifactId>
       <configuration>
        <slingUrlSuffix>/libs/dam/install/</slingUrlSuffix>
       </configuration>
      </plugin>
      <plugin>
       <groupId>org.apache.felix</groupId>
       <artifactId>maven-bundle-plugin</artifactId>
       <extensions>true</extensions>
       <configuration>
        <instructions>
         <Bundle-Category>cq5</Bundle-Category>
         <Export-Package> com.day.cq5.myhandler </Export-Package>
        </instructions>
       </configuration>
      </plugin>
     </plugins>
    </build>
    <!-- ====================================================================== -->
    <!-- D E P E N D E N C I E S -->
    <!-- ====================================================================== -->
    <dependencies>
     <dependency>
      <groupId>com.day.cq.dam</groupId>
      <artifactId>cq-dam-api</artifactId>
      <version>5.2.10</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>com.day.cq.dam</groupId>
      <artifactId>cq-dam-core</artifactId>
      <version>5.2.10</version>
      <scope>provided</scope>
     </dependency>
     <dependency>
      <groupId>com.day.cq</groupId>
      <artifactId>cq-commons</artifactId>
     </dependency>
     <dependency>
      <groupId>javax.jcr</groupId>
      <artifactId>jcr</artifactId>
     </dependency>
     <dependency>
      <groupId>org.apache.felix</groupId>
      <artifactId>org.osgi.compendium</artifactId>
     </dependency>
     <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
     </dependency>
     <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
     </dependency>
     <dependency>
      <groupId>commons-collections</groupId>
      <artifactId>commons-collections</artifactId>
     </dependency>
     <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.commons</groupId>
      <artifactId>day-commons-gfx</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.commons</groupId>
      <artifactId>day-commons-text</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.cq.workflow</groupId>
      <artifactId>cq-workflow-api</artifactId>
     </dependency>
     <dependency>
      <groupId>com.day.cq.wcm</groupId>
      <artifactId>cq-wcm-foundation</artifactId>
      <version>5.2.22</version>
     </dependency>
    </dependencies>
   

4. 建立com.day.cq5.myhandler包含myBundle/src/main/java下Java類的包：

   1. 在myBundle下，按一下右鍵src/main/java，依次選擇新建和包。
   2. 將其命名為com.day.cq5.myhandler ，然後按一下「完成」。

5. 建立Java類MyHandler:

   1. 在Eclipse的myBundle/src/main/java下，按一下右鍵com.day.cq5.myhandler包。 選擇新建，然後選擇類。
   2. 在對話框窗口中，為Java類MyHandler命名，然後按一下完成。 Eclipse 會建立並開啟檔 MyHandler.java案。
   3. 在MyHandler.java中，使用下列項目取代現有代碼，然後儲存變更：

   package com.day.cq5.myhandler;
   import java.awt.Color;
   import java.awt.Rectangle;
   import java.awt.image.BufferedImage;
   import java.io.IOException;
   import java.io.InputStream;
   import java.io.InputStreamReader;
   import javax.jcr.Node;
   import javax.jcr.RepositoryException;
   import javax.jcr.Session;
   import org.apache.commons.io.IOUtils;
   import org.slf4j.Logger;
   import org.slf4j.LoggerFactory;
   import com.day.cq.dam.api.metadata.ExtractedMetadata;
   import com.day.cq.dam.core.AbstractAssetHandler;
   import com.day.image.Font;
   import com.day.image.Layer;
   import com.day.cq.wcm.foundation.ImageHelper;
   
   /**
    * The <code>MyHandler</code> can extract text files
    * @scr.component inherit="true" immediate="true" metatype="false"
    * @scr.service
    *
    **/
   
   public class MyHandler extends AbstractAssetHandler {
    /** * Logger instance for this class. */
    private static final Logger log = LoggerFactory.getLogger(MyHandler.class);
    /** * Music icon margin */
    private static final int MARGIN = 10;
    /** * @see com.day.cq.dam.api.handler.AssetHandler#getMimeTypes() */
    public String[] getMimeTypes() {
     return new String[] {"text/plain"};
    }
   
    public ExtractedMetadata extractMetadata(Node asset) {
     ExtractedMetadata extractedMetadata = new ExtractedMetadata();
     InputStream data = getInputStream(asset);
     try {
      // read text data
      InputStreamReader reader = new InputStreamReader(data);
      char[] buffer = new char[4096];
      String text = "";
      while (reader.read(buffer) != -1) {
       text += new String(buffer);
      }
      reader.close();
      long wordCount = this.wordCount(text);
      extractedMetadata.setProperty("text", text);
      extractedMetadata.setMetaDataProperty("Word Count",wordCount);
      setMimetype(extractedMetadata, asset);
     } catch (Throwable t) {
      log.error("handling error: " + t.toString(), t);
     } finally {
      IOUtils.closeQuietly(data);
     }
     return extractedMetadata; }
    // ----------------------< helpers >----------------------------------------
    protected BufferedImage getThumbnailImage(Node node) {
     ExtractedMetadata metadata = extractMetadata(node);
     final String text = (String) metadata.getProperty("text");
     // create text layer
     final Layer layer = new Layer(500, 600, Color.WHITE);
     layer.setPaint(Color.black);
     Font font = new Font("Arial", 12);
     String displayText = this.getDisplayText(text, 600, 12);
     if(displayText!=null && displayText.length() > 0) {
      // commons-gfx Font class would throw IllegalArgumentException on empty or null text
      layer.drawText(10, 10, 500, 600, displayText, font, Font.ALIGN_LEFT, 0, 0);
     }
     // create watermark and merge with text layer
     Layer watermarkLayer;
     try {
      final Session session = node.getSession();
      watermarkLayer = ImageHelper.createLayer(session, "/content/dam/we-retail/en/products/apparel/gloves/Gloves.jpg");
      watermarkLayer.setX(MARGIN);
      watermarkLayer.setY(MARGIN);
      layer.merge(watermarkLayer);
     } catch (RepositoryException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
     } catch (IOException e) {
      // TODO Auto-generated catch block
      e.printStackTrace(); }
     layer.crop(new Rectangle(510, 600));
     return layer.getImage(); }
    // ---------------< private >-----------------------------------------------
    /**
     * This method cuts lines if the text file is too long..
     * * @param text
     * * text to check
     * * @param height
     * * text box height (px)
     * * @param fontheight
     * * font height (px)
     * * @return the text which will fit into the box
     */
    private String getDisplayText(String text, int height, int fontheight) {
     String trimmedText = text.trim();
     int numOfLines = height / fontheight;
     String lines[] = trimmedText.split("\n");
     if (lines.length <= numOfLines) {
      return trimmedText;
     } else {
      String cuttetText = "";
      for (int i = 0; i < numOfLines; i++) {
       cuttetText += lines[i] + "\n";
      }
      return cuttetText;
     }
    }
    /**
     * * This method counts the number of words in a string
     * * @param text the String whose words would like to be counted
     * * @return the number of words in the string
     * */
    private long wordCount(String text) {
     // We need to keep track of the last character, if we have two whitespaces in a row we don't want to double count.
     // The starting of the document is always a whitespace.
     boolean prevWhiteSpace = true;
     boolean currentWhiteSpace = true;
     char c; long numwords = 0;
     int j = text.length();
     int i = 0;
     while (i < j) {
      c = text.charAt(i++);
      if (c == 0) { break; }
      currentWhiteSpace = Character.isWhitespace(c);
      if (currentWhiteSpace && !prevWhiteSpace) { numwords++; }
      prevWhiteSpace = currentWhiteSpace;
     }
     // If we do not end with a whitespace then we need to add one extra word.
     if (!currentWhiteSpace) { numwords++; }
     return numwords;
    }
   }
   

6. 編譯Java類並建立包：

   1. 按一下右鍵myBundle項目，選擇​運行方式，然後選擇​Maven安裝。
   2. 套件myBundle-0.0.1-SNAPSHOT.jar（包含編譯的類）在myBundle/target下建立。

7. 在CRX總管中，在/apps/myApp下建立新節點。 名稱= install，類型= nt:folder。

8. 複製套件組合myBundle-0.0.1-SNAPSHOT.jar並將其儲存在/apps/myApp/install下（例如使用WebDAV）。 新的文字處理常式現在在Experience Manager中處於作用中狀態。

9. 在瀏覽器中，開啟Apache Felix Web Management Console。 選擇元件頁簽並禁用預設文本處理程式com.day.cq.dam.core.impl.handler.TextHandler。

基於命令行的媒體處理程式

Experience Manager 可讓您在工作流程中執行任何命令列工具，以轉換資產(例如 ImageMagick)，並將新轉譯新增至資產。您只需在托管Experience Manager伺服器的磁碟上安裝命令行工具，並向工作流中添加和配置進程步驟。 調用的進程（稱為CommandLineProcess）還允許根據特定MIME類型進行篩選，並基於新格式副本建立多個縮略圖。

下列轉換可以自動執行並儲存在Assets中：

• 使用ImageMagick和Ghostscript的EPS和AI轉換。
• 使用FFmpeg進行FLV視訊轉碼。
• 使用LAME進行MP3編碼。
• 使用SOX進行音頻處理。

CommandLineProcess進程按列出順序執行以下操作：

• 如果指定，則根據特定MIME類型篩選檔案。
• 在承載Experience Manager伺服器的磁碟上建立臨時目錄。
• 將原始檔案流到臨時目錄。
• 執行由步驟的參數定義的命令。 該命令正在臨時目錄內執行，具有運行Experience Manager的用戶的權限。
• 將結果流回Experience Manager伺服器的轉譯資料夾。
• 刪除臨時目錄。
• 根據這些轉譯建立縮圖（如果指定）。 縮圖的數字和尺寸由步驟的參數定義。

使用ImageMagick的範例

以下示例說明如何設定命令行處理步驟，以便每次在Experience Manager伺服器上將具有miMIME e-type GIF或TIFF的資產添加到/content/dam時，將建立原始影像的翻轉影像以及另外三個縮略圖（140x100、48x48和10x250）。

要執行此操作，請使用ImageMagick。 ImageMagick 是一種免費的命令行軟體，用於建立、編輯和合成點陣圖影像。

在托管Experience Manager伺服器的磁碟上安裝ImageMagick :

1. 安裝ImageMagick:請參閱ImageMagick檔案。

2. 設定工具，以便在命令行上運行convert。

3. 要查看工具是否正確安裝，請在命令行上運行以下命令convert -h。

   它會顯示說明畫面，其中包含轉換工具的所有可能選項。

   注意

   在某些版本的Windows中，轉換命令可能無法運行，因為它與作為Windows安裝一部分的本機轉換實用程式衝突。 在此案例中，請提及用於將影像檔案轉換為縮圖的ImageMagick軟體的完整路徑。 例如， "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png。

4. 要查看工具是否正常運行，請將JPG映像添加到工作目錄，然後在命令行上運行命令convert <image-name>.jpg -flip <image-name>-flipped.jpg。 已翻轉的影像將添加到目錄中。 然後，將命令列處理步驟新增至​DAM更新資產​工作流程。

5. 前往​Workflow​控制台。

6. 在​Models​標籤中，編輯​DAM Update Asset​模型。

7. 將​Web啟用的轉譯​步驟的引數變更為：mime:image/gif,mime:image/tiff,tn:140:100,tn:48:48,tn:10:250,cmd:convert ${directory}/${filename} -flip ${directory}/${basename}.flipped.jpg。

8. 儲存工作流程。

若要測試修改後的工作流程，請新增資產至/content/dam。

1. 在檔案系統中，獲取您所選擇的TIFF影像。 將其更名為myImage.tiff並將其複製到/content/dam，例如使用WebDAV。
2. 前往​CQ5 DAM​主控台，例如https://localhost:4502/libs/wcm/core/content/damadmin.html。
3. 開啟資產​myImage.tiff​並確認已建立翻轉的影像和三個縮圖。

配置CommandLineProcess進程步驟

本節介紹如何設定 CommandLineProcess的Process參數。

使用逗號分隔處理引數的值，且請勿以空白字元開頭。

例如，如果ImageMagick安裝在Experience Manager伺服器所在的磁碟上，並且使用CommandLineProcess作為實施，並且使用Process Arguments的以下值建立進程步驟：

mime:image/gif,mime:image/tiff,tn:140:100,tn:48:48,tn:10:250,cmd:convert ${directory}/${filename} -flip ${directory}/${basename}.flipped.jpg

然後，當工作流程執行時，步驟僅會套用至image/gif或mime:image/tiff為mime-types的資產，其會建立原始影像的翻轉影像，將其轉換為JPG，並建立三個具有尺寸的縮圖：140x100、48x48和10x250。

使用以下處理參數使用ImageMagick建立三個標準縮圖：

mime:image/tiff,mime:image/png,mime:image/bmp,mime:image/gif,mime:image/jpeg,cmd:convert ${filename} -define jpeg:size=319x319 -thumbnail "319x319>" -background transparent -gravity center -extent 319x319 -write png:cq5dam.thumbnail.319.319.png -thumbnail "140x100>" -background transparent -gravity center -extent 140x100 -write cq5dam.thumbnail.140.100.png -thumbnail "48x48>" -background transparent -gravity center -extent 48x48 cq5dam.thumbnail.48.48.png

使用以下Process Arguments使用ImageMagick建立啟用Web的格式副本：

mime:image/tiff,mime:image/png,mime:image/bmp,mime:image/gif,mime:image/jpeg,cmd:convert ${filename} -define jpeg:size=1280x1280 -thumbnail "1280x1280>" cq5dam.web.1280.1280.jpeg