toxcore/toxav/rtp.h

154 lines
3.8 KiB
C
Raw Normal View History

/** rtp.h
2014-02-17 09:01:30 +08:00
*
* Copyright (C) 2013-2015 Tox project All Rights Reserved.
*
* This file is part of Tox.
*
* Tox is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Tox 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with Tox. If not, see <http://www.gnu.org/licenses/>.
*
*/
#ifndef RTP_H
#define RTP_H
#define RTP_VERSION 2
2014-02-16 03:44:33 +08:00
#include "../toxcore/Messenger.h"
#define LOGGED_LOCK(mutex) do { \
2015-04-08 07:00:19 +08:00
/*LOGGER_DEBUG("Locking mutex: %p", mutex);*/\
pthread_mutex_lock(mutex);\
2015-04-08 07:00:19 +08:00
/*LOGGER_DEBUG("Locked mutex: %p", mutex);*/\
} while(0)
#define LOGGED_UNLOCK(mutex) do { \
2015-04-08 07:00:19 +08:00
/*LOGGER_DEBUG("Unlocking mutex: %p", mutex);*/\
pthread_mutex_unlock(mutex);\
2015-04-08 07:00:19 +08:00
/*LOGGER_DEBUG("Unlocked mutex: %p", mutex);*/\
} while(0)
2015-04-26 06:31:03 +08:00
#define MAX_RTP_SIZE 1500
2014-01-27 04:02:11 +08:00
/**
2015-04-22 08:09:37 +08:00
* Payload type identifier. Also used as rtp callback prefix. (Not dummies)
*/
enum {
rtp_TypeAudio = 192,
2015-04-22 08:09:37 +08:00
rtp_TypeVideo,
};
2015-04-27 06:15:57 +08:00
enum {
rtp_StateBad = -1,
rtp_StateNormal,
rtp_StateGood,
2015-04-27 06:15:57 +08:00
};
2015-04-13 07:45:53 +08:00
/**
* Standard rtp header.
*/
typedef struct {
uint8_t flags; /* Version(2),Padding(1), Ext(1), Cc(4) */
uint8_t marker_payloadt; /* Marker(1), PlayLoad Type(7) */
uint16_t sequnum; /* Sequence Number */
uint32_t timestamp; /* Timestamp */
uint32_t ssrc; /* SSRC */
uint32_t csrc[16]; /* CSRC's table */
uint32_t length; /* Length of the header in payload string. */
} RTPHeader;
2015-04-13 07:45:53 +08:00
/**
2014-11-18 07:46:46 +08:00
* Standard rtp extension header.
*/
typedef struct {
uint16_t type; /* Extension profile */
uint16_t length; /* Number of extensions */
2014-02-17 09:01:30 +08:00
uint32_t *table; /* Extension's table */
} RTPExtHeader;
/**
2014-11-18 07:46:46 +08:00
* Standard rtp message.
*/
2015-04-22 08:09:37 +08:00
typedef struct RTPMessage_s {
2014-02-17 09:01:30 +08:00
RTPHeader *header;
RTPExtHeader *ext_header;
uint32_t length;
2015-04-26 06:31:03 +08:00
uint8_t data[];
} RTPMessage;
/**
2014-11-29 20:42:19 +08:00
* RTP control session.
*/
typedef struct {
2015-04-22 08:09:37 +08:00
uint8_t version;
uint8_t padding;
uint8_t extension;
uint8_t cc;
uint8_t marker;
uint8_t payload_type;
uint16_t sequnum; /* Sending sequence number */
uint16_t rsequnum; /* Receiving sequence number */
uint32_t rtimestamp;
uint32_t ssrc;
uint32_t *csrc;
/* If some additional data must be sent via message
* apply it here. Only by allocating this member you will be
* automatically placing it within a message.
*/
2015-04-22 08:09:37 +08:00
RTPExtHeader *ext_header;
2014-02-17 09:01:30 +08:00
/* Msg prefix for core to know when recving */
2015-04-22 08:09:37 +08:00
uint8_t prefix;
2015-04-22 08:09:37 +08:00
Messenger *m;
2015-04-29 07:01:25 +08:00
int friend_number;
struct RTCPSession_s *rtcp_session;
2015-04-22 08:09:37 +08:00
void *cs;
int (*mcb) (void*, RTPMessage* msg);
} RTPSession;
/**
2014-11-18 07:46:46 +08:00
* Must be called before calling any other rtp function.
*/
2015-04-29 07:01:25 +08:00
RTPSession *rtp_new ( int payload_type, Messenger *m, int friend_num, void* cs, int (*mcb) (void*, RTPMessage*) );
2014-05-03 07:46:03 +08:00
/**
2014-11-18 07:46:46 +08:00
* Terminate the session.
2014-05-03 07:46:03 +08:00
*/
2015-01-25 06:29:54 +08:00
void rtp_kill ( RTPSession* session );
2015-04-13 07:45:53 +08:00
/**
* Do periodical rtp work.
*/
2015-04-27 06:15:57 +08:00
int rtp_do(RTPSession *session);
2015-01-25 06:29:54 +08:00
/**
2015-04-26 06:31:03 +08:00
* By default rtp is in receiving state
2015-01-25 06:29:54 +08:00
*/
2015-02-21 08:07:22 +08:00
int rtp_start_receiving (RTPSession *session);
/**
* Pause rtp receiving mode.
*/
int rtp_stop_receiving (RTPSession *session);
/**
* Sends msg to RTPSession::dest
*/
2015-04-26 06:31:03 +08:00
int rtp_send_data ( RTPSession* session, const uint8_t* data, uint16_t length, bool dummy );
/**
2014-11-18 07:46:46 +08:00
* Dealloc msg.
*/
2015-04-26 06:31:03 +08:00
void rtp_free_msg ( RTPMessage *msg );
#endif /* RTP_H */