Audio Enable/Disable

Audio Settings allows you to customize the in-cabin auditory alerts and communication experience of the Raven device.

By leveraging the Raven device's built-in speaker and microphone, these settings dictate how the device communicates with the driver, what live audio data is transmitted back to management, and what gets permanently recorded. Customizing these settings unlocks two value pillars for your customers:

• Driver Coaching and Awareness: Improve fleet safety by providing immediate, customizable in-cab audio feedback when speeding or when AI detects risky behavior, enabling drivers to self-correct in real-time.

• Privacy and Compliance: Strictly control whether in-cabin audio is captured during live streaming or video recording, ensuring fleets remain compliant with local surveillance laws, union regulations, and driver privacy expectations.

To support these goals, we have exposed a set of flexible configuration options via the RC-API. Below is a guide to these settings and how they shape the user experience for different types of fleets.

Configuration Guide: Tailoring the In-Cabin Auditory Experience

Different fleets have vastly different rules regarding driver feedback and audio recording. We designed these API settings to give you granular control over what the driver hears, what the fleet manager can listen to, and what gets captured as evidence.

The Master Chime: In-Cabin Notifications

API Setting: audio_notifications_enabled

This setting acts as the primary toggle for the system sounds generated by the Raven device to alert the driver.

The Experience: When set to true (the default), Raven acts as an active co-pilot. It will play an audio notification in several specific scenarios:

• Privacy Alerts: When a manager remotely connects to the camera or starts a live cabin stream.

• Action Confirmation: When a driver performs a hand gesture to trigger a short video recording.

• Safety Coaching: When the current vehicle speed goes above the speeding threshold (paired with the visual speed widget), or when an AI detection event occurs.

Why use it: Disabling this (false) creates a completely silent device, which may be preferred for executive transport. Enabling it ensures drivers are proactively coached and kept aware of when they are being monitored.

Alert Style: Customizing the Feedback

API Setting: AudioAlertType

When notifications are active, this setting defines the exact format of the auditory feedback triggered by Raven events.

The Experience: You can configure the alert to one of three supported options:

• NONE: No audio alert is played.

• BEEP: A standard chime or beep sound alert.

• VOICE: A spoken voice alert, providing verbal context for the specific event.

Why use it: This allows fleets to dial in the exact level of intrusiveness. VOICE alerts are excellent for unambiguous driver coaching (e.g., explicitly stating what behavior was detected), while a standard BEEP provides awareness without the distraction of spoken words. NONE can be used to silence event feedback while leaving other system chimes active.

Recorded Evidence: Video Audio

API Setting: AudioAlertType > audio_recording

Visual evidence is crucial, but recording ambient cabin conversations is often restricted by local laws. This setting controls the permanent audio track on saved video files.

The Experience: When set to true (the default), video clips captured by the camera will include an audio track. When toggled to false, the audio recording stream is completely removed from any video recordings taken from that camera.

Why use it: This is vital for strict privacy compliance. It allows fleets to retain hard visual evidence of accidents or incidents while guaranteeing that the resulting video files are completely mute, satisfying two-party consent laws and union agreements.

Privacy Control: Live Streaming Audio

API Setting: streaming_audio_enabled

Visual monitoring is one thing, but listening to live cabin conversations is highly sensitive. This setting strictly controls the microphone during active live viewing.

The Experience: When set to false (the default), a fleet manager can watch a live video stream of the cabin or road, but the audio feed is completely muted. When set to true, the manager will hear live audio from inside the vehicle.

Why use it: Much like the audio_recording toggle for saved videos, this is a critical setting for regulatory compliance during live operations. It allows fleets to maintain video security while guaranteeing that real-time driver conversations remain private.

Dispatch & Communication: Message Alerts

API Setting: message_notification_audio_enabled

When dispatch needs to get a hold of a driver, the driver needs to know a message is waiting safely.

The Experience: When set to true (the default), Raven will play a specific audio ping whenever a new message is received from the fleet management system.

Why use it: It ensures critical communications (like route changes or urgent updates) are not missed by the driver, acting much like a standard smartphone text notification but tailored for the driving environment.

Customer Profile & Recommended Configurations

Customer Profile	Recommended Configuration	Why?
Unionized / High-Privacy	streaming_audio: false audio_recording: false audio_notifications: true	Protects driver privacy by muting both the live remote feed and saved video files. Maintains transparency so drivers hear a chime if someone connects to the camera.
Active Coaching & Safety	audio_notifications: true AudioAlertType: VOICE	Maximizes driver feedback. The driver receives unambiguous verbal warnings for speeding and AI risk events, allowing for real-time self-correction.
Executive / Luxury Transport	audio_notifications: false AudioAlertType: NONE message_notification_audio: false	Provides a silent, distraction-free environment for passengers. The device acts passively without beeping or interrupting the cabin atmosphere.
Cash-in-Transit / High Security	streaming_audio: true audio_recording: true	Maximum oversight. Fleet managers can hear exactly what is happening in the cabin during an emergency, and all saved video evidence retains its audio track.