Skip to content

Commit 3760a6e

Browse files
NIP-53 Text Refinements and formatting fixes (#2052)
1 parent 8c45ff5 commit 3760a6e

File tree

1 file changed

+21
-28
lines changed

1 file changed

+21
-28
lines changed

53.md

Lines changed: 21 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ Live Activities
66

77
`draft` `optional`
88

9-
Service providers want to offer live activities to the Nostr network in such a way that participants can easily log and query by clients. This NIP describes a general framework to advertise the involvement of pubkeys in such live activities.
9+
This NIP introduces event kinds to advertise live spaces and the participation of pubkeys in them.
1010

11-
## Concepts
11+
## Live Streaming
1212

13-
### Live Event
13+
A special event with `kind:30311` "Live Streaming Event" is defined as an _addressable event_ whose tags advertise the content and participats of a live stream.
1414

15-
A special event with `kind:30311` "Live Event" is defined as an _addressable event_ of public `p` tags. Each `p` tag SHOULD have a **displayable** marker name for the current role (e.g. `Host`, `Speaker`, `Participant`) of the user in the event and the relay information MAY be empty. This event will be constantly updated as participants join and leave the activity.
15+
Each `p` tag SHOULD have a **displayable** marker name for the current role (e.g. `Host`, `Speaker`, `Participant`) of the user in the event and the relay information MAY be empty. This event will be constantly updated as participants join and leave the activity.
1616

1717
For example:
1818

@@ -69,7 +69,7 @@ Event `kind:1311` is live chat's channel message. Clients MUST include the `a` t
6969
{
7070
"kind": 1311,
7171
"tags": [
72-
["a", "30311:<Community event author pubkey>:<d-identifier of the community>", "<Optional relay url>", "root"],
72+
["a", "30311:<Community event author pubkey>:<d-identifier of the community>", "<Optional relay url>"],
7373
],
7474
"content": "Zaps to live streams is beautiful.",
7575
// other fields...
@@ -84,13 +84,9 @@ Event `kind:1311` is live chat's channel message. Clients MUST include the `a` t
8484

8585
Hosts may choose to pin one or more live chat messages by updating the `pinned` tags in the live event kind `30311`.
8686

87-
## Use Cases
87+
### Examples
8888

89-
Common use cases include meeting rooms/workshops, watch-together activities, or event spaces, such as [zap.stream](https://zap.stream).
90-
91-
## Example
92-
93-
### Live Streaming
89+
#### Live Streaming
9490

9591
```json
9692
{
@@ -114,7 +110,7 @@ Common use cases include meeting rooms/workshops, watch-together activities, or
114110
}
115111
```
116112

117-
### Live Streaming chat message
113+
#### Live Streaming chat message
118114

119115
```json
120116
{
@@ -130,18 +126,13 @@ Common use cases include meeting rooms/workshops, watch-together activities, or
130126
}
131127
```
132128

133-
## Interactive Rooms and Meetings
134-
-----
135-
136-
`draft` `optional`
129+
## Meeting Spaces
137130

138-
Service providers want to offer Interactive Rooms to the Nostr network in such a way that participants can easily log and query by clients. This NIP describes a general framework to advertise rooms and their associated events.
131+
Meeting spaces contain one or more video/audio rooms where users can join and participate in the streaming.
139132

140-
## Concepts
133+
### Meeting Space Event (kind:30312)
141134

142-
### Interactive Room (kind:30312)
143-
144-
A special event with `kind:30312` "Interactive Room" defines the configuration and properties of a virtual interactive space. Each room has a unique identifier and can host multiple events/meetings.
135+
A special event with `kind:30312` "Space Host" defines the configuration and properties of a virtual interactive space. Each space has a unique identifier and can host multiple events/meetings.
145136

146137
```jsonc
147138
{
@@ -162,19 +153,20 @@ A special event with `kind:30312` "Interactive Room" defines the configuration a
162153
}
163154
```
164155

165-
Room properties:
156+
Space properties:
166157
* MUST be either open, private or closed. Closed means the room is not in operation.
167158
* MAY specify access control policy for private rooms (e.g. invite-only, payment required)
168159
* MAY persist when not in use
169160
* MUST have at least one provider with "Host" role
170161
* MAY have multiple providers with different roles
162+
171163
Provider roles (p tags):
172164
* Host: Full room management capabilities
173165
* Moderator: Room moderation capabilities
174166
* Speaker: Allowed to present/speak
175167
* Optional proof field for role verification
176168

177-
### Room Meeting (kind:30313)
169+
### Meeting Room Events (kind:30313)
178170

179171
A special event with kind:30313 represents a scheduled or ongoing meeting within a room. It MUST reference its parent room using the d tag.
180172

@@ -183,7 +175,7 @@ A special event with kind:30313 represents a scheduled or ongoing meeting within
183175
"kind": 30313,
184176
"tags": [
185177
["d", "<event-unique-identifier>"], // Required: Event identifier
186-
["a", "30312:<pubkey>:<room-id>", "wss://nostr.example.com"], // Required: Reference to parent room, 'd' from 30312
178+
["a", "30312:<pubkey>:<room-id>", "wss://nostr.example.com"], // Required: Reference to parent space, 'd' from 30312
187179
["title", "<meeting-title>"], // Required: Meeting title
188180
["summary", "<description>"], // Optional: Meeting description
189181
["image", "<preview image url>"], // Optional: Meeting image
@@ -204,14 +196,15 @@ Event properties:
204196
* MUST have a start time
205197
* MAY track participant counts
206198
* MAY include participant roles specific to the event
199+
207200
Event management:
208201
* Clients SHOULD update event status regularly when live
209202
* Events without updates for 1 hour MAY be considered ended
210203
* starts and ends timestamps SHOULD be updated when status changes
211204

212-
Examples
205+
### Examples
213206

214-
Interactive Room (kind:30312)
207+
#### Meeting Space (kind:30312)
215208

216209
```jsonc
217210
{
@@ -233,7 +226,7 @@ Interactive Room (kind:30312)
233226
}
234227
```
235228

236-
Conference Event (kind:30313)
229+
#### Meeting room (kind:30313)
237230

238231
```jsonc
239232
{
@@ -254,7 +247,7 @@ Conference Event (kind:30313)
254247
"content": ""
255248
}
256249
```
257-
## Room Presence
250+
### Room Presence
258251

259252
New `kind: 10312` provides an event which signals presence of a listener.
260253

0 commit comments

Comments
 (0)