dash

package module
v1.31.8 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 22, 2025 License: OSL-3.0 Imports: 10 Imported by: 2

README

DASH

Some things are hidden for a reason, and if you see them, you'll be changed forever, but I wanted to be changed forever.

Miranda July

Go language, I need a package for DASH (MPD) files

  1. standard library only
  2. use a separate file for each type
  3. only send new or updated files
  4. package is named "dash"
  5. package will include a parse method, byte slice input
  6. BaseURL is a single element not a slice
  7. support these elements and attributes
    • MPD
      • @mediaPresentationDuration
      • BaseURL
      • Period
        • @duration
        • @id
        • BaseURL
        • AdaptationSet
          • @codecs
          • @height
          • @lang
          • @mimeType
          • @width
          • ContentProtection
            • @schemeIdUri
            • cenc:pssh
          • Role
            • @value
          • SegmentTemplate
            • @duration
            • @endNumber
            • @initialization
            • @media
            • @presentationTimeOffset
            • @startNumber
            • @timescale
            • SegmentTimeline
              • S
                • @d
                • @r
          • Representation
            • @bandwidth
            • @codecs
            • @height
            • @id
            • @mimeType
            • @width
            • BaseURL
            • SegmentTemplate
            • ContentProtection
            • SegmentBase
              • @indexRange
              • Initialization
                • @range
            • SegmentList
              • Initialization
                • @sourceURL
              • SegmentURL
                • @media
  8. add navigation
    1. from AdaptationSet to Period
    2. from Initialization to SegmentList
    3. from Period to MPD
    4. from Representation to AdaptationSet
    5. from SegmentList to Representation
    6. from SegmentTemplate to AdaptationSet
    7. from SegmentTemplate to Representation
    8. from SegmentURL to SegmentList
  9. resolve BaseURL using
    1. MPD URL
    2. all parent BaseURL
  10. resolve Initialization@sourceURL using
  11. MPD URL
  12. all parent BaseURL
  13. resolve SegmentTemplate@initialization using
  14. MPD URL
  15. all parent BaseURL
  16. resolve SegmentTemplate@media using
  17. MPD URL
  18. all parent BaseURL
  19. resolve SegmentURL@media using
  20. MPD URL
  21. all parent BaseURL
  22. resolve function should return *url.URL
  23. add method to get all Representation, group by id
  24. add method to get codecs
  25. add method to get height
  26. add method to get width
  27. add method to get mimeType
  28. AdaptationSet.Role is single element not slice
  29. add method to get SegmentTemplate
  30. add method to replace SegmentTemplate@initialization
  • $RepresentationID$
  1. add method to replace SegmentTemplate@media
  • $Number$
  • $Number%02d$
  • $Number%03d$
  • $Number%04d$
  • $Number%05d$
  • $Number%06d$
  • $Number%07d$
  • $Number%08d$
  • $Number%09d$
  • $RepresentationID$
  1. add method to replace SegmentTemplate@media
  • $RepresentationID$
  • $Time$
  1. SegmentTemplate@startNumber is 1 if missing
  2. SegmentTemplate@timescale is 1 if missing
  3. Period@duration is MPD@mediaPresentationDuration if missing
  4. add method to get Time values from SegmentTimeline
  5. add method to get Number values from SegmentTimeline
  6. add method to get Number values from SegmentTemplate@startNumber to SegmentTemplate@endNumber
  7. add method to get Number values from Ceil( AsSeconds(Period@duration) / (SegmentTemplate@duration / SegmentTemplate@timescale) )
  8. add a method that returns the SegmentTemplate URLs
  9. use SegmentTemplate@presentationTimeOffset as initial $Time$
  10. add method to get time.Duration 
    time.ParseDuration(strings.ToLower(
   strings.TrimPrefix(Period@duration, "PT"),
))
  11. add method to get unique ContentProtection from
  • AdaptationSet
  • Representation
  1. include test file in same package
  • test will read all ".mpd" files in the "testdata" folder
  • user will provide test files
  • for each file, get the slice of replaced SegmentTemplate@media URLs
  • only get one slice of URLs per mimeType
  • print slice length, and first and last URLs
  1. add Representation.String method. each value on its own line
  2. Representation@bandwidth
  3. Representation.GetWidth
  4. Representation.GetHeight
  5. Representation.GetCodecs
  6. Representation.GetMimeType
  7. AdaptationSet@lang
  8. Role@value
  9. Period@id
  10. Representation@id

contact

email
[email protected]
Discord username
10308

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func FormatRange added in v1.31.6 

func FormatRange(start, end uint64) string

func ParseRange added in v1.28.5 

func ParseRange(input string) (uint64, uint64, error)

Types

type AdaptationSet 

type AdaptationSet struct {
	Codecs            string               `xml:"codecs,attr"`
	ContentProtection []*ContentProtection `xml:"ContentProtection"`
	Height            int                  `xml:"height,attr"`
	Label             string               `xml:"Label"`
	Lang              string               `xml:"lang,attr"`
	MimeType          string               `xml:"mimeType,attr"`
	Representations   []*Representation    `xml:"Representation"`
	Role              *Role                `xml:"Role"`
	SegmentTemplate   *SegmentTemplate     `xml:"SegmentTemplate"`
	Width             int                  `xml:"width,attr"`
	// Navigation
	Parent *Period `xml:"-"`
}

AdaptationSet groups Representations.

type ContentProtection 

type ContentProtection struct {
	SchemeIdUri string `xml:"schemeIdUri,attr"`
	// DefaultKid maps to cenc:default_KID (urn:mpeg:cenc:2013)
	DefaultKid string `xml:"urn:mpeg:cenc:2013 default_KID,attr"`
	// Pssh maps to the cenc:pssh element (urn:mpeg:cenc:2013)
	Pssh string `xml:"urn:mpeg:cenc:2013 pssh"`
}

ContentProtection specifies DRM schemes.

func (*ContentProtection) GetDefaultKid added in v1.31.0 

func (cp *ContentProtection) GetDefaultKid() ([]byte, error)

GetDefaultKid returns the DefaultKid as a byte slice.

func (*ContentProtection) GetPssh added in v1.31.0 

func (cp *ContentProtection) GetPssh() ([]byte, error)

GetPssh returns the PSSH data as a byte slice.

type Initialization added in v1.25.4 

type Initialization struct {
	// Used in SegmentBase
	Range string `xml:"range,attr"`
	// Used in SegmentList
	SourceUrl string `xml:"sourceURL,attr"`
	// Navigation
	Parent *SegmentList `xml:"-"`
}

Initialization contains URL and byte range information for initialization segments.

func (*Initialization) ResolveSourceUrl added in v1.31.0 

func (i *Initialization) ResolveSourceUrl() (*url.URL, error)

ResolveSourceUrl resolves the @sourceURL attribute against the parent SegmentList's context.

type Mpd 

type Mpd struct {
	MediaPresentationDuration string    `xml:"mediaPresentationDuration,attr"`
	BaseUrl                   string    `xml:"BaseURL"`
	Periods                   []*Period `xml:"Period"`
	MpdUrl                    *url.URL  `xml:"-"`
}

Mpd represents the root element of the DASH MPD file.

func Parse added in v1.28.4 

func Parse(data []byte) (*Mpd, error)

Parse takes a byte slice of an MPD file, unmarshals it, links navigation parents, and normalizes Representation IDs.

func (*Mpd) GetRepresentations added in v1.31.0 

func (m *Mpd) GetRepresentations() map[string][]*Representation

GetRepresentations returns a map of all Representations keyed by their Id.

func (*Mpd) ResolveBaseUrl added in v1.31.0 

func (m *Mpd) ResolveBaseUrl() (*url.URL, error)

ResolveBaseUrl resolves the MPD's BaseURL against the MpdUrl.

type Period 

type Period struct {
	Duration       string           `xml:"duration,attr"`
	Id             string           `xml:"id,attr"`
	BaseUrl        string           `xml:"BaseURL"`
	AdaptationSets []*AdaptationSet `xml:"AdaptationSet"`
	// Navigation
	Parent *Mpd `xml:"-"`
}

Period represents a temporal part of the media content.

func (*Period) GetDuration added in v1.28.4 

func (p *Period) GetDuration() (time.Duration, error)

GetDuration parses the ISO 8601 Duration attribute.

func (*Period) ResolveBaseUrl added in v1.31.0 

func (p *Period) ResolveBaseUrl() (*url.URL, error)

ResolveBaseUrl resolves the Period's BaseURL against the parent Mpd's resolved BaseUrl.

type Representation 

type Representation struct {
	Bandwidth         int                  `xml:"bandwidth,attr"`
	Codecs            string               `xml:"codecs,attr"`
	Height            int                  `xml:"height,attr"`
	Id                string               `xml:"id,attr"`
	MimeType          string               `xml:"mimeType,attr"`
	Width             int                  `xml:"width,attr"`
	BaseUrl           string               `xml:"BaseURL"`
	SegmentTemplate   *SegmentTemplate     `xml:"SegmentTemplate"`
	ContentProtection []*ContentProtection `xml:"ContentProtection"`
	SegmentBase       *SegmentBase         `xml:"SegmentBase"`
	SegmentList       *SegmentList         `xml:"SegmentList"`
	Parent            *AdaptationSet       `xml:"-"`
}

Representation describes a version of the media content.

func (*Representation) GetCodecs added in v1.28.4 

func (r *Representation) GetCodecs() string

func (*Representation) GetContentProtection added in v1.28.8 

func (r *Representation) GetContentProtection() []*ContentProtection

func (*Representation) GetHeight added in v1.28.4 

func (r *Representation) GetHeight() int

func (*Representation) GetLabel added in v1.31.7 

func (r *Representation) GetLabel() string

func (*Representation) GetLang added in v1.31.7 

func (r *Representation) GetLang() string

func (*Representation) GetMimeType added in v1.25.2 

func (r *Representation) GetMimeType() string

func (*Representation) GetPeriodId added in v1.31.7 

func (r *Representation) GetPeriodId() string

func (*Representation) GetRole added in v1.31.7 

func (r *Representation) GetRole() string

func (*Representation) GetSegmentTemplate added in v1.28.4 

func (r *Representation) GetSegmentTemplate() *SegmentTemplate

func (*Representation) GetWidth added in v1.28.4 

func (r *Representation) GetWidth() int

func (*Representation) ResolveBaseUrl added in v1.31.0 

func (r *Representation) ResolveBaseUrl() (*url.URL, error)

ResolveBaseUrl resolves the Representation's BaseURL against the parent hierarchy.

func (*Representation) String 

func (r *Representation) String() string

String returns a multi-line summary of the Representation.

type Role added in v1.28.4 

type Role struct {
	Value string `xml:"value,attr"`
}

Role defines the role of the media content.

type S added in v1.28.4 

type S struct {
	D uint `xml:"d,attr"` // Duration
	R int  `xml:"r,attr"` // Repeat count
}

S represents a segment within the timeline.

type SegmentBase 

type SegmentBase struct {
	IndexRange     string          `xml:"indexRange,attr"`
	Initialization *Initialization `xml:"Initialization"`
}

SegmentBase defines base information for segments.

type SegmentList added in v1.26.1 

type SegmentList struct {
	Duration       uint            `xml:"duration,attr"`
	Timescale      *uint           `xml:"timescale,attr"`
	Initialization *Initialization `xml:"Initialization"`
	SegmentUrls    []*SegmentUrl   `xml:"SegmentURL"`
	// Navigation
	Parent *Representation `xml:"-"`
}

SegmentList contains a list of SegmentUrls.

func (*SegmentList) GetTimescale added in v1.29.7 

func (sl *SegmentList) GetTimescale() uint

type SegmentTemplate 

type SegmentTemplate struct {
	Duration               uint             `xml:"duration,attr"`
	EndNumber              uint             `xml:"endNumber,attr"`
	Initialization         string           `xml:"initialization,attr"`
	Media                  string           `xml:"media,attr"`
	PresentationTimeOffset uint             `xml:"presentationTimeOffset,attr"`
	StartNumber            *uint            `xml:"startNumber,attr"`
	Timescale              *uint            `xml:"timescale,attr"`
	SegmentTimeline        *SegmentTimeline `xml:"SegmentTimeline"`
	// Navigation
	ParentAdaptationSet  *AdaptationSet  `xml:"-"`
	ParentRepresentation *Representation `xml:"-"`
}

SegmentTemplate defines specific rules for generating segment URLs.

func (*SegmentTemplate) GetDurationBasedNumbers added in v1.28.4 

func (st *SegmentTemplate) GetDurationBasedNumbers() ([]uint, error)

func (*SegmentTemplate) GetNumberRange added in v1.28.4 

func (st *SegmentTemplate) GetNumberRange() []uint

func (*SegmentTemplate) GetSegmentUrls added in v1.31.0 

func (st *SegmentTemplate) GetSegmentUrls(rep *Representation) ([]*url.URL, error)

func (*SegmentTemplate) GetStartNumber added in v1.28.4 

func (st *SegmentTemplate) GetStartNumber() uint

func (*SegmentTemplate) GetTimelineNumbers added in v1.28.4 

func (st *SegmentTemplate) GetTimelineNumbers() []uint

func (*SegmentTemplate) GetTimelineTimes added in v1.28.4 

func (st *SegmentTemplate) GetTimelineTimes() []uint

func (*SegmentTemplate) GetTimescale added in v1.28.4 

func (st *SegmentTemplate) GetTimescale() uint

func (*SegmentTemplate) ResolveInitialization added in v1.28.4 

func (st *SegmentTemplate) ResolveInitialization(rep *Representation) (*url.URL, error)

func (*SegmentTemplate) ResolveMedia added in v1.28.4 

func (st *SegmentTemplate) ResolveMedia(rep *Representation, number int) (*url.URL, error)

func (*SegmentTemplate) ResolveMediaTime added in v1.28.4 

func (st *SegmentTemplate) ResolveMediaTime(rep *Representation, timeVal int) (*url.URL, error)

type SegmentTimeline added in v1.28.4 

type SegmentTimeline struct {
	S []*S `xml:"S"`
}

SegmentTimeline defines specific timing for segments.

type SegmentUrl added in v1.31.0 

type SegmentUrl struct {
	Media string `xml:"media,attr"`
	// Navigation
	Parent *SegmentList `xml:"-"`
}

SegmentUrl defines a specific media segment source.

func (*SegmentUrl) ResolveMedia added in v1.31.0 

func (su *SegmentUrl) ResolveMedia() (*url.URL, error)

ResolveMedia resolves the @media attribute against the parent SegmentList's context.

Source Files

View all Source files

Directories

Path Synopsis
research
2025/10

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.