audiolevelextension.go 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. package rtp
  2. import (
  3. "errors"
  4. )
  5. const (
  6. // audioLevelExtensionSize One byte header size
  7. audioLevelExtensionSize = 1
  8. )
  9. var errAudioLevelOverflow = errors.New("audio level overflow")
  10. // AudioLevelExtension is a extension payload format described in
  11. // https://tools.ietf.org/html/rfc6464
  12. //
  13. // Implementation based on:
  14. // https://chromium.googlesource.com/external/webrtc/+/e2a017725570ead5946a4ca8235af27470ca0df9/webrtc/modules/rtp_rtcp/source/rtp_header_extensions.cc#49
  15. //
  16. // One byte format:
  17. // 0 1
  18. // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
  19. // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  20. // | ID | len=0 |V| level |
  21. // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  22. //
  23. // Two byte format:
  24. // 0 1 2 3
  25. // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  26. // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  27. // | ID | len=1 |V| level | 0 (pad) |
  28. // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  29. type AudioLevelExtension struct {
  30. Level uint8
  31. Voice bool
  32. }
  33. // Marshal serializes the members to buffer
  34. func (a AudioLevelExtension) Marshal() ([]byte, error) {
  35. if a.Level > 127 {
  36. return nil, errAudioLevelOverflow
  37. }
  38. voice := uint8(0x00)
  39. if a.Voice {
  40. voice = 0x80
  41. }
  42. buf := make([]byte, audioLevelExtensionSize)
  43. buf[0] = voice | a.Level
  44. return buf, nil
  45. }
  46. // Unmarshal parses the passed byte slice and stores the result in the members
  47. func (a *AudioLevelExtension) Unmarshal(rawData []byte) error {
  48. if len(rawData) < audioLevelExtensionSize {
  49. return errTooSmall
  50. }
  51. a.Level = rawData[0] & 0x7F
  52. a.Voice = rawData[0]&0x80 != 0
  53. return nil
  54. }