tencent cloud

云点播

动态与公告
产品动态
公告
产品简介
产品概述
产品特性
产品功能
产品优势
应用场景
解决方案
专业版
云点播专业版简介
快速入门
控制台指南
开发指南
购买指南
计费概述
计费方式
购买指引
账单查询
续费说明
欠费说明
退费说明
快速入门
控制台指南
控制台介绍
服务概览
应用管理
媒体管理
资源包管理
License 管理
实时日志分析
实践教程
媒体上传
如何将点播的媒体文件进行智能降冷
媒体处理
分发播放
如何接收事件通知
如何进行源站迁移
直播录制
如何进行自定义源站回源
直播精彩剪辑固化至云点播 VOD 指引
如何使用 EdgeOne 分发云点播内容
开发指南
媒体上传
媒体加工处理
媒体 AI
事件通知
媒体分发播放
媒体加密与版权保护
播放频道
访问管理
下载媒体文件
应用体系
错误码
播放器 SDK 文档
概述
基本概念
产品功能
Demo 体验
免费测试
购买指南
SDK 下载
License 指引
播放器教程
含 UI 集成方案
无 UI 集成方案
高级功能
API 文档
第三方播放器插件
Player SDK Policy
服务端 API 文档
History
Introduction
API Category
Other APIs
Media Processing APIs
Task Management APIs
Media Upload APIs
Media Management APIs
Event Notification Relevant API
Media Categorization APIs
Domain Name Management APIs
Distribution APIs
AI-based Sample Management APIs
Region Management APIs
Data Statistics APIs
Carousel-Related APIs
Just In Time Transcode APIs
No longer recommended APIs
Making API Requests
AI-based image processing APIs
Parameter Template APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表

VR 播放插件(TCPlayerVRPlugin)

PDF
聚焦模式
字号
最后更新时间: 2024-04-11 16:18:08
TCPlayerVRPlugin 插件可用于 VR 全景视频播放,播放中可以通过陀螺仪转动或手势操作来改变视角,提供多种属性和方法来控制播放表现,支持 PC 端和移动端。

使用条件

目前 Web 播放器 SDK 5.0.0 以上版本支持使用 VR 播放插件。
VR 播放需获取 Web 端播放器高级版 License 方可使用。

接入方式

播放器初始化过程参见 TCPlayer 集成指引API 文档
初始化播放器实例时,可通过声明 plugins 插件的方法开启 VR 播放能力,开启后播放器会自动加载并使用本插件:
const player = TCPlayer('player-container-id', { // player-container-id 为播放器容器ID,必须与html中一致
plugins: {
VR: {
isEnableController: true,
...
},
}
});

VR 插件属性说明

名称
说明
默认值
isEnableController
是否打开 VR 控制器
true
isEnableZoom
是否允许画面缩放
true
yaw
初始化左右视角角度,单位为度
0
pitch
初始化上下视角角度,单位为度
0
fov
初始化可视视角,单位为度
65
yawRange
限制视角活动的范围
[-180, 180]
pitchRange
限制视角活动的范围
[-90, 90]
fovRange
限制视角活动的范围
[30, 110]

VR 插件方法说明

VR 插件初始化后,会生成实例,实例化之后会进入 VR 模式播放视频,可以在播放器实例上找到 VR 实例,通过 VR 实例可以调用相关方法:

- lookAt

在一段时间通过动画形式移动到特定角度的视角。
player.plugins['VR'].lookAt({ yaw: 30 }, 1000);

- setGyroMode

如果您的设备拥有运动传感器(陀螺仪、加速传感器),您可以通过设备的运动来改变视角,这个方法可取值为 'VR' | 'none' | 'yawPitch'
player.plugins['VR'].setGyroMode('none');


- enableSensor

获取使用运动传感器的权限。一般在 Android 设备,默认会开启运动传感器,在 iOS 13+,则需要触发人机交互手动获取权限。
player.plugins['VR'].enableSensor();
说明:
1. 在浏览器劫持播放的环境,无法支持 VR 视频的播放。
2. Android 端播放器初始化后会默认进入 VR 模式,并开启陀螺仪。
3. iOS 端根据系统版本不同,表现会有差异:
3.1 系统版本13+,需要手动点击页面,触发人机交互并获取权限后,才能打开陀螺仪。
3.2 系统版本12.2 - 13,需进入系统设置手动开启运动传感器。通常来说开启路径一般为设置 > Safari > 动作与方向访问,开启传感器后刷新页面,即可打开。

示例

单击 此处 可参考示例。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈