mirror of
https://forgejo.ellis.link/continuwuation/continuwuity.git
synced 2026-11-12 19:56:48 +00:00
docs(livekit): Add appendix sectionon creating livekit tokens via livekit-cli
This commit is contained in:
1 parent
fb3113ea69
commit
c67f08a208
1 file changed
+32
-2
+32
-2
@@ -285,7 +285,7 @@ You can then send this payload to the lk-jwt-service:
|
||||
curl -X POST -d @payload.json https://livekit.example.com/get_token
|
||||
```
|
||||
|
||||
The lk-jwt-service will, after checking against Continuwuity, answer with a `jwt` token to create a LiveKit media room:
|
||||
The lk-jwt-service will, after checking against Continuwuity, answer with a `jwt` token to [create a LiveKit media room](#livekit-cli):
|
||||
|
||||
```json
|
||||
{"url":"wss://livekit.example.com","jwt":"a_really_really_long_string"}
|
||||
@@ -375,12 +375,13 @@ Specifications:
|
||||
- [MSC4195: MatrixRTC Transport using LiveKit Backend][MSC4195]
|
||||
- [MSC3401: Native Group VoIP Signalling][MSC3401] - state events for legacy calls
|
||||
- [MSC4075: MatrixRTC invites and notifications][MSC4075] - for ringing users
|
||||
- [MSC4354: Sticky Events] - for MatrixRTC 2.0 calls
|
||||
- [MSC4354: Sticky Events][MSC4354] - for MatrixRTC 2.0 calls
|
||||
|
||||
[MSC4143]: https://github.com/matrix-org/matrix-spec-proposals/pull/4143
|
||||
[MSC4195]: https://github.com/matrix-org/matrix-spec-proposals/pull/4195
|
||||
[MSC3401]: https://github.com/matrix-org/matrix-spec-proposals/pull/3401
|
||||
[MSC4075]: https://github.com/matrix-org/matrix-spec-proposals/pull/4075
|
||||
[MSC4354]: https://github.com/matrix-org/matrix-spec-proposals/pull/4354
|
||||
|
||||
Source code:
|
||||
|
||||
@@ -412,6 +413,35 @@ To support Legacy and Compatibility mode, ensure that the user is allowed to sen
|
||||
|
||||
To support MatrixRTC 2.0 mode, sticky events has to be enabled on the Matrix server. In Continuwuity, this is as easy as setting `enable_sticky_events = true` in the config file.
|
||||
|
||||
### Creating LiveKit tokens via `livekit-cli` {#livekit-cli}
|
||||
|
||||
To create room tokens directly without going through `lk-jwt-service`, use the [Livekit CLI tool][livekit-cli].
|
||||
|
||||
<Tabs groupId="livekit">
|
||||
<Tab label="Bare Binary">
|
||||
|
||||
First, download the [release tarball][livekit-cli-releases] and extract it. Then:
|
||||
|
||||
```sh
|
||||
./lk --url https://livekit.example.com \
|
||||
--api-key APIUxUnMnSkuFWV \
|
||||
--api-secret t93ZVjPeoEdyx7Wbet3kG4L3NGZIZVEFvqe0UuiVc22A \
|
||||
token create --create --join
|
||||
```
|
||||
</Tab>
|
||||
<Tab label="Docker">
|
||||
```sh
|
||||
docker run --rm docker.io/livekit/livekit-cli --url https://livekit.example.com \
|
||||
--api-key APIUxUnMnSkuFWV \
|
||||
--api-secret t93ZVjPeoEdyx7Wbet3kG4L3NGZIZVEFvqe0UuiVc22A \
|
||||
token create --create --join
|
||||
```
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
[livekit-cli]: https://github.com/livekit/livekit-cli
|
||||
[livekit-cli-releases]: https://github.com/livekit/livekit-cli
|
||||
|
||||
### Additional TURN-over-TLS on 443 configuration
|
||||
|
||||
Most of the time, LiveKit [**does not need TURN**][sspaeth-matrix-voip-turn] to function. However, there are situations where clients may be unable to use nonstandard ports or UDP connections, such as in highly restrictive networks. In such cases, a TURN-over-TLS server on port 443 could relay traffic for the clients.
|
||||
|
||||
Reference in new issue
Block a user