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 URL Source Type 为 REMOTE 时出现此项,远程视频的 URL
Clip Source 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 URL Source Type 为 REMOTE 时出现此项,字幕文件的 URL
Caption File Source Type 为 LOCAL 时出现此项,本地字幕文件
Video Player 关联指定的 VideoPlayer,将字幕按时间同步于此视频。

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

条与 "" 相匹配的结果

    没有与 "" 匹配的结果