媒體集請求

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

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

請求語法

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

集合響應類型

set機制支援以下類型的響應:

簡單影像

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

簡單影片

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

色票集

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

層次色票集

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

回轉集

一組項目,由簡單的影像ID清單組成。

二維自旋集

一組由簡單影像或基本旋轉集的引用組成的項目。

頁集

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

媒體集

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

影片集

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

外部設定類型檢測

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

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

    • 如果記錄「影像集」欄位中至少有一個項目包含冒號,則假設e-catalog set
    • 如果記錄「影像集」欄位中至少有一個項目包含兩個分號,則假設媒體已設定。
    • 如果記錄「影像集」欄位中至少有一個項目包含一個分號,則假設影像集。
    • 假設沒有任何項目包含冒號或分號,但至少有一個項目包含參考集或行內集(這是2D回轉集),則假設回轉集。
    • 如果沒有包含冒號或分號或參考集或行內集的條目(即以逗號分隔的影像清單),則假設未知集。
  • 如果在影像AND靜態內容目錄中都找到記錄

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

    • 如果副檔名如下,則假設有視訊: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欄位被解析為一組鍵/值對,並且該集中的標籤鍵索引用於檢索給定鍵的值。 然後,在​s​和​i​的​l​屬性中返回此值。

強制限制

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

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

不支援巢狀媒體集。 嵌套媒體集被定義為包含介質集類型的介質集。 如果偵測到此情況,則會傳回錯誤。

範例

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

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

另請參閱

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

本頁內容