Provides robot system audio service controller. Through the AudioController, you can control robot audio and obtain status via RPC methods.

Interface Definition

AudioController is a C++ class that encapsulates audio control functionality, mainly used for audio playback control, TTS playback, volume setting and query, etc.

AudioController

Item	Content
Function Name	AudioController
Function Declaration	AudioController();
Function Overview	Initialize audio controller object, construct internal state, allocate resources, etc.
Notes	Constructs internal state.

~AudioController

Item	Content
Function Name	~AudioController
Function Declaration	~AudioController();
Function Overview	Release audio controller resources, ensure playback stops and clean up low-level resources.
Notes	Ensures safe resource release.

Initialize

Item	Content
Function Name	Initialize
Function Declaration	bool Initialize();
Function Overview	Initialize audio control module, prepare playback resources and devices.
Return Value	true indicates success, false indicates failure.
Notes	Used in conjunction with Shutdown().

Shutdown

Item	Content
Function Name	Shutdown
Function Declaration	void Shutdown();
Function Overview	Shutdown audio controller and release resources.
Notes	Ensure called before destruction.

Play

Item	Content
Function Name	Play
Function Declaration	Status Play(const TtsCommand& cmd);
Function Overview	Play TTS (text-to-speech) voice commands.
Parameter Description	cmd: TTS command, contains text, speech rate, tone, etc.
Return Value	Status::OK indicates success, others indicate failure state.
Notes	Blocking interface, ensure module is initialized before calling.

Stop

Item	Content
Function Name	Stop
Function Declaration	Status Stop();
Function Overview	Stop current audio playback.
Return Value	Status::OK indicates success, others indicate failure state.
Notes	Blocking interface, usually used to interrupt current voice.

SetVolume

Item	Content
Function Name	SetVolume
Function Declaration	Status SetVolume(int volume);
Function Overview	Set audio output volume.
Parameter Description	volume: Volume value, typically ranges from 0~100.
Return Value	Status::OK indicates success, others indicate failure state.
Notes	Blocking interface, takes effect immediately after setting.

GetVolume

Item	Content
Function Name	GetVolume
Function Declaration	Status GetVolume(int& volume);
Function Overview	Get current audio output volume.
Parameter Description	volume: Returns current volume value by reference.
Return Value	Status::OK indicates success, others indicate failure state.
Notes	Blocking interface, return value should be checked before using volume.

Type Definitions

TtsPriority — TTS Playback Priority Level

Used to control interrupt behavior between different TTS tasks. Higher priority tasks will interrupt playback of current lower priority tasks.

Enumeration Value	Description
TtsPriority::HIGH	Highest priority, e.g.: low battery warning, emergency alerts
TtsPriority::MIDDLE	Medium priority, e.g.: system prompts, status announcements
TtsPriority::LOW	Lowest priority, e.g.: daily voice conversation, background announcements

---

TtsMode — Task Scheduling Strategy Under Same Priority

Used to fine-tune control of playback order and clearing logic for multiple TTS tasks under the same priority conditions.

Enumeration Value	Description
TtsMode::CLEARTOP	Clear all tasks of current priority (including currently playing and waiting queue), immediately play this request
TtsMode::ADD	Append this request to the end of current priority queue, play in order (does not interrupt current playback)
TtsMode::CLEARBUFFER	Clear unplayed requests in queue, keep current playback, then play this request

---

Structure Definitions

TtsCommand — TTS Playback Command Structure

Describes complete information for a TTS playback request, supporting unique identifier, text content, priority control, and scheduling mode under same priority.

Field Name	Type	Description
id	std::string	TTS task unique ID, e.g. "id_01", used to track playback status
content	std::string	Text content to be played, e.g. "Hello, welcome to the intelligent voice system."
priority	TtsPriority	Playback priority, controls whether to interrupt currently playing low-priority voice
mode	TtsMode	Scheduling strategy under same priority, controls whether tasks are appended, overridden, etc.

AudioStream - Audio Stream Structure

Describes raw audio stream or BF audio stream data.

Field Name	Type	Description
data_length	int32_t	Data length
raw_data	std::vector<uint8_t>	Audio stream data