Compare commits

..

No commits in common. "7d8488adc7ea2d9b5d268f3e51ec10426d806edf" and "386354fd65089a16aba8174d49271f6ed09c95a5" have entirely different histories.

1 changed files with 18 additions and 26 deletions

View File

@ -8,9 +8,7 @@ LVSP runs over a *long-lived* websocket with TLS. The encoding is JSON.
## OP code table
"client" is litecord. "server" is the voice server.
note: only the opcode is sent in a message, so the names are determined by the implementation of LVSP.
"client" is litecord. "server" is the voice server.
| opcode | name | sent by |
| --: | :-- | :-- |
@ -121,17 +119,15 @@ are laid on.
### InfoType Enum
note: this enum is only ever identified by its opcode, so the `name` field can differ from the values in this enum without error.
| value | name | description |
| --: | :-- | :-- |
| 0 | CHANNEL\_REQ | channel assignment request |
| 1 | CHANNEL\_ASSIGN | channel assignment reply |
| 2 | CHANNEL\_DESTROY | channel destroy |
| 3 | VOICE\_STATE\_CREATE | voice state create request |
| 4 | VOICE\_STATE\_DONE | voice state created |
| 5 | VOICE\_STATE\_DESTROY | voice state destroy |
| 6 | VOICE\_STATE\_UPDATE | voice state update |
| 3 | VST\_CREATE | voice state create request |
| 4 | VST\_DONE | voice state created |
| 5 | VST\_UPDATE | voice state update |
| 6 | VST\_LEAVE | voice state leave |
### CHANNEL\_REQ
@ -162,7 +158,7 @@ a channel being deleted, or all members in it leaving.
Same data as CHANNEL\_ASSIGN, but without `token`.
### VOICE\_STATE\_CREATE
### VST\_CREATE
Sent by the client to create a voice state.
@ -172,25 +168,21 @@ Sent by the client to create a voice state.
| channel\_id | snowflake | channel id |
| guild\_id | Optional[snowflake] | guild id. not provided if dm / group dm |
### VOICE\_STATE\_DONE
### VST\_DONE
Sent by the server to indicate the success of a VOICE\_STATE\_CREATE.
Sent by the server to indicate the success of a VST\_CREATE.
Has the same fields as VOICE\_STATE\_CREATE, but with extras:
Has the same fields as VST\_CREATE, but with extras:
| field | type | description |
| --: | :-- | :-- |
| session\_id | string | session id for the voice state |
### VOICE\_STATE\_DESTROY
### VST\_DESTROY
Sent by the client when a user is leaving a channel OR moving between channels
in a guild. More on state transitions later on.
### VOICE\_STATE\_UPDATE
Sent to update an existing voice state. Potentially unused.
| field | type | description |
| --: | :-- | :-- |
| session\_id | string | session id for the voice state |
@ -203,11 +195,11 @@ Since the channel is unitialized, both logic on initialization AND
user join is here.
- Client will send a CHANNEL\_REQ.
- Client MAY send a VOICE\_STATE\_CREATE right after as well.
- Client MAY send a VST\_CREATE right after as well.
- The Server MUST process CHANNEL\_REQ first, so the Server can keep
a lock on channel operations while it is initialized.
- Reply with CHANNEL\_ASSIGN once initialization is done.
- Process VOICE\_STATE\_CREATE
- Process VST\_CREATE
### Updating a voice channel
@ -222,15 +214,15 @@ user join is here.
### User joining an (initialized) voice channel
- Client sends VOICE\_STATE\_CREATE
- Server sends VOICE\_STATE\_DONE
- Client sends VST\_CREATE
- Server sends VST\_DONE
### User leaves a channel
- Client sends VOICE\_STATE\_DESTROY with the old fields
- Client sends VST\_DESTROY with the old fields
### User moves a channel
- Client sends VOICE\_STATE\_DESTROY with the old fields
- Client sends VOICE\_STATE\_CREATE with the new fields
- Server sends VOICE\_STATE\_DONE
- Client sends VST\_DESTROY with the old fields
- Client sends VST\_CREATE with the new fields
- Server sends VST\_DONE