用途:为使用 libvlc(VLC 媒体播放器背后的多媒体框架)的开发者提供辅助,覆盖 API 用法、代码生成、调试与架构决策,支持 3.x 与 4.x 两个大版本及多种语言和平台。
版本区分:参考文档用内联标记区分版本——无标记为两版共用,[3.x] 仅 3.x(4.x 已移除),[4.x] 为 4.x 新增,[4.x change] 表示两版均存在但签名有变。生成代码时若上下文不明确,需先确认目标版本,再选择匹配的 API 与绑定。
主要能力:识别当前集成面(C API、LibVLCSharp、vlcj、移动端、桌面、流媒体、转码或插件发现);按需加载 libvlc-skill.md 中相关章节,而非整份引用;在把播放问题归因于编解码前,先核查媒体生命周期、线程、原生库加载、日志与释放行为。
参考章节涵盖:架构总览与对象模型;核心概念(生命周期、线程规则、事件系统、错误处理、日志、插件发现);API 参考(instance、media、media player、media list、事件、dialog、discoverer、renderer、VLM、tracklist、program、GPU 渲染、A-B 循环、picture API);语言绑定(C、C#/LibVLCSharp、Python、Java/vlcj、Go、C++/libvlcpp);常见工作流(播放、元数据、缩略图、播放列表、Chromecast、转码、流媒体、录制、轨道选择、马赛克、移动端生命周期);平台集成(Windows/Win32、WPF、WinForms、D3D11,macOS/iOS,Linux/GTK、wxWidgets,Qt,Android,Avalonia);流媒体与转码(sout 链、协议、Chromecast);故障排查(死锁、无音视频、内存泄漏、常见陷阱);CLI 选项;已弃用 API;以及 3.x→4.x 迁移指南。
使用要点与限制:需明确 libvlc 主版本;确保原生库与插件在目标运行时中可被发现;事件回调不得阻塞 libvlc 工作线程;media、player、instance 对象须按正确顺序释放。未提供收费、价格与具体平台支持清单,相关内容暂未提供。