媒體集請求

「影像伺服」提供擷取階層式文字回應(xml或json)的機制,該回應代表與特定記錄的catalog::ImageSet相關聯的所有資源和中繼資料。

檢視器可使用此機制產生回應,以通知簡單影像、視訊、視訊集、色票集、回轉集、頁面集(e-catalog)和媒體集的呈現方式。

要求語法

可使用req=set修飾符並參考淨路徑中的目錄記錄ID來檢索catalog::ImageSet的設定響應。 或者,您也可以使用imageset=修飾元,直接在URL中指定影像集。 如果使用imageset=修飾詞來指定影像集,則應將整個值括在大括弧中,以逸出影像集值,並確保任何包含的修飾詞不被解譯為URL查詢字串的一部分。

設定回應的類型

設定機制支援下列類型的回應:

簡單影像

未定義目錄::ImageSet的影像記錄。

簡單影片

靜態內容目錄中的視訊記錄。

色票集

一組項,包括對影像記錄的引用和對用作色票的影像記錄的可選單獨引用。

分層色票集

由基本色板項或對色板集記錄的引用組成的一組項。

回轉集

一組項目,包含簡單的影像ID清單。

二維自旋集

由簡單影像或基本回轉集的參照組成的項目集。

頁面集

一組項目,包含最多三個頁面影像的清單

媒體集

由簡單影像、視訊集、色票集、階層式色票集、回轉集、二維回轉集、頁面集和視訊資產組成的一組項目。 每個媒體集項目也可包含選用色票。

視訊集

由簡單影片清單組成的項目集。

外置式檢測

收到req=set請求時,要生成的響應類型由catalog::AssetType的值確定。 如果未定義catalog::AssetType,則響應類型由以下規則確定:

  • 如果在映像目錄中找到記錄,則定義catalog::ImageSet

    • 如果記錄「影像集」欄位中至少有一個條目包含冒號,則假定設定電子目錄
    • 如果「記錄影像集」欄位中至少有一個條目包含兩個分號,則假設介質已設定。
    • 如果「記錄影像集」欄位中至少有一個條目包含一個分號,則假設已設定影像。
    • 如果沒有任何項目包含冒號或分號,但至少有一個項目包含引用集或行內集(這是2D回轉集),則假設為回轉集。
    • 如果沒有任何條目包含冒號、分號、引用集或行內集(即以逗號分隔的影像清單),則假設未知集。
  • 如果在影像和靜態內容目錄中都找到記錄

    • 如果檔案副檔名如下,則假設為video :mp3, mp4, flv, f4v, swf, xml
    • 假設影像
  • 如果在靜態內容目錄中找到記錄,但在影像目錄中找不到記錄

    • 如果檔案副檔名如下,則假設為video :mp3, mp4, flv, f4v, swf, xml
    • 假設為靜態
  • 如果在影像目錄中找到記錄,但在靜態內容目錄中找不到

    • 假設影像
  • 如果在映像目錄中找不到記錄,且在靜態內容目錄中找不到記錄

    • 如果副檔名如下,則假設為檔案式視訊:mp3, mp4, flv, f4v, swf, xml
    • 假設基於檔案的影像

在所有情況下,結果的xml響應都將符合指定的XML文檔,並設定與檢測到的類型對應的根節點。

內置式檢測

當檢測到外部集為類型媒體集時,響應將包含與catalog::ImageSet中的每個媒體集條目對應的一組媒體集項。 如果為特定媒體集條目指定了可選類型參數,則將根據下表將其映射到輸出類型:

輸入類型 輸出類型
img img
basic img
advanced_image img
img_set img_set
advanced_image_set img_set
advanced_swatchset img_set
spin spin
video video
video_set video_set
static static
ecat ecat

如果未指定特定媒體集條目的可選類型參數或與不支援的類型相對應,則使用與在外部集級別應用的相同規則自動檢測媒體集項目類型。

XML規範

返回的xml響應符合以下規範:

http://crc.scene7.com/is-docs/examples/mediaset.dtd

LabelKey

labelkey=修飾符與catalog::UserData欄位一起使用,以生成影像和色票的標籤。 將catalog:UserData欄位解析為一組鍵/值對,並將labelkey索引到此集以檢索給定鍵的值。 然後,在​s​和​i​的​l​屬性中返回此值。

強制限制

為了限制回應的大小並防止自我參考問題,最大嵌套深度由伺服器屬性PS::fvctx.nestingLimit控制。 如果超過此限制,則會傳回錯誤。

為了限制大型電子目錄集的xml響應的大小,根據伺服器屬性PS::fvctx.brochureLimit來抑制手冊集項的私有元資料。 與手冊相關聯的所有私人中繼資料都會匯出,直到手冊限制達到為止。 一旦超出限制,將隱藏私有地圖和用戶資料,並設定相應的標誌,以指示隱藏的資料類型。

不支援巢狀媒體集。 巢狀媒體集定義為包含媒體集類型媒體集項目的媒體集。 如果偵測到此條件,則會傳回錯誤。

範例

有關req=set請求的XML回應範例,請參閱HTML範例標題下的屬性頁面。

http://crc.scene7.com/is-docs/examples/properties.htm

另請參閱

req= , imageset=, catalog::ImageSet, Image Catalog Reference

本頁內容