ra8_audio.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"

typedef struct ra8_audio_source_iface ra8_audio_source_iface_t;

typedef enum : uint8_t {
  k_ra8_audio_format_pcm_s16le = 0U, 
  k_ra8_audio_format_pcm_s32le,      
} ra8_audio_format_t;

typedef struct {
  void*    data;     
  uint32_t capacity; 
} ra8_audio_buffer_t;

typedef struct {
  const void*        data;           
  uint32_t           bytes;          
  uint32_t           sample_count;   
  uint32_t           sample_rate_hz; 
  uint32_t           timestamp_ms;   
  uint8_t            channels;       
  uint8_t            valid_bits;     
  ra8_audio_format_t format;         
} ra8_audio_frame_t;

typedef struct {
  uint32_t           frame_bytes;       
  uint32_t           samples_per_frame; 
  uint32_t           sample_rate_hz;    
  uint8_t            channels;          
  uint8_t            valid_bits;        
  ra8_audio_format_t format;            
} ra8_audio_source_info_t;

typedef struct {
  const ra8_audio_source_iface_t* iface; 
  void*                           ctx;   
} ra8_audio_source_t;

typedef void (*ra8_audio_frame_callback_t)(void* ctx, const ra8_audio_frame_t* frame);

[[nodiscard]] ra8_err_t ra8_audio_frame_validate(const ra8_audio_frame_t* frame);

[[nodiscard]] ra8_err_t ra8_audio_source_get_info(ra8_audio_source_t*      source,
                                                  ra8_audio_source_info_t* out_info);

[[nodiscard]] ra8_err_t ra8_audio_source_capture(ra8_audio_source_t*       source,
                                                 const ra8_audio_buffer_t* buffer,
                                                 ra8_audio_frame_t*        out_frame);

[[nodiscard]] ra8_err_t ra8_audio_source_stream_start(ra8_audio_source_t*        source,
                                                      const ra8_audio_buffer_t*  buffer,
                                                      ra8_audio_frame_callback_t callback,
                                                      void*                      ctx);

[[nodiscard]] ra8_err_t ra8_audio_source_stop(ra8_audio_source_t* source);
 
#ifdef __cplusplus
}
#endif