Add set_rate and get_rate to audio doc, tweaks

Author: microbit-grace

lang/en/typeshed/stdlib/microbit/audio.pyi

@@ -179,6 +179,24 @@ class AudioRecording:
         :param rate: The sampling rate at which data will be stored via the microphone, or played via the ``audio.play()`` function.
         """
 
+    def set_rate(self, sample_rate: int) -> None:
+        """Configure the sampling rate associated with the data in the
+        ``AudioRecording`` instance.
+
+        Example: ``my_recording.set_rate(22_000)``
+
+        :param sample_rate: The sample rate to set.
+        """
+
+    def get_rate(self) -> int:
+        """Get the sampling rate associated with the data in the
+        ``AudioRecording`` instance.
+
+        Example: ``current_rate = my_recording.get_rate()``
+
+         :return: The configured sample rate.
+        """
+
     def copy(self) -> None:
         """Create a copy of the ``AudioRecording``.
 
@@ -247,7 +265,6 @@ class AudioTrack:
         """Configure the sampling rate associated with the data in the
         ``AudioTrack`` instance.
 
-
         Changes to an ``AudioTrack`` rate won't affect the original source rate,
         so multiple instances pointing to the same buffer can have different
         rates and the original buffer rate would stay unmodified.

lang/en/typeshed/stdlib/microbit/microphone.pyi

@@ -156,6 +156,6 @@ def set_sensitivity(gain: float) -> None:
 
     The default sensitivity is ``microphone.SENSITIVITY_MEDIUM``.
 
-    :param gain: The microphone gain. Use ``microphone.SENSITIVITY_LOW``, ``microphone.SENSITIVITY_MEDIUM``, ``microphone.SENSITIVITY_HIGH``, or a value between these levels.
+    :param gain: The microphone gain. Use ``microphone.SENSITIVITY_LOW``, ``microphone.SENSITIVITY_MEDIUM``, ``microphone.SENSITIVITY_HIGH``, which all correspond to a number, or a value between these levels.
     """
     ...