內容目录

上一个主题

VideoPlayer Inspector

下一个主题

发行说明

VideoPlayerBaseBehaviour Class

Description

VideoPlayerBaseBehaviour是在AR场景中控制VideoPlayer的component。

VideoPlayerBaseBehaviour可以被添加到任何物体上,视频会在其上播放。

如果要使用自动缩放功能,它应该作为 ImageTargetBaseBehaviour 的子物体存在在场景中。

如果要播放透明视频,你需要设置物体的材质能够显示alpha通道。EasyAR提供了一个简单的样例材质 TransparentVideo.mat 。

Public Types

enum ScaleMode{None, Fill, Fit, FitWidth, FitHeight}
enum ScalePlane{XY, XZ, YX, YZ, ZX, ZY}
enum VideoType{Normal, TransparentSideBySide, TransparentTopAndBottom}

Public Fields

bool EnableAutoPlay
bool EnableLoop
bool OpenWhenStart
bool DisplayTextMessage
string Path
StorageType Storage
VideoType Type
float VideoScaleFactorBase
ScaleMode VideoScaleMode
ScalePlane VideoScalePlane

Public Properties

float Volume

Public Functions

void Open()
void Close()
bool Play()
bool Pause()
bool Stop()
bool Seek(int position)
int CurPosition()
int Duration()
int Width()
int Height()

Public Events

event EventHandler VideoErrorEvent
event EventHandler VideoReachEndEvent
event EventHandler VideoReadyEvent

Overwritten MonoBahaviour Functions

protected virtual void Awake()
protected virtual void OnDestroy()
protected virtual void OnDisable()
protected virtual void OnEnable()
protected virtual void Start()
protected virtual void Update()

enum ScaleMode

Constant Value Description
None 0 不缩放
Fill 1 填充ImageTarget,视频会被缩放到与Imagetarget同样大小。
Fit 2 适配ImageTarget,视频会被缩放到最大可适配到Imagetarget里面的大小。
FitWidth 3 适配ImageTarget的宽度,视频宽度会被设成和Imagetarget的宽度相同,而视频比例不变。
FitHeight 4 适配ImageTarget的高度,视频高度会被设成和Imagetarget的高度相同,而视频比例不变。

enum ScalePlane

Constant Value Description
XY 1 在XY平面缩放。
XZ 2 在XZ平面缩放。
YX 4 在YX平面缩放。
YZ 6 在YZ平面缩放。
ZX 8 在ZX平面缩放。
ZY 9 在ZY平面缩放。

enum VideoType

Constant Value Description
Normal 0 普通视频
TransparentSideBySide 1 透明视频,左半边是RGB通道,右半边是alpha通道。
TransparentTopAndBottom 2 透明视频,上半边是RGB通道,下半边是alpha通道。

bool EnableAutoPlay

启用自动播放。如果启用,当视频成功打开之后会自动开始播放。

bool EnableLoop

启用循环播放。如果启用,当视频播放到结束的时候,会自动从头再次播放。

bool OpenWhenStart

在 MonoBehaviour.Start 被调用的时候打开视频。

bool DisplayTextMessage

在不支持的平台上显示不支持的信息。

string Path

视频路径。set操作需要在Open之前调用。详见 StorageType

可以是本地视频文件(path/to/video.mp4)或url(http://www.../.../video.mp4)。

StorageType Storage

视频存储路径的类型。set操作需要在Open之前调用。详见 StorageType

VideoType Type

视频类型。set操作需要在Open之前调用。

float VideoScaleFactorBase

视频基础缩放系数。在视频缩放过程中缩放后的视频大小会乘以这个系数。通常你可以对plane设为0.1,其它简单物体设为1。

ScaleMode VideoScaleMode

缩放模式。

ScalePlane VideoScalePlane

缩放平面。物体在这个平面上的大小将被根据缩放模式和ImageTarget的大小自动调整。

float Volume

视频音量。在成功的Open之后使用。

void Open()

打开视频。

这个方法是异步的方法。如果需要手动控制视频播放,需要在调用 Open 后在 VideoReadyEvent 事件处理函数中调用 Play

void Close()

关闭视频。

如果需要手动控制视频播放,需要在调用 Open 后在 VideoReadyEvent 事件处理函数中调用 Play

bool Play()

开始或继续播放视频。

bool Pause()

暂停视频播放。

bool Stop()

停止视频播放。

bool Seek(int position)

将播放位置调整到 position 。在成功的Open之后使用(在 VideoReadyEvent 被触发之后)。

int CurPosition()

返回当前播放到的视频位置。在成功的Open之后使用(在 VideoReadyEvent 被触发之后)。

int Duration()

返回视频长度。在成功的Open之后使用(在 VideoReadyEvent 被触发之后)。

int Width()

返回视频宽度。在成功的Open之后使用(在 VideoReadyEvent 被触发之后)。

int Height()

返回视频高度。在成功的Open之后使用(在 VideoReadyEvent 被触发之后)。

event EventHandler VideoErrorEvent

视频打开或播放错误的事件。

event EventHandler VideoReachEndEvent

视频播放结束的事件。

event EventHandler VideoReadyEvent

视频成功打开的事件。在收到这个事件的时候你就可以开始播放视频了。