bpy.context.speaker

bpy.context.speaker 是 blender 中的一个上下文属性，用于表示当前选中的扬声器对象。

类型

bpy.types.Speaker

访问

bpy.context.speaker 可以读取或者写入扬声器对象，例如：

# 读取当前选中的扬声器对象
speaker = bpy.context.speaker

# 创建一个新的扬声器对象并且设置为当前选中的对象
new_speaker = bpy.data.speakers.new(name="New Speaker")
bpy.context.scene.objects.active = new_speaker
bpy.context.speaker = new_speaker

属性

bpy.types.Speaker 类型具有以下属性：

• angle_attenuation : 扬声器指向目标的衰减角度 (float)
• attenuation : 声音衰减的强度 (float)
• cone_angle_outer : 扬声器外圈的角度 (float)
• distance_max : 扬声器最大的距离 (float)
• distance_reference : 扬声器的参考距离 (float)
• energy : 声音的能量 (float)
• is_valid : 声音是否合法 (bool)
• mute : 是否静音 (bool)
• name : 扬声器名称 (string)
• sound : 当前扬声器播放的声音 (Sound)

示例

以下示例代码将更改当前场景中选定的扬声器的各个属性：

import bpy

# 获取当前选中的扬声器
speaker = bpy.context.speaker

# 更改扬声器的属性
speaker.angle_attenuation = 5.0
speaker.attenuation = 1.5
speaker.cone_angle_outer = 60.0
speaker.distance_max = 200.0
speaker.distance_reference = 100.0
speaker.energy = 10.0
speaker.mute = False

异常

如果未选中任何扬声器或者当前选择的对象不是扬声器对象，则会引发 AttributeError 异常。

相关文档

• bpy.context
• bpy.data.speakers
• Sound Object