nokhwa

nokhwa

Rust跨平台网络摄像头库简单易用

nokhwa是一个跨平台Rust网络摄像头库,支持Linux、Windows、Mac和Web浏览器。它提供多种后端如Video4Linux、MSMF和AVFoundation,实现帧捕获、设备查询和图像解码等功能。nokhwa通过高级API和低级访问,结合灵活的特性配置,使开发者能够便捷地创建摄像头应用。

Rust摄像头跨平台视频捕捉开源库Github开源项目

货物版本 docs.rs 版本

nokhwa

Nokhwa(녹화):韩语单词,意为"记录"。

一个简单易用的跨平台 Rust 网络摄像头捕获库

使用 nokhwa

可以通过在 Cargo.toml 中添加以下内容来将 Nokhwa 添加到你的 crate 中:

[dependencies.nokhwa] version = "0.10.0" # 使用原生输入后端,启用 WGPU 集成 features = ["input-native", "output-wgpu"]

大多数情况下,你只需使用 Camera 结构体提供的功能。如果需要更低级别的访问,可以选择使用 nokhwa::backends::capture::* 中的原始捕获后端。

示例

// 系统中的第一个摄像头 let index = CameraIndex::Index(0); // 请求可解码为 RGB 的最高分辨率 CameraFormat let requested = RequestedFormat::new::<RgbFormat>(RequestedFormatType::AbsoluteHighestFrameRate); // 创建摄像头 let mut camera = Camera::new(index, requested).unwrap(); // 获取一帧 let frame = camera.frame().unwrap(); println!("捕获单帧大小为 {}", frame.buffer().len()); // 解码为 ImageBuffer let decoded = frame.decode_image::<RgbFormat>().unwrap(); println!("解码后帧大小为 {}", decoded.len());

examples 文件夹中有一个使用 nokhwa 制作的命令行应用。

API 支持

下表列出了当前 Nokhwa API 的支持情况。

  • Backend 列表示后端。
  • Input 列表示从摄像头读取帧的支持。
  • Query 列表示系统设备列表支持。
  • Query-Device 列表示读取设备功能的支持。
  • Platform 列表示该功能可用的平台。
后端输入查询设备查询平台
Video4Linux(input-native)Linux
MSMF(input-native)Windows
AVFoundation(input-native)Mac
OpenCV(input-opencv)^Linux, Windows, Mac
WASM(input-wasm)浏览器(Web)

✅: 可用, 🔮 : 实验性, ❌ : 不支持, 🚧: 计划中/进行中

^ = 可能存在 bug。同时支持 IP 摄像头。

特性

默认特性不包含任何内容。以 input-* 开头的特性用于启用特定后端。

input-* 特性:

  • input-native:使用 V4L2(Linux)、MSMF(Windows) 或 AVFoundation(Mac OS)
  • input-opencv:启用 opencv 后端(跨平台)
  • input-jscam:启用 JSCamera 结构体,使用浏览器 API(Web)

相应地,以 output-* 开头的特性控制输出(通常是来自摄像头的帧)

output-* 特性:

  • output-wgpu:启用 API 以直接将帧复制到 wgpu 纹理中。
  • output-threaded:启用基于线程/回调的摄像头。

其他特性:

  • decoding:启用 mozjpeg 解码。默认启用。
  • docs-only:文档特性。在 docs.rs 构建中启用。
  • docs-nolink:构建文档时链接任何库。在 docs.rs 构建中启用。
  • test-fail-warning:警告时失败。在 CI 中启用。

你可以根据需要选择以减少冗余。

问题

如果你要提出问题,请确保:

  • 该问题尚未被提出
  • 附上你的操作、环境、复现步骤和回溯信息 谢谢!

贡献

欢迎贡献!

  • 请使用 rustfmt 格式化所有代码,并遵守 clippy 的建议(除非必要)
  • 请限制 unsafe 的使用
  • 所有贡献均在 Apache 2.0 许可下,除非另有说明

最低支持的 Rust 版本

nokhwa 可能在旧版本的 rustc 上构建,但除了最新的稳定版 Rust 外,不保证其他版本。

赞助商

请考虑捐赠!这有助于我在父母面前不那么像个失败者!

编辑推荐精选

蛙蛙写作

蛙蛙写作

AI小说写作助手,一站式润色、改写、扩写

蛙蛙写作—国内先进的AI写作平台,涵盖小说、学术、社交媒体等多场景。提供续写、改写、润色等功能,助力创作者高效优化写作流程。界面简洁,功能全面,适合各类写作者提升内容品质和工作效率。

AI辅助写作AI工具蛙蛙写作AI写作工具学术助手办公助手营销助手AI助手
Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
问小白

问小白

全能AI智能助手,随时解答生活与工作的多样问题

问小白,由元石科技研发的AI智能助手,快速准确地解答各种生活和工作问题,包括但不限于搜索、规划和社交互动,帮助用户在日常生活中提高效率,轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手,它拥有超精准的音频识别翻译能力,几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球,无论你是留学生、商务人士、韩剧美剧爱好者,还是出国游玩、多国会议、跨国追星等等,都可以满足你所有需要同传的场景需求,线上线下通用,扫除语言障碍,让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

下拉加载更多