audios

class janim.timeline.audios.PlayAudioInfo(audio: Audio, clip_range: TimeRange, range: TimeRange)

基类:object

在 Timeline 中播放的音频,所对应的参数信息

参数:
  • audio -- 音频对象

  • clip_range -- 将音频对象中的哪一段裁剪出来

  • range -- 将裁剪出来的音频放在 Timeline 的什么时候播放

另见 play_audio()

audio: Audio
clip_range: TimeRange
range: TimeRange
class janim.timeline.audios.AudiosMixin(*args, **kwargs)

基类:TimelineCore

向 Timeline 提供播放音频的功能

提示

该类中的方法都可以直接在 Timeline 中使用

play_audio(audio: Audio, *, delay: float = 0, begin: float = 0, end: float = -1, clip: tuple[float, float] | None = None) → TimeRange

在当前位置播放音频

参数:
  • delay -- 往后延迟几秒开始播放

  • begin -- 裁剪 audio 的开始秒数

  • end -- 裁剪 audio 的结束秒数

  • clip -- 对 (begin, end) 的简写,若设置该值,则会覆盖 start 与 end

返回:

播放的时间范围

示例:

# 裁剪出 'test.mp3' 中 1.2~6.5s 的部分,从当前时刻开始播放
self.play_audio(Audio('test.mp3'), begin=1.2, end=6.5)

# 等价于
self.play_audio(Audio('test.mp3'), clip=(1.2, 6.5))
has_audio() → bool

该 Timeline 自身是否有可以播放的音频

has_audio_for_all() → bool

考虑所有子 Timeline,是否有可以播放的音频

备注

不包括 to_playback_control_item() 构造的子 Timeline