diff --git a/xep-xxxx-extensible-file-thumbnails.md b/xep-xxxx-extensible-file-thumbnails.md index 4b37e12..7b5fc0f 100644 --- a/xep-xxxx-extensible-file-thumbnails.md +++ b/xep-xxxx-extensible-file-thumbnails.md @@ -14,39 +14,38 @@ This document specifies are more general and extensible element for specifiying ## Usage ```xml - - LEHV6nWB2yk8pyoJadR*.7kCMdnj - + + LEHV6nWB2yk8pyoJadR*.7kCMdnj + ``` -In this example, the thumbnail contains only a blurhash thumbnail, indicated by the `` element, but an implementation -may add more versions of the same thumbnail, i.e. another `` element as a fallback if a client does not support -blurhash. To prevent confusion in the display of a thumbnail, all children of `` must describe a thumbnail -for the same file. +This example specifies a thumbnail of type `blurhash`, meaning that the child element of the +`` element must contain a `` element (See "Thumbnail Types"). ### Thumbnail Types #### Blurhash -If a sender includes a `` inside the `` element, then it must be interpreted as -[Blurhash](https://github.com/woltapp/blurhash) data. As a sender, care must be taken to not make the Blurhash -thumbnail too big as to not loose the advantages of blurhash. +If a sender specifies the type of the `` element to be +`proto:urn:xmpp:eft:0:blurhash`, then the `` element's value must be interpreted +as [Blurhash](https://github.com/woltapp/blurhash) data. As a sender, care must be taken to +not make the Blurhash thumbnail too big as to not loose the advantages of Blurhash. ```xml - - LEHV6nWB2yk8pyoJadR*.7kCMdnj - + + LEHV6nWB2yk8pyoJadR*.7kCMdnj + ``` #### Jingle Content Thumbnail Compatability In order to enable a pseudo-interoperability with [Jingle Content Thumbnails](https://xmpp.org/extensions/xep-0264.html), inclusion of a `` element is allowed. This is to allow easy reuse of an already existent [Jingle Content Thumbnails](https://xmpp.org/extensions/xep-0264.html) -implementation. +implementation. The type of the `` must then be set to `proto:urn:xmpp:eft:0:base64-bob`. ```xml - + - + ``` ## Usage Example with Stateless Inline Media Sharing @@ -55,34 +54,36 @@ NOTE: This example is taken from [Stateless Inline Media Sharing](https://xmpp.o ```xml - Look at the nice view from the summit. - - - - image/jpeg - summit.jpg - 3032449 - 2XarmwTlNxDAMkvymloX3S5+VbylNrJt/l5QyPa+YoU= - 2AfMGH8O7UNPTvUVAM9aK13mpCY= - Photo from the summit. - - - - - LEHV6nWB2yk8pyoJadR*.7kCMdnj - - - - - - - - - + Look at the nice view from the summit. + + + + image/jpeg + summit.jpg + 3032449 + 2XarmwTlNxDAMkvymloX3S5+VbylNrJt/l5QyPa+YoU= + 2AfMGH8O7UNPTvUVAM9aK13mpCY= + Photo from the summit. + + + + + LEHV6nWB2yk8pyoJadR*.7kCMdnj + + + + + + + + + + + ``` @@ -95,6 +96,11 @@ The same considerations apply as specified by [Jingle Content Thumbnails](https: - Change XML namespace from `proto:urn:xmpp:eft:0` to `urn:xmpp:eft:0` once we submit this as an XEP ## Changelog +### 0.2.0 + +- Namespace the thumbnail type +- `` to `` + ### 0.1.0 - Remove the base64 thumbnail type @@ -109,5 +115,5 @@ The same considerations apply as specified by [Jingle Content Thumbnails](https: | Key | Value | | --- | --- | | Author | PapaTutuWawa | -| Version | 0.1.0 | +| Version | 0.2.0 | | Short name | eft |