跳到主要内容

功能及约束说明

hi_mpi_sys_bind​

函数功能​

调用本接口建立数据接收者与数据源之间的关联关系，同一个数据接收者只能绑定一个数据源，绑定后，数据源生成的数据将自动发送给接收者。

约束说明​

  • 当前支持如下数据源、数据接收者之间的绑定关系：

    数据源数据接收者说明
    视频输入VI视频处理VPSSVPSS Group ID取值在[256, 264)范围内。
    视频解码VDEC视频处理VPSSVPSS Group ID取值在[0, 256)范围内。
    视频处理VPSS视频输出VOVPSS Group ID取值在[0, 256)范围内。
    音频解码ADEC音频输出AO-
    音频输入AI音频编码AENC-

  • 除以下场景可将设备号或通道号设置为0，其它场景均需根据实际使用的设备号、通道号来设置。

    • VI和VDEC作为数据源，是以通道为发送者，向其他模块发送数据，用户将设备号src_chn.dev_id参数设置为0，SDK不检查输入的设备号。
    • VPSS作为数据接收者时，是以设备（GROUP）为接收者，接收其他模块发来的数据，用户将通道号dst_chn.chn_id参数设置为0。

函数原型​

hi_s32 hi_mpi_sys_bind(const hi_mpp_chn *src_chn, const hi_mpp_chn *dest_chn)

参数说明​

参数名输入/输出说明
src_chn输入源通道指针。
dest_chn输入目的通道指针。

返回值说明​

父主题： 公共接口

hi_mpi_sys_unbind​

函数功能​

调用本接口解除数据源与数据接收者之间的关联关系。

约束说明​

  • dst_chn如果找不到绑定的源通道，则直接返回成功。如果找到了绑定的源通道，但是绑定的源通道和src_chn不匹配，则返回失败。

函数原型​

hi_s32 hi_mpi_sys_unbind(const hi_mpp_chn *src_chn, const hi_mpp_chn *dest_chn)

参数说明​

参数名输入/输出说明
src_chn输入源通道指针。
dest_chn输入目的通道指针。

返回值说明​

父主题： 公共接口

功能及约束说明​

  • AI（Audio Input）音频输入、AO（Audio Output）音频输出API主要实现配置及启用音频输入设备、获取音频帧数据、播放等功能，本章中的接口均不支持多进程**，且同一个设备ID不支持在多线程中使用**。

  • 对于内置Audio Codec，主要通过ioctl命令字实现对硬件设备的操作。

  • 在录音起始阶段，由于硬件存在资源准备的过程，因此可能在起始阶段瞬间存在音频数据波动现象，但并不影响后续录音功能。

  • 关于AI、AO设备的说明如下：

    表1 AO设备

    AO dev输出对接器件
    0对接外置codec0
    1对接外置codec1
    2内置codec
    3HDMI0
    4HDMI1

    表2 AI设备

    AI dev输入对接器件
    0对接外置codec0
    1对接外置codec1
    2内置codec

父主题： AI音频输入/AO音频输出

hi_mpi_ai_set_pub_attr​

函数功能​

设置AI设备属性。

约束说明​

  • 仅支持I2S主模式。
  • 在双声道和右声道模式下，chn_cnt需为2；在左声道模式下，chn_cnt需为1。

函数原型​

hi_s32 hi_mpi_ai_set_pub_attr(hi_audio_dev ai_dev, const hi_aio_attr *attr);

参数说明​

参数名输入/输出说明。
ai_dev输入音频设备号，取值范围：[0, 2]。
attr输入AI设备属性。

返回值说明​

参考资源​

接口调用流程，参见音频获取&音频播放功能。

父主题： AI音频输入/AO音频输出

hi_mpi_ai_enable​

函数功能​

启用AI设备。

约束说明​

  • 启用AI设备前，必须先调用hi_mpi_ai_set_pub_attr接口配置AI设备属性，否则返回属性未配置错误。
  • 如果AI设备已经处于enable状态，则直接返回成功。

函数原型​

hi_s32 hi_mpi_ai_enable(hi_audio_dev ai_dev);

参数说明​

参数名输入/输出说明。
ai_dev输入音频设备号，取值范围：[0, 2]。

返回值说明​

参考资源​

接口调用流程，参见音频获取&音频播放功能。

父主题： AI音频输入/AO音频输出

hi_mpi_ai_disable​

函数功能​

禁用AI设备。

约束说明​

  • 如果AI设备已经处于禁用状态，则直接返回成功。
  • 禁用AI设备前，必须先调用hi_mpi_ai_disable_chn接口禁用该设备下已启用的所有AI通道。

函数原型​

hi_s32 hi_mpi_ai_disable(hi_audio_dev ai_dev);

参数说明​

参数名输入/输出说明。
ai_dev输入音频设备号，取值范围：[0, 2]。

返回值说明​

参考资源​

接口调用流程，参见音频获取&音频播放功能。

父主题： AI音频输入/AO音频输出

在线提单