19 class SHIT_API SHIT_REFLECT(BlackList) AudioSource : public Behavior {

20 SHIT_REFLECT_BODY(AudioSource)

21 public:

22 AudioSource() = default;

23

24 // --- 属性 ---

25 void setAudioPath(const std::string& path);

26 const std::string& getAudioPath() const { return m_audioPath; }

27

28 void setLoop(bool loop);

29 bool isLoop() const { return m_loop; }

30

31 void setVolume(float volume);

32 float getVolume() const { return m_volume; }

33

34 void setPlayOnStart(bool playOnStart);

35 bool isPlayOnStart() const { return m_playOnStart; }

36

37 // --- 播放控制 ---

38 void play();

39 void stop();

40 void pause();

41

42 // Behavior 生命周期：首次驱动时按 PlayOnStart 自动播放

43 void onStart() override;

44

45 private:

46 SHIT_META(({.displayName = "Audio Path", .tooltip = "音频资源路径（相对资源目录，如 resource/bgm.mp3）"}))

47 std::string m_audioPath;

48 SHIT_META(({.displayName = "Loop", .tooltip = "循环播放"}))

49 bool m_loop = false;

50 SHIT_META(({.displayName = "Volume", .tooltip = "音量 0~1", .range = {0, 1}, .step = 0.05}))

51 float m_volume = 1.0f;

52 SHIT_META(({.displayName = "Play On Start", .tooltip = "onStart 时自动播放（全局暂停/编辑态不播）"}))

53 bool m_playOnStart = true;

54

55 // 当前播放轨道句柄（仅运行时，不入反射/序列化）

56 SHIT_META(Disable)

57 std::shared_ptr<AudioTrack> m_track;

58 };