participant.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <ascii-chat/asciichat_errno.h>
#include "session/settings.h"
 
/* ============================================================================
 * Session Participant Types
 * ============================================================================ */
 
typedef struct session_participant session_participant_t;
 
typedef struct {
  void (*on_connected)(session_participant_t *p, uint32_t client_id, void *user_data);
 
  void (*on_disconnected)(session_participant_t *p, void *user_data);
 
  void (*on_frame_received)(session_participant_t *p, const char *frame, void *user_data);
 
  void (*on_audio_received)(session_participant_t *p, const float *samples, size_t count, void *user_data);
 
  void (*on_settings_changed)(session_participant_t *p, const session_settings_t *settings, void *user_data);
 
  void (*on_error)(session_participant_t *p, asciichat_error_t error, const char *message, void *user_data);
} session_participant_callbacks_t;
 
typedef struct {
  const char *address;
 
  int port;
 
  bool encryption_enabled;
 
  const char *password;
 
  const char *server_key;
 
  bool enable_audio;
 
  bool enable_video;
 
  session_participant_callbacks_t callbacks;
 
  void *user_data;
} session_participant_config_t;
 
/* ============================================================================
 * Session Participant Lifecycle Functions
 * @{
 */
 
session_participant_t *session_participant_create(const session_participant_config_t *config);
 
void session_participant_destroy(session_participant_t *p);
 
/* ============================================================================
 * Session Participant Connection Functions
 * @{
 */
 
asciichat_error_t session_participant_connect(session_participant_t *p);
 
void session_participant_disconnect(session_participant_t *p);
 
bool session_participant_is_connected(session_participant_t *p);
 
uint32_t session_participant_get_client_id(session_participant_t *p);
 
/* ============================================================================
 * Session Participant Media Control Functions
 * @{
 */
 
asciichat_error_t session_participant_start_video(session_participant_t *p);
 
void session_participant_stop_video(session_participant_t *p);
 
bool session_participant_is_video_active(session_participant_t *p);
 
asciichat_error_t session_participant_start_audio(session_participant_t *p);
 
void session_participant_stop_audio(session_participant_t *p);
 
bool session_participant_is_audio_active(session_participant_t *p);
 
/* ============================================================================
 * Session Participant Settings Functions
 * @{
 */
 
asciichat_error_t session_participant_get_settings(session_participant_t *p, session_settings_t *settings);
 
asciichat_error_t session_participant_request_settings(session_participant_t *p, const session_settings_t *settings);
 
/* ============================================================================
 * Session Participant Media Capture Functions
 * @{
 */
 
asciichat_error_t session_participant_start_video_capture(session_participant_t *p);
 
void session_participant_stop_video_capture(session_participant_t *p);
 
asciichat_error_t session_participant_start_audio_capture(session_participant_t *p);
 
void session_participant_stop_audio_capture(session_participant_t *p);
 
socket_t session_participant_get_socket(session_participant_t *p);
 
/* ============================================================================
 * Session Participant Transport Functions (WebRTC Integration)
 * @{
 */
 
typedef struct acip_transport acip_transport_t;
 
asciichat_error_t session_participant_set_transport(session_participant_t *p, acip_transport_t *transport);
 
acip_transport_t *session_participant_get_transport(session_participant_t *p);
 
bool session_participant_has_transport(session_participant_t *p);