Skip to content

XR 视频播放器

XR 头戴设备相较于传统的显示器拥有更为多样化的视频展示方式,结合设备自身的多轴向定位特性和双屏渲染画面,可以满足用户在 3D 场景中浏览全景视频或动态材质的需要。Cocos CreatorXR v1.1.0提供了通用化的 XR 视频播放器,针对 XR 设备优化了视频渲染管线并支持切换展示窗口、180 度、360 度多风格的视频。同时,播放器还提供了交互功能辅助您进行播放控制,您只需要添加或替换视频资源即可完成简易的视频播放功能的内容开发,简化创作步骤,降低开发门槛。

创建视频播放器,请在层级管理器右键 创建 -> XR -> XR Video Player

xr_video_player_node

其节点中包含的核心组件如下:

XR Video Player

cc.XRVideoPlayer

用于调整视频的各项属性

属性说明
Source Type视频来源:REMOTE 表示远程视频 URL,LOCAL 表示本地视频地址
Remote URLSource Type 为 REMOTE 时出现此项,远程视频的 URL
ClipSource Type 为 LOCAL 时出现此项,本地视频剪辑
Play On Awake视频加载后是否自动开始播放
Playback Rate视频播放时的速率,范围:[0.0,2.5]
Volume视频的音量 [0.0,1.0]
Mute是否静音。静音时音量设置为0,取消静音时恢复原来的音量。
Loop视频是否应在结束时再次播放
Keep Aspect Ratio是否保持视频自身的宽高比(使用竖屏视频查看效果)
Shape视频样式。
Content关联带有 MeshRenderer 组件的 VideoContent 作为视频材质渲染对象。
Video Player Event视频播放回调函数,该回调函数会在特定情况被触发,比如播放中、暂停、停止和播放完毕。

XR Video Controller

cc.XRVideoController

用于关联UI和视频功能。

属性说明
Player关联指定的 VideoPlayer,用于控制其播放功能。
HMD Control绑定头戴显示器的控制器对象节点。
Left Hand Controller绑定左手柄的控制器对象节点。
Right Hand Controller绑定右手柄的控制器对象节点。
Play Pause播放/暂停 UI。
Progress Bar进度条 UI。
Fast Forward快进按钮 UI。
Rewind快退按钮 UI。
Video Shape UI视频样式 UI。
Player Back Rate Bar倍速 UI。
Volume UI音量调节 UI。

Video Caption

cc.XRVideoCaption

用于解析字幕文件,目前只支持解析 .srt 类型的字幕文件。

属性说明
Caption Source Type字幕来源:REMOTE 表示 URL 里的文件并解析字幕,LOCAL 表示本地字幕文件。
Remote URLSource Type 为 REMOTE 时出现此项,字幕文件的 URL
Caption FileSource Type 为 LOCAL 时出现此项,本地字幕文件
Video Player关联指定的 VideoPlayer,将字幕按时间同步于此视频。

注:Vulkan 目前不支持视频播放器。