MSO-Player：基于vlc的Unity直播流播放器，支持主流RTSP、RTMP、HTTP等常见格式
MSO-Player
基于libVLC的Unity视频播放解决方案
支持2D视频和360度全景视频播放的Unity插件
📑 目录
- 🎥 MSO-Player
- 📋 功能概述
- 🚀 快速入门
- 📚 关键组件
- 📝 使用案例
- 🔌 依赖项
- 📋 注意事项
- 📄 许可证
- 📞 联系与支持
📋 功能概述
MSO-Player是一个为Unity开发的强大视频播放解决方案，基于libVLC库构建，提供了丰富的功能和卓越的性能：
演示
Unity 播放海量RTSP视频，多线程播放，长时间运行稳定（已开源）
核心特性
- ✅ 普通视频播放：在UI上或3D物体上播放常规视频
- ✅ 360度全景视频：沉浸式全景视频体验，支持鼠标/触摸/陀螺仪控制
- ✅ 多种格式支持：基于libVLC，几乎支持所有流行的视频格式和流媒体协议
- ✅ 流媒体支持：RTSP、RTMP、HTTP等流媒体协议
- ✅ 超高性能播放：针对移动设备优化的高性能视频渲染
- ✅ 增强内存管理：优化的纹理管理和内存使用
- ✅ 实时渲染优化：高效的视频帧处理和渲染
- ✅ 自动画质切换：根据网络状况自动调整视频质量
- ✅ 增强稳定性：改进的错误处理和播放稳定性
- ✅ 安卓平台支持：完全支持安卓设备，包括基本的硬件加速
- ✅ 硬件解码加速：支持GPU硬解码，提升播放性能和降低能耗
- ✅ 特定设备优化：针对小米、三星等特定安卓设备进行专门优化
- ✅ 低性能设备适配：为低配置手机提供特殊优化，确保流畅播放体验
🚀 快速入门
安装要求
- Unity 2019.4 或更高版本
- 支持的平台：Windows、Linux、Android
安装步骤
- 将 MSO-Player 文件夹导入您的 Unity 项目
- 确保项目中已包含 libVLC 相关 dll 文件（位于 Plugins 文件夹）
- Windows: Plugins/x86_64/libvlc/
- Android: Plugins/Android/
基本使用 - 普通视频
- 创建一个带有 RawImage 组件的 UI 对象
- 添加
MediaPlayer组件 - 设置视频 URL（本地文件或流媒体链接）
- 点击播放按钮或调用
Play()方法
// 代码示例 - 控制视频播放
MediaPlayer player = GetComponent<MediaPlayer>();
player.SetUrl("https://example.com/video.mp4", true); // 设置URL并自动播放
基本使用 - 360度全景视频
- 创建一个球体物体
- 添加
MediaPlayer360组件 - 使用编辑器工具设置适当的材质和相机
- 设置全景视频 URL 并播放
// 代码示例 - 控制全景视频播放
MediaPlayer360 player = GetComponent<MediaPlayer360>();
player.SetUrl("https://example.com/panorama.mp4", true);
安卓平台特别说明
在安卓平台上使用时，请确保在AndroidManifest.xml中添加以下权限：
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
📚 关键组件
MediaPlayer
标准视频播放器组件，用于在UI的RawImage上播放视频。
主要属性：
URL: 视频源地址Width/Height: 视频分辨率Mute: 是否静音PlayOnStart: 是否自动播放
主要方法：
Play(): 开始播放Pause(): 暂停/恢复播放Stop(): 停止播放SetUrl(string url, bool autoPlay): 设置新的媒体源
MediaPlayer360
全景视频播放器组件，用于在球体上播放360度视频。
主要属性：
- 继承自MediaPlayer的所有属性
FlipY: 360度视频Y轴翻转开关
主要方法：
- 继承自MediaPlayer的所有方法
SetUrl(string url, bool autoPlay): 设置新的媒体源Play(): 开始播放Pause(): 暂停/恢复播放Stop(): 停止播放Refresh(): 刷新当前媒体
CameraController360
用于控制360全景相机的组件，支持多种输入方式。
主要特性：
- 鼠标拖拽控制
- 触摸屏幕控制
- 设备陀螺仪控制
- 平滑旋转过渡
📝 使用案例
视频流监控
// 实时显示RTSP摄像头流
MediaPlayer player = GetComponent<MediaPlayer>();
player.SetUrl("rtsp://admin:password@192.168.1.100:554/stream");
player.Play();
VR全景体验
// 创建可交互的360度环境
MediaPlayer360 player = GetComponent<MediaPlayer360>();
player.SetUrl("https://example.com/360tour.mp4");
安卓应用视频展示
// 在安卓应用中播放视频
MediaPlayer player = GetComponent<MediaPlayer>();
player.SetUrl("file:///storage/emulated/0/DCIM/Camera/video.mp4");
player.Play();
🔌 依赖项
- LibVLC - 视频解码和处理
- Unity UI System - 用于视频渲染和交互
📋 注意事项
- 性能考虑：全景视频分辨率对性能影响较大，请根据目标平台适当调整
- 平台特定设置：在移动平台上发布前，请检查平台特定的设置和权限
- 视频方向问题：不同来源的360视频可能需要不同的翻转/旋转设置
- 安卓兼容性：已针对不同安卓设备进行了兼容性优化，但在极低配置设备上可能需要进一步调整
📄 许可证
本项目采用 MIT 许可证。
📞 联系与支持
- 问题报告：请使用 GitHub Issues
- 联系作者：[873438526@qq.com]
如果您喜欢这个项目，请考虑给它一个⭐