Dynamic Media與OpenAPI功能的整合 integrate-asset-selector-dynamic-media-open-apis
Asset Selector可讓您使用各種Adobe應用程式進行整合,好讓他們順暢地共同作業。
先決條件 prereqs-polaris
如果您整合Asset Selector與Dynamic Media以及OpenAPI功能,請使用下列先決條件:
Dynamic Media與OpenAPI功能的整合 adobe-app-integration-polaris
Asset Selector與Dynamic Media OpenAPI程式的整合涉及各種步驟,包括建立自訂的動態媒體URL或準備挑選動態媒體URL等。
整合 Dynamic Media 的資產選擇器與 OpenAPI 功能 integrate-dynamic-media
rootPath
和path
屬性不應該是具有OpenAPI功能的Dynamic Media的一部分。 您可以改為設定aemTierType
屬性。 以下是設定的語法:
aemTierType:[1: "delivery"]
此設定可讓您檢視所有核准的資產,而不使用資料夾或以平面結構檢視。 如需詳細資訊,請導覽至資產選擇器屬性下的aemTierType
屬性。
從已核准的資產建立動態傳送URL create-dynamic-media-url
設定「資產選擇器」後,系統會使用物件的結構描述,從選取的資產建立動態傳送URL。
例如,從選取資產時收到的物件陣列中的一個物件的結構描述:
{
"dc:format": "image/jpeg",
"repo:assetId": "urn:aaid:aem:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"repo:name": "image-7.jpg",
"repo:repositoryId": "delivery-pxxxx-exxxxxx.adobe.com",
...
}
所有選取的資產都由做為JSON物件的handleSelection
函式執行。 例如 JsonObj
。動態傳遞URL是透過結合以下電信業者來建立:
assetJsonObj["repo:repositoryId"]
/adobe/dynamicmedia/deliver
assetJsonObj["repo:assetId"]
assetJsonObj["repo:name"].split(".").slice(0,-1).join(".")
.jpg
核准的資產傳送API規格 approved-assets-delivery-api-specification
URL格式:https://<delivery-api-host>/adobe/dynamicmedia/deliver/<asset-id>/<seo-name>.<format>?<image-modification-query-parameters>
其中,
- 主機為
https://delivery-pxxxxx-exxxxxx.adobe.com
- API根目錄為
"/adobe/dynamicmedia/deliver"
<asset-id>
為資產識別碼<seo-name>
為資產名稱<format>
為輸出格式<image modification query parameters>
為核准資產的傳遞API規格所支援
核准的資產傳送API approved-assets-delivery-api
動態傳送URL擁有下列語法:https://<delivery-api-host>/adobe/assets/deliver/<asset-id>/<seo-name>
,其中,
- 主機為
https://delivery-pxxxxx-exxxxxx.adobe.com
- 原始轉譯傳遞的API根為
"/adobe/assets/deliver"
<asset-id>
為資產識別碼<seo-name>
為具有或不具有副檔名的資產名稱
準備挑選動態傳遞URL ready-to-pick-dynamic-delivery-url
所有選取的資產都由做為JSON物件的handleSelection
函式執行。 例如 JsonObj
。動態傳遞URL是透過結合以下電信業者來建立:
assetJsonObj["repo:repositoryId"]
/adobe/assets/deliver
assetJsonObj["repo:assetId"]
assetJsonObj["repo:name"]
以下是遍歷JSON物件的兩種方式:
-
縮圖: 縮圖可為影像,資產為PDF、視訊、影像等。 不過,您可以使用資產縮圖的高度和寬度屬性作為動態傳送轉譯。
下列轉譯集可用於PDF型別資產:
在sidekick中選取PDF後,選取內容會提供以下資訊。 以下為遍歷JSON物件的方式:您可以在上方熒幕擷圖中,參考
selection[0].....selection[4]
以取得一系列轉譯連結。 例如,其中一個縮圖轉譯的關鍵屬性包括:code language-none { "height": 319, "width": 319, "href": "https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/as/algorithm design.jpg?accept-experimental=1&width=319&height=319&preferwebp=true", "type": "image/webp" }
在上述熒幕擷圖中,如果需要PDF,而非其縮圖,則需要將PDF原始轉譯的傳送URL合併到目標體驗中。 例如 https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/original/as/algorithm design.pdf?accept-experimental=1
-
影片: 您可以使用內嵌iFrame的影片型別資產,使用影片播放器URL。 您可以在目標體驗中使用下列陣列轉譯:
code language-none { "height": 319, "width": 319, "href": "https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/as/asDragDrop.2.jpg?accept-experimental=1&width=319&height=319&preferwebp=true", "type": "image/webp" }
您可以在上方熒幕擷圖中,參考
selection[0].....selection[4]
以取得一系列轉譯連結。 例如,其中一個縮圖轉譯的關鍵屬性包括:上述熒幕擷取畫面中的程式碼片段為視訊資產的範例。 其中包含轉譯連結陣列。 摘錄中的
selection[5]
是影像縮圖的範例,可做為目標體驗中視訊縮圖的預留位置。 轉譯陣列中的selection[5]
適用於視訊播放器。 這提供一個HTML,可設為iframe的src
。 它支援自我調整位元速率串流,這是網頁最佳化的視訊傳送方式。在上述範例中,視訊播放器URL為
https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/play?accept-experimental=1
設定自訂篩選器 configure-custom-filters-dynamic-media-open-api
Dynamic Media的資產選擇器搭配OpenAPI功能,可讓您設定自訂屬性以及基於這些屬性的篩選器。 filterSchema
屬性是用來設定這類屬性。 自訂可公開為metadata.<metadata bucket>.<property name>.
,以便針對其設定篩選器,其中,
metadata
是資產的資訊embedded
是用於設定的靜態引數,並且<propertyname>
是您正在設定的篩選器名稱
對於設定,定義在jcr:content/metadata/
層級的屬性會針對您要設定的篩選器,公開為metadata.<metadata bucket>.<property name>.
。
例如,在具有OpenAPI功能的Dynamic Media資產選擇器中,asset jcr:content/metadata/client_name:market
上的屬性會針對篩選器設定轉換為metadata.embedded.client_name:market
。
若要取得名稱,必須完成一次性活動。 對資產發出搜尋API呼叫,並取得屬性名稱(基本上是貯體)。
具OpenAPI功能的Dynamic Media資產選擇器使用者介面 interface-dynamic-media-open-api
與Adobe的微前端資產選擇器整合後,您只能看到Experience Manager資產存放庫中所有已核准資產的結構。