媒体集请求 media-set-requests
图像服务提供了一种用于获取分层文本响应(xml或json)的机制,该响应表示与特定记录的catalog::ImageSet关联的所有资源和元数据。
观看者可以使用此机制生成响应,以通知简单图像、视频、视频集、样本集、旋转集、页面集(e-catalog)和媒体集的呈现。
请求语法 section-d72b1d95e4ce4bb1b332ce096c2b99f1
可以使用req=set
修饰符并引用Net路径中的目录记录ID来检索catalog::ImageSet
的设置响应。 或者,可以使用imageset=
修饰符直接在URL中指定图像集。 如果使用imageset=
修饰符指定图像集,则应将整个值括在大括号中,以便对图像集值进行转义,并确保所包含的任何修饰符均不会解释为URL查询字符串的一部分。
集合响应的类型 section-93eb0a1f70344da2a888e56372ad3896
设置机制支持以下类型的响应:
外集类型检测 section-3dd6e453528d46898e559d31458a59ba
收到req=set
请求时,要生成的响应类型由catalog::AssetType
的值决定。 如果未定义catalog::AssetType
,则响应类型由以下规则确定:
-
如果在图像目录中找到记录并且定义了
catalog::ImageSet
- 如果记录图像集字段中至少有一个条目包含冒号,则假定已设置e目录
- 如果记录“图像集”字段中至少有一个条目包含两个分号,则假定媒体集。
- 如果记录图像集字段中至少有一个条目包含一个分号,则假定图像集。
- 如果没有任何条目包含冒号或分号,但至少有一个条目包含引用集或内联集(这是2D旋转集),则假定为旋转集。
- 如果没有条目包含冒号、分号、引用的集或内嵌集(即以逗号分隔的图像列表),则假定为未知集。
-
如果在图像和静态内容目录中都找到了记录
- 如果文件扩展名在以下集中,则假定为视频: mp3、mp4、flv、f4v、swf、xml
- 否则,假设图像
-
如果在静态内容目录中找到记录,但在图像目录中找不到记录
- 如果文件扩展名在以下集中,则假定为视频: mp3、mp4、flv、f4v、swf、xml
- 假设为静态,否则
-
如果在图像目录中找到记录,但在静态内容目录中未找到记录,则为
- 假设图像
-
如果在图像目录中未找到记录,在静态内容目录中未找到记录
- 如果文件扩展名在以下集中,则假定使用基于文件的视频: mp3、mp4、flv、f4v、swf、xml
- 否则,采用基于文件的图像
在所有情况下,生成的xml响应都符合指定的XML文档,并且设置的根节点与检测到的类型相对应。
内集型检测 section-8f46490e467247e69ce284704def06f3
当检测到外部集为类型媒体集时,响应包含一组与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规范 section-c1bd60948ef545759a16885bb6fcc607
返回的xml响应符合以下规范:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
标签键 section-bf565de6f7294cf89620343c9071f415
labelkey=
修饰符与catalog::UserData
字段一起使用,以生成图像和样本的标签。 catalog:UserData
字段被解析为一组键/值对,该组中的标签键索引用于检索给定键的值。 此值随后在 s
和 i
的 l
特性中返回。
强制限制 section-b9f042873bee45a5ae11b69fd42f2bca
为了限制响应大小并防止出现自引用问题,最大嵌套深度由服务器属性PS::fvctx.nestingLimit
控制。 如果超过此限制,则会返回错误。
为了限制大型e-catalog集的xml响应大小,根据服务器属性PS::fvctx.brochureLimit
,禁止小册子集项目的私有元数据。 与宣传册关联的所有私有元数据都将导出,直到达到宣传册限制为止。 超过限制后,将禁止专用映射和用户数据,并设置相应标志以指示禁止的数据类型。
不支持嵌套媒体集。 嵌套媒体集被定义为包含媒体集类型的媒体集项目的媒体集。 如果检测到此情况,则会返回错误。
示例 section-588c9d33aa05482c86cd2b1936887228
有关req=set
请求的示例XML响应,请参阅HTML示例标题下的“属性”页。
http://crc.scene7.com/is-docs/examples/properties.htm