MSO-Player

📑 目录

• 🎥 MSO-Player
  • 📋 功能概述
  • 🚀 快速入门
  • 📚 关键组件
  • 📝 使用案例
  • 🔌 依赖项
  • 📋 注意事项
  • 📄 许可证
  • 📞 联系与支持

📋 功能概述

MSO-Player是一个为Unity开发的强大视频播放解决方案，基于libVLC库构建，提供了丰富的功能和卓越的性能：

演示

核心特性

• ✅ 普通视频播放：在UI上或3D物体上播放常规视频
• ✅ 360度全景视频：沉浸式全景视频体验，支持鼠标/触摸/陀螺仪控制
• ✅ 多种格式支持：基于libVLC，几乎支持所有流行的视频格式和流媒体协议
• ✅ 流媒体支持：RTSP、RTMP、HTTP等流媒体协议
• ✅ 超高性能播放：针对移动设备优化的高性能视频渲染
• ✅ 增强内存管理：优化的纹理管理和内存使用
• ✅ 实时渲染优化：高效的视频帧处理和渲染
• ✅ 自动画质切换：根据网络状况自动调整视频质量
• ✅ 增强稳定性：改进的错误处理和播放稳定性
• ✅ 安卓平台支持：完全支持安卓设备，包括基本的硬件加速
• ✅ 硬件解码加速：支持GPU硬解码，提升播放性能和降低能耗
• ✅ 特定设备优化：针对小米、三星等特定安卓设备进行专门优化
• ✅ 低性能设备适配：为低配置手机提供特殊优化，确保流畅播放体验

🚀 快速入门

安装要求

• Unity 2019.4 或更高版本
• 支持的平台：Windows、Linux、Android

安装步骤

1. 将 MSO-Player 文件夹导入您的 Unity 项目
2. 确保项目中已包含 libVLC 相关 dll 文件（位于 Plugins 文件夹）
   • Windows: Plugins/x86_64/libvlc/
   • Android: Plugins/Android/

基本使用 - 普通视频

1. 创建一个带有 RawImage 组件的 UI 对象
2. 添加 MediaPlayer 组件
3. 设置视频 URL（本地文件或流媒体链接）
4. 点击播放按钮或调用 Play() 方法

// 代码示例 - 控制视频播放
MediaPlayer player = GetComponent<MediaPlayer>();
player.SetUrl("https://example.com/video.mp4", true); // 设置URL并自动播放

基本使用 - 360度全景视频

1. 创建一个球体物体
2. 添加 MediaPlayer360 组件
3. 使用编辑器工具设置适当的材质和相机
4. 设置全景视频 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 - 用于视频渲染和交互

📋 注意事项

1. 性能考虑：全景视频分辨率对性能影响较大，请根据目标平台适当调整
2. 平台特定设置：在移动平台上发布前，请检查平台特定的设置和权限
3. 视频方向问题：不同来源的360视频可能需要不同的翻转/旋转设置
4. 安卓兼容性：已针对不同安卓设备进行了兼容性优化，但在极低配置设备上可能需要进一步调整

📄 许可证

本项目采用 MIT 许可证。

📞 联系与支持

• 问题报告：请使用 GitHub Issues
• 联系作者：[873438526@qq.com]

---