Logic fix and docs

Author: leandroBorgesFerreira

packages/stream_chat_flutter/lib/src/attachment/audio/audio_player_attachment.dart

@@ -129,7 +129,8 @@ class _AudioPlayerMessageState extends State<AudioPlayerMessage> {
           builder: (context, snapshot) {
             final state = snapshot.data ?? ProcessingState.idle;
             if (state == ProcessingState.ready ||
-                state == ProcessingState.idle) {
+                state == ProcessingState.idle ||
+                !playingThis) {
               return ElevatedButton(
                 style: ElevatedButton.styleFrom(
                   elevation: 2,

packages/stream_chat_flutter/lib/src/attachment/audio/audio_player_compose_message.dart

@@ -6,19 +6,23 @@ import 'package:just_audio/just_audio.dart';
 import 'package:stream_chat_flutter/src/attachment/audio/audio_player_attachment.dart';
 import 'package:stream_chat_flutter/stream_chat_flutter.dart';
 
-/// Docs
+/// {@template audioListPlayer}
+/// AudioPlayer intended to be used inside message composer. This audio player
+/// plays only one music at a time.
+/// {@endtemplate}
 class AudioPlayerComposeMessage extends StatefulWidget {
-  /// Docs
+  /// {@macro audioListPlayer}
   const AudioPlayerComposeMessage({
     super.key,
     required this.attachment,
     this.actionButton,
   });
 
-  /// Docs
+  /// Attachment of the audio
   final Attachment attachment;
 
-  /// Docs
+  /// An action button to that can be used to perform actions. Example: Delete
+  /// audio from compose.
   final Widget? actionButton;
 
   @override

packages/stream_chat_flutter/lib/src/attachment/audio/record_controller.dart

@@ -8,7 +8,8 @@ import 'package:stream_chat_flutter/src/attachment/audio/wave_bars_normalizer.da
 import 'package:stream_chat_flutter/stream_chat_flutter.dart';
 
 /// {@template recordController}
-/// Controller of audio record
+/// Controller of audio record. This call can be used to controll the recording
+/// logic programmatically.
 /// {@endtemplate}
 class StreamRecordController {
   /// {@macro WaveBarsNormalizer}
@@ -34,7 +35,7 @@ class StreamRecordController {
   /// A Stream that provides the amplitude variation of the record.
   Stream<Amplitude> get amplitudeStream => _amplitudeController.stream;
 
-  /// Docs
+  /// Initialization of the controller.
   void init() {
     _amplitudeSink = _amplitudeController.sink;
     _amplitudeSink?.addStream(

packages/stream_chat_flutter/lib/src/message_input/on_press_button.dart

@@ -86,7 +86,7 @@ class OnPressButton extends StatelessWidget {
   /// The action to perform when the button is pressed or clicked.
   final VoidCallback onPressed;
 
-  ///Docs
+  /// Padding of button.
   final EdgeInsetsGeometry? padding;
 
   /// Returns a copy of this object with the given fields updated.

packages/stream_chat_flutter/lib/src/message_input/record/record_button.dart

@@ -1,9 +1,13 @@
 import 'package:flutter/material.dart';
 import 'package:stream_chat_flutter/src/misc/stream_svg_icon.dart';
 
-///Docs
+/// {@template recordButton}
+/// Record button that start the recording process. This button doesn't have
+/// any logic related to recording, this should be provided in the callbacks.
+/// This button allows to set callback to onHold and onPressed.
+/// {@endtemplate}
 class RecordButton extends StatelessWidget {
-  ///Docs
+  /// {@macro recordButton}
   const RecordButton({
     super.key,
     required this.icon,
@@ -34,7 +38,7 @@ class RecordButton extends StatelessWidget {
   /// Icon of the button.
   final Widget icon;
 
-  ///Docs
+  /// Padding of button
   final EdgeInsetsGeometry? padding;
 
   /// Returns a copy of this object with the given fields updated.

packages/stream_chat_flutter/lib/src/message_input/record/record_field.dart

@@ -6,9 +6,12 @@ import 'package:stream_chat_flutter/src/message_input/on_press_button.dart';
 import 'package:stream_chat_flutter/src/message_input/record/record_timer_widget.dart';
 import 'package:stream_chat_flutter/stream_chat_flutter.dart';
 
-///Docs
+/// {@template recordField}
+/// Record field. The version of text input of StreamMessageInput, but for
+/// recording audio messages.
+/// {@endtemplate}
 class RecordField extends StatelessWidget {
-  ///Docs
+  /// {@macro recordField}
   const RecordField({
     super.key,
     required this.recordController,
@@ -21,7 +24,7 @@ class RecordField extends StatelessWidget {
     this.onAudioRecorded,
   });
 
-  ///Docs
+  /// Controller of record.
   final StreamRecordController recordController;
 
   /// Builder for customizing the resumeRecord button.

packages/stream_chat_flutter/lib/src/message_input/stream_message_input.dart

@@ -361,7 +361,7 @@ class StreamMessageInputState extends State<StreamMessageInput>
     _controller = StreamRestorableMessageInputController(message: message);
   }
 
-  void _createLocalRecordController([Message? message]) {
+  void _createLocalRecordController() {
     _recordControllerInstance = StreamRecordController(audioRecorder: Record());
   }
 

packages/stream_chat_flutter/test/src/mocks.dart

@@ -13,10 +13,7 @@ class MockRecorder extends Mock implements Record {
 }
 
 class MockStreamRecordController extends Mock
-    implements StreamRecordController {
-
-
-}
+    implements StreamRecordController {}
 
 class MockClient extends Mock implements StreamChatClient {
   MockClient() {