Slight tweaks to the mic driver

Author: JesseTG

CHANGELOG.md

@@ -12,6 +12,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added `MicrophoneDriver.microphones` to list all allocated `Microphone`s.
+- Added `Session.mic`.
+
 ### Changed
 
 - **BREAKING:** Rename `GeneratorCameraDriver` to `IterableCameraDriver`.

src/libretro/builder.py

@@ -48,6 +48,7 @@
     LoggerMessageInterface,
     MessageInterface,
     MicrophoneDriver,
+    MicrophoneSource,
     MidiDriver,
     MultiVideoDriver,
     OptionDriver,
@@ -129,7 +130,7 @@ class _DefaultType(Enum):
 HardwareContextArg: TypeAlias = _OptionalArg[HardwareContext]
 ThrottleStateArg: TypeAlias = _OptionalArg[retro_throttle_state]
 SavestateContextArg: TypeAlias = _OptionalArg[SavestateContext]
-MicDriverArg: TypeAlias = _OptionalArg[MicrophoneDriver]
+MicDriverArg: TypeAlias = _OptionalArg[MicrophoneDriver] | MicrophoneSource
 PowerDriverArg: TypeAlias = _OptionalArg[PowerDriver] | retro_device_power
 
 

src/libretro/drivers/microphone/driver.py

@@ -1,6 +1,6 @@
 from abc import abstractmethod
 from collections import deque
-from collections.abc import Sequence
+from collections.abc import Collection, Sequence
 from ctypes import POINTER, byref, c_int16, c_void_p, cast, memmove, sizeof
 from typing import NamedTuple, Protocol, runtime_checkable
 
@@ -71,6 +71,13 @@ def __init__(self):
     @abstractmethod
     def version(self) -> int: ...
 
+    @property
+    def microphones(self) -> Collection[Microphone]:
+        """
+        Returns a collection of all open microphones.
+        """
+        return tuple(h.handle for h in self.__microphones.values())
+
     @abstractmethod
     def open_mic(self, params: retro_microphone_params | None) -> Microphone: ...
 

src/libretro/session.py

@@ -38,6 +38,7 @@
     LoadedContentFile,
     LogDriver,
     MessageInterface,
+    MicrophoneDriver,
     MidiDriver,
     OptionDriver,
     RumbleDriver,
@@ -304,6 +305,10 @@ def content_info_overrides(
     ) -> Sequence[retro_system_content_info_override] | None:
         return self._environment.content.overrides
 
+    @property
+    def mic(self) -> MicrophoneDriver:
+        return self._environment.microphones
+
     def run(self) -> None:
         if self._is_exited or self._environment.is_shutdown:
             raise CoreShutDownException()