modules/stream_out/rtp.h

   1 /*****************************************************************************
   2  * rtp.h: rtp stream output module header
   3  *****************************************************************************
   4  * Copyright (C) 2003-2007 VLC authors and VideoLAN
   5  * $Id$
   6  *
   7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
   8  *          Rémi Denis-Courmont
   9  *
  10  * This program is free software; you can redistribute it and/or modify it
  11  * under the terms of the GNU Lesser General Public License as published by
  12  * the Free Software Foundation; either version 2.1 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18  * GNU Lesser General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU Lesser General Public License
  21  * along with this program; if not, write to the Free Software Foundation,
  22  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 typedef struct rtsp_stream_t rtsp_stream_t;
  26 typedef struct rtsp_stream_id_t rtsp_stream_id_t;
  27
  28 rtsp_stream_t *RtspSetup( vlc_object_t *owner, vod_media_t *media,
  29                           const char *path );
  30 void RtspUnsetup( rtsp_stream_t *rtsp );
  31
  32 rtsp_stream_id_t *RtspAddId( rtsp_stream_t *rtsp, sout_stream_id_sys_t *sid,
  33                              uint32_t ssrc, unsigned clock_rate,
  34                              int mcast_fd );
  35 void RtspDelId( rtsp_stream_t *rtsp, rtsp_stream_id_t * );
  36
  37 char *RtspAppendTrackPath( rtsp_stream_id_t *id, const char *base );
  38
  39 int RtspTrackAttach( rtsp_stream_t *rtsp, const char *name,
  40                      rtsp_stream_id_t *id, sout_stream_id_sys_t *sout_id,
  41                      uint32_t *ssrc, uint16_t *seq_init );
  42 void RtspTrackDetach( rtsp_stream_t *rtsp, const char *name,
  43                       sout_stream_id_sys_t *sout_id);
  44
  45 char *SDPGenerate( sout_stream_t *p_stream, const char *rtsp_url );
  46 char *SDPGenerateVoD( const vod_media_t *p_media, const char *rtsp_url );
  47
  48 uint32_t rtp_compute_ts( unsigned i_clock_rate, int64_t i_pts );
  49 int rtp_add_sink( sout_stream_id_sys_t *id, int fd, bool rtcp_mux, uint16_t *seq );
  50 void rtp_del_sink( sout_stream_id_sys_t *id, int fd );
  51 uint16_t rtp_get_seq( sout_stream_id_sys_t *id );
  52 int64_t rtp_get_ts( const sout_stream_t *p_stream, const sout_stream_id_sys_t *id,
  53                     const vod_media_t *p_media, const char *psz_vod_session,
  54                     int64_t *p_npt );
  55
  56 /* RTP packetization */
  57 void rtp_packetize_common (sout_stream_id_sys_t *id, block_t *out,
  58                            bool b_m_bit, int64_t i_pts);
  59 void rtp_packetize_send (sout_stream_id_sys_t *id, block_t *out);
  60 size_t rtp_mtu (const sout_stream_id_sys_t *id);
  61
  62 int rtp_packetize_xiph_config( sout_stream_id_sys_t *id, const char *fmtp,
  63                                int64_t i_pts );
  64
  65 /* RTCP */
  66 typedef struct rtcp_sender_t rtcp_sender_t;
  67 rtcp_sender_t *OpenRTCP (vlc_object_t *obj, int rtp_fd, int proto,
  68                          bool mux);
  69 void CloseRTCP (rtcp_sender_t *rtcp);
  70 void SendRTCP (rtcp_sender_t *restrict rtcp, const block_t *rtp);
  71
  72 typedef int (*pf_rtp_packetizer_t)( sout_stream_id_sys_t *, block_t * );
  73
  74 typedef struct rtp_format_t
  75 {
  76     /* Used for SDP and packetization */
  77     uint8_t      payload_type;
  78     unsigned     clock_rate;
  79     unsigned     channels;
  80     enum es_format_category_e cat;
  81     /* Used in SDP only */
  82     unsigned     bitrate;
  83     const char  *ptname;
  84     char        *fmtp;
  85     /* Used for packetization only */
  86     pf_rtp_packetizer_t pf_packetize;
  87 } rtp_format_t;
  88
  89 int rtp_get_fmt( vlc_object_t *obj, const es_format_t *p_fmt, const char *mux,
  90                  rtp_format_t *p_rtp_fmt );
  91
  92 /* Only used by rtp_packetize_rawvideo */
  93 void rtp_get_video_geometry( sout_stream_id_sys_t *id, int *width, int *height );
  94 uint16_t rtp_get_extended_sequence( sout_stream_id_sys_t *id );
  95
  96 /* VoD */
  97 int  OpenVoD ( vlc_object_t * );
  98 void CloseVoD( vlc_object_t * );
  99
 100 int vod_check_range(vod_media_t *p_media, const char *psz_session,
 101                     int64_t start, int64_t end);
 102 void vod_play(vod_media_t *p_media, const char *psz_session,
 103               int64_t *start, int64_t end);
 104 void vod_pause(vod_media_t *p_media, const char *psz_session, int64_t *npt);
 105 void vod_stop(vod_media_t *p_media, const char *psz_session);
 106
 107 const char *vod_get_mux(const vod_media_t *p_media);
 108 int vod_init_id(vod_media_t *p_media, const char *psz_session, int es_id,
 109                 sout_stream_id_sys_t *sout_id, rtp_format_t *rtp_fmt,
 110                 uint32_t *ssrc, uint16_t *seq_init);
 111 void vod_detach_id(vod_media_t *p_media, const char *psz_session,
 112                    sout_stream_id_sys_t *sout_id);
 113