mirror of
https://github.com/aler9/gortsplib
synced 2025-11-03 03:03:31 +08:00
98 lines
4.2 KiB
Markdown
98 lines
4.2 KiB
Markdown
|
|
# gortsplib
|
|
|
|
[](https://github.com/aler9/gortsplib/actions?query=workflow:test)
|
|
[](https://github.com/aler9/gortsplib/actions?query=workflow:lint)
|
|
[](https://goreportcard.com/report/github.com/aler9/gortsplib)
|
|
[](https://codecov.io/gh/aler9/gortsplib/branch/main)
|
|
[](https://pkg.go.dev/github.com/aler9/gortsplib#pkg-index)
|
|
|
|
RTSP 1.0 client and server library for the Go programming language, written for [rtsp-simple-server](https://github.com/aler9/rtsp-simple-server).
|
|
|
|
Go ≥ 1.17 is required.
|
|
|
|
Features:
|
|
|
|
* Client
|
|
* Query servers about available streams and tracks
|
|
* Read
|
|
* Read streams from servers with the UDP, UDP-multicast or TCP transport protocol
|
|
* Read TLS-encrypted streams (TCP only)
|
|
* Switch transport protocol automatically
|
|
* Read only selected tracks of a stream
|
|
* Pause or seek without disconnecting from the server
|
|
* Generate RTCP receiver reports (UDP only)
|
|
* Reorder incoming RTP packets (UDP only)
|
|
* Clean up non-compliant streams (remove padding, re-encode RTP packets if they are too big)
|
|
* Publish
|
|
* Publish streams to servers with the UDP or TCP transport protocol
|
|
* Publish TLS-encrypted streams (TCP only)
|
|
* Switch transport protocol automatically
|
|
* Pause without disconnecting from the server
|
|
* Generate RTCP sender reports (UDP only)
|
|
* Server
|
|
* Handle requests from clients
|
|
* Sessions and connections are independent
|
|
* Publish
|
|
* Read streams from clients with the UDP or TCP transport protocol
|
|
* Read TLS-encrypted streams (TCP only)
|
|
* Generate RTCP receiver reports (UDP only)
|
|
* Reorder incoming RTP packets (UDP only)
|
|
* Clean up non-compliant streams (remove padding, re-encode RTP packets if they are too big)
|
|
* Read
|
|
* Write streams to clients with the UDP, UDP-multicast or TCP transport protocol
|
|
* Write TLS-encrypted streams
|
|
* Compute and provide SSRC, RTP-Info to clients
|
|
* Generate RTCP sender reports (UDP only)
|
|
* Utilities
|
|
* Parse RTSP elements: requests, responses, SDP
|
|
* Parse H264 elements and formats: RTP/H264, Annex-B, AVCC, anti-competition, DTS
|
|
* Parse AAC elements and formats: RTP/AAC, ADTS, MPEG-4 audio configurations
|
|
|
|
## Table of contents
|
|
|
|
* [Examples](#examples)
|
|
* [API Documentation](#api-documentation)
|
|
* [Links](#links)
|
|
|
|
## Examples
|
|
|
|
* [client-query](examples/client-query/main.go)
|
|
* [client-read](examples/client-read/main.go)
|
|
* [client-read-partial](examples/client-read-partial/main.go)
|
|
* [client-read-options](examples/client-read-options/main.go)
|
|
* [client-read-pause](examples/client-read-pause/main.go)
|
|
* [client-read-h264](examples/client-read-h264/main.go)
|
|
* [client-read-h264-convert-to-jpeg](examples/client-read-h264-convert-to-jpeg/main.go)
|
|
* [client-read-h264-save-to-disk](examples/client-read-h264-save-to-disk/main.go)
|
|
* [client-read-aac](examples/client-read-aac/main.go)
|
|
* [client-read-republish](examples/client-read-republish/main.go)
|
|
* [client-publish-h264](examples/client-publish-h264/main.go)
|
|
* [client-publish-pcmu](examples/client-publish-pcmu/main.go)
|
|
* [client-publish-aac](examples/client-publish-aac/main.go)
|
|
* [client-publish-opus](examples/client-publish-opus/main.go)
|
|
* [client-publish-options](examples/client-publish-options/main.go)
|
|
* [client-publish-pause](examples/client-publish-pause/main.go)
|
|
* [server](examples/server/main.go)
|
|
* [server-tls](examples/server-tls/main.go)
|
|
|
|
## API Documentation
|
|
|
|
https://pkg.go.dev/github.com/aler9/gortsplib#pkg-index
|
|
|
|
## Links
|
|
|
|
Related projects
|
|
|
|
* rtsp-simple-server https://github.com/aler9/rtsp-simple-server
|
|
* pion/sdp (SDP library used internally) https://github.com/pion/sdp
|
|
* pion/rtp (RTP library used internally) https://github.com/pion/rtp
|
|
* pion/rtcp (RTCP library used internally) https://github.com/pion/rtcp
|
|
|
|
Standards
|
|
|
|
* RTSP 1.0 https://tools.ietf.org/html/rfc2326
|
|
* RTSP 2.0 https://tools.ietf.org/html/rfc7826
|
|
* HTTP 1.1 https://tools.ietf.org/html/rfc2616
|
|
* Golang project layout https://github.com/golang-standards/project-layout
|