Skip to main content

mojentic/realtime/
codec.rs

1//! Base64 ↔ PCM16 audio codec helpers.
2
3use base64::engine::general_purpose;
4use base64::Engine;
5
6/// Decode a base64 string into a `Vec<i16>` of little-endian PCM samples.
7pub fn decode_base64_pcm16(b64: &str) -> Result<Vec<i16>, base64::DecodeError> {
8    let bytes = general_purpose::STANDARD.decode(b64)?;
9    let mut samples = Vec::with_capacity(bytes.len() / 2);
10    let mut remaining = bytes.as_slice();
11    while let Some((sample, rest)) = remaining.split_first_chunk::<2>() {
12        samples.push(i16::from_le_bytes(*sample));
13        remaining = rest;
14    }
15    Ok(samples)
16}
17
18/// Encode a slice of PCM16 samples as a base64 string.
19pub fn encode_base64_pcm16(samples: &[i16]) -> String {
20    let mut bytes = Vec::with_capacity(samples.len() * 2);
21    for s in samples {
22        bytes.extend_from_slice(&s.to_le_bytes());
23    }
24    general_purpose::STANDARD.encode(bytes)
25}
26
27/// Encode raw PCM16 wire bytes (already little-endian) as base64.
28pub fn encode_base64_pcm16_bytes(bytes: &[u8]) -> String {
29    general_purpose::STANDARD.encode(bytes)
30}
31
32#[cfg(test)]
33mod tests {
34    use super::*;
35
36    #[test]
37    fn round_trip_pcm16() {
38        let original: Vec<i16> = vec![0, 1, -1, 32_767, -32_768, 12_345];
39        let encoded = encode_base64_pcm16(&original);
40        let decoded = decode_base64_pcm16(&encoded).unwrap();
41        assert_eq!(decoded, original);
42    }
43
44    #[test]
45    fn round_trip_pcm16_bytes() {
46        let samples: Vec<i16> = vec![10, -10, 20, -20];
47        let bytes: Vec<u8> = samples.iter().flat_map(|s| s.to_le_bytes()).collect();
48
49        let encoded = encode_base64_pcm16_bytes(&bytes);
50        let decoded = decode_base64_pcm16(&encoded).unwrap();
51
52        assert_eq!(decoded, samples);
53    }
54}