diff --git a/_includes/links.md b/_includes/links.md index 2d97d6f47..b62991561 100644 --- a/_includes/links.md +++ b/_includes/links.md @@ -52,7 +52,8 @@ [0154]: {{ site.cookbook_url | absolute_url }}/recipe/0154-geo-extension/ "Locate a Manifest on a Web Map" [0232]: {{ site.cookbook_url | absolute_url }}/recipe/0232-image-thumbnail-canvas/ "Implementation discussion: Thumbnails on Canvases" -[0219]: {{ site.cookbook_url | absolute_url }}/recipe/0219-using-caption-file/ "Using Caption and Subtitle Files with Video Content" + +[0219]: {{ site.cookbook_url | absolute_url }}/recipe/0219-using-caption-file/ "Using Caption Files with Video Content" [0229]: {{ site.cookbook_url | absolute_url }}/recipe/0229-behavior-ranges/ "Adding Thumbnail Navigation and `no-nav` to a Video Resource" [0230]: {{ site.cookbook_url | absolute_url }}/recipe/0230-navdate/ "Navigation by Chronology" [0231]: {{ site.cookbook_url | absolute_url }}/recipe/0231-transcript-meta-recipe/ "Transcripts, Captions, and Subtitles - General Considerations" diff --git a/recipe/0219-using-caption-file/index.md b/recipe/0219-using-caption-file/index.md index f8f9ed393..22e4627d1 100644 --- a/recipe/0219-using-caption-file/index.md +++ b/recipe/0219-using-caption-file/index.md @@ -1,9 +1,9 @@ --- -title: Using Caption and Subtitle Files with Video Content +title: Using Caption Files with Video Content id: 219 layout: recipe tags: [video, caption, subtitle, presentation] -summary: "Providing a caption or subtitle file to a video resource." +summary: "Providing a caption file to a video resource." viewers: - Clover - Ramp @@ -15,15 +15,14 @@ topic: AV ## Use Case -Captions and subtitles may be available for your video content and you may want to enable them for your IIIF video resources. +Captions may be available for your video content and you may want to enable them for your IIIF video resources. ## Implementation notes -Caption and subtitle file formats are used to mark up the external text track resources in connection with the HTML track element of a video file. The markup file formats use time tags that allow for time alignment of the video content with the captions or subtitles. +Caption file formats are used to mark up the external text track resources in connection with the HTML track element of a video file. The markup file formats use time tags that allow for time alignment of the video content with the captions. -Offering the caption file as an Annotation on the Canvas that contains the media file itself enables us to express the relationship between the two. The `type` and `format` properties of the Annotation can be used by the client to identify files in a format supported by the media player for captions. The `motivation` value of `supplementing` indicates the fact that processing this Annotation is optional. - -In addition to this implementation, one should consider offering the captions or subtitles as multiple timed annotations, making the text available in multiple ways. See [Using Annotations for Timed Text][0079]. +Offering the caption file as an Annotation on the Canvas that contains the media file itself enables us to express the relationship between the two. The `provides` property of the Annotation can be used by the client to identify caption files in a format that should be supported by the media player. The `format` property of the Annotation can also be used to verify that the file is in an appropriate format. +In addition to this implementation, one can also offer captions as multiple timed annotations, making the text available in multiple ways. See [Using Annotations for Timed Text][0079]. While captions, subtitles, and transcripts each present some text interpretation of the A/V content, the ways in which they are consumed by users differ. For a more detailed discussion about these differences see [Transcripts, Captions, and Subtitles - General Considerations][0231]. @@ -31,11 +30,9 @@ While captions, subtitles, and transcripts each present some text interpretation Formats other than [WebVTT](https://w3c.github.io/webvtt/) (Web Video Text Tracks) are supported in IIIF, but may not be as widely supported in viewers. -When using segmented WebVTT with HLS, see [Serving HLS Files][0257]. - ## Example -In this example we use a caption file in the WebVTT format, but other options include a subtitle file in the [SRT](https://en.wikipedia.org/wiki/SubRip) (SubRip Text) or [TTML](https://w3c.github.io/ttml3/index.html) (Timed Text Markup Language) formats, or other text-based format used for the same purpose. +In this example we use a caption file in the WebVTT format, but other options include a caption file in the [SRT](https://en.wikipedia.org/wiki/SubRip) (SubRip Text) or [TTML](https://w3c.github.io/ttml3/index.html) (Timed Text Markup Language) formats, or other text-based format used for the same purpose. {% include manifest_links.html viewers="Clover, Ramp, Aviary, Theseus" manifest="manifest.json" %} @@ -43,11 +40,11 @@ In this example we use a caption file in the WebVTT format, but other options in # Related recipes -- [Simplest Manifest - Video][0003] -- [Providing Access to Transcripts of A/V Content][0017] -- [Providing Alternative Representations][0046] +- [Using Transcript Files with Video and Audio Content][0253] +- [Using Caption and Subtitle Files in Multiple Languages with Video Content][0074] - [Using Annotations for Timed Text][0079] -- [Serving HLS Files][0257] +- [Providing Access to Transcripts of A/V Content][0017] +- [Annotating a Poetry Reading][0103] {% include acronyms.md %} {% include links.md %} diff --git a/recipe/0219-using-caption-file/manifest.json b/recipe/0219-using-caption-file/manifest.json index 548a05c41..485211c39 100644 --- a/recipe/0219-using-caption-file/manifest.json +++ b/recipe/0219-using-caption-file/manifest.json @@ -45,6 +45,7 @@ "id": "{{ id.path }}/canvas/page2/a1", "type": "Annotation", "motivation": "supplementing", + "provides": ["closedCaptions"], "body": { "id": "https://fixtures.iiif.io/video/indiana/lunchroom_manners/lunchroom_manners.vtt", "type": "Text",