Linux FFmpeg深度解析之avdevice_list_input_sources调用流程与实战(六)-北京尧图网络

简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮点击获取二维码文章目录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()负责调用输入设备格式提供的枚举能力返回设备列表它不打开采集流也不读取音视频帧。输入设备格式avdevice_list_input_sources设备名称和选项设备格式枚举回调AVDeviceInfoList设备列表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对应的AVInputFormatdevice_name设备格式名称可与device二选一同时提供时以device为准device_options传给设备枚举上下文的私有选项可以为NULLdevice_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()完成统一的列表创建与分派。临时上下文在流程结束时释放无论枚举成功还是失败。AVInputFormat与设备选项创建临时输入设备上下文应用设备私有选项调用avdevice_list_devices释放临时上下文3.2调用设备格式的枚举回调avdevice_list_devices()检查上下文是否包含输入或输出格式并检查对应格式是否实现get_device_list回调。没有回调时它将输出列表置为NULL并返回AVERROR(ENOSYS)。如果回调存在通用层分配AVDeviceInfoList将default_device初始化为-1然后调用具体设备格式的回调。回调负责发现设备并向列表添加信息。发生错误时通用层释放已创建的列表成功时返回设备数量列表所有权交给调用者。否是失败成功临时AVFormatContext输入格式支持枚举返回ENOSYS创建AVDeviceInfoList调用设备格式回调枚举结果释放列表并返回错误返回设备数量和列表以ALSA输入格式为例设备后端通过ALSA设备提示枚举采集端点并填充设备名称和描述。接口只返回这些发现信息不替应用选择设备也不保证设备随后一定能成功打开。4.实战案例4.1准备ALSA输入格式示例使用ALSA输入格式枚举音频采集源。设备枚举依赖FFmpeg构建时包含ALSA输入设备支持也依赖当前系统能够访问ALSA设备信息。constAVInputFormat*input_format;avdevice_register_all();input_formatav_find_input_format(alsa);如果input_format为NULL说明当前运行环境没有找到该输入格式应先检查FFmpeg构建配置和设备注册状态。4.2枚举设备并读取结果将输入格式传给avdevice_list_input_sources()检查返回值。返回值大于等于0时表示枚举成功数值是设备数量返回值小于0时表示发生错误。每项设备信息由列表拥有。完成访问后调用avdevice_free_list_devices()不要单独释放列表内部的名称、描述或媒体类型数组。4.3完整代码#includestdio.h#includelibavdevice/avdevice.h#includelibavformat/avformat.h#includelibavutil/error.hstaticvoidprint_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_listNULL;intcount;inti;/* 注册设备格式并查找ALSA音频输入格式 */avdevice_register_all();input_formatav_find_input_format(alsa);if(input_formatNULL){fprintf(stderr,ALSA input format is unavailable\n);return1;}/* 设备名和私有选项都为空由ALSA后端枚举默认可发现的输入源 */countavdevice_list_input_sources(input_format,NULL,NULL,device_list);if(count0){print_error(count);avdevice_free_list_devices(device_list);return1;}/* 读取设备名称、描述和媒体类型信息 */for(i0;device_list!NULLidevice_list-nb_devices;i){constAVDeviceInfo*devicedevice_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()根据输入设备格式枚举采集源并返回由调用者释放的设备列表但不打开采集流或读取音视频帧。

Linux FFmpeg深度解析之avdevice_list_input_sources调用流程与实战(六)

相关推荐

硬盘数据恢复，这5个妙招汇总操作轻松，效果显著！

【StrongSort 03】多轨迹算法StrongSort改进点

华为云码道本地部署手册

更多资讯

专科生论文写作工具评测与高效使用指南

SQL正则表达式实战：从基础到高级应用

华为CE交换机M-LAG配置与故障排查实战

2026年微信C盘存储优化与清理全攻略

微信C盘空间占用分析与清理优化方案

Java技术栈在充电桩物联网平台中的应用与实践

今日更新

学生选课系统DFD图绘制指南：边界划分与分层校验实战

JIRA敏捷落地：Scrum角色权限、Sprint与燃尽图避坑指南

SEMI S8人机工程验收实战：从条款拆解到现场实测的完整指南

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？