nips/61.md

36 lines
1.3 KiB
Markdown
Raw Normal View History

2024-04-20 02:35:56 -04:00
NIP-61
======
Danmaku
-------
`draft` `optional`
This NIP defines a new kind of event, `2333`, for danmaku.
Danmaku (弾幕 だんまく; 弹幕; literally translated as "bullet curtain" and figuratively as "barrage") is a subtitle system in online video platforms that originates from Japan and popularised in Mainland China. Such system allows user to post moving comments onto a playing video that are synchronized to the video timeline. The comments are typically presented as “shooting” across the screen, resembling a barrage.
### Format
The format uses a regular event kind `2333`.
The `.content` of these events is the content of the danmaku comment.
The list of tags are as follows:
* `i` (required) universally unique identifier of the video. The format is `<platform (lowercase)>:<identity>` where `<platform>` is the platform of the video and `<identity>` is the unique identifier of the video on that platform. For example, a YouTube video with the identifier `aA-jiiepOrE` would have the identifier `youtube:aA-jiiepOrE`.
* `time` (required) the time of the video when the danmaku comment is sent in seconds.
```jsonc
{
"id": "<...>",
"pubkey": "<...>",
"kind": 2333,
"tags": [
["i", "youtube:aA-jiiepOrE"],
["time", "3.018597"]
],
"content": "Hello Nostr!",
"sig": "<...>",
"created_at": 1713368851
}
```