0079 using annotations for captions

recipe/0079-annotations-for-captions/index.md

@@ -0,0 +1,53 @@
+---
+title: Using Annotations for Timed Text
+id: 79
+layout: recipe
+tags: [video, caption, subtitle, presentation]
+summary: "Providing captions, represented as annotations, to a video resource."
+viewers:
+ - Clover
+ - Ramp
+ - Aviary
+ - Theseus
+topic: AV
+---
+
+## Use Case
+
+You want to represent captions for your video content as timed annotations.
+
+## Implementation notes
+
+This recipe follows the pattern for [Using Caption Files with Video Content][0219], but shows an alternative form of representing a caption file using annotations.
+
+In this recipe, annotations are used to mark up video content shown on a canvas of the manifest. The time alignment of the captions with the video content is achieved by annotations that target the canvas by using Media Fragments URIs with a [temporal dimenstion](https://www.w3.org/TR/media-frags/#naming-time). The `provides` property of the Annotation is used by the IIIF client to identify the annotations containing captions and be used as such by the media player. 
+
+## Restrictions
+
+
+
+## Example
+
+In this example we show the same captions and video from [Using Caption Files with Video Content][0219]. but the `annotations` section of the manifest links to a `AnnotationPage` instead of the WebVTT file.
+
+The `AnnotationPage` contains one annotation per individual caption entry, and these are provided as `supplementing` annotations on the Canvas that contains the video file. The references to the canvas uses Media Fragment URIs with a begin time and an end time. The annotations also contain the `provides` property with the value `closedCaptions` to inform the IIIF viewer that these annotations are representing captions. The language of the captions is expressed with a `language` property containing a [BCP 47](https://tools.ietf.org/html/bcp47) language code as specified by the Presentation API 4.0.
+
+Note: This recipe may also be applied for subtitles. In such cases, the `provides` property of the annotations must have the value `subtitles`. 
+
+{% include manifest_links.html viewers="Clover, Ramp, Aviary, Theseus" manifest="manifest.json" %}
+
+{% include jsonviewer.html src="manifest.json" config='data-line="39-44"'%}
+
+{% include jsonviewer.html src="lunchroom_manners-captions-en.json" config='data-line="6-18"'%}
+
+# Related recipes
+
+- [Simplest Manifest - Video][0003]
+- [Using Caption Files with Video Content][0219]
+- [Using Caption and Subtitle Files in Multiple Languages with Video Content][0074]
+- [A Side-by-side Transcript of a Video Recording][0253]
+- [Providing Access to Transcripts of A/V Content][0017]
+- [Serving HLS Files][0257]
+
+{% include acronyms.md %}
+{% include links.md %}