RF: Allow mic device to be set by index, give mic a settable status p…

…roperty and allow blank audioclips to be appended (#3679)

Co-authored-by: Todd <TEParsons>

psychopy/sound/audioclip.py

@@ -429,6 +429,12 @@ def append(self, clip):
             snd1.append(snd2)
 
         """
+        # if either clip is empty, just replace it
+        if len(self.samples) == 0:
+            return clip
+        if len(clip.samples) == 0:
+            return self
+
         assert self.channels == clip.channels
         assert self._sampleRateHz == clip.sampleRateHz
 

psychopy/sound/microphone.py

@@ -86,12 +86,18 @@ def __init__(self,
                 "be installed.")
 
         # get information about the selected device
+        devices = Microphone.getDevices()
         if isinstance(device, AudioDeviceInfo):
             self._device = device
+        elif isinstance(device, (int, float)):
+            devicesByIndex = {d.deviceIndex: d for d in devices}
+            if device in devicesByIndex:
+                self._device = devicesByIndex[device]
+            else:
+                raise AudioInvalidCaptureDeviceError(
+                    'No suitable audio recording devices found matching index {}.'.format(device))
         else:
             # get default device, first enumerated usually
-            devices = Microphone.getDevices()
-
             if not devices:
                 raise AudioInvalidCaptureDeviceError(
                     'No suitable audio recording devices found on this system. '
@@ -206,6 +212,14 @@ def bufferSecs(self):
 
     @property
     def status(self):
+        if hasattr(self, "_statusFlag"):
+            return self._statusFlag
+    @status.setter
+    def status(self, value):
+        self._statusFlag = value
+
+    @property
+    def streamStatus(self):
         """Status of the audio stream (`AudioDeviceStatus` or `None`).
 
         See :class:`~psychopy.sound.AudioDeviceStatus` for a complete overview