fixes foreground service error when mic permission is not granted (#751)

Author: Brazol

docusaurus/docs/Flutter/05-advanced/07-background-modes.mdx

@@ -79,6 +79,10 @@ By default, the SDK handles button tap by canceling the call when the user taps
 
 We require the following permissions to create an appropriate foreground service: `FOREGROUND_SERVICE`, `FOREGROUND_SERVICE_PHONE_CALL`, and `FOREGROUND_SERVICE_MICROPHONE`. Additionally, the `FOREGROUND_SERVICE_MEDIA_PROJECTION` permission is necessary for the screen sharing functionality. They are added out-of-the-box as part of our `stream_video_flutter` package.
 
+:::note
+Because of the foreground service type it requires a microphone (`RECORD_AUDIO`) permission to be enabled. Make sure the user grants the permission before beginning the call, otherwise the service will not be able to start.
+:::
+
 ## iOS
 
 iOS background modes provide the necessary framework to maintain connectivity, handle incoming calls, and manage ongoing calls even when the app isn't in the foreground. By using the appropriate background modes, your app can stay responsive to call events without being suspended by the system.

dogfooding/lib/screens/home_screen.dart

@@ -12,6 +12,7 @@ import 'package:flutter_dogfooding/widgets/stream_button.dart';
 // 📦 Package imports:
 import 'package:stream_video_flutter/stream_video_flutter.dart';
 import 'package:stream_video_flutter/stream_video_flutter_background.dart';
+import 'package:permission_handler/permission_handler.dart';
 
 import '../app/user_auth_controller.dart';
 import '../di/injector.dart';
@@ -36,6 +37,12 @@ class _HomeScreenState extends State<HomeScreen> {
 
   @override
   void initState() {
+    [
+      Permission.notification,
+      Permission.camera,
+      Permission.microphone,
+    ].request();
+
     StreamBackgroundService.init(
       StreamVideo.instance,
       onButtonClick: (call, type, serviceType) async {
@@ -49,6 +56,7 @@ class _HomeScreenState extends State<HomeScreen> {
         }
       },
     );
+
     super.initState();
   }
 

packages/stream_video_flutter/lib/src/call_background/background_service.dart

@@ -1,5 +1,6 @@
 import 'dart:async';
 
+import 'package:permission_handler/permission_handler.dart';
 import 'package:stream_video/stream_video.dart';
 
 import '../../stream_video_flutter_background.dart';
@@ -112,13 +113,22 @@ class StreamBackgroundService {
     OnUiLayerDestroyed? onUiLayerDestroyed,
   }) async {
     try {
+      if (!await Permission.microphone.isGranted) {
+        _logger.d(
+          () =>
+              '[onConnected] cannot start the service, microphone permission is not granted',
+        );
+        return;
+      }
+
       final result = await StreamVideoFlutterBackground.startService(
         NotificationPayload(
           callCid: call.callCid.value,
           options: optionsBuilder.call(call),
         ),
         ServiceType.call,
       );
+
       _logger.d(() => '[onConnected] call service start result: $result');
       if (result) {
         StreamVideoFlutterBackground.setOnNotificationContentClick(

packages/stream_video_flutter/pubspec.yaml

@@ -17,6 +17,7 @@ dependencies:
   flutter:
     sdk: flutter
   flutter_webrtc: ^0.11.6
+  permission_handler: ^11.3.1
   plugin_platform_interface: ^2.1.7
   rate_limiter: ^1.0.0
   stream_video: ^0.5.1
@@ -34,11 +35,11 @@ dev_dependencies:
 flutter:
   assets:
     - images/
-  
+
   fonts:
-    - family:  StreamIcons
+    - family: StreamIcons
       fonts:
-       - asset: fonts/StreamIcons.ttf
+        - asset: fonts/StreamIcons.ttf
 
   uses-material-design: true