文件Dynamic Media Image Production System API

createAssetSet createassetset

Last update: Fri Sep 01 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
  • Admin

使用要發佈至影像伺服器的原始集定義字串建立一般資產集。

語法

授權的使用者型別 section-d670d3af552147199b65c7eb847544a3

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

參數 section-3580b586296e42a5b21426085b1bb72d

輸入(createAssetSet)

名稱
類型
必要
說明
companyHandle
xsd:string
是
包含資產集之公司的控制代碼。
folderHandle
xsd:string
是
建立新資產集所在資料夾的控制代碼。
名稱
xsd:string
是
資產名稱。
子型別
xsd:string
是
使用者端為資產集型別建立的唯一識別碼。
setDefinition
xsd:string
否

集合定義字串中的引數。

這些引數必須解析成目標檢視器指定的格式。

thumbAssetHandle
xsd:string
否
資產的控制代碼，可作為新影像集的縮圖。 如果未指定，IPS會嘗試使用集合所參照的第一個影像資產。

setDefinition的替代函式

您可以內嵌指定在目錄查閱或發佈期間解析的替代函式。 替代字串的格式為 ${<substitution_func>}. 可用的函式概述如下。

NOTE
引數清單中的控制代碼常值必須用方括弧括住 ([]). 解析期間，替代字串以外的所有文字都會逐字複製到輸出字串中。
替代函式
傳回
getFilePath([asset_handle>])
資產的主要來源檔案路徑。
getCatalogId([<asset_handle>])
資產的目錄ID。
getMetaData([<asset_handle>], [<metadata_field_handle>])
資產的中繼資料值。
getThumbCatalogId([<asset_handle>])
資產的目錄ID （僅適用於影像型資產）。 關聯的縮圖資產的目錄ID （適用於其他資產）。 如果相關的縮圖資產無法使用，此函式會傳回空字串。

媒體setDefinition字串範例

${getCatalogId([a|1664|22|1664])};${getCatalogId([a|1664|22|1664])};1,${getFilePath([a|103
6|19|144])};${getCatalogId([a|452|1|433])};2;${getMetadata([a|1036|19|144], [m|1|ASSET|SharedDateField])}

在目錄查詢或發佈時間，此程式將解析為類似於以下內容的字串：

jcompany/myRenderSet;jcompany/myRenderSet;1,jcompany/Videos/Somebodys_N08275_flv.flv;jcomp any/myimg-1;2;20090703 10:05:53

輸出(createAssetSet)

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

範例 section-fed53089de824d67ab96cd9103d384b4

請求

<createAssetSetParam xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
   <companyHandle>c|1</companyHandle>
   <folderHandle>f|jcompany/AssetSets/</folderHandle>
   <name>testAssetSet</name>
   <subType>MediaSet</subType>
</createAssetSetParam>

回答

<createAssetSetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
   <assetHandle>a|1801|44|1801</assetHandle>
</createAssetSetReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681