participant.h

Go to the documentation of this file.

#include <ascii-chat/network/connection.h>
 
#pragma once
#include <ascii-chat/network/acip/transport.h>
 
#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;

  const char *tls_ca_file;
  bool quic_audio_datagrams;
  bool quic_visual_datagrams;

  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 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_ownership_t ownership);

asciichat_error_t session_participant_set_connection(session_participant_t *p, network_connection_t **owner);
asciichat_error_t session_participant_take_connection(session_participant_t *, network_connection_t **);

acip_transport_t *session_participant_get_transport(session_participant_t *p);

bool session_participant_has_transport(session_participant_t *p);



network_connection_t *session_participant_connection(session_participant_t *p);
asciichat_error_t session_participant_receive_settings(session_participant_t *p, const void *payload, size_t length);