本文會帶領外掛程式開發人員了解如何建立 Animate 外掛程式,以支援使用 Animate CC 2014.2 的自訂平台。如果您使用的是 Animate CC 2014.1 (2014 年 10 月更新),請參閱本文件的上一版

若要建立自訂平台支援插件,開發人員必須從下列位置下載「自訂平台支援開發套件」:

下載

從下列位置下載範例插件,並當做參考,用來建立自訂平台支援插件:

下載

插件包含下列元素:

  • DocType 會在 Animate 中加入自訂平台的新文件類型,並控制編寫功能。
  • 「發佈者」允許設定發佈設定,並將文件發佈至自訂平台。

如需「自訂平台支援」功能的概觀,請參閱自訂平台支援

Animate CC 2015 的新功能

  • 查詢元件庫元件類型的能力:若是元件,ILibraryItem::GetProperties() 會有額外的項目,其金鑰為 kLibProp_SymbolType_DictKey。金鑰的值可以是 kLibProp_SymbolType_Button、kLibProp_SymbolType_MovieClip 或 kLibProp_SymbolType_Graphic。
  • 區分按鈕與 MovieClip 的能力:在上一版之前,DOM 和 IFrameCommandGenerator 服務都是將按鈕實體當做 MovieClip 來處理。自 Animate CC 2015 起,已新增了介面,可以支援按鈕實體。如果 IMovieClip 實體也實作 IButton 介面,就會被當做按鈕實體來處理。按鈕的四個狀態,也就是「一般」、「滑入」、「按下」和「感應區」,永遠分別對應到影格 0、1、2 和 3。請參閱檔案 IButton.h,深入了解按鈕實體。
  • 可取得 IClassicText 物件邊界的新 API:ITimelineBuilder 介面中的 AddClassicText 功能現在會傳回 CLASSIC_TEXT_INFO_2 的物件 (而非舊的 CLASSIC_TEXT_INFO),該物件包含新的欄位「邊界」,代表 IClassicText 物件的邊界。
  • 範例插件已經修改成重複使用形狀填色所用的點陣圖。
  • Mongoose 網路伺服器已經整合至範例插件。

注意:Animate CC 2015 版本提供的新 IK 骨塊工具,在自訂平台文件類型中是停用的。當您將 IK 內容貼到自訂平台文件時,Animate 會將內容轉換為逐格動畫。

2015 年 2 月更新IFrameCommandGenerator 服務中的「遮色片」支援,這個版本支援 IFrameCommandGenerator 服務中的遮色片。新介面 ITimelineBuilder2 繼承自現有 ITimelineBuilder 介面,包含插件必須實作才能使這個功能運作的功能。請參閱自訂平台支援 API 文件,以深入了解全新的 ITimelineBuilder2 介面。

建立 Animate 自訂平台支援插件

您可以使用下列其中一個方法來開發自訂平台支援插件:

  • 使用自訂平台支援開發套件中的 API 來建立插件。
  • 將開發套件中包含的範例插件設定自訂為符合您的需求。

「自訂平台支援」插件會封裝為 .zxp 檔案,可與 Animate CC 一起安裝。您可以將插件裝載在 Adobe Add-ons 頁面,以供使用者使用 Creative Cloud 應用程式進行下載和安裝,或者將插件以 .zxp 套件的形式散佈,讓使用者可以使用 Adobe Extensions Manager 進行安裝。

系統需求

開發人員需要下列軟體,才能使用自訂平台支援開發套件來建置插件:

  • Microsoft Windows 7 或 Apple Mac OS 10.8 和更高版本
  • Microsoft Visual Studio 2012 (適用於 Windows) 或 XCode 4.5.2 (適用於 Mac)
  • Animate CC 2014.1 及更新版本
  • 適用於 C/C++ 開發人員的 Eclipse IDE
  • Adobe Extension Builder 3.0
  • Adobe Extension Manager 7.2.1.6

插件開發人員的 API 參考文件

自訂平台支援開發套件包含下列元素:

  • FCM (Flash 組件模型):包含在開發套件中的標題檔案會定義名為 FCM 的架構,此架構是用於插件管理。
  • DocType:這個元素包含一組介面,可協助您將新的文件類型加入 Animate 開始頁面,並讓您可以針對自訂文件類型啟用或停用功能。
  • DOM (文件物件模型):這個元素包含一組介面,可協助您存取使用 DOM 格式的 Animate 文件中的內容。 
  • 發佈者:這個元素包含一組介面,提供發佈工作流程的攔截程序。

如需自訂平台支援中的 API 的完整資訊,以及如何使用 API 來建立插件的範例,請參閱自訂平台支援 API 參考

建立自訂平台支援插件

您可以依照下列方式建立自訂平台支援插件:

  1. 下載「自訂平台支援開發套件」。
  2. 將套件內容解壓縮到您的電腦。
  3. 在 VisualStudio 或 Xcode 中開啟新專案,並將開發套件中的標題檔案納入您的軟體開發專案。若要快速建立您的自訂平台支援插件,您可以使用 SampleCreateJSPlatform 目錄下方的下列範例插件,做為插件專案的基礎程式碼。
  4.             例如,SampleCreateJS 插件檔案位於                        SampleCreateJSPlatform\Plugin\SampleCreateJS\project\

  5. 為您的目標平台進行必要變更。
  6. 編譯程式碼,以產生插件 (.dll 或 .plug-in)。 

封裝自訂平台支援插件

您可以依照下列方式,為自訂平台支援插件產生可散佈的套件:

  1. 開啟範例 Eclipse 檔案,或者在 Eclipse 的「New Project wizard」(新增專案精靈) 中,建立新的應用程式擴充功能專案。為專案提供名稱,然後按一下「Next」(下一步)。
  2. 在「New Adobe Application Extension Project」(新增 Adobe 應用程式擴充功能專案) 面板上,選擇「Adobe Animate」做為目標應用程式,並按一下「Next」(下一步)。
  3. 在 Windows 上,將您所建立的插件檔案的副檔名從 .dll 變更為 .fcm,或在 Mac 上,將副檔名從 .plug-in 變更為 .fcm.plug-in,然後將插件檔案加入專案 (Windows:ExtensionContent/plugins/lib/win,MAC:ExtensionContent/plugins/lib/mac)。
  4. 修改 manifest.xml,以設定您的擴充功能。若要開啟資訊清單檔案,請以滑鼠右鍵按一下專案總管中的擴充功能,並選取「Adobe Extension Builder 3 > Bundle Manifest Editor」(合併資訊清單編輯器),然後選取位於 EclipseProject\.staged-extension\CSXS 之「Bundle Manifest Editor」(合併資訊清單編輯器) 中的資訊清單索引標籤。
  5. 若要允許編輯 manifest.xml,請在視窗內以滑鼠右鍵按一下,並選取「Open with > XML editor」(開啟方式 > XML 編輯器)。您必須注意的兩個索引標籤是 ExtensionListDispatchInfoList

    典型的 ExtensionList 標籤看起來如下:

<ExtensionList>

        <Extension Id="PluginID" Version="1.0" />

        <Extension Id="PublishSettingsID" Version-"1.0" />

</ExtensionList>

 

這個標籤包含最終 ZXP 套件中擴充功能的清單,其中每個擴充功能都有唯一的字串做為其 ID。在這個情況中,先前章節中建立的 .dll 或 .plugin 檔案會包含在擴充功能。然後,其他擴充功能可用來設定「發佈者」的「發佈設定」UI。在 ExtensionList 標籤的範例中,擴充功能 ID 為 PluginID 的擴充功能包含 .dll/.plugin 檔案,而擴充功能 ID 為 PublishSettingsID 的擴充功能會設定發佈者的發佈設定 UI。

 

  1. DispatchInfoList 標籤包含 ExtensionList 中所提到每個擴充功能的詳細資料。下列是 DispatchInfoList 的範例:
<DispatchInfoList>
            <Extension Id="PluginID">
                    <DispatchInfo >
                            <Resources>
                            <MainPath>./plugin/fcm.xml</MainPath>
                            </Resources>
                            <Lifecycle>
                            <AutoVisible>true</AutoVisible>
                            </Lifecycle>
                            <UI>
                                <Type>ModalDialog</Type>
                                <Menu>CreateJS</Menu>
                                <Geometry>
                                     <Size>
                                           <Height>200</Height>
                                           <Width>200</Width>
                                     </Size>
                                 </Geometry>
                             </UI>
                    </DispatchInfo>
        </Extension>
        <Extension Id="PublishSettingsID">
                    <DispatchInfo >
                            <Resources>
                            <MainPath>./index.html</MainPath>
                            </Resources>
                            <Lifecycle>
                                    <AutoVisible>true</AutoVisible>
                            </Lifecycle>
                            <UI>
                                    <Type>ModalDialog</Type>
                                    <Menu>Publish Settings</Menu>
                                    <Geometry>
                                         <Size>
                                                <Height>170</Height>
                                                 <Width>486</Width>
                                          </Size>
                                    </Geometry>
                            </UI>
                    </DispatchInfo>
           </Extension>
</DispatchInfoList>
     
  1. 對於包含 .dll 或 .plugin 檔案的擴充功能,您可以忽略 MainPath 標籤以外的所有標籤。MainPath 標籤包含相對於 ExtensionContent 資料夾的檔案 fcm.xml 路徑。您必須將 .dll 檔案重新命名為 .fcm,並放在 win 資料夾內,fcm.xml 旁邊。同樣地,如果您在 Mac 環境工作,請將 .plugin 檔案重新命名為 .fcm.plugin,並放在 mac 資料夾內,fcm.xml 旁邊。
  2. 用來設定發佈設定使用者介面的 HTML 擴充功能,是 Animate 的 HTML 擴充功能。若要深入了解 Animate 的 HTML 擴充功能,請參閱建立 HTML 擴充功能
  3. 確認 Host 標籤中版本屬性較低的值為 14.1,即具有自訂平台支援的 Animate CC 的最低 (內部) 版本。

<ExecutionEnvironment>
<HostList>
<Host Name="FLPR" Version="15.0" />
</HostList>.
.
.
</ExecutionEnvironment>
     
  1. 切換至「Script Explorer」(指令碼總管) 檢視,以滑鼠右鍵按一下您的專案,並選擇「Export > Adobe Extension Builder 3 > Application Extension」(匯出 > Adobe Extension Builder 3 > 應用程式擴充功能)。「Export Wizard」(匯出精靈) 隨即顯示。
  2. 您必須擁有憑證才能簽署擴充功能套件。瀏覽到現有憑證,或按一下「Create」(建立) 以建立新憑證。
  3. 按一下「Finish」(完成) 以編譯專案。Eclipse 隨即產生副檔名為 .zxp 的插件檔案,以供您裝載在 Adobe Add-ons 網站上。

散佈您的自訂平台支援插件

您可以將自訂平台支援插件裝載在 Adobe Add-ons 頁面,藉此散佈並獲利。您的插件套件將經過 Adobe 審核及核准程序,然後才會列在頁面中。您可以依照下列方式裝載插件:

  1. 使用您的 Adobe 使用者 ID 和密碼登入 Adobe Add-ons 頁面。
  2. 在左側面板的「成為製作人」下方,按一下連結前往製作人入口網站
  3. 如果您尚未註冊成為製作人,請按一下「Sign-up」(註冊) 按鈕。
  4. 如需有關如何註冊成為製作人及裝載插件的詳細指示,請參閱製作人入口網站快速入門
  5. 依照快速入門頁面所述,完成製作人入口網站工作流程中的下列步驟。
    1. 以單一檔案封裝您的產品。
    2. 輸入產品相關資訊並上傳檔案。
    3. 加入行銷資源。
    4. 預覽您的產品。
    5. 提交您的產品,以供核准。
  6. 核准之後,您的插件就會列在 Add-ons 頁面的 Animate 產品類別下方。

註解:

 

功能要求和錯誤報告

如果您要傳送任何問題、疑慮、產品錯誤或功能要求給 Animate 產品團隊,請填寫下列表格:

Adobe 功能要求和錯誤報告表格

此産品由 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 授權  Creative Commons 條款未涵蓋 Twitter™ 與 Facebook 文章。

法律說明   |   線上隱私權政策