xt_audio_svc（音频服务）

音频服务层（统一的 TTS/文件播放入口） 更多...

结构体
struct	xt_audio_svc_tts_info
struct	xt_audio_svc_file_info

宏定义
#define	xt_audio_svc_tts_play(_dev, _text, _size, _level)
#define	xt_audio_svc_file_play(_dev, _path, _level)

类型定义
typedef void(*	xt_audio_svc_evt_cb_t) (xt_audio_t dev, enum xt_audio_svc_evt evt, void *user_data)

枚举
enum	xt_audio_svc_evt {   XT_AUDIO_SVC_EVT_TTS_CMPLT , XT_AUDIO_SVC_EVT_TTS_ERROR , XT_AUDIO_SVC_EVT_TTS_ABORT , XT_AUDIO_SVC_EVT_FILE_CMPLT ,   XT_AUDIO_SVC_EVT_FILE_ERROR , XT_AUDIO_SVC_EVT_FILE_ABORT }
enum	xt_audio_svc_type { XT_AUDIO_SVC_TTS , XT_AUDIO_SVC_FILE , XT_AUDIO_SVC_ANY }

函数
xt_err_t	xt_audio_svc_register_evt_cb (xt_audio_svc_evt_cb_t cb, void *user_data)
	注册全局事件回调
xt_err_t	xt_audio_svc_tts_play_ext (xt_audio_t dev, const char *text, uint32_t size, uint8_t level, struct xt_audio_svc_tts_info *info)
	TTS 播放（扩展版本）
xt_err_t	xt_audio_svc_file_play_ext (xt_audio_t dev, const char *path, uint8_t level, struct xt_audio_svc_file_info *info)
	文件播放（扩展版本）
xt_err_t	xt_audio_svc_stop (xt_audio_t dev, enum xt_audio_svc_type type)
	停止指定类型的服务

详细描述

音频服务层（统一的 TTS/文件播放入口）

宏定义说明

xt_audio_svc_file_play

#define xt_audio_svc_file_play	(		_dev,
			_path,
			_level )

值:

xt_audio_svc_file_play_ext(_dev, _path, _level, NULL)

在文件 xt_audio_svc.h 第 105 行定义.

xt_audio_svc_tts_play

#define xt_audio_svc_tts_play	(		_dev,
			_text,
			_size,
			_level )

值:

xt_audio_svc_tts_play_ext(_dev, _text, _size, _level, NULL)

在文件 xt_audio_svc.h 第 102 行定义.

类型定义说明

xt_audio_svc_evt_cb_t

typedef void(* xt_audio_svc_evt_cb_t) (xt_audio_t dev, enum xt_audio_svc_evt evt, void *user_data)

在文件 xt_audio_svc.h 第 48 行定义.

枚举类型说明

xt_audio_svc_evt

enum xt_audio_svc_evt

枚举值
XT_AUDIO_SVC_EVT_TTS_CMPLT
XT_AUDIO_SVC_EVT_TTS_ERROR
XT_AUDIO_SVC_EVT_TTS_ABORT
XT_AUDIO_SVC_EVT_FILE_CMPLT
XT_AUDIO_SVC_EVT_FILE_ERROR
XT_AUDIO_SVC_EVT_FILE_ABORT

在文件 xt_audio_svc.h 第 33 行定义.

xt_audio_svc_type

enum xt_audio_svc_type

枚举值
XT_AUDIO_SVC_TTS
XT_AUDIO_SVC_FILE
XT_AUDIO_SVC_ANY

在文件 xt_audio_svc.h 第 42 行定义.

函数说明

xt_audio_svc_file_play_ext()

xt_err_t xt_audio_svc_file_play_ext	(	xt_audio_t	dev,
		const char *	path,
		uint8_t	level,
		struct xt_audio_svc_file_info *	info )

文件播放（扩展版本）

参数

dev	音频设备句柄
path	文件路径（支持 .amr/.mp3/.wav/.opus）
level	音量等级 0-100
info	扩展参数（可为 NULL）

返回

XT_EOK 成功，XT_EBUSY 已有服务在执行

xt_audio_svc_register_evt_cb()

xt_err_t xt_audio_svc_register_evt_cb	(	xt_audio_svc_evt_cb_t	cb,
		void *	user_data )

注册全局事件回调

xt_audio_svc_stop()

xt_err_t xt_audio_svc_stop	(	xt_audio_t	dev,
		enum xt_audio_svc_type	type )

停止指定类型的服务

参数

dev	音频设备句柄
type	要停止的服务类型，XT_AUDIO_SVC_ANY 停止所有

xt_audio_svc_tts_play_ext()

xt_err_t xt_audio_svc_tts_play_ext	(	xt_audio_t	dev,
		const char *	text,
		uint32_t	size,
		uint8_t	level,
		struct xt_audio_svc_tts_info *	info )

TTS 播放（扩展版本）

参数

dev	音频设备句柄（xt_audio_dev_setup 返回的）
text	UTF-8 文本
size	文本字节数
level	音量等级 0-100
info	扩展参数（可为 NULL）

返回

XT_EOK 成功，XT_EBUSY 已有服务在执行