├── .github
└── workflows
│ └── ci.yml
├── .gitignore
├── LICENSE
├── README.md
├── conditional_unit.go
├── fixtures
├── akamai_bbb_30fps.mpd
├── elemental_delta_1.6.1_live.mpd
├── elemental_delta_live.mpd
└── elemental_delta_vod.mpd
├── go.mod
├── go.sum
├── mpd.go
└── mpd_test.go
/.github/workflows/ci.yml:
--------------------------------------------------------------------------------
1 | on:
2 | push:
3 | branches: [ master ]
4 |
5 | jobs:
6 | deploy:
7 | runs-on: ubuntu-latest
8 |
9 | steps:
10 | - uses: actions/checkout@v4
11 | - uses: actions/setup-go@v4
12 | with:
13 | go-version: '^1.20'
14 |
15 | - name: Run tests
16 | run: go test -v ./... -check.v
17 |
18 | - name: Update coverage report
19 | uses: ncruces/go-coverage-report@v0
20 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | *.ignore
2 | .idea
3 | go-mpd.iml
4 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 |
3 | Copyright (c) 2015 mc² software
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | [](https://github.com/unki2aut/go-mpd/actions/workflows/ci.yml) [](https://raw.githack.com/wiki/unki2aut/go-mpd/coverage.html) [](https://goreportcard.com/report/github.com/unki2aut/go-mpd) [](https://godoc.org/github.com/unki2aut/go-mpd)
2 | # go-mpd
3 |
4 | Go library for parsing and generating MPEG-DASH Media Presentation Description (MPD) files.
5 |
6 | This project is based on https://github.com/mc2soft/mpd.
7 |
8 | ## Usage
9 |
10 | ```go
11 | package main
12 |
13 | import (
14 | "fmt"
15 | "github.com/unki2aut/go-mpd"
16 | )
17 |
18 | func main() {
19 | mpd := new(mpd.MPD)
20 | mpd.Decode([]byte(`
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 | `))
38 |
39 | fmt.Println(mpd.MediaPresentationDuration)
40 | }
41 | ```
42 |
43 | ## Related links
44 | * https://en.wikipedia.org/wiki/Dynamic_Adaptive_Streaming_over_HTTP
45 | * [ISO_IEC_23009-1_2014 Standard](http://standards.iso.org/ittf/PubliclyAvailableStandards/c065274_ISO_IEC_23009-1_2014.zip)
46 |
47 | ## MPD parsing/generation in other languages
48 | * Javascript - https://github.com/videojs/mpd-parser
49 | * Python - https://github.com/sangwonl/python-mpegdash
50 | * Cpp - https://github.com/bitmovin/libdash
51 | * Java - https://github.com/carlanton/mpd-tools
52 |
--------------------------------------------------------------------------------
/conditional_unit.go:
--------------------------------------------------------------------------------
1 | package mpd
2 |
3 | import (
4 | "encoding/xml"
5 | "fmt"
6 | "strconv"
7 | )
8 |
9 | // ConditionalUint (ConditionalUintType) defined in XSD as a union of unsignedInt and boolean.
10 | type ConditionalUint struct {
11 | u *uint64
12 | b *bool
13 | }
14 |
15 | // MarshalXMLAttr encodes ConditionalUint.
16 | func (c ConditionalUint) MarshalXMLAttr(name xml.Name) (xml.Attr, error) {
17 | if c.u != nil {
18 | return xml.Attr{Name: name, Value: strconv.FormatUint(*c.u, 10)}, nil
19 | }
20 |
21 | if c.b != nil {
22 | return xml.Attr{Name: name, Value: strconv.FormatBool(*c.b)}, nil
23 | }
24 |
25 | // both are nil - no attribute, client will threat it like "false"
26 | return xml.Attr{}, nil
27 | }
28 |
29 | // UnmarshalXMLAttr decodes ConditionalUint.
30 | func (c *ConditionalUint) UnmarshalXMLAttr(attr xml.Attr) error {
31 | u, err := strconv.ParseUint(attr.Value, 10, 64)
32 | if err == nil {
33 | c.u = &u
34 | return nil
35 | }
36 |
37 | b, err := strconv.ParseBool(attr.Value)
38 | if err == nil {
39 | c.b = &b
40 | return nil
41 | }
42 |
43 | return fmt.Errorf("ConditionalUint: can't UnmarshalXMLAttr %#v", attr)
44 | }
45 |
46 | // check interfaces
47 | var (
48 | _ xml.MarshalerAttr = ConditionalUint{}
49 | _ xml.UnmarshalerAttr = &ConditionalUint{}
50 | )
51 |
--------------------------------------------------------------------------------
/fixtures/akamai_bbb_30fps.mpd:
--------------------------------------------------------------------------------
1 |
2 |
3 | ./
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
--------------------------------------------------------------------------------
/fixtures/elemental_delta_1.6.1_live.mpd:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |