レンディション

レンディションの取得は、エンティティ オブジェクト (IEntity) を介して行われます。すべてのエンティティがレンディションをサポートしているわけではありませんが、たとえば、M.Asset はサポートしています。

レンディションには、IEntity.Renditionsプロパティを介してアクセスできます。これは、IRenditionオブジェクトのリストを返します。レンディションは、レンディション名とレンディション アイテムで構成されます。既定では、アセットのレンディションは次のように名前が付けられています (カスタマイズすることはできます)。

• "bigthumbnail"
• "downloadAlternative"
• "downloadOriginal"
• "downloadPreview"
• "メタデータ"
• "pdf"
• "プレビュー"
• "サムネイル"

レンディション アイテム (IRendition.Items) の数は、ファイルとレンディションによって異なります。画像は、1 つまたは複数のアイテムに処理できます。たとえば、画像のレイヤーごとにアイテムが存在する場合があります。PDF ファイルには、ページごとにレンディション アイテムを含めることができます。

レンディションをサポートしないエンティティは、空のレンディション リストを返します。

レンディションのダウンロードは、IRendition オブジェクトおよび IRenditionItemオブジェクトを通してダウンロードできます。レンディションは、IRenditionItem オブジェクトの Href プロパティを使用して手動でダウンロードできますが、指定したファイルパスへの直接ダウンロードまたはストリームとしてのダウンロードもサポートしています。

次の例では、元のファイル ("downloadOriginal") の最初のレンディション アイテムが ID 8626 のアセットからダウンロードされます。directory 変数は、レンディションが保存されるフォルダーです。

var asset = await MClient.Entities.GetAsync(8626);
var original = asset.GetRendition("downloadOriginal");
var rendition = original.Items.FirstOrDefault();

if (rendition != null)
{
var filename = asset.GetPropertyValue<string>(Constants.Asset.FileName);
var directory = @"C:\Users\Stylelabs\Desktop";
var filepath = Path.Combine(directory, filename);
await rendition.DownloadAsync(filepath);
}