接口速查
更新时间：2025-08-22
UnityXplayer类
| 接口名 | 描述 |
|---|---|
| public UnityXplayer(String appId) | 构造函数 |
| public IntPtr GetPlayer() | 返回播放器实例 |
| public int OpenUrl(string url) | 开始播放URL 正常起播返回0，鉴权失败时会返回错误码，含义如下 20003：鉴权服务器无返回 20004：找不到证书 20005：证书校验错误 20006：证书过期 20008：证书参数错误 20009：其他系统错误 |
| public int Pause() | 暂停播放 |
| public int Resume() | 恢复播放 |
| public int IsPlaying() | 是否在播放状态中 |
| public int GetDuration() | 返回媒体时长，单位毫秒 |
| public int GetCurrentPosition() | 返回当面播放位置，单位毫秒 |
| public int SeekTo(int time) | seek到指定位置，单位毫秒 |
| public int Stop() | 停止播放，释放资源，重新播放需创建新的实例 |
| public byte[] GetSEI() | 获取码流中的SEI信息 |
| public int GetErrorCode() | 获取错误码 |
| public int GetInfo() | 获取事件码 |
| public int GetStatus() | 获取播放器状态码 |
| public int SetVolume(float volume) | 设置音量，范围[0, 1] |
| public int SetSpeed(float speed) | 设置播放速度，建议范围[0.25, 2] |
| public int IsLooping() | 是否在循环播放状态中 |
| public int SetLooping(int looping) | 设置循环播放 |
| public void EnableWanos(bool enable) | 开启/关闭全景声空间音效 |
| public int SetYawAndPitch(float yaw, float pitch) | 设置空间音效的yaw和pitch参数，其他参数自动为0 |
| public int Set6DofData(float x, float y, float z, float yaw, float pitch, float roll) | 设置空间音效6DoF参数 |
| public int GetVideoWidth() | 获取视频宽度 |
| public int GetVideoHeight() | 获取视频高度 |
| public IntPtr GetYTex(IntPtr width, IntPtr height) | 获取解码后的Y纹理指针和宽高 iOS平台特有 |
| public IntPtr GetUVTex(IntPtr width, IntPtr height) | 获取解码后的UV纹理指针和宽高 iOS平台特有 |
| public int CreateSurface() | 创建用于显示视频画面的Surface Android平台特有 |
| public int GetOesTex() | 获取OES纹理ID Android平台特有 |
| public int DestroySurface() | 销毁Surface Android平台特有 |
常见错误码含义
| 错误码 | 含义 |
|---|---|
| -1 | 操作无权限 |
| -2 | 本地没有此文件 |
| -5 | I/O错误 |
| Android：-110 iOS：-60 |
网络连接超时 常见原因： - 客户端弱网下产生连接超时 - 服务端返还数据慢导致超时 - http劫持 |
| Android：-111 iOS：-61 |
连接被拒绝，服务端行为，例如鉴权 |
| Android：-101 iOS：-51 |
网络不可达，典型原因：断网或者网络切换后，使用原IP继续链接 |
| -541478725 | EOF |
| -808465656 | HTTP_BAD_REQUEST |
| -858797304 | 网络请求失败（http 403） |
| -875574520 | 网络请求失败（http 404） |
| -1482175992 | 网络请求失败（http code > 500） |
| -1094995529 | 解码信息异常 |
| -1414092869 | 视频帧读取超时 |
常见事件码含义
| 事件码 | 含义 |
|---|---|
| 200 | 播放器准备就绪 |
| 300 | 播放完成 |
| 301 | 播放停止 |
| 400 | 视频分辨率变化 |
| 402 | 视频渲染开始 |
| 403 | 音频渲染开始 |
| 500 | 缓冲开始 |
| 501 | 缓冲结束 |
| 502 | 缓冲进度回调 |
| 600 | seek完成 |
| 700 | 播放状态更新回调 |
状态码含义
| 状态码 | 含义 |
|---|---|
| 0 | 初始状态 |
| 1 | 已初始化 |
| 2 | 准备中 |
| 3 | 准备就绪 |
| 4 | 播放已开始 |
| 5 | 播放已暂停 |
| 6 | 播放已完成 |
| 7 | 播放已停止 |
| 8 | 播放错误 |
| 9 | 播放器已释放 |