How to use assetstreamer (stream qualities / download source file)

Owned by Lasse Brønnum Brønsholt (Unlicensed)
Last updated: Sept 27, 2023 by Brian Bak Laursen
3 min read

This is a short guid of how to use assetstreamer.aspx

Instructions

When you want to stream qualities, use this:

Where:

  • [DAMURL] is the URL of the DAM Center (remember http/https)
  • [AssetId] is the assetId you want to stream
  • [MediaFormatId] is the formatId of the quality you want to download
  • [DestinationId] is the destination (child if using SM)
  • [AccessKey] is a valid accesskey generated (e.g. from user/password through the API (Connect-service))


This only applies to qualities of an asset you have R access to and that are actual qualities on the Frontend.Data destination(s).


To download an assets source file, use this:


Notice

The below resizing is working only in 5.6 and also subject to change in near future (Q3-Q4 in 2022)


PLEASE be aware of using on demand resizing with too large files. If you have larger files for resize and crop then use specific pre-generated media formats instead.


Do you need dynamic or on-demand resize?

We have a solution for you which must be used together with a CDN. 

Please contact Digizuite for getting the resize URL but here follows a explanation:

To add resizing then you can add the following

  • These parameters can be added to the above:
    • Mandatory
      • function=resize
      • mimeType: The format to store image in such as image/jpeg or image/png
      • destinationid must aslo be present always
    • Optional for resize:
      • Height: New height of image as number (or when used with x, y or gravity then it becomes the height around the focal point)
      • Width: New width of image as number (or when used with x, y or gravity then it becomes the width around the focal point)
      • aspectType: Scale image acording formula: aspectType=0 Dont hold ascpec, aspectType=1 Hold height scrink width, aspectType=2 hold width scrink height, aspectType=3 in box
      • quality: Quality of the image in a value between 0 and 100 (The quality setting applies only to the JPEG encoder. PNG and BMP are both lossless, meaning that there's no quality/space trade-off to be made)
      • force: if this is true then it will always recalculate so only use this when needing to update the underlying asset to ensure newest version (do not use on all requests)
      • lastUpdated: Timestamp (just in miliseconds) of when the asset was last updated in the DAM (this is important for CDN since each URL is unique). This is often received from the DAM or if push-based integration then it is the last update you received.
    • Focal Point (optional)**
      • x: Offset for the x coordinate (in pixels)
      • y: Offset for y coordinate (in pixels)
      • gravity: Specific placement of gravity (overrules x and y). Read more: https://www.google.com/search?q=ImageMagick.Gravity
        • Northwest, North, Northeast, West, Center, East, Southwest, South, Southeast
      • cH: Crop height in pixels (must be used with either x,y or gravity)
      • cW: Crop width in pixels (must be used with either x,y or gravity)
  •  Example (NOT THE DAM URL):


Functional Approach

The above approach can also be mapped to a functional approach. Query parameters are then instead an integrated segment in URL (as know from cloudflare and others)

  • Important changes are
    • We have added filename.extension to the URL to control filename in the Content-Disposition header in the response
    • mimeType is no longer applicable, and the type is controlled by the extension of the filename provided. 
    • The query parameters are now a segment after /assets/ and before /filename.extension where the parameters are comma separated.
  • Example: [DAM_RESIZE_URL]/assets/assetID=[AssetId],mediaformatid=[MediaFormatId],destinationid=[DestinationId],width=[Width],height=[Height],quality=[Quality],aspecttype=[AspectType],timestamp=[LastUpdated]/filename.extension



**Resize can be combined with a crop of the resized image. You can add either x+y coordinates with cH and cW or you can do gravity + cH and cW.


Where:

  • [DAMURL] is the URL of the DAM Center (remember http/https)
  • [AssetId] is the assetId you want to stream
  • [AccessKey] is a valid accesskey generated (e.g. from user/password through the API (Connect-service))

Note: static parameter AssetOutputIdent=44 - no not change/alter