音频流播放器3D¶

类别： 核心

简要说明¶

在三维空间中播放三维声音。

属性¶

int	area_mask	1
float	attenuation_filter_cutoff_hz	5000.0
float	attenuation_filter_db	-24.0
AttenuationModel	attenuation_model	0
bool	autoplay	假
String	bus	“主控形状”
DopplerTracking	doppler_tracking	0
float	emission_angle_degrees	45.0
bool	emission_angle_enabled	假
float	emission_angle_filter_attenuation_db	-12.0
float	max_db	3.0
float	max_distance	0.0
OutOfRangeMode	out_of_range_mode	0
float	pitch_scale	1.0
bool	playing	假
AudioStream	stream
bool	stream_paused	假
float	unit_db	0.0
float	unit_size	1.0

方法¶

float	get_playback_position ( )
AudioStreamPlayback	get_stream_playback ( )
无效	play ( float from_position=0.0 )
无效	seek ( float to_position )
无效	stop ( )

信号¶

finished ( )

当音频停止播放时发出。

枚举¶

枚举 AttenuationModel ：

ATTENUATION_INVERSE_DISTANCE = 0 ——按距离线性减弱响度。
ATTENUATION_INVERSE_SQUARE_DISTANCE = 1 ——按距离平方衰减响度。
ATTENUATION_LOGARITHMIC = 2 ——响度按距离的对数衰减。
ATTENUATION_DISABLED = 3 ——不按距离减弱响度。

枚举 OutOfRangeMode ：

OUT_OF_RANGE_MIX = 0 ---即使音频超出范围，也要将其混入。
OUT_OF_RANGE_PAUSE = 1 ---超出范围时暂停此音频。

枚举 DopplerTracking ：

DOPPLER_TRACKING_DISABLED = 0 ---禁用多普勒跟踪。
DOPPLER_TRACKING_IDLE_STEP = 1 ---在空闲步骤中执行多普勒跟踪。
DOPPLER_TRACKING_PHYSICS_STEP = 2 ---在物理步骤中执行多普勒跟踪。

描述¶

使用定向声音效果播放声音效果，必要时使用距离衰减，产生空间中可听到位置的效果。

教程¶

音频流

属性描述¶

int area_mask

违约	1
设定器	设置区域掩码（值）
吸气剂	获取区域掩码（）。

播放此声音的区域。

float attenuation_filter_cutoff_hz

违约	5000.0
设定器	设置衰减滤波器截止频率（值）
吸气剂	得到衰减滤波器截止频率

将音频抑制在该频率以上，单位为赫兹。

float attenuation_filter_db

违约	-24.0
设定器	设置衰减滤波器分贝（值）
吸气剂	获取衰减滤波器

滤波器对响度的影响量，单位为分贝。

AttenuationModel attenuation_model

违约	0
设定器	设置衰减模型（值）
吸气剂	获取衰减模型（）

决定音频是否应随着距离线性、四次、对数或不受距离影响而变得更安静，从而有效地禁用衰减。

bool autoplay

违约	假
设定器	设置自动播放（值）
吸气剂	是否启用了自动播放（

如果 true ，添加到场景树时播放音频。

String bus

违约	“主控形状”
设定器	设置总线（值）
吸气剂	获取总线（）

正在播放此音频的总线。

DopplerTracking doppler_tracking

违约	0
设定器	设置多普勒跟踪（值）
吸气剂	获取多普勒跟踪

决定多普勒效应的计算步骤。

float emission_angle_degrees

违约	45.0
设定器	设置发射角度（值）
吸气剂	得到发射角

音频到达相机时的无阻尼角度。

bool emission_angle_enabled

违约	假
设定器	设置发射角度（值）
吸气剂	是否启用了“发射角度”（）

如果 true ，应根据声音的方向抑制音频。

float emission_angle_filter_attenuation_db

违约	-12.0
设定器	设置发射角滤波器衰减分贝（值）
吸气剂	得到发射角滤波器衰减分贝

如果摄像头不在 emission_angle_degrees 和 emission_angle_enabled 由该系数设置，单位为dB。

float max_db

违约	3.0
设定器	设置最大分贝（值）
吸气剂	获取_max_db（）。

设置声级的绝对最大值，单位为dB。

float max_distance

违约	0.0
设定器	设置最大距离（值）
吸气剂	获取最大距离（）

设置与 out_of_range_mode 生效。如果设置为0，则无效。

OutOfRangeMode out_of_range_mode

违约	0
设定器	设置范围模式（值）
吸气剂	将_移出_range_模式（）。

决定当源在外部时音频是否应暂停 max_distance 范围。

float pitch_scale

违约	1.0
设定器	设置螺距刻度（值）
吸气剂	获取音高音阶

改变音高和音速。

bool playing

违约	假
吸气剂	正在玩（

如果 true ，正在播放音频。

AudioStream stream

设定器	设置流（值）
吸气剂	获取流（）

这个 AudioStream 要播放的对象。

bool stream_paused

违约	假
设定器	设置流暂停（值）
吸气剂	获取流暂停（））

float unit_db

违约	0.0
设定器	设置单位分贝（值）
吸气剂	获取u单位u db（）

不受阻尼影响的基本声级，单位为分贝。

float unit_size

违约	1.0
设定器	设置单位大小（值）
吸气剂	获取单元大小（）。

衰减效应系数。

方法说明¶

float get_playback_position ( )

返回中的位置 AudioStream .

AudioStreamPlayback get_stream_playback ( )

void play ( float from_position=0.0 )

播放给定位置的音频 from_position ，秒。

void seek ( float to_position )

设置播放音频的位置（秒）。

void stop ( )

停止音频。