Struct AudioChunk 

pub struct AudioChunk {
    pub data: Vec<u8>,
    pub format: AudioFormat,
}

Available on crate feature realtime only.

Audio chunk with format information.

Fields

data: Vec<u8>

Raw audio data.

format: AudioFormat

Audio format of this chunk.

Implementations

impl AudioChunk

pub fn new(data: Vec<u8>, format: AudioFormat) -> AudioChunk

Create a new audio chunk.

pub fn pcm16_24khz(data: Vec<u8>) -> AudioChunk

Create a PCM16 24kHz audio chunk (OpenAI format).

pub fn pcm16_16khz(data: Vec<u8>) -> AudioChunk

Create a PCM16 16kHz audio chunk (Gemini input format).

pub fn duration_ms(&self) -> f64

Get duration of this audio chunk in milliseconds.

pub fn to_base64(&self) -> String

Encode audio data as base64.

pub fn from_base64( encoded: &str, format: AudioFormat, ) -> Result<AudioChunk, DecodeError>

Decode audio data from base64.

pub fn from_i16_samples(samples: &[i16], format: AudioFormat) -> AudioChunk

Create an AudioChunk from i16 samples (converts to PCM16 little-endian bytes).

This is useful when working with audio APIs (like LiveKit) that provide samples as i16 slices rather than raw byte buffers.

On little-endian hosts the samples are reinterpreted and copied in one vectorized memcpy instead of one to_le_bytes call per sample. On big-endian hosts each sample is byte-swapped individually, so the emitted bytes are little-endian PCM16 on every target.

Example

use adk_realtime::audio::{AudioChunk, AudioFormat};

let chunk = AudioChunk::from_i16_samples(&[1, -1], AudioFormat::pcm16_24khz());
assert_eq!(chunk.data, vec![0x01, 0x00, 0xff, 0xff]);

pub fn to_i16_samples(&self) -> Result<Cow<'_, [i16]>, String>

Interpret the audio data as i16 samples (assuming PCM16 little-endian).

When the buffer is suitably aligned on a little-endian host the samples are borrowed directly from self.data and no copy is made (Cow::Borrowed). Otherwise — a big-endian host, or a misaligned buffer — the samples are decoded into a freshly allocated Vec (Cow::Owned).

Errors

Returns an error string if the data length is not even (not valid PCM16).

Example

use adk_realtime::audio::{AudioChunk, AudioFormat};

let chunk = AudioChunk::pcm16_24khz(vec![0x01, 0x00, 0xff, 0xff]);
let samples = chunk.to_i16_samples().unwrap();
assert_eq!(samples.as_ref(), &[1, -1]);

// An odd byte count cannot be valid PCM16.
assert!(AudioChunk::pcm16_24khz(vec![0x01]).to_i16_samples().is_err());

Trait Implementations

impl Clone for AudioChunk

fn clone(&self) -> AudioChunk

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AudioChunk

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.