文件Dynamic Media Image Production System API

createDerivedAsset createderivedasset

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
  • 管理員

建立衍生自現有主要來源影像資產的新資產。

語法

衍生資產會指定影像伺服器通訊協定命令，以修改擁有者影像的表示方式。 AdjustedView衍生型別有助於將簡單的修改套用至單一影像（例如，藉由指定裁切矩形），而LayerView則有助於建立可能包含文字或其他影像的多層檢視。

與影像復本（請參閱copyImage）不同，衍生的影像已連結至其擁有者影像。 所有者影像的變更會修改關聯的衍生資產。 刪除擁有者影像會刪除任何關聯的衍生影像。

授權的使用者型別 authorized-user-types

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser

參數 section-5a0dde01cff6454da3646ea805c2be1e

輸入(createDerivedAssetParam)

名稱
類型
必要
說明
companyHandle
xsd:string
是
包含新資產之資產的公司的控制代碼。
ownerHandle
xsd:string
是
衍生新影像的主要影像資產的控點。
folderHandle
xsd:string
是
建立新衍生資產的資料夾的控制代碼。
name
xsd:string
是
衍生資產的名稱。
type
xsd:string
是
新衍生資產的資產型別： AdjustedView或LayerView。
urlModifier
xsd:string
否
影像伺服或影像演算通訊協定命令已在​ 要求或urlPostApplyModifier命令之前 ​套用。
urlPostApplyModifier
xsd:string
否
影像伺服或影像演算通訊協定命令已在​ 之後 ​套用到要求或urlPostApplyModifier命令。

輸出(createDerivedAssetParam)

名稱
類型
必要
說明
assetHandle
xsd:string
是
衍生資產的控點。

範例 section-5d5ea893a1ef4edc8b3a396f1936e8c9

範常式式碼會建立具有已調整檢視的衍生資產，以及具有任意值的urlModifier和urlPostApplyModifier。 回應會將控制代碼傳回至新衍生的資產。

要求

<createDerivedAssetParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <ownerHandle>a|943|1|580</ownerHandle>
   <folderHandle>ApiTestCo/</folderHandle>
   <name>ApiDerivedAsset</name>
   <type>AdjustedView</type>
   <urlModifier>modify=this</urlModifier>
   <urlPostApplyModifier>action=awesome</urlPostApplyModifier>
</createDerivedAssetParam>

回應

<createDerivedAssetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <assetHandle>a|944|10|2</assetHandle>
</createDerivedAssetReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681