docs: added info note about plugin (#472)

* docs: added info note plugin

* fix: naming

* docs: removed info about connecting to only node from web audio api coverage

* fix: small fix

---------

Co-authored-by: Maciej Makowski <[email protected]>
Co-authored-by: michal <[email protected]>

Author: 3 people

packages/audiodocs/docs/fundamentals/getting-started.mdx

@@ -35,7 +35,64 @@ Install the `react-native-audio-api` package from npm:
   </TabItem>
 </Tabs>
 
-### Step 2: Wrap metro config with Audio API wrapper
+### Step 2: Add Audio API expo plugin (optional)
+
+Add `react-native-audio-api` expo plugin to your `app.json` or `app.config.js`.
+
+<details>
+<summary>app.json</summary>
+```javascript
+{
+  "plugins": [
+    [
+      "react-native-audio-api",
+      {
+        "iosBackgroundMode": true,
+        "androidPermissions" : [
+          "android.permission.MODIFY_AUDIO_SETTINGS",
+          "android.permission.FOREGROUND_SERVICE",
+          "android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"
+        ],
+        "androidForegroundService": true,
+        "androidFSTypes": [
+          "mediaPlayback"
+        ]
+      }
+    ]
+  ]
+}
+```
+</details>
+
+<details>
+<summary>app.config.js</summary>
+```javascript
+export default {
+  ...
+  "plugins": [
+    [
+      "react-native-audio-api",
+      {
+        "iosBackgroundMode": true,
+        "androidPermissions" : [
+          "android.permission.MODIFY_AUDIO_SETTINGS",
+          "android.permission.FOREGROUND_SERVICE",
+          "android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"
+        ],
+        "androidForegroundService": true,
+        "androidFSTypes": [
+          "mediaPlayback"
+        ]
+      }
+    ]
+  ]
+};
+```
+</details>
+
+Read more about plugin [here](/other/audio-api-plugin)!
+
+### Step 3: Wrap metro config with Audio API wrapper (recommended)
 
 Wrap your existing Metro configuration in the `metro.config.js` file with the `wrapWithAudioAPIMetroConfig` function:
 

packages/audiodocs/docs/other/audio-api-plugin.mdx

@@ -0,0 +1,7 @@
+---
+id: audio-api-plugin
+sidebar_label: Audio API Expo plugin
+sidebar_position: 3
+---
+
+# 🚧 Audio API Expo plugin 🚧

packages/audiodocs/docs/other/web-audio-api-coverage.mdx

@@ -14,7 +14,7 @@ sidebar_position: 2
 | AudioBuffer | ✅ |
 | AudioBufferSourceNode | ✅ |
 | AudioDestinationNode | ✅ |
-| AudioNode | ✅ | `connect` to `AudioNode` is only possible |
+| AudioNode | ✅ |
 | AudioParam | ✅ |
 | AudioScheduledSourceNode | ✅ |
 | BiquadFilterNode | ✅ |

packages/react-native-audio-api/src/plugin/withAudioAPI.ts

@@ -9,19 +9,19 @@ const pkg = require('react-native-audio-api/package.json');
 
 interface Options {
   iosBackgroundMode: boolean;
+  androidPermissions: string[];
   androidForegroundService: boolean;
-  androidFSPermissions: string[];
   androidFSTypes: string[];
 }
 
 const withDefaultOptions = (options: Partial<Options>): Options => {
   return {
     iosBackgroundMode: true,
-    androidForegroundService: true,
-    androidFSPermissions: [
+    androidPermissions: [
       'android.permission.FOREGROUND_SERVICE',
       'android.permission.WAKE_LOCK',
     ],
+    androidForegroundService: true,
     androidFSTypes: ['mediaPlayback'],
     ...options,
   };
@@ -41,12 +41,9 @@ const withBackgroundAudio: ConfigPlugin = (config) => {
 
 const withAndroidPermissions: ConfigPlugin<Options> = (
   config,
-  { androidFSPermissions }: Options
+  { androidPermissions }: Options
 ) => {
-  return AndroidConfig.Permissions.withPermissions(
-    config,
-    androidFSPermissions
-  );
+  return AndroidConfig.Permissions.withPermissions(config, androidPermissions);
 };
 
 const withForegroundService: ConfigPlugin<Options> = (
@@ -87,8 +84,9 @@ const withAudioAPI: ConfigPlugin<Options> = (config, optionsIn) => {
     config = withBackgroundAudio(config);
   }
 
+  config = withAndroidPermissions(config, options);
+
   if (options.androidForegroundService) {
-    config = withAndroidPermissions(config, options);
     config = withForegroundService(config, options);
   }