VideoStreamPlayer

继承： Control < CanvasItem < Node < Object

用于播放视频的控件。

描述

用于播放 VideoStream 资源的控件。

支持的视频格式有 Ogg Theora（.ogv，VideoStreamTheora）以及任何通过 GDExtension 插件公开的格式。

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

教程

• 播放视频

属性

方法

信号

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"

• void set_bus ( StringName value )

• StringName get_bus ( )

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

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

• void set_stream ( VideoStream value )

• VideoStream get_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.