add partial client read example; fix #16

examples/client-read-partial.go

@@ -0,0 +1,63 @@
+// +build ignore
+
+package main
+
+import (
+	"fmt"
+
+	"github.com/aler9/gortsplib"
+	"github.com/aler9/gortsplib/pkg/base"
+	"github.com/aler9/gortsplib/pkg/headers"
+)
+
+// This example shows how to
+// 1. connect to a RTSP server
+// 2. get tracks published on a path
+// 3. read only selected tracks
+
+func main() {
+	u, err := base.ParseURL("rtsp://myserver/mypath")
+	if err != nil {
+		panic(err)
+	}
+
+	conn, err := gortsplib.Dial(u.Host)
+	if err != nil {
+		panic(err)
+	}
+	defer conn.Close()
+
+	_, err = conn.Options(u)
+	if err != nil {
+		panic(err)
+	}
+
+	tracks, _, err := conn.Describe(u)
+	if err != nil {
+		panic(err)
+	}
+
+	for _, t := range tracks {
+		// start reading only video tracks, skipping audio or application tracks
+		if t.Media.MediaName.Media == "video" {
+			_, err := conn.Setup(headers.TransportModePlay, t, 0, 0)
+			if err != nil {
+				panic(err)
+			}
+		}
+	}
+
+	_, err = conn.Play()
+	if err != nil {
+		panic(err)
+	}
+
+	// read track frames
+	readerDone := conn.OnFrame(func(id int, typ gortsplib.StreamType, buf []byte) {
+		fmt.Printf("frame from track %d, type %v: %v\n", id, typ, buf)
+	})
+
+	// catch any error
+	err = <-readerDone
+	panic(err)
+}