[AEM Assets]{class="badge positive" title="適用於AEM Assets)。"}

具有 OpenAPI 功能的 Dynamic Media 常見問題 new-dynaminc-media-apis-frequently-asked-questions

Dynamic Media具有​ OpenAPI (開放式應用程式設計介面) ​功能,可透過標準化的開發人員友善API端點,傳送、轉換及管理豐富媒體資產(影像、視訊及其他視覺內容)。 此常見問題指南會回答關於這些功能如何運作、其啟用什麼以及如何採用這些功能的最常見問題。

什麼是Dynamic Media具有OpenAPI功能? what-are-dynamic-media-openapi-capabilities

Dynamic Media是一組媒體交付和轉換服務,可自動最佳化、調整任何裝置、頻道或畫面的資產大小及轉譯資產。 OpenAPI功能​透過開放、完整記錄的API規格來公開這些服務,讓開發人員可以將媒體傳遞直接整合到他們自己的應用程式、店面和內容體驗中。

因為介面遵循OpenAPI標準,所以是自我說明且可預測的。 因此,整合團隊可以發現可用的端點、瞭解請求和回應格式,並比使用專有的、未記載的介面更快地產生使用者端代碼。

主要優點 key-benefits

Dynamic Media與OpenAPI功能的主要優點包括:

  • 標準化整合:​符合OpenAPI規範的端點可讓媒體服務直接連線到現有的應用程式和工具鏈。
  • 隨選媒體轉換: Assets在要求時最佳化、調整大小及重新格式化,不需要儲存多個手動變體。
  • 多管道傳送:​單一資產可以透過網路、行動裝置和連線的體驗來傳送和調整。
  • Headless就緒架構: API優先傳送與Headless及可撰寫的技術棧疊一致。
  • 更快開發:​自我說明規格可加速整合團隊的上線、使用者端程式碼產生和測試。

Dynamic Media OpenAPI功能可以做什麼? what-can-i-do

您可以要求媒體資產、套用即時轉換(例如裁切、調整大小和格式轉換),以及將最佳化內容傳送至網路、行動裝置和連線的體驗 — 所有這些都透過標準化的API呼叫完成。

OpenAPI功能與傳統Dynamic Media傳送有何不同? openapi-vs-traditional

傳統傳遞方式需仰賴預設的URL模式和範本。 OpenAPI功能新增了標準化的程式化介面,使自動化、自訂整合和Headless (分離式前端)架構更容易實施。

這些功能是否適用於Headless與可撰寫的架構? headless-composable

可以。 因為媒體是透過API (而非固定頁面範本)擷取和轉換,Dynamic Media OpenAPI功能自然適合於Headless內容管理和可撰寫的商務設定,在這裡,展示層與內容和服務分開。

我需要開發人員資源才能使用這些功能嗎? developer-resources

API型整合通常涉及開發人員將端點連線至應用程式。 不過,OpenAPI規格透過提供一致、機器可讀的定義(支援自動化使用者端產生和測試)來減少這項工作量。

否。 使用​ 具有OpenAPI功能的Dynamic Media ​時,只有​ 已核准和最新版本的資產 ​可供搜尋和傳遞。 尚未核准或僅存在於舊版修訂的Assets會從此搜尋與傳送範圍中排除。

兩個條件控管Experience Manager Assets as a Cloud Service存放庫中的資產是否出現:

  • 核准狀態 — 資產必須標籤為已核准。 仍在草稿中或等待稽核的Assets不會公開以供搜尋和傳遞。
  • 版本貨幣 — 只有核准資產的​ 最新版本 ​才適用。 系統不會傳回取代或歷史版本。

此範圍設定是有意為之。 因為只有已核准、目前資產符合資格,所以傳遞僅限於通過治理檢閱的內容,這可​確保所有管道和應用程式的品牌一致性。 因此,透過Dynamic Media使用OpenAPI功能使用資產的下游體驗會可靠地參考經過審查的最新內容,而不是未經核准或過時的修訂版本。

管理員如何將新增至資料夾的新資產和現有資產標記為已核准? add-assets-to-folder-as-approved

管理員會設定資料夾進行大量核准,然後重新處理任何預先存在的資產,以將資料夾中的新資產和現有資產標籤為已核准。 在Adobe Experience Manager (AEM) Assets中,資產的狀態是由​ jcr:content/metadata/dam:status ​屬性所控管。 此屬性可控制是否將資產視為整個資產庫中的可用、已封鎖或待修訂專案。

此屬性的值為:

  • 已核准 — 資產已驗證且可供使用,並在資產卡上以已核准圖示標幟。

  • 已拒絕 — 資產已封鎖,且已以已拒絕的指標標幟。

  • 要求的變更 — 資產需要修訂,而且處理方式與拒絕的資產相同。

AEM Assets會使用資產卡上可用的已核准圖示來區分​ 已核准 ​狀態,如下圖管理員和資產檢視所示:

管理員視圖

管理員視圖中的已核准資產

資產視圖

資產視圖中的已核准資產

若要核准資料夾中的所有資產,請參閱如何大量核准資料夾中的資產相關指示。 還有一段影片說明整個過程。

設定用於大量核准的資料夾後,所有新增至該資料夾的新資產都會自動獲得核准。 這可確保資料夾的核准狀態一致,無需手動稽核每次新上傳。 所有現有資產只有在重新處理後才核准,因為重新處理會針對資料夾的大量核准設定重新評估dam:status屬性。 請參閱重新處理數位資產以了解有關如何重新處理資產的指示。 如果管理員從任何其他資料夾複製或移動未核准的資產,他們必須重新處理資產,以便移動的資產繼承核准狀態。

每當管理員指定​ Rejected ​或​ Changes requested ​值時,AEM Assets就會將資產標示為​Rejected,因為這兩個值都代表未核准的狀態。 AEM Assets會使用「管理員」檢視中資產卡上可用的 拒絕Assets 來區分「已拒絕」狀態。

同樣地,AEM Assets會使用資產卡上的下列已拒絕狀態,在Assets檢視中區分「已拒絕」狀態:

資產視圖中的已拒絕資產

Adobe IMS (Adobe Identity Management Services)使用者和群組ID是從Adobe的​ Admin Console ​擷取,並套用至Experience Manager Assets Admin view,以設定可保護傳遞和搜尋體驗的角色。 根據這些IMS使用者或群組ID指派角色,可確保只有授權的身分才能存取、傳遞或搜尋特定資產。 由於資產層級的存取是由這些身分所控管,因此使用正確的IMS ID是Experience Manager中角色型安全性的基礎步驟。

需要存取​ Experience Manager Author ​環境的使用者在Adobe的​ Admin Console ​中被管理為​Adobe IMS使用者。 如需有關何謂 Adobe IMS 使用者,以及如何在 Admin Console 中加以存取和管理的資訊,請參閱 Adobe IMS 使用者。

IMS身分如何對應到資產角色:

  • Adobe IMS使用者​代表在Adobe的​ Admin Console ​中集中布建和管理的人員,可為Adobe Experience Cloud應用程式中的身分提供單一信任來源。
  • Adobe IMS群組​允許將多個使用者一起管理,因此角色和許可權可以一致地套用至一個群組,而不是分別套用至每個使用者。
  • 從Admin Console取得的​ 使用者ID ​或​ 群組ID ​是在設定資產上的角色、將傳遞和搜尋許可權直接繫結至已知的受管理身分時參考的值。

由於傳送和搜尋體驗是由資產上設定的角色所控管,因此從Admin Console擷取正確的Adobe IMS使用者或群組ID至關重要。 此方法可集中管理身分、降低未經授權存取資產的風險,並維持許可權與整個Adobe環境中已管理身分的方式一致。

可以同時核准一個資料夾內的多項資產嗎? approve-multiple-assets-in-folder

可以。 Adobe Experience Manager (AEM) Assets可讓使用者同時核准資料夾中的多個資產,而不需個別核准每個檔案。 大量核准可簡化檢閱工作流程,並可在管理大型資產庫時節省相當長的時間,因為​ 已核准 ​檢閱狀態會套用至單一動作中選取的每個資產。

根據您使用的介面,支援的方法有兩種: Assets管理檢視​或​Assets檢視。

在Assets管理檢視中核准多個資產

執行以下步驟即可在 Experience Manager Assets Admin view 中同時核准多項資產:

  1. 選取資產,然後按一下「屬性」。
  2. 在「基本」索引標籤中,向下捲動至「審查狀態」。
  3. 將審查狀態變更為「已核准」。
  4. 按一下「儲存並關閉」。

如此會一次將​ 已核准 ​稽核狀態套用至每個選取的資產,並在單一步驟中確認及關閉變更。

在Assets檢視中核准多個資產

同樣地,若要在 Assets 視圖中的資料夾內同時核准多項資產:

  1. 選取資產,然後按一下「大量中繼資料編輯」。

  2. 在右側面板「屬性」區段內提供的「狀態」欄位中,選取「已核准」。

  3. 按一下「儲存」。

按一下「儲存」​​會同時將​ 已核准 ​狀態認可到所有選取的資產,確保資料夾中的檢閱狀態一致。

如何確保資產傳遞和支援 OpenAPI 之 Dynamic Media 的搜尋? secure-asset-delivery

Adobe Experience Manager中的​ 中央資產控管 ​可讓​ 數位資產管理(DAM)管理員 ​和​ 品牌管理員 ​直接控制誰可以存取透過​ OpenAPI (開放式應用程式設計介面) ​傳遞的資產。 此治理模型透過在來源強制存取規則,因此僅授權使用者可擷取受保護的內容,從而確保資產搜尋和資產傳送的安全。

這些管理員會使用兩個主要控制項,限制編寫端的存取權,尤其是對​ AEM as a Cloud Service編寫執行個體 ​的存取權:

  • 角色組態:​根據指派的角色授與或拒絕存取權,確保每個使用者或群組只能看到其許可權允許的資產。
  • 啟用和停用排程:​管理員為已核准的資產設定精確的啟用和停用時間,因此內容會根據定義的發佈期間自動變成可用或撤銷。

由於這些控制項會套用至編寫層級,因此會控管每個下游請求。 搜尋資產或使用傳遞URL的一般使用者,只有在成功通過授權程式後,才會收到受限制的資產。 系統會封鎖授權失敗的請求,避免在知道傳遞URL時進行未授權的擷取。 這可確保DAM管理員和品牌管理員所做的治理決策在搜尋結果和直接傳送連結中一致執行。

如需更多資訊,請參閱限制存取 Experience Manager 中的資產。

如何取得編輯資產核准狀態的權限? permissions-edit-approval-status

若要取得編輯資產核准狀態的許可權,管理員必須授與對套用至資產資料夾的中繼資料結構描述中​ 檢閱狀態 ​欄位的編輯存取權。 身為數位資產管理(DAM)使用者,依預設,您可能沒有核准資產的許可權,因為核准和稽核狀態編輯是在中繼資料結構描述層級控制,而非透過一般資料夾存取控制。

管理員可依照下列步驟啟用此存取權:

  1. 開啟​ 預設中繼資料結構 ​或套用至相關資產資料夾的任何其他中繼資料結構。
  2. 在該結構描述中找到​ 檢閱狀態 ​欄位。
  3. 提供​ 檢閱狀態 ​欄位的編輯許可權。

授與編輯許可權給​ 檢閱狀態 ​欄位可確保指定的DAM使用者可以直接變更資產的核准狀態,精簡檢閱工作流程。 如需更多資訊,請參閱如何停用「核准狀態」欄位的編輯。

支援的影片檔案大小為何? supported-file-formats-videos

具有OpenAPI功能的Dynamic Media支援長格式視訊,檔案大小上限為​50 GB,每個視訊的最長持續時間為​2小時。 這些限制定義了單一視訊上傳的上限,允許提供完整長度的內容,例如錄製的網路研討會、訓練課程、產品示範和延伸簡報,而不將視訊分割成較短的區段。

由於Dynamic Media可容納大小達​ 50 GB ​的檔案,因此可以上傳及串流高解析度及高位元速率影片,同時保留品質。 2小時​的持續時間上限可確保長格式資產能容納在單一連續檔案中,進而簡化檢視者的內容管理及播放。

具有 OpenAPI 功能的 Dynamic Media 與 Dynamic Media 解決方案有何不同? dynamic-media-and-dynamic-media-with-openapi-differences

具備OpenAPI功能的Dynamic Media與Dynamic Media是截然不同的解決方案,各自提供專屬的傳送功能。 徹底檢閱您的特定需求,以決定最符合您需求的解決方案。

Adobe的一般指導方針是將Dynamic Media與OpenAPI (開放式應用程式設計介面)棧疊用於任何整合使用案例,無論它們涉及第一方或第三方應用程式。 由於這兩個棧疊使用不同的URL結構,請使用以下決定規則來選擇正確的方法:

  • 現有的整合:​如果與Dynamic Media棧疊的整合已經存在,請勿變更,因為OpenAPI棧疊URL的結構不同。
  • 全新整合:​對於任何全新整合的使用案例,請利用OpenAPI棧疊。
  • 進階修飾元:​如果您的使用案例需要進階修飾元,而OpenAPI棧疊尚未提供進階修飾元,請避免OpenAPI棧疊,直到Adobe彌合差距為止。
  • 基本原生傳遞:​即使是來自Adobe Experience Manager (AEM) Assets Cloud Services的基本原生傳遞,只要您的使用案例包含在OpenAPI棧疊提供的修飾詞中,就可以評估OpenAPI棧疊。

總而言之,視使用案例的性質而定,Dynamic Media和具有OpenAPI棧疊的Dynamic Media可以共存。

以下是具有 OpenAPI 功能的 Dynamic Media 與 Dynamic Media 之間的一些主要差異:

具有 OpenAPI 功能的 Dynamic Media
Dynamic Media
僅適用於 Assets as a Cloud Service
也可以搭配內部部署或 Adobe Managed Services 使用,但需要額外的設定和佈建步驟。
豐富的影像修飾元組支援,例如寬度、高度、旋轉、翻轉、品質和格式
豐富的可用影像修飾元
根據使用者、角色、日期和時間來限制資產傳遞
所有使用者都可以存取發佈到 Dynamic Media 的資產
大部分開發人員都熟悉​OpenAPI規格,這是廣泛採用的API描述標準。 使用內容建議程式,Adobe Experience Manager (AEM) Assets的擴充性變得非常簡單。
以SOAP (Simple Object Access Protocol)為基礎的API,這會在開發整合自訂功能時成為一個障礙。
在數位資產管理(DAM)中對已核准資產所做的任何變更(包括版本更新和中繼資料修改),都會自動反映在傳送URL中。 透過內容傳遞網路(CDN)為Dynamic Media設定OpenAPI功能的短​存留時間(TTL)值為10分鐘,在​之內,所有編寫和發佈的介面便都能看到更新,10分鐘內。
10小時​的建議CDN TTL。 您可以使用快取失效動作來覆寫 TTL 值。
只有已核准的資產可用於將資產傳送至下游應用程式,以在數位體驗中啟用品牌上已核准的資產。
Dynamic Media已發佈資產的任何更新都會在未經核准工作流程的情況下自動發佈,因此無法確保在數位體驗中經過品牌核准的資產。
以傳遞資產數量為依據的使用情況報告。 此功能即將推出。
使用情況報告尚無法使用。 此功能即將推出。
下游應用程式無法再使用Assets as a Cloud Service存放庫上標示為過期的Assets。
沒有固有的資產到期時間。 資產從 AEM as a Cloud Service 存放庫中刪除之前,會一直保持公開狀態。
不支援影片智慧裁切功能。
支援影片智慧裁切功能。
動態視訊編碼​可確保根據輸入視訊提供最佳編碼,因此不需要安裝原生視訊傳送。
不論輸入視訊為何,Standard 3都會對​進行編碼,這可能會影響視訊傳送效能。 您必須手動設定不同視訊位元速率的不同編碼。
啟用使用資產UID 的安全​模糊化URL,而不會影響搜尋引擎最佳化(SEO)。
URL模糊化僅適用於URL查詢引數。 可辨識URL中的資產ID (資產名稱)。

具有 OpenAPI 功能的 Dynamic Media 如何解決已連線資產功能的限制? dynamic-media-openapi-addresses-connected-assets-limitations

具備OpenAPI功能的Dynamic Media克服連線Assets功能的核心限制,消除二進位複製、支援所有AEM Assets格式型別(包括視訊)、移除四執行個體連線限制、啟用可擴充的自訂整合,並提供近乎即時的資產更新。 下列表格概述了兩種解決方案之間的主要區別:

具有 OpenAPI 功能的 Dynamic Media
已連線資產
AEM as a Cloud Service提供遠端數位資產管理(DAM)部署的Assets。
遠端 DAM 部署上的資產可在 AEM as a Cloud Service 或 Adobe Managed Services 上使用。
當遠端DAM部署中的資產可在AEM Sites執行個體上使用時,資產二進位檔​ 不會 ​複製。 由於二進位檔會保留在來源中,這可避免重複儲存空間,並為每個資產保留單一信任來源。
遠端DAM部署中的資產可在AEM Sites執行個體上使用時,系統會複製資產二進位檔。
支援AEM Assets所支援的​所有資產格式型別,包括視訊。
不支援影片。
您可以從遠端DAM部署擷取資產時,在本機Sites部署上使用動態媒體。
本機Sites部署上的Dynamic Media為唯讀。
連線到遠端DAM部署的AEM Sites執行個體數目沒有限制。 您可以為遠端DAM上核准的資產設定角色🔗,以限制對Sites執行個體上資產的存取。
限制將​ 不超過4個AEM Sites執行個體 ​連線到遠端DAM部署。 數量增加需要額外的測試。
內容顧問和具有OpenAPI功能的Dynamic Media都是​可擴充的,以允許自訂整合。
連線的Assets API 不可擴充,以允許自訂整合。
對遠端DAM部署上可用的已核准資產所做的任何變更(包括版本更新和中繼資料修改),都會在10分鐘的短​存留時間(TTL)值內自動反映在Sites執行個體上。
遠端DAM部署上的資產更新會透過生命週期事件自動處理,但與具有OpenAPI功能的Dynamic Media相比,需要更多時間。
遠端DAM上的資產中繼資料也可在AEM Sites例項上使用。
遠端DAM上的資產中繼資料在AEM Sites例項上無法使用。

一些修飾元被標記為「可用性受限」。 我要如何開始使用? use-limited-availability-modifiers

有限可用性修飾元需要明確啟用您的帳戶,才能用於生產環境。 Adobe預設不會啟用這些修飾元,因此您必須透過Adobe支援請求存取權。 此程式包含兩個步驟:開啟支援案例並提供身分識別詳細資訊,Adobe需要這些詳細資訊來布建要求的功能。

為了使生產時能在您的帳戶使用可用性受限的修飾元:

  1. 使用 Admin Console 建立 Adobe 支援案例。

  2. 在Adobe支援案例中提及下列詳細資料,讓Adobe可以識別您的組織並布建要求的功能:

    • IMS組織 (Identity Management系統組織識別碼)

    • 要啟用的修飾元清單

  3. 提交案例,並等待Adobe支援確認已為您的IMS組織啟用請求的有限可用性修飾元。Adobe確認啟用後,指定的修飾元即可在您的帳戶上用於生產。

如何測試實驗性修飾元? modifiers-not-generally-available

實驗API可讓您測試任何尚未普遍可用的修飾元。 實驗(或測試版) API可讓開發人員提早存取仍在評估中的功能,以便您可以在新修飾元升級至穩定(一般可用)集之前先驗證這些修飾元。 這可讓您試用即將推出的功能、確認其在工作流程中的行為如預期,並在一般版本之前提供意見回饋。

若要測試一般不提供的修飾元,請透過實驗API路徑叫用它。 例如:

</adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>

expires-YYYYMMDD區段表示實驗修飾元是時間限制的,表示實驗版本預計變更或到期的日期,提醒您一旦發行後要移轉至一般可用的對等專案。

如需叫用這些端點的詳細資訊,請參閱如何使用實驗API的指南。 若要識別哪些修飾元可供使用,請參閱修飾元完整清單。

另請參閱

recommendation-more-help
experience-manager-cloud-service-help-main-toc