[publish] [important] add sound to capture_response for audio-sst

Author: zh1peng

docs/tutorials/build_stimunit.md

@@ -280,7 +280,7 @@ StimUnit('goodbye',win,kb)\
 
 ### 6. Get responses with `capture_response()`
 
-The `capture_response()` method in `StimUnit` integrates stimulus presentation, timing, triggers, and response handling into a single, chainable call. It is ideal for:
+The `capture_response()` method in `StimUnit` integrates stimulus presentation, timing, triggers, and response handling into a single, chainable call. Like `.show()`, it automatically handles both visual and audio stimuli. It is ideal for:
 
 - Detecting and logging subject responses within a predefined response window
 - Determining correct versus incorrect responses for performance analysis

docs/tutorials/build_stimunit_cn.md

@@ -270,7 +270,7 @@ StimUnit('goodbye',win,kb)\
 
 ### 6. 使用 `capture_response()` 获取反应
 
-`capture_response()` 方法在 `StimUnit` 中将刺激呈现、计时、触发器和反应处理集成到一个单一的、可链式调用的函数中。它非常适合：
+`capture_response()` 方法在 `StimUnit` 中将刺激呈现、计时、触发器和反应处理集成到一个单一的、可链式调用的函数中。与 `.show()` 类似，它会自动处理视觉和听觉刺激。它非常适合：
 
 - 在预定义的反应窗口内检测和记录被试的反应
 - 为性能分析确定正确与不正确的反应

psyflow/StimUnit.py

@@ -498,9 +498,13 @@ def capture_response(
             raise TypeError(f"Invalid duration type: {type(duration)}")
         self.set_state(duration=t_val)
 
-        # initial draw + trigger scheduling
+        # --- Initial Flip (trigger locked to onset) ---
         for stim in self.stimuli:
-            stim.draw()
+            if hasattr(stim, "play") and callable(stim.play):
+                self.win.callOnFlip(stim.play)
+            else:
+                stim.draw()
+
         self.win.callOnFlip(self.send_trigger, onset_trigger)
         self.win.callOnFlip(self.set_state,
                         onset_time=self.clock.getTime(), 
@@ -519,12 +523,12 @@ def capture_response(
         responded = False
         chosen_key = None  # track which key to highlight
 
-
+        visual_stims = [s for s in self.stimuli if hasattr(s, "draw") and callable(s.draw)]
         n_frames = int(round(t_val / self.frame_time))
         for _ in range(n_frames-1):
             # draw or blank?
             if not (responded and terminate_on_response):
-                for stim in self.stimuli:
+                for stim in visual_stims:
                     stim.draw()
             # draw highlight if requested
             if highlight_stim and (responded or dynamic_highlight):

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "psyflow"
-version = "0.1.1"
+version = "0.1.2"
 description = "A utility package for building modular PsychoPy experiments."
 authors = [
     { name="Zhipeng Cao", email="[email protected]" }