FairyPlayer

1) 本地媒体播放

适用于日常视频、音乐、课程、录屏等文件的直接播放。

• 使用步骤：打开软件后，点击“打开文件”或直接拖拽媒体文件到窗口。
• 常用操作：拖动进度条快进/回退，调节音量，切换全屏，支持暂停与继续播放。
• 适用格式：常见 mp4、mkv、mp3、flac、wav 等主流格式（受系统编解码能力影响）。

2) 在线流媒体播放（M3U8）

适用于直播流、课程回放、网络点播地址等需要在线播放的场景。

• 使用步骤：在地址输入区域粘贴 M3U8 链接，点击“播放”即可开始加载。
• 网络要求：网络越稳定，首帧加载越快；弱网环境下可能出现缓冲。
• 故障排查：链接失效、跨域限制或源站限流时，可能无法播放。

3) 媒体信息探测

用于查看视频/音频的关键参数，便于转码前评估。

• 可查看信息：时长、分辨率、编码格式、码率、音轨等。
• 使用方式：加载媒体后打开“属性/信息”面板查看详情。
• 典型用途：判断素材是否需要转码、封装或统一参数。

4) 视频截图

用于截取当前播放画面，生成图片文件用于预览或记录。

• 使用步骤：播放到目标时间点，点击“截图”按钮。
• 输出结果：自动生成 PNG 图片，保存到默认输出目录。
• 适用场景：制作封面、教学截图、问题反馈定位。

5) 转码与封装

用于将不兼容素材转换为通用格式，或仅更换容器以提升兼容性。

• 转码：可将源视频转为更通用的 H.264 + AAC 组合。
• 封装：在不重编码前提下更换封装容器，速度更快。
• 使用建议：先用“媒体信息探测”确认源文件参数，再选择转码或封装。

Windows 目录示例

• FairyPlayer.exe：主程序入口，双击即可启动。
• bin/：程序运行依赖的可执行组件目录，请勿删除或改名。
• dlls/：动态链接库目录，提供图形、多媒体等底层运行支持。
• images/（或 img/）：界面图标与图片资源目录。
• logs/：运行日志目录（若存在），用于问题排查。

Linux 目录示例

• FairyPlayer：Linux 主可执行文件。
• run.sh：推荐启动脚本，会自动处理运行环境后启动主程序。
• code/：运行模块与动态库目录（如 native_core、FFmpeg 相关文件）。
• images/（或 img/）：界面图标与图片资源目录。
• logs/：运行日志目录（若存在），用于故障定位。