翻译：Wu Gang
原文地址：https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/
专题主页 | 专题列表

用例

您有一个超大的视频展示给网站访问者。由于每个访问者的连接可靠性和带宽都是未知和不可预测的，因此希望向他们展示视频的静态图像预览（加载速度更快），直到视频加载完成或已充分缓冲。

实施说明

在一个 Manifest 及其资源中，您可以使用多个 placeholderCanvas，以允许您为每个合适的资源（Collection、Manifest、Canvas 和 Range）提供一个真实的 placeholderCanvas。
placeholderCanvas的Annotation目标的值应该是placeholderCanvas的id，而不是具有placeholderCanvas的资源的id。
始终牢记给符合要求的客户端提供的广泛自由度：是否以及在何种 UI 中显示放置在 placeholderCanvas 属性中的内容由客户端决定。不要将此属性用于必须显示的内容。 另一方面，在placeholderCanvas中放置内容确实会向符合要求的客户端传递这样的信息：如果显示内容，则应在其所附加到的资源显示之前予以显示。

限制

placeholderCanvas 的每个实例可能只包含一个 Canvas，因此可能特别地不包含额外的 placeholderCanvas 或accompanyingCanvas。

示例

本示例中，主要内容是一段多尼采蒂的《爱之甘醇》（L’elisir d’amore）的表演视频，placeholderCanvas 是视频中的一个静止帧。 对于带宽有限的站点访问者，显示静止帧可以让他们提前了解表演方面的情况，例如服装、舞台和布景设计。
注意：查看器尚不支持 placeholderCanvas 属性。
JSON-LD

  1. {
  2.   "@context": "http://iiif.io/api/presentation/3/context.json",
  3.   "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/manifest.json",
  4.   "type": "Manifest",
  5.   "label": {
  6.     "en": [
  7.       "Video recording of Donizetti's _The Elixer of Love_"
  8.     ]
  9.   },
  10.   "items": [
  11.     {
  12.       "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/canvas/donizetti",
  13.       "type": "Canvas",
  14.       "duration": 7278.466,
  15.       "width": 640,
  16.       "height": 360,
  17.       "placeholderCanvas": {
  18.         "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/canvas/donizetti/placeholder",
  19.         "type": "Canvas",
  20.         "width": 640,
  21.         "height": 360,
  22.         "items": [
  23.           {
  24.             "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/canvas/donizetti/placeholder/1",
  25.             "type": "AnnotationPage",
  26.             "items": [
  27.               {
  28.                 "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/canvas/donizetti/placeholder/1-image",
  29.                 "type": "Annotation",
  30.                 "motivation": "painting",
  31.                 "body": {
  32.                   "id": "https://fixtures.iiif.io/video/indiana/donizetti-elixir/act1-thumbnail.png",
  33.                   "type": "Image",
  34.                   "format": "image/png",
  35.                   "width": 640,
  36.                   "height": 360
  37.                 },
  38.                 "target": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/canvas/donizetti/placeholder"
  39.               }
  40.             ]
  41.           }
  42.         ]
  43.       },
  44.       "items": [
  45.         {
  46.           "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/donizetti/1",
  47.           "type": "AnnotationPage",
  48.           "items": [
  49.             {
  50.               "id": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/donizetti/1-video",
  51.               "type": "Annotation",
  52.               "motivation": "painting",
  53.               "body": {
  54.                 "id": "https://fixtures.iiif.io/video/indiana/donizetti-elixir/vae0637_accessH264_low.mp4",
  55.                 "type": "Video",
  56.                 "duration": 7278.466,
  57.                 "width": 640,
  58.                 "height": 360,
  59.                 "format": "video/mp4"
  60.               },
  61.               "target": "https://iiif.io/api/cookbook/recipe/0013-placeholderCanvas/canvas/donizetti"
  62.             }
  63.           ]
  64.         }
  65.       ]
  66.     }
  67.   ]
  68. }

相关专题