diff --git a/docs/calls/livekit.mdx b/docs/calls/livekit.mdx index fae599158..35438cf8a 100644 --- a/docs/calls/livekit.mdx +++ b/docs/calls/livekit.mdx @@ -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]. + + + + +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 +``` + + +```sh +docker run --rm docker.io/livekit/livekit-cli --url https://livekit.example.com \ + --api-key APIUxUnMnSkuFWV \ + --api-secret t93ZVjPeoEdyx7Wbet3kG4L3NGZIZVEFvqe0UuiVc22A \ + token create --create --join +``` + + + +[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.