Internt i ett anpassat program

Senast uppdaterad: 14 oktober 2025

Skapat för:

  • Utvecklare

Använd följande bild för att förstå hela arbetsflödet när en digital resurs bearbetas med ett anpassat program av en klient.

Anpassat programarbetsflöde

Bild: Steg som används vid bearbetning av en resurs med Adobe Asset Compute Service.

Registrering

Klienten måste anropa /register en gång före den första begäran till /process så att den kan ställa in och hämta journal-URL:en för att ta emot Adobe I/O Events -händelser för Adobe Asset Compute.

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"

JavaScript-biblioteket @adobe/asset-compute-client kan användas i NodeJS-program för att hantera alla nödvändiga steg från registrering, bearbetning till asynkron händelsehantering. Mer information om obligatoriska rubriker finns i Autentisering och auktorisering.

Bearbetar

Klienten skickar en bearbetningsbegäran.

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>

Klienten ansvarar för att formatera återgivningarna korrekt med försignerade URL:er. JavaScript-biblioteket @adobe/node-cloud-blobstore-wrapper kan användas i NodeJS-program för att försignera URL:er. För närvarande stöder biblioteket endast Azure Blob Storage och AWS S3 Containers.

Bearbetningsbegäran returnerar en requestId som kan användas för avsökning av Adobe I/O-händelser.

Nedan följer ett exempel på en anpassad begäran om programbearbetning.

{
    "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 skickar begäranden om anpassade programåtergivningar till det anpassade programmet. Den använder en HTTP POST till den angivna program-URL:en, som är den skyddade webbåtgärds-URL:en från App Builder. Alla förfrågningar använder HTTPS-protokollet för att maximera datasäkerheten.

Asset Compute SDK som används av ett anpassat program hanterar HTTP POST-begäran. Det hanterar också hämtning av källan, överföring av återgivningar, sändning av Adobe I/O Events och felhantering.

Programkod

Anpassad kod behöver bara tillhandahålla ett återanrop som tar den lokalt tillgängliga källfilen (source.path). rendition.path är platsen där det slutliga resultatet av en resursbearbetningsbegäran ska placeras. Det anpassade programmet använder återanropet för att omvandla de lokalt tillgängliga källfilerna till en återgivningsfil med det namn som skickades (rendition.path). Ett anpassat program måste skriva till rendition.path för att skapa en återgivning:

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);
});

Hämta källfiler

Ett anpassat program hanterar bara lokala filer. Asset Compute SDK hanterar nedladdningen av källfilen.

Skapa återgivning

SDK anropar en asynkron återgivningscallback-funktion för varje återgivning.

Callback-funktionen har åtkomst till objekten source och rendition. source.path finns redan och är sökvägen till den lokala kopian av källfilen. rendition.path är sökvägen där den bearbetade återgivningen måste lagras. Om inte flaggan disableSourceDownload anges måste programmet använda exakt rendition.path. Annars kan inte SDK hitta eller identifiera återgivningsfilen och misslyckas.

Den alltför enkla framställningen av exemplet görs för att illustrera och fokusera på anatomin i ett anpassat program. Programmet kopierar bara källfilen till återgivningsmålet.

Mer information om återgivningens återanropsparametrar finns i Asset Compute SDK API.