自訂應用程式的內部結構
使用下圖來瞭解當使用者端使用自訂應用程式處理數位資產時的端對端工作流程。
圖：使用AdobeAsset Compute Service處理資產時涉及的步驟。
註冊
使用者端必須先呼叫/register一次，才能在第一次對/process發出要求之前，設定並擷取分錄URL，以接收AdobeAsset compute的AdobeI/O Events事件。
curl -X POST \
https://asset-compute.adobe.io/register \
-H "x-ims-org-id: $ORG_ID" \
-H "x-gw-ims-org-id: $ORG_ID" \
-H "Authorization: Bearer $JWT_TOKEN" \
-H "x-api-key: $API_KEY"
@adobe/asset-compute-client JavaScript程式庫可用於NodeJS應用程式，以處理從註冊、處理到非同步事件處理的所有必要步驟。 如需必要標頭的詳細資訊，請參閱驗證和授權。
處理中
使用者端傳送處理要求。
curl -X POST \
https://asset-compute.adobe.io/process \
-H "x-ims-org-id: $ORG_ID" \
-H "x-gw-ims-org-id: $ORG_ID" \
-H "Authorization: Bearer $JWT_TOKEN" \
-H "x-api-key: $API_KEY" \
-d "<RENDITION_JSON>
使用者端負責使用預先簽署的URL正確格式化轉譯。 @adobe/node-cloud-blobstore-wrapper JavaScript程式庫可用於NodeJS應用程式，以預先簽署URL。 目前資料庫僅支援Azure Blob儲存和AWS S3容器。
處理要求傳回可用於輪詢Adobe I/O事件的requestId。
以下為範例自訂應用程式處理請求。
{
"source": "https://www.adobe.com/some-source-file.jpg",
"renditions" : [
{
"worker": "https://my-project-namespace.adobeioruntime.net/api/v1/web/my-namespace-version/my-worker",
"name": "rendition1.jpg",
"target": "https://some-presigned-put-url-for-rendition1.jpg",
}
],
"userData": {
"my-asset-id": "1234567890"
}
}
Asset Compute Service傳送自訂應用程式轉譯要求給自訂應用程式。 它會使用HTTPPOST連線提供的應用程式URL，這是來自App Builder的安全網路動作URL。 所有要求都會使用HTTPS通訊協定，以提升資料安全性。
自訂應用程式使用的Asset computeSDK會處理HTTPPOST要求。 它也會處理來源下載、上傳轉譯、傳送AdobeI/O Events和錯誤處理。
應用程式程式碼
自訂程式碼只需要提供取用本機可用原始程式檔(source.path)的回呼。 rendition.path是放置資產處理請求之最終結果的位置。 自訂應用程式會使用回呼，使用傳入的名稱(rendition.path)，將本機可用的來源檔案轉換為轉譯檔案。 自訂應用程式必須寫入rendition.path才能建立轉譯：
const { worker } = require('@adobe/asset-compute-sdk');
const fs = require('fs').promises;
// worker() is the entry point in the SDK "framework".
// The asynchronous function defined is the rendition callback.
exports.main = worker(async (source, rendition) => {
// Tip: custom worker parameters are available in rendition.instructions.
console.log(rendition.instructions.name); // should print out `rendition.jpg`.
// Simplest example: copy the source file to the rendition file destination so as to transfer the asset as is without processing.
await fs.copyFile(source.path, rendition.path);
});
下載來源檔案
自訂應用程式只會處理本機檔案。 Asset computeSDK會處理來源檔案的下載。
建立轉譯
SDK會呼叫每個轉譯的非同步轉譯回呼函式。
回呼函式可以存取來源和轉譯物件。 source.path已經存在，而且是來源檔案的本機復本路徑。 rendition.path是必須儲存已處理轉譯的路徑。 除非已設定disableSourceDownload旗標，否則應用程式必須完全使用rendition.path。 否則，SDK將無法找到或識別轉譯檔案，並會失敗。
範例的過度簡化是為了說明和專注於自訂應用程式的剖析。 應用程式只會將來源檔案複製到轉譯目的地。
如需有關轉譯回呼引數的詳細資訊，請參閱Asset computeSDK API。
上傳轉譯
在建立每個轉譯並儲存在rendition.path提供路徑的檔案中後，Asset computeSDK會將每個轉譯上傳至雲端儲存空間(AWS或Azure)。 若且唯若傳入請求具有多個指向相同應用程式URL的轉譯時，自訂應用程式才會同時取得多個轉譯。 上傳至雲端儲存空間會在每個轉譯之後以及下一個轉譯的執行回呼之前完成。
batchWorker()有不同的行為。 它會處理所有轉譯，並在所有轉譯均已處理完畢後上傳它們。