VideoStreamPlayer

继承: Control < CanvasItem < Node < Object

用于播放视频的控件。

描述

用于播放 VideoStream 资源的控件。

支持的视频格式有 Ogg Theora.ogvVideoStreamTheora)以及任何通过 GDExtension 插件公开的格式。

警告:在 Web 上,视频播放由于缺少特定于体系结构的汇编优化而表现不佳。

教程

属性

int

audio_track

0

bool

autoplay

false

int

buffering_msec

500

StringName

bus

&”Master”

bool

expand

false

bool

loop

false

bool

paused

false

VideoStream

stream

float

stream_position

float

volume

float

volume_db

0.0

方法

float

get_stream_length ( ) const

String

get_stream_name ( ) const

Texture2D

get_video_texture ( ) const

bool

is_playing ( ) const

void

play ( )

void

stop ( )


信号

finished ( )

播放结束时触发。


属性说明

int audio_track = 0

  • void set_audio_track ( int value )

  • int get_audio_track ( )

要播放的嵌入式音轨。


bool autoplay = false

  • void set_autoplay ( bool value )

  • bool has_autoplay ( )

如果为 true,当场景加载时开始播放。


int buffering_msec = 500

  • void set_buffering_msec ( int value )

  • int get_buffering_msec ( )

播放时存储在缓冲区的时间,以毫秒计。


StringName bus = &"Master"

用于声音播放的音频总线。


bool expand = false

  • void set_expand ( bool value )

  • bool has_expand ( )

如果为 true,视频会缩放到控件的尺寸。否则,控件的最小尺寸将被自动调整以匹配视频流的尺寸。


bool loop = false

  • void set_loop ( bool value )

  • bool has_loop ( )

如果为 true,该视频将在到达末尾时重新开始。


bool paused = false

  • void set_paused ( bool value )

  • bool is_paused ( )

如果为 true,则暂停视频。


VideoStream stream

指定的视频流。支持的格式见描述。


float stream_position

  • void set_stream_position ( float value )

  • float get_stream_position ( )

流的当前位置,单位:秒。

注意:更改此值不会产生任何影响,因为除了由 GDExtension 插件实现的视频格式,搜索定位尚未被实现。


float volume

  • void set_volume ( float value )

  • float get_volume ( )

音频音量为线性值。


float volume_db = 0.0

  • void set_volume_db ( float value )

  • float get_volume_db ( )

音频音量,单位是 dB。


方法说明

float get_stream_length ( ) const

当前流的长度,单位:秒。

注意:对于 VideoStreamTheora 流(Godot 支持的内置格式),该值将始终为零,因为获取流长度尚未实现。GDExtension 插件实现的视频格式可能会支持该功能。


String get_stream_name ( ) const

返回视频流的名称,如果没有指定视频流,则返回 "<No Stream>"


Texture2D get_video_texture ( ) const

将当前帧作为 Texture2D 返回。


bool is_playing ( ) const

如果视频正在播放,返回 true

注意:如果在播放过程中暂停,视频仍被认为在播放。


void play ( )

从头开始播放视频。如果视频处于暂停状态,不会取消暂停。


void stop ( )

停止视频播放并将视频流位置设置为 0。

注意:虽然视频流位置将被设置为 0,但视频流的第一帧不会成为当前帧。

Previous Next


© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.