565efa4f39
c9cdae001 fix(toxav): remove extra copy of video frame on encode 4f6d4546b test: Improve the fake network library. a2581e700 refactor(toxcore): generate `Friend_Request` and `Dht_Nodes_Response` 2aaa11770 refactor(toxcore): use Tox_Memory in generated events 5c367452b test(toxcore): fix incorrect mutex in tox_scenario_get_time 8f92e710f perf: Add a timed limit of number of cookie requests. 695b6417a test: Add some more simulated network support. 815ae9ce9 test(toxcore): fix thread-safety in scenario framework 6d85c754e test(toxcore): add unit tests for net_crypto 9c22e79cc test(support): add SimulatedEnvironment for deterministic testing f34fcb195 chore: Update windows Dockerfile to debian stable (trixie). ece0e8980 fix(group_moderation): allow validating unsorted sanction list signatures a4fa754d7 refactor: rename struct Packet to struct Net_Packet d6f330f85 cleanup: Fix some warnings from coverity. e206bffa2 fix(group_chats): fix sync packets reverting topics 0e4715598 test: Add new scenario testing framework. 668291f44 refactor(toxcore): decouple Network_Funcs from sockaddr via IP_Port fc4396cef fix: potential division by zero in toxav and unsafe hex parsing 8e8b352ab refactor: Add nullable annotations to struct members. 7740bb421 refactor: decouple net_crypto from DHT 1936d4296 test: add benchmark for toxav audio and video 46bfdc2df fix: correct printf format specifiers for unsigned integers REVERT: 1828c5356 fix(toxav): remove extra copy of video frame on encode git-subtree-dir: external/toxcore/c-toxcore git-subtree-split: c9cdae001341e701fca980c9bb9febfeb95d2902
125 lines
4.3 KiB
C
125 lines
4.3 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 *_Nonnull rtp_message_data(const RTPMessage *_Nonnull msg);
|
|
uint32_t rtp_message_len(const RTPMessage *_Nonnull msg);
|
|
uint8_t rtp_message_pt(const RTPMessage *_Nonnull msg);
|
|
uint16_t rtp_message_sequnum(const RTPMessage *_Nonnull msg);
|
|
uint64_t rtp_message_flags(const RTPMessage *_Nonnull msg);
|
|
uint32_t rtp_message_data_length_full(const RTPMessage *_Nonnull msg);
|
|
|
|
/* RTPSession accessors */
|
|
bool rtp_session_is_receiving_active(const RTPSession *_Nullable session);
|
|
uint32_t rtp_session_get_ssrc(const RTPSession *_Nonnull session);
|
|
void rtp_session_set_ssrc(RTPSession *_Nonnull 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 *_Nonnull mono_time, void *_Nonnull cs, RTPMessage *_Nonnull msg);
|
|
|
|
typedef int rtp_send_packet_cb(void *_Nullable user_data, const uint8_t *_Nonnull data, uint16_t length);
|
|
typedef void rtp_add_recv_cb(void *_Nullable user_data, uint32_t bytes);
|
|
typedef void rtp_add_lost_cb(void *_Nullable user_data, uint32_t bytes);
|
|
|
|
void rtp_receive_packet(RTPSession *_Nonnull session, const uint8_t *_Nonnull 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 *_Nonnull rdata, const struct RTPHeader *_Nonnull 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 *_Nonnull data, struct RTPHeader *_Nonnull header);
|
|
|
|
RTPSession *_Nullable rtp_new(const Logger *_Nonnull log, int payload_type, Mono_Time *_Nonnull mono_time,
|
|
rtp_send_packet_cb *_Nullable send_packet, void *_Nullable send_packet_user_data,
|
|
rtp_add_recv_cb *_Nullable add_recv, rtp_add_lost_cb *_Nullable add_lost, void *_Nullable bwc_user_data,
|
|
void *_Nonnull cs, rtp_m_cb *_Nonnull mcb);
|
|
void rtp_kill(const Logger *_Nonnull log, RTPSession *_Nullable session);
|
|
void rtp_allow_receiving_mark(RTPSession *_Nullable session);
|
|
void rtp_stop_receiving_mark(RTPSession *_Nullable 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 *_Nonnull log, RTPSession *_Nonnull session, const uint8_t *_Nonnull data, uint32_t length,
|
|
bool is_keyframe);
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /* C_TOXCORE_TOXAV_RTP_H */
|