hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
/**********
This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the
Free Software Foundation; either version 3 of the License, or (at your
option) any later version. (See <http://www.gnu.org/copyleft/lesser.html>.)
 
This library is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for
more details.
 
You should have received a copy of the GNU Lesser General Public License
along with this library; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
**********/
// "liveMedia"
// Copyright (c) 1996-2017 Live Networks, Inc.  All rights reserved.
// RTP sink for Vorbis audio
// C++ header
 
#ifndef _VORBIS_AUDIO_RTP_SINK_HH
#define _VORBIS_AUDIO_RTP_SINK_HH
 
#ifndef _AUDIO_RTP_SINK_HH
#include "AudioRTPSink.hh"
#endif
 
class VorbisAudioRTPSink: public AudioRTPSink {
public:
  static VorbisAudioRTPSink*
  createNew(UsageEnvironment& env, Groupsock* RTPgs, u_int8_t rtpPayloadFormat,
       u_int32_t rtpTimestampFrequency, unsigned numChannels,
       // The following headers provide the 'configuration' information, for the SDP description:
       u_int8_t* identificationHeader, unsigned identificationHeaderSize,
       u_int8_t* commentHeader, unsigned commentHeaderSize,
       u_int8_t* setupHeader, unsigned setupHeaderSize,
       u_int32_t identField = 0xFACADE);
 
  static VorbisAudioRTPSink*
  createNew(UsageEnvironment& env, Groupsock* RTPgs, u_int8_t rtpPayloadFormat,
       u_int32_t rtpTimestampFrequency, unsigned numChannels,
       char const* configStr);
    // an optional variant of "createNew()" that takes a Base-64-encoded 'configuration' string,
    // rather than the raw configuration headers as parameter.
 
protected:
  VorbisAudioRTPSink(UsageEnvironment& env, Groupsock* RTPgs,
            u_int8_t rtpPayloadFormat, u_int32_t rtpTimestampFrequency, unsigned numChannels,
            u_int8_t* identificationHeader, unsigned identificationHeaderSize,
            u_int8_t* commentHeader, unsigned commentHeaderSize,
            u_int8_t* setupHeader, unsigned setupHeaderSize,
            u_int32_t identField);
   // called only by createNew()
 
  virtual ~VorbisAudioRTPSink();
 
private: // redefined virtual functions:
  virtual char const* auxSDPLine(); // for the "a=fmtp:" SDP line
 
  virtual void doSpecialFrameHandling(unsigned fragmentationOffset,
                                      unsigned char* frameStart,
                                      unsigned numBytesInFrame,
                                      struct timeval framePresentationTime,
                                      unsigned numRemainingBytes);
  virtual Boolean frameCanAppearAfterPacketStart(unsigned char const* frameStart,
                        unsigned numBytesInFrame) const;
  virtual unsigned specialHeaderSize() const;
  virtual unsigned frameSpecificHeaderSize() const;
 
private:
  u_int32_t fIdent; // "Ident" field used by this stream.  (Only the low 24 bits of this are used.)
  char* fFmtpSDPLine;
};
 
 
// A general function used by both "VorbisAudioRTPSink" and "TheoraVideoRTPSink" to construct
// a Base64-encoded 'config' string (for SDP) from "identification", "comment", "setup" headers.
// (Note: The result string was heap-allocated, and the caller should delete[] it afterwards.)
 
char* generateVorbisOrTheoraConfigStr(u_int8_t* identificationHeader, unsigned identificationHeaderSize,
                     u_int8_t* commentHeader, unsigned commentHeaderSize,
                     u_int8_t* setupHeader, unsigned setupHeaderSize,
                     u_int32_t identField);
 
#endif