e95f2cbb1c
1828c5356 fix(toxav): remove extra copy of video frame on encode b66b8ded6 refactor: improve group stability, moderation determinism, and DHT dual-stack handling 4fbd7c10a fix(toxav): fix heap buffer overflow in RTP video packet handling 809fe8c78 refactor(tox): make the `#define` consts int literals. 50d242a37 refactor(toxav): improve MSI safety and testability da1c13a2f fix(toxav): harden video processing and fix large frame handling 472825288 fix(toxav): fix multiple logic bugs in audio module dc963d9a9 fix(toxav): fix multiple bugs in bandwidth controller and add tests 3bf5778ef refactor(toxav): split out RTP module and add exhaustive unit tests b79b7d436 fix(autotools): add tox_log_level.h to public headers list ea2e34ff2 chore: Disable cirrus. We're out of quota again. b449ea2ed chore(ci): update azure runner image to windows-2022 windows-2019 is EOL e115b136d refactor: Make add_to_list non-recursive. REVERT: e58eb27a8 fix(toxav): remove extra copy of video frame on encode Tested and works, but there might be alignment issues and other stuff. git-subtree-dir: external/toxcore/c-toxcore git-subtree-split: 1828c5356b2daf1d5f680854e776d74b181d268c
125 lines
3.9 KiB
C
125 lines
3.9 KiB
C
/* SPDX-License-Identifier: GPL-3.0-or-later
|
|
* Copyright © 2016-2025 The TokTok team.
|
|
* Copyright © 2013-2015 Tox project.
|
|
*/
|
|
#ifndef C_TOXCORE_TOXAV_RTP_H
|
|
#define C_TOXCORE_TOXAV_RTP_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#include "../toxcore/logger.h"
|
|
#include "../toxcore/mono_time.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* RTPHeader serialised size in bytes.
|
|
*/
|
|
#define RTP_HEADER_SIZE 80
|
|
|
|
/**
|
|
* Number of 32 bit padding fields between @ref RTPHeader::offset_lower and
|
|
* everything before it.
|
|
*/
|
|
#define RTP_PADDING_FIELDS 11
|
|
|
|
/**
|
|
* Payload type identifier. Also used as rtp callback prefix.
|
|
*/
|
|
typedef enum RTP_Type {
|
|
RTP_TYPE_AUDIO = 192,
|
|
RTP_TYPE_VIDEO = 193,
|
|
} RTP_Type;
|
|
|
|
/**
|
|
* A bit mask (up to 64 bits) specifying features of the current frame affecting
|
|
* the behaviour of the decoder.
|
|
*/
|
|
typedef enum RTPFlags {
|
|
/**
|
|
* Support frames larger than 64KiB. The full 32 bit length and offset are
|
|
* set in @ref RTPHeader::data_length_full and @ref RTPHeader::offset_full.
|
|
*/
|
|
RTP_LARGE_FRAME = 1 << 0,
|
|
/**
|
|
* Whether the packet is part of a key frame.
|
|
*/
|
|
RTP_KEY_FRAME = 1 << 1,
|
|
} RTPFlags;
|
|
|
|
typedef struct RTPHeader RTPHeader;
|
|
typedef struct RTPMessage RTPMessage;
|
|
typedef struct RTPSession RTPSession;
|
|
|
|
/* RTPMessage accessors */
|
|
const uint8_t *rtp_message_data(const RTPMessage *msg);
|
|
uint32_t rtp_message_len(const RTPMessage *msg);
|
|
uint8_t rtp_message_pt(const RTPMessage *msg);
|
|
uint16_t rtp_message_sequnum(const RTPMessage *msg);
|
|
uint64_t rtp_message_flags(const RTPMessage *msg);
|
|
uint32_t rtp_message_data_length_full(const RTPMessage *msg);
|
|
|
|
/* RTPSession accessors */
|
|
bool rtp_session_is_receiving_active(const RTPSession *session);
|
|
uint32_t rtp_session_get_ssrc(const RTPSession *session);
|
|
void rtp_session_set_ssrc(RTPSession *session, uint32_t ssrc);
|
|
|
|
#define USED_RTP_WORKBUFFER_COUNT 3
|
|
#define DISMISS_FIRST_LOST_VIDEO_PACKET_COUNT 10
|
|
|
|
typedef int rtp_m_cb(const Mono_Time *mono_time, void *cs, RTPMessage *msg);
|
|
|
|
typedef int rtp_send_packet_cb(void *user_data, const uint8_t *data, uint16_t length);
|
|
typedef void rtp_add_recv_cb(void *user_data, uint32_t bytes);
|
|
typedef void rtp_add_lost_cb(void *user_data, uint32_t bytes);
|
|
|
|
void rtp_receive_packet(RTPSession *session, const uint8_t *data, size_t length);
|
|
|
|
/**
|
|
* Serialise an RTPHeader to bytes to be sent over the network.
|
|
*
|
|
* @param rdata A byte array of length RTP_HEADER_SIZE. Does not need to be
|
|
* initialised. All RTP_HEADER_SIZE bytes will be initialised after a call
|
|
* to this function.
|
|
* @param header The RTPHeader to serialise.
|
|
*/
|
|
size_t rtp_header_pack(uint8_t *rdata, const struct RTPHeader *header);
|
|
|
|
/**
|
|
* Deserialise an RTPHeader from bytes received over the network.
|
|
*
|
|
* @param data A byte array of length RTP_HEADER_SIZE.
|
|
* @param header The RTPHeader to write the unpacked values to.
|
|
*/
|
|
size_t rtp_header_unpack(const uint8_t *data, struct RTPHeader *header);
|
|
|
|
RTPSession *rtp_new(const Logger *log, int payload_type, Mono_Time *mono_time,
|
|
rtp_send_packet_cb *send_packet, void *send_packet_user_data,
|
|
rtp_add_recv_cb *add_recv, rtp_add_lost_cb *add_lost, void *bwc_user_data,
|
|
void *cs, rtp_m_cb *mcb);
|
|
void rtp_kill(const Logger *log, RTPSession *session);
|
|
void rtp_allow_receiving_mark(RTPSession *session);
|
|
void rtp_stop_receiving_mark(RTPSession *session);
|
|
|
|
/**
|
|
* @brief Send a frame of audio or video data, chunked in @ref RTPMessage instances.
|
|
*
|
|
* @param session The A/V session to send the data for.
|
|
* @param data A byte array of length @p length.
|
|
* @param length The number of bytes to send from @p data.
|
|
* @param is_keyframe Whether this video frame is a key frame. If it is an
|
|
* audio frame, this parameter is ignored.
|
|
*/
|
|
int rtp_send_data(const Logger *log, RTPSession *session, const uint8_t *data, uint32_t length,
|
|
bool is_keyframe);
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /* C_TOXCORE_TOXAV_RTP_H */
|