sdp.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
#include "common.h"
#include "asciichat_errno.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================================
 * Audio Codec Configuration
 * ============================================================================ */
 
typedef struct {
  uint32_t sample_rate;    
  uint8_t channels;        
  uint32_t bitrate;        
  uint16_t frame_duration; 
  bool dtx_enabled;        
  bool fec_enabled;        
} opus_config_t;
 
/* ============================================================================
 * Terminal Rendering Capability "Codecs"
 * ============================================================================ */
 
typedef enum {
  ACIP_CODEC_TRUECOLOR = 96, 
  ACIP_CODEC_256COLOR = 97,  
  ACIP_CODEC_16COLOR = 98,   
  ACIP_CODEC_MONO = 99,      
} acip_codec_t;
 
typedef struct {
  uint16_t width;  
  uint16_t height; 
  enum { RENDERER_BLOCK, RENDERER_HALFBLOCK, RENDERER_BRAILLE } renderer;
  enum { CHARSET_ASCII, CHARSET_UTF8, CHARSET_UTF8_WIDE } charset;
  enum { COMPRESSION_NONE, COMPRESSION_RLE, COMPRESSION_ZSTD } compression;
  bool csi_rep_support;     
  const char *palette_hint; 
} terminal_format_params_t;
 
typedef struct {
  acip_codec_t codec;              
  terminal_format_params_t format; 
} terminal_capability_t;
 
/* ============================================================================
 * SDP Session Description
 * ============================================================================ */
 
typedef struct {
  /* Session-level attributes */
  char session_id[32];      
  char session_version[16]; 
 
  /* Audio media section */
  bool has_audio;             
  opus_config_t audio_config; 
 
  /* Video media section (terminal capabilities) */
  bool has_video;                        
  terminal_capability_t *video_codecs;   
  size_t video_codec_count;              
  terminal_format_params_t video_format; 
 
  /* Raw SDP string (generated from above) */
  char sdp_string[4096]; 
  size_t sdp_length;     
} sdp_session_t;
 
/* ============================================================================
 * SDP Generation (Offer/Answer)
 * ============================================================================ */
 
asciichat_error_t sdp_generate_offer(const terminal_capability_t *capabilities, size_t capability_count,
                                     const opus_config_t *audio_config, const terminal_format_params_t *format,
                                     sdp_session_t *offer_out);
 
asciichat_error_t sdp_generate_answer(const sdp_session_t *offer, const terminal_capability_t *server_capabilities,
                                      size_t server_capability_count, const opus_config_t *audio_config,
                                      const terminal_format_params_t *server_format, sdp_session_t *answer_out);
 
/* ============================================================================
 * SDP Parsing (Offer/Answer)
 * ============================================================================ */
 
asciichat_error_t sdp_parse(const char *sdp_string, sdp_session_t *session);
 
asciichat_error_t sdp_get_selected_video_codec(const sdp_session_t *answer, acip_codec_t *selected_codec,
                                               terminal_format_params_t *selected_format);
 
/* ============================================================================
 * Capability Detection
 * ============================================================================ */
 
asciichat_error_t sdp_detect_terminal_capabilities(terminal_capability_t *capabilities, size_t capability_count,
                                                   size_t *detected_count);
 
/* ============================================================================
 * Utility Functions
 * ============================================================================ */
 
void sdp_session_free(sdp_session_t *session);
 
const char *sdp_codec_name(acip_codec_t codec);
 
const char *sdp_renderer_name(int renderer_type);
 
#ifdef __cplusplus
}
#endif