[*] add opus coder

Author: heng30

Cargo.lock

@@ -117,7 +117,6 @@ tokio-stream = "0.1"
 audiopus = "0.3.0-rc.0"
 derive_builder = "0.20"
 wayland-client = "0.31"
-job_scheduler_ng = "2.4"
 fast_image_resize = "5.3"
 wayland-protocols = "0.32"
 wayland-protocols-wlr = "0.3"

Cargo.toml

@@ -12,19 +12,24 @@ http.workspace = true
 bytes.workspace = true
 anyhow.workspace = true
 webrtc.workspace = true
-chrono.workspace = true
-fdk-aac.workspace = true
 bytesio.workspace = true
 indexmap.workspace = true
 audiopus.workspace = true
 byteorder.workspace = true
 thiserror.workspace = true
 derive_setters.workspace = true
-job_scheduler_ng.workspace = true
 tokio = { workspace = true, features = ["full"] }
 cutil = { workspace = true, features = ["crypto"] }
-serde = { workspace = true, features = ["derive", "rc"] }
+serde = { workspace = true, features = ["derive"] }
 
 [dev-dependencies]
+image.workspace = true
+hound.workspace = true
 env_logger.workspace = true
 serde_json.workspace = true
+
+[target.'cfg(target_os = "linux")'.dev-dependencies]
+video-encoder = { workspace = true, features = ["x264"] }
+
+[target.'cfg(target_os = "windows")'.dev-dependencies]
+video-encoder = { workspace = true, features = ["ffmpeg"] }

lib/wrtc/Cargo.toml

@@ -1,34 +1,54 @@
-A WebRTC server implementation that streams H264 video files to WHEP clients.
+# WRTC Examples
 
-### Basic Usage
+This directory contains example programs demonstrating various features of the wrtc library.
 
-```bash
-# Run with default settings (creates test file if needed)
-cargo run --example whep_demo
-```
+## Opus Codec Demo
 
-### Advanced Usage
+The `opus_demo.rs` example demonstrates how to use the Opus audio codec for encoding and decoding audio data.
 
-```bash
-# With custom H264 file
-H264_FILE_PATH=/path/to/your/video.h264 cargo run --example whep_demo
-
-# With custom settings
-WRTC_SERVER_ADDRESS=0.0.0.0:9090 \
-H264_FPS=25 \
-WRTC_APP_NAME=live \
-WRTC_STREAM_NAME=my_stream \
-cargo run --example whep_demo
-```
+### Features
 
-### Environment Variables
+- Reads WAV audio files
+- Encodes audio data using Opus codec
+- Decodes encoded audio back to PCM
+- Writes decoded audio to new WAV file
+- Shows compression ratio statistics
+- Comprehensive logging with env_logger
 
-- `WRTC_SERVER_ADDRESS`: Server bind address (default: `127.0.0.1:8080`)
-- `H264_FILE_PATH`: Path to H264 file (default: `./test_video.h264`)
-- `H264_FPS`: Frames per second for playback (default: `30`)
-- `WRTC_APP_NAME`: WebRTC app name (default: `live`)
-- `WRTC_STREAM_NAME`: WebRTC stream name (default: `test_stream`)
+### Usage
 
 ```bash
-RUST_LOG=debug WRTC_SERVER_ADDRESS=0.0.0.0:9090 H264_FILE_PATH=/home/blue/Code/rust/wayshot/lib/wrtc/data/test.h264 cargo run --example whep_demo
+# Run with default logging (info level)
+cargo run --example opus_demo
+
+# Run with debug logging for detailed frame information
+RUST_LOG=debug cargo run --example opus_demo
+
+# Run with only warnings and errors
+RUST_LOG=warn cargo run --example opus_demo
+
+# Run with custom log filtering
+RUST_LOG=opus_demo=debug cargo run --example opus_demo
 ```
+
+### What it does
+
+1. **Reads** `data/test.wav` (48kHz, stereo, 5 seconds)
+2. **Encodes** audio to Opus packets (250 frames)
+3. **Decodes** Opus packets back to audio
+4. **Saves** result to `/tmp/opus-coder.wav`
+5. **Shows** compression statistics (~31:1 compression ratio)
+
+### Dependencies
+
+- `hound` - WAV file I/O
+- `env_logger` - Structured logging
+- `log` - Logging facade
+- `wrtc::opus` - Opus codec implementation
+
+### Log Levels
+
+- **INFO**: Basic progress information (default)
+- **DEBUG**: Detailed frame-by-frame encoding/decoding info
+- **WARN**: Error messages for failed operations
+- **ERROR**: Critical errors that stop execution