diff options
| author | zmeyer44 <54515037+zmeyer44@users.noreply.github.com> | 2023-12-09 12:55:25 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-12-09 12:55:25 -0500 |
| commit | cec99e7b13a823d08527790bd46297d545ddb881 (patch) | |
| tree | 89d7a0fb8bb80bbd7a635c22dbf79fbd43e50526 | |
| parent | a2914eed6d34d2e40ad2e361519bcd52300ef25e (diff) | |
Update 44.md
Updating to reference NIP-94 file metadata event
| -rw-r--r-- | 44.md | 26 |
1 files changed, 10 insertions, 16 deletions
| @@ -6,9 +6,9 @@ Video Events | |||
| 6 | 6 | ||
| 7 | `draft` `optional` | 7 | `draft` `optional` |
| 8 | 8 | ||
| 9 | This specification defines video events representing a dedicated post of externally hosted content. These video events are _parameterized replaceable_ and deletable per [NIP-09](09.md). | 9 | This specification defines video events representing a dedicated post of externally hosted content. These video events are _parameterized replaceable_ and deletable per [NIP-09](09.md). The content of a video event is the stringified JSON of a `kind 1063` File metadata event as described in [NIP-94](94.md). |
| 10 | 10 | ||
| 11 | Unlike a `kind 1` event with a video attached, Video Events are meant to contain all necessary metadata concerning the media and to be surfaced in media specific clients rather than general micro-blogging clients. The thought is for events of this kind to be referenced in a YouTube like nostr client where the video itself is at the center of the experience. | 11 | Unlike a `kind 1` event with a video attached, Video Events are meant to contain all additional metadata concerning the subject media and to be surfaced in video-specific clients rather than general micro-blogging clients. The thought is for events of this kind to be referenced in a Netflix, YouTube, or TikTok like nostr client where the video itself is at the center of the experience. |
| 12 | 12 | ||
| 13 | ## Video Events | 13 | ## Video Events |
| 14 | 14 | ||
| @@ -18,23 +18,20 @@ There are two types of video events represented by different kinds: horizontal a | |||
| 18 | 18 | ||
| 19 | The format uses a parameterized replaceable event kind `34235` for horizontal videos and `34236` for vertical videos. | 19 | The format uses a parameterized replaceable event kind `34235` for horizontal videos and `34236` for vertical videos. |
| 20 | 20 | ||
| 21 | The `.content` of these events is optional and should be a summary of the video's contents. | 21 | The `.content` of these events is the stringified JSON of a `kind 1063` file metadata event. |
| 22 | 22 | ||
| 23 | The list of tags are as follows: | 23 | The list of tags are as follows: |
| 24 | * `d` (required) universally unique identifier (UUID). Generated by the client creating the video event. | 24 | * `d` (required) universally unique identifier (UUID). Generated by the client creating the video event. |
| 25 | * `e` (required, repeated) reference tag to kind 1063 file metadata event being posted, optional relay information for the file metadata event, optional quality value (low|medium|high) | ||
| 25 | * `title` (required) title of the video | 26 | * `title` (required) title of the video |
| 26 | * `url` (required) a link to the video data | ||
| 27 | * `m` (optional) the MIME type of the video data in the `src` tag | ||
| 28 | * `summary` (optional) summary/description of the video (same as content) | 27 | * `summary` (optional) summary/description of the video (same as content) |
| 29 | * `image` (optional) url of preview image with same dimensions | 28 | * `url` (optional) a default link to the video data |
| 30 | * `thumb` (optional) url of thumbnail with same aspect ratio | ||
| 31 | * `dim` (optional) size of file in pixels in the form <width>x<height> | ||
| 32 | * `text-track` (optional, repeated) link to WebVTT file for video, type of supplementary information (captions/subtitles/chapters/metadata), optional language code | 29 | * `text-track` (optional, repeated) link to WebVTT file for video, type of supplementary information (captions/subtitles/chapters/metadata), optional language code |
| 30 | * `thumb` (optional) url of thumbnail with same aspect ratio | ||
| 33 | * `content-warning` (optional) warning about content of NSFW video | 31 | * `content-warning` (optional) warning about content of NSFW video |
| 34 | * `alt` (optional) description for accessibility | ||
| 35 | * `t` (optional, repeated) hashtag to categorize video | 32 | * `t` (optional, repeated) hashtag to categorize video |
| 36 | * `p` (optional, repeated) 32-bytes hex pubkey of a participant in the video, optional recommended relay URL | 33 | * `p` (optional, repeated) 32-bytes hex pubkey of a participant in the video, optional recommended relay URL |
| 37 | * `r` (optional, repeated) references / links to web pages. | 34 | * `r` (optional, repeated) references / links to web pages |
| 38 | 35 | ||
| 39 | ```json | 36 | ```json |
| 40 | { | 37 | { |
| @@ -42,22 +39,19 @@ The list of tags are as follows: | |||
| 42 | "pubkey": <32-bytes lowercase hex-encoded public key of the event creator>, | 39 | "pubkey": <32-bytes lowercase hex-encoded public key of the event creator>, |
| 43 | "created_at": <Unix timestamp in seconds>, | 40 | "created_at": <Unix timestamp in seconds>, |
| 44 | "kind": 34235 | 34236, | 41 | "kind": 34235 | 34236, |
| 45 | "content": "<summary of video>", | 42 | "content": "<stringified JSON of kind 1063 event>", |
| 46 | "tags": [ | 43 | "tags": [ |
| 47 | ["d", "<UUID>"], | 44 | ["d", "<UUID>"], |
| 45 | ["e", "<hex-id>", "<relay-url>", "<optional quality value>"], | ||
| 48 | 46 | ||
| 49 | ["title", "<title of video>"], | 47 | ["title", "<title of video>"], |
| 50 | ["summary", "<summary of video>"], | 48 | ["summary", "<summary of video>"], |
| 51 | ["thumb", "<thumbnail image for video>"], | 49 | ["thumb", "<thumbnail image for video>"], |
| 52 | ["image", "<preview image for video>"], | ||
| 53 | ["alt", <description>], | ||
| 54 | 50 | ||
| 55 | // Video Data | 51 | // Video Data |
| 56 | ["url", "<url>"], | 52 | ["url", "<optional recommended url>"] |
| 57 | ["m", "<MIME type>"], | ||
| 58 | ["text-track", "<url>", "<text track type>", "<optional language>"], | 53 | ["text-track", "<url>", "<text track type>", "<optional language>"], |
| 59 | ["content-warning", "<reason>"], | 54 | ["content-warning", "<reason>"], |
| 60 | ["dim", <size of video in pixels>], | ||
| 61 | 55 | ||
| 62 | // Participants | 56 | // Participants |
| 63 | ["p", "<32-bytes hex of a pubkey>", "<optional recommended relay URL>"], | 57 | ["p", "<32-bytes hex of a pubkey>", "<optional recommended relay URL>"], |