AudioRecorder and Issue Request

content/en-us/reference/engine/classes/AudioRecorder.yaml

@@ -1,8 +1,18 @@
 name: AudioRecorder
 type: class
 memory_category: Internal
-summary: ''
-description: ''
+summary: |
+  Record audio streams in-experience.
+description: |
+  The **AudioRecorder** can be used to record audio streams in-experience.
+  The results can be loaded back into an `Class.AudioPlayer|AudioPlayer` for playback.
+
+  There's a fixed time limit on how long a recording can be, which is **`60` seconds**.
+
+
+  At the moment `Class.AudioDeviceInput|AudioDeviceInput` can not be recorded.
+  The method `Class.AudioRecorder.GetUnrecordableInstancesAsync()|GetUnrecordableInstancesAsync()` can be used
+  to check specifically which instances aren't recordable.
 code_samples: []
 inherits:
   - Instance
@@ -12,7 +22,8 @@ deprecation_message: ''
 properties:
   - name: AudioRecorder.IsRecording
     summary: ''
-    description: ''
+    description: |
+      Returns whether the `Class.AudioRecorder|AudioRecorder` is currently recording.
     code_samples: []
     type: boolean
     tags: []
@@ -30,7 +41,8 @@ properties:
     writeCapabilities: []
   - name: AudioRecorder.TimeLength
     summary: ''
-    description: ''
+    description: |
+      Returns the current length of the recording in seconds.
     code_samples: []
     type: double
     tags:
@@ -51,7 +63,8 @@ properties:
 methods:
   - name: AudioRecorder:Clear
     summary: ''
-    description: ''
+    description: |
+      Clears out the recording from the `Class.AudioRecorder|AudioRecorder`.
     code_samples: []
     parameters: []
     returns:
@@ -115,7 +128,9 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:GetTemporaryContent
     summary: ''
-    description: ''
+    description: |
+      Returns recorded content that can be played back with `Class.AudioPlayer|AudioPlayer`.
+      The content retrieved from this method is only valid in the current session.
     code_samples: []
     parameters: []
     returns:
@@ -130,7 +145,8 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:Stop
     summary: ''
-    description: ''
+    description: |
+      Stops recording.
     code_samples: []
     parameters: []
     returns:
@@ -145,7 +161,9 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:CanRecordAsync
     summary: ''
-    description: ''
+    description: |
+      Returns whether the `Class.AudioRecorder|AudioRecorder` can currently record. For instance, this will return `false`
+      if the current recording data has reached the recording time limit. To clear the recording use `Class.AudioRecorder:Clear()|:Clear()`
     code_samples: []
     parameters: []
     returns:
@@ -161,7 +179,9 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:GetUnrecordableInstancesAsync
     summary: ''
-    description: ''
+    description: |
+      Traverses the audio graph, starting from this recorder's inputs, to find unrecordable instances.
+      Currently, `Class.AudioDeviceInput` is not recordable.
     code_samples: []
     parameters: []
     returns:
@@ -177,7 +197,8 @@ methods:
     writeCapabilities: []
   - name: AudioRecorder:RecordAsync
     summary: ''
-    description: ''
+    description: |
+      If `Class.AudioRecorder:CanRecordAsync` returns true, begins recording. If recording cannot begin, this method produces an error.
     code_samples: []
     parameters: []
     returns: