下载
中文
注册

hi_mpi_ai_get_frame

Atlas 200/300/500 推理产品,不支持该接口。

Atlas 训练系列产品,不支持该接口。

Atlas 推理系列产品,不支持该接口。

Atlas A2训练系列产品/Atlas 800I A2推理产品,不支持该接口。

函数功能

获取音频帧。

约束说明

  • 获取音频帧数据前,必须先调用hi_mpi_ai_enable接口使能对应的AI设备。
  • 录音为左声道和双声道时,ai_chn需固定为0;右声道时,ai_chn为1。
  • 本接口与hi_mpi_ai_release_frame接口需成对出现,调用本接口获取音频帧,音频帧使用完毕之后应该及时调用hi_mpi_ai_release_frame接口释放音频帧。

函数原型

hi_s32 hi_mpi_ai_get_frame(hi_audio_dev ai_dev, hi_ai_chn ai_chn, hi_audio_frame *frame, hi_aec_frame *aec_frame, hi_s32 milli_sec);

参数说明

参数名

输入/输出

说明

ai_dev

输入

音频设备号,取值范围:[0, 2]。

ai_chn

输入

音频输入通道号。

frame

输出

音频帧结构体指针。

aec_frame

输出

回声抵消参考帧结构体指针。

预留参数,当前设置为NULL。

milli_sec

输入

配置获取数据的超时时间,单位是毫秒,取值范围如下:

  • -1:表示阻塞模式,无数据时一直等待;
  • 0:表示非阻塞模式,无数据时则报错返回;
  • >0:需要配置具体的超时时间,表示超过指定时间后无数据,则报错返回。

返回值说明

参考资源

接口调用流程,参见音频获取&音频播放