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

用例

您有想要提供给用户的内容，以丰富主要内容的呈现或体验。 这可能是在用户选择开始与主要内容交互之前要体验的事情和/或在与主要内容交互时要考虑的其他事情。 您可能希望纯音频 Canvas 在播放时有可用的图像，或者相反，在用户浏览纯图像 Manifest 时有可用的音频。

实施说明

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

限制

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

示例

在该示例中，主 Canvas 包含古斯塔夫·马勒第三交响曲的演奏音频，accompanyingCanvas 包含乐谱中的一页的图像。
注意：查看器尚不支持 _accompanyingCanvas 属性。_
JSON-LD

  1. {
  2.   "@context": "http://iiif.io/api/presentation/3/context.json",
  3.   "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/manifest.json",
  4.   "type": "Manifest",
  5.   "label": {
  6.     "en": [
  7.       "Partial audio recording of Gustav Mahler's _Symphony No. 3_"
  8.     ]
  9.   },
  10.   "items": [
  11.     {
  12.       "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/p1",
  13.       "type": "Canvas",
  14.       "label": {
  15.         "en": [
  16.           "Gustav Mahler, Symphony No. 3, CD 1"
  17.         ]
  18.       },
  19.       "duration": 1985.024,
  20.       "accompanyingCanvas": {
  21.         "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/accompanying",
  22.         "type": "Canvas",
  23.         "label": {
  24.           "en": [
  25.             "First page of score for Gustav Mahler, Symphony No. 3"
  26.           ]
  27.         },
  28.         "height": 998,
  29.         "width": 772,
  30.         "items": [
  31.           {
  32.             "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/accompanying/annotation/page",
  33.             "type": "AnnotationPage",
  34.             "items": [
  35.               {
  36.                 "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/accompanying/annotation/image",
  37.                 "type": "Annotation",
  38.                 "motivation": "painting",
  39.                 "body": {
  40.                   "id": "https://iiif.io/api/image/3.0/example/reference/4b45bba3ea612ee46f5371ce84dbcd89-mahler-0/full/,998/0/default.jpg",
  41.                   "type": "Image",
  42.                   "format": "image/jpeg",
  43.                   "height": 998,
  44.                   "width": 772,
  45.                   "service": [
  46.                     {
  47.                       "id": "https://iiif.io/api/image/3.0/example/reference/4b45bba3ea612ee46f5371ce84dbcd89-mahler-0",
  48.                       "type": "ImageService3",
  49.                       "profile": "level1"
  50.                     }
  51.                   ]
  52.                 },
  53.                 "target": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/accompanying"
  54.               }
  55.             ]
  56.           }
  57.         ]
  58.       },
  59.       "items": [
  60.         {
  61.           "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/page/p1",
  62.           "type": "AnnotationPage",
  63.           "items": [
  64.             {
  65.               "id": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/page/annotation/segment1-audio",
  66.               "type": "Annotation",
  67.               "motivation": "painting",
  68.               "body": {
  69.                 "id": "https://fixtures.iiif.io/audio/indiana/mahler-symphony-3/CD1/medium/128Kbps.mp4",
  70.                 "type": "Sound",
  71.                 "duration": 1985.024,
  72.                 "format": "video/mp4"
  73.               },
  74.               "target": "https://iiif.io/api/cookbook/recipe/0014-accompanyingcanvas/canvas/page/p1"
  75.             }
  76.           ]
  77.         }
  78.       ]
  79.     }
  80.   ]
  81. }

相关专题