unity avprovideo 播放视频

### 如何在 Unity 中使用 AVPro Video 插件播放视频

#### 导入插件
为了能够在 Unity 项目中利用 AVPro Video 进行视频播放，第一步是下载并安装该插件。可以从官方 GitHub 页面获取免费版本[^4] 或者通过 Unity Asset Store 购买更高级别的版本以获得额外功能和支持。

一旦选择了合适的版本后，在 Unity 编辑器内依次点击 `Window` -> `Package Manager` 来管理第三方包资源；对于直接下载下来的 `.unitypackage` 文件，则可以通过菜单栏选择 `Assets` -> `Import Package...` 完成导入操作[^1]。

#### 创建基本场景设置
完成上述步骤之后，接下来创建一个新的 GameObject 并命名为 "MediaPlayer" ，用于承载所有的媒体控制逻辑组件。接着添加一个名为 MediaPlayer 的 Component 到此对象上，这一步骤可通过右键单击 Inspector 面板内的空白区域来实现，随后搜索并附加对应的脚本文件。

using UnityEngine;
using RenderHeads.Media.AVProVideo;

public class SimplePlayer : MonoBehaviour {
    private MediaPlayer _mediaPlayer; 

    void Start() {
        // 初始化 Media Player 组件实例化
        _mediaPlayer = gameObject.AddComponent<MediaPlayer>();
        
        string videoPath = Application.streamingAssetsPath + "/example.mp4";
        PlayVideo(videoPath);
    }

    public void PlayVideo(string path){
        if (_mediaPlayer != null && !string.IsNullOrEmpty(path)){
            _mediaPlayer.Stop();
            _mediaPlayer.OpenFileAsync(path, OnOpenComplete);    
        }
    }

    private void OnOpenComplete(bool success){
        Debug.Log($"Opening file completed with status {success}");
        if (success){
            _mediaPlayer.Play();   
        }else{
            Debug.LogError("Failed to open the specified media.");
        }
    }
}

这段 C# 代码展示了如何初始化 MediaPlayer 对象以及定义了一个简单的函数用来加载本地路径下的 MP4 格式的影片素材，并尝试异步打开指定位置的多媒体文件以便后续播放处理。

#### 处理远程视频流
当涉及到从网络服务器拉取在线内容时，只需调整 URL 地址指向目标源即可。需要注意的是，某些情况下可能还需要配置跨域资源共享(CORS)策略确保请求合法性[^3]。

另外值得注意的一点是在 Android 设备上部署应用期间，如果希望访问存储于设备内部特定目录结构里的私有数据（比如 SD 卡），则应该遵循平台安全指南实施必要的权限声明工作。