)
简介：CSDN博客专家、《Android系统多媒体进阶实战》作者
博主新书推荐：《Android系统多媒体进阶实战》🚀
Android Audio工程师专栏地址：Audio工程师进阶系列【原创干货持续更新中……】🚀
Android多媒体专栏地址：多媒体系统工程师系列【原创干货持续更新中……】🚀
专题一 二：AAOS车载系统+AOSP14系统攻城狮入门视频实战课🚀
专题三：Android14 Binder之HIDL与AIDL通信实战课🚀
专题四：Android15快速自定义与集成音效实战课🚀
专题五：Android15音频策略实战课🚀
专题六：Android15音频性能实战课(无声/杂音/断音/爆音实战案例)🚀
人生格言：人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.
点击获取二维码
🍉🍉🍉文章目录🍉🍉🍉
- 🌻1.前言
- 🌻2.应用场景和用法
- 2.1枚举输入采集源
- 2.2函数原型与返回语义
- 🌻3.调用流程剖析
- 3.1创建临时设备上下文
- 3.2调用设备格式的枚举回调
- 🌻4.实战案例
- 4.1准备ALSA输入格式
- 4.2枚举设备并读取结果
- 4.3完整代码
- 🌻5.总结
🌻1.前言
本篇目的：理解
avdevice_list_input_sources()如何根据输入设备格式枚举可用采集源，并通过程序读取设备名称和描述。
应用要从摄像头或音频设备采集数据时，通常要先让用户选择一个输入源。avdevice_list_input_sources()负责调用输入设备格式提供的枚举能力，返回设备列表；它不打开采集流，也不读取音视频帧。
🌻2.应用场景和用法
2.1枚举输入采集源
这个接口适合在真正打开设备之前获取候选输入源。
| 场景 | 接口用途 | 后续动作 |
|---|---|---|
| 摄像头选择 | 列出输入格式发现的视频设备 | 将选中的设备名传给打开输入接口 |
| 音频设备选择 | 通过ALSA等输入格式枚举采集设备 | 将设备名交给对应输入格式 |
| 采集源诊断 | 检查当前构建和系统环境能发现哪些设备 | 对比设备名、描述和系统设备状态 |
| 应用选项初始化 | 使用设备私有选项影响枚举 | 后续打开设备时传入相同选项 |
设备枚举由具体的AVInputFormat实现。某个输入格式没有实现设备列表回调时，接口会返回AVERROR(ENOSYS)。即使枚举成功，设备列表也不保证覆盖所有可用设备，具体发现范围取决于设备后端和系统环境。
2.2函数原型与返回语义
函数原型如下：
intavdevice_list_input_sources(constAVInputFormat*device,constchar*device_name,AVDictionary*device_options,AVDeviceInfoList**device_list);| 参数 | 含义 |
|---|---|
device | 输入设备格式，例如alsa或v4l2对应的AVInputFormat |
device_name | 设备格式名称；可与device二选一，同时提供时以device为准 |
device_options | 传给设备枚举上下文的私有选项，可以为NULL |
device_list | 接收枚举结果的输出参数，调用者应传入有效指针 |
成功时返回发现的设备数量，并通过device_list返回AVDeviceInfoList。失败时返回负的AVERROR错误码。列表中的每一项包含设备名称、描述和可提供的媒体类型。
该接口会在内部创建输入设备上下文，复制并应用选项，调用通用设备枚举接口，然后释放临时上下文。调用者需要使用avdevice_free_list_devices()释放返回列表。枚举结果不是采集流；实际采集仍需之后调用avformat_open_input()。
🌻3.调用流程剖析
3.1创建临时设备上下文
调用avdevice_list_input_sources()时，FFmpeg先根据device和device_name创建临时输入设备上下文。传入device_options时，内部会复制字典，再把选项应用到临时上下文，因此不会把内部应用选项时的字典变化带回调用者。
随后，函数调用avdevice_list_devices()完成统一的列表创建与分派。临时上下文在流程结束时释放，无论枚举成功还是失败。
3.2调用设备格式的枚举回调
avdevice_list_devices()检查上下文是否包含输入或输出格式，并检查对应格式是否实现get_device_list回调。没有回调时，它将输出列表置为NULL并返回AVERROR(ENOSYS)。
如果回调存在，通用层分配AVDeviceInfoList，将default_device初始化为-1，然后调用具体设备格式的回调。回调负责发现设备并向列表添加信息。发生错误时，通用层释放已创建的列表；成功时，返回设备数量，列表所有权交给调用者。
以ALSA输入格式为例，设备后端通过ALSA设备提示枚举采集端点，并填充设备名称和描述。接口只返回这些发现信息，不替应用选择设备，也不保证设备随后一定能成功打开。
🌻4.实战案例
4.1准备ALSA输入格式
示例使用ALSA输入格式枚举音频采集源。设备枚举依赖FFmpeg构建时包含ALSA输入设备支持，也依赖当前系统能够访问ALSA设备信息。
constAVInputFormat*input_format;avdevice_register_all();input_format=av_find_input_format("alsa");如果input_format为NULL，说明当前运行环境没有找到该输入格式，应先检查FFmpeg构建配置和设备注册状态。
4.2枚举设备并读取结果
将输入格式传给avdevice_list_input_sources()，检查返回值。返回值大于等于0时表示枚举成功，数值是设备数量；返回值小于0时表示发生错误。
每项设备信息由列表拥有。完成访问后调用avdevice_free_list_devices()，不要单独释放列表内部的名称、描述或媒体类型数组。
4.3完整代码
#include<stdio.h>#include<libavdevice/avdevice.h>#include<libavformat/avformat.h>#include<libavutil/error.h>staticvoidprint_error(interror){charmessage[AV_ERROR_MAX_STRING_SIZE];av_strerror(error,message,sizeof(message));fprintf(stderr,"Device enumeration failed: %s\n",message);}intmain(void){constAVInputFormat*input_format;AVDeviceInfoList*device_list=NULL;intcount;inti;/* 注册设备格式，并查找ALSA音频输入格式 */avdevice_register_all();input_format=av_find_input_format("alsa");if(input_format==NULL){fprintf(stderr,"ALSA input format is unavailable\n");return1;}/* 设备名和私有选项都为空，由ALSA后端枚举默认可发现的输入源 */count=avdevice_list_input_sources(input_format,NULL,NULL,&device_list);if(count<0){print_error(count);avdevice_free_list_devices(&device_list);return1;}/* 读取设备名称、描述和媒体类型信息 */for(i=0;device_list!=NULL&&i<device_list->nb_devices;i++){constAVDeviceInfo*device=device_list->devices[i];printf("device: %s\n",device->device_name!=NULL?device->device_name:"(unknown)");printf("description: %s\n",device->device_description!=NULL?device->device_description:"(no description)");printf("media types: %d\n",device->nb_media_types);}/* 释放接口返回的完整设备列表 */avdevice_free_list_devices(&device_list);return0;}🌻5.总结
avdevice_list_input_sources()根据输入设备格式枚举采集源并返回由调用者释放的设备列表，但不打开采集流或读取音视频帧。
