src/common/session/audio.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>
 
/* ============================================================================
 * Session Audio Context
 * ============================================================================ */

typedef struct session_audio_ctx session_audio_ctx_t;
 
/* ============================================================================
 * Session Audio Lifecycle Functions
 * @{
 */

session_audio_ctx_t *session_audio_create(bool is_host);

void session_audio_destroy(session_audio_ctx_t *ctx);

 
/* ============================================================================
 * Session Audio Control Functions
 * @{
 */

asciichat_error_t session_audio_start_capture(session_audio_ctx_t *ctx);

asciichat_error_t session_audio_start_playback(session_audio_ctx_t *ctx);

asciichat_error_t session_audio_start_duplex(session_audio_ctx_t *ctx);

void session_audio_stop(session_audio_ctx_t *ctx);

bool session_audio_is_running(session_audio_ctx_t *ctx);

 
/* ============================================================================
 * Session Audio I/O Functions
 * @{
 */

size_t session_audio_read_captured(session_audio_ctx_t *ctx, float *buffer, size_t num_samples);

asciichat_error_t session_audio_write_playback(session_audio_ctx_t *ctx, const float *buffer, size_t num_samples);

 
/* ============================================================================
 * Session Audio Host-Only Functions (Mixing)
 * @{
 */

asciichat_error_t session_audio_add_source(session_audio_ctx_t *ctx, uint32_t source_id);

void session_audio_remove_source(session_audio_ctx_t *ctx, uint32_t source_id);

asciichat_error_t session_audio_write_source(session_audio_ctx_t *ctx, uint32_t source_id, const float *samples,
                                             size_t num_samples);

size_t session_audio_mix_excluding(session_audio_ctx_t *ctx, uint32_t exclude_id, float *output, size_t num_samples);


 
/* Configure a borrowed local source before starting audio. */
void session_audio_set_capture_source(session_audio_ctx_t *ctx, void *source);
 
void *session_audio_get_context(session_audio_ctx_t *ctx);