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