react-native-google-mobile-ads 14.1.0 → 14.2.0

package/__tests__/googleMobileAds.test.ts

@@ -87,6 +87,22 @@ describe('Admob', function () {
           admob().openDebugMenu('');
         }).toThrowError('openDebugMenu expected a non-empty string value');
       });
+
+      it('does call native setAppVolume method', () => {
+        admob().setAppVolume(0.5);
+        expect(RNGoogleMobileAdsModule.setAppVolume).toBeCalledTimes(1);
+      });
+
+      it('throws if setAppVolume is greater than 1', function () {
+        expect(() => {
+          admob().setAppVolume(2);
+        }).toThrowError('The app volume must be a value between 0 and 1 inclusive.');
+      });
+
+      it('does call native setAppMuted method', () => {
+        admob().setAppMuted(true);
+        expect(RNGoogleMobileAdsModule.setAppMuted).toBeCalledTimes(1);
+      });
     });
   });
 });

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsModule.java

@@ -194,4 +194,14 @@ public class ReactNativeGoogleMobileAdsModule extends ReactNativeModule {
           .runOnUiThread(() -> MobileAds.openDebugMenu(getCurrentActivity(), adUnit));
     }
   }
+
+  @ReactMethod
+  public void setAppVolume(final Float volume) {
+    MobileAds.setAppVolume(volume);
+  }
+
+  @ReactMethod
+  public void setAppMuted(final Boolean muted) {
+    MobileAds.setAppMuted(muted);
+  }
 }

package/docs/ad-inspector.mdx

@@ -2,7 +2,7 @@
 
 The debug menu is a tool that allows you to test and debug your app's ad experience. It can be used to:
 
-```
+```js
 await mobileAds().openDebugMenu(AD_UNIT_ID);
 ````
 

package/docs/displaying-ads-hook.mdx

@@ -20,9 +20,11 @@ export default function App() {
 }
 ```
 
-> The `adUnitid` parameter can also be used to manage creation and destruction of an ad instance.
-> If `adUnitid` is set or changed, new ad instance will be created and previous ad instance will be destroyed if exists.
-> If `adUnitid` is set to `null`, no ad instance will be created and previous ad instance will be destroyed if exists.
+<Info>
+The `adUnitid` parameter can also be used to manage creation and destruction of an ad instance.
+If `adUnitid` is set or changed, new ad instance will be created and previous ad instance will be destroyed if exists.
+If `adUnitid` is set to `null`, no ad instance will be created and previous ad instance will be destroyed if exists.
+</Info>
 
 The second argument is an additional optional request options object to be sent whilst loading an advert, such as keywords & location.
 Setting additional request options helps AdMob choose better tailored ads from the network. View the [`RequestOptions`](/reference/admob/requestoptions)
@@ -92,8 +94,10 @@ Return values of the hook are:
 | load           | Function                           | Start loading the advert with the provided RequestOptions.                                                         |
 | show           | Function                           | Show the loaded advert to the user.                                                                                |
 
-> Note that `isOpened` value remains `true` even after the ad is closed.
-> The value changes to `false` when ad is initialized via calling `load()`.
-> To determine whether the ad is currently showing, use `isShowing` value.
+<Info>
+Note that `isOpened` value remains `true` even after the ad is closed.
+The value changes to `false` when ad is initialized via calling `load()`.
+To determine whether the ad is currently showing, use `isShowing` value.
+</Info>
 
 [Impression-level ad revenue]: /impression-level-ad-revenue

package/docs/displaying-ads.mdx

@@ -423,7 +423,9 @@ function App() {
 The `size` prop takes a [`BannerAdSize`](/reference/admob/banneradsize) type, and once the advert is available, will
 fill the space for the chosen size.
 
-> If no inventory for the size specified is available, an error will be thrown via `onAdFailedToLoad`!
+<Info>
+If no inventory for the size specified is available, an error will be thrown via `onAdFailedToLoad`!
+</Info>
 
 The `requestOptions` prop is additional optional request options object to be sent whilst loading an advert, such as keywords & location.
 Setting additional request options helps AdMob choose better tailored ads from the network. View the [`RequestOptions`](/reference/admob/requestoptions)

package/docs/european-user-consent.mdx

@@ -14,20 +14,27 @@ Android & iOS, and provides a single JavaScript interface for both platforms.
 Ads served by Google can be categorized as personalized or non-personalized, both requiring consent from users in the EEA. By default,
 ad requests to Google serve personalized ads, with ad selection based on the user's previously collected data. Users outside of the EEA do not require consent.
 
-> The `AdsConsent` helper only provides you with the tools for requesting consent, it is up to the developer to ensure the consent status is reflected throughout the app.
+<Info>
+The `AdsConsent` helper only provides you with the tools for requesting consent, it is up to the developer to ensure the consent status is reflected throughout the app.
+</Info>
 
 ## Handling consent
 
-To setup and configure ads consent collection, first of all:
+To setup and configure ads consent collection, start by enabling and configuring GDPR and IDFA messaging in the [Privacy & messaging section of AdMob's Web Console](https://apps.admob.com/v2/privacymessaging).
 
-- Enable and configure GDPR and IDFA messaging in the [Privacy & messaging section of AdMob's Web Console](https://apps.admob.com/v2/privacymessaging).
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
 
-- For Android, add the following rule into
-  `android/app/proguard-rules.pro`:
-  ```
-  -keep class com.google.android.gms.internal.consent_sdk.** { *; }
-  ```
-- For Expo users, add extraProguardRules property to `app.json` file following this guide [Expo](https://docs.expo.dev/versions/latest/sdk/build-properties/#pluginconfigtypeandroid):
+For Android, add the following rule into `android/app/proguard-rules.pro`:
+
+```
+-keep class com.google.android.gms.internal.consent_sdk.** { *; }
+```
+
+</TabItem>
+<TabItem value="expo">
+
+Add the `extraProguardRules` property to `app.json` file as described in the [Expo documentation](https://docs.expo.dev/versions/latest/sdk/build-properties/#pluginconfigtypeandroid):
 
 ```json
 {
@@ -48,14 +55,21 @@ To setup and configure ads consent collection, first of all:
 
 You'll need to generate a new development build before using it.
 
+</TabItem>
+</Tabs>
+
 ### Delaying app measurement
 
 By default, the Google Mobile Ads SDK initializes app measurement and begins sending user-level event data to Google immediately when the app starts.
 If your app will be used by users within the EEA, it is important you prevent app measurement until your first ad has been requested (after consent).
 
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
+
 Within your projects `app.json` file, set the `delay_app_measurement_init` to `true` to delay app measurement:
 
 ```json
+// <project-root>/app.json
 {
   "react-native-google-mobile-ads": {
     "android_app_id": "ca-app-pub-xxxxxxxx~xxxxxxxx",
@@ -65,23 +79,42 @@ Within your projects `app.json` file, set the `delay_app_measurement_init` to `t
 }
 ```
 
-Once set, rebuild your application:
+</TabItem>
+<TabItem value="expo">
 
-```bash
-# For iOS
-npx react-native run-ios
+Within your projects `app.json` file, set the `delayAppMeasurementInit` to `true` to delay app measurement:
 
-# For Android
-npx react-native run-android
+```json
+// <project-root>/app.json
+{
+  "expo": {
+    "plugins": [
+      [
+        "react-native-google-mobile-ads",
+        {
+          "androidAppId": "ca-app-pub-xxxxxxxx~xxxxxxxx",
+          "iosAppId": "ca-app-pub-xxxxxxxx~xxxxxxxx",
+          "delayAppMeasurementInit": true
+        }
+      ]
+    ]
+  }
+}
 ```
 
+</TabItem>
+</Tabs>
+
+Once set, rebuild your application.
+
 ### App Tracking Transparency
 
 If you configure an [ATT message](https://support.google.com/admob/answer/10115331) in your Google AdMob account, the UMP SDK will automatically handle the ATT alert.
 This will also show an IDFA explainer message. If you don't want to show an explainer message you can show the ATT alert [manually](https://docs.page/invertase/react-native-google-mobile-ads#app-tracking-transparency-ios).
 Also, within your projects `app.json` file, you have to provide a user tracking usage description (once set, rebuild your application):
 
-#### For React Native projects (without Expo)
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
 
 ```json
 // <project-root>/app.json
@@ -94,7 +127,8 @@ Also, within your projects `app.json` file, you have to provide a user tracking
 }
 ```
 
-#### For Expo projects
+</TabItem>
+<TabItem value="expo">
 
 ```json
 // <project-root>/app.json
@@ -114,6 +148,9 @@ Also, within your projects `app.json` file, you have to provide a user tracking
 }
 ```
 
+</TabItem>
+</Tabs>
+
 ### Requesting consent information
 
 It is recommended you request consent information each time your application starts to determine if the consent modal should be shown, e.g. due to provider changes.
@@ -140,7 +177,7 @@ the the actual user consent**. It simply indicates if you now have a consent res
 (_i.e._ if user consent is **required**, the form has been presented, and user has
 **denied** the consent, the status returned by this method will be `OBTAINED`,
 and not `REQUIRED` as some may expect). To check the actual consent status
-see [Inspecting consent choices] below.
+see [Inspecting consent choices](/european-user-consent/#inspecting-consent-choices) below.
 
 ### Gathering user consent
 
@@ -280,7 +317,3 @@ AdsConsent.reset();
 In case of troubles, double-check the original documentation for underlying
 UMP SDK for [Android](https://developers.google.com/admob/ump/android/quick-start) /
 [iOS](https://developers.google.com/admob/ump/ios/quick-start).
-
-<!-- links -->
-
-[inspecting consent choices]: #inspecting-consent-choices

package/docs/index.mdx

@@ -1,22 +1,60 @@
-# Installation
+# Getting Started
+
+The AdMob module allows you to display adverts to your users. All adverts are served over the Google AdMob network, meaning
+a [Google AdMob account](https://apps.admob.com) is required.
+
+<YouTube id="9qCxo0D-Sak" />
+
+The module supports four types of Ads:
+
+1. Full screen [App Open Ads](/displaying-ads#app-open-ads).
+2. Full screen [Interstitial Ads](/displaying-ads#interstitial-ads).
+3. Full screen [Rewarded Ads](/displaying-ads#rewarded-ads).
+4. Component based [Banner Ads](/displaying-ads#banner-ads-component).
+
+## Installation
+
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
 
 ```bash
 # Install the admob module
-yarn add react-native-google-mobile-ads
+npm install react-native-google-mobile-ads
 ```
 
-> On Android, before releasing your app, you must select _Yes, my app contains ads_ in the Google Play Store, Policy, App content, Manage under Ads.
+</TabItem>
+<TabItem value="expo">
 
-## Optionally configure iOS static frameworks
+```bash
+# Install the admob module and config plugin
+npx expo install react-native-google-mobile-ads
+```
 
-On iOS if you need to use static frameworks (that is, `use_frameworks! :linkage => :static` in your `Podfile`) you must add the variable `$RNGoogleMobileAdsAsStaticFramework = true` to the targets in your `Podfile`. You may need this if you use this module in combination with react-native-firebase v15 and higher since it requires `use_frameworks!`.
+</TabItem>
+</Tabs>
 
-Expo users may enable static frameworks by using the `expo-build-properties` plugin.
-To do so [follow the official `expo-build-properties` installation instructions](https://docs.expo.dev/versions/latest/sdk/build-properties/) and merge the following code into your `app.json` or `app.config.js` file:
+<Info>
+On Android, before releasing your app, you must select "Yes, my app contains ads" in the Google Play Console under "Policy and programmes" > "App content" > "Manage".
+</Info>
+
+### Optionally configure iOS static frameworks
+
+Follow these steps on iOS if you need to use static frameworks (that is, `use_frameworks! :linkage => :static` in your `Podfile`).
+You may need this if you use this module in combination with `react-native-firebase` v15 and higher since it requires `use_frameworks!`.
+
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
+
+To enable static frameworks, you must add the variable `$RNGoogleMobileAdsAsStaticFramework = true` to the targets in your `Podfile`.
 
-#### app.json
+</TabItem>
+<TabItem value="expo">
+
+Expo users may enable static frameworks by using the `expo-build-properties` plugin.
+To do so [follow the official `expo-build-properties` installation instructions](https://docs.expo.dev/versions/latest/sdk/build-properties/) and merge the following code into your `app.json` file:
 
 ```json
+// <project-root>/app.json
 {
   "expo": {
     "plugins": [
@@ -33,50 +71,8 @@ To do so [follow the official `expo-build-properties` installation instructions]
 }
 ```
 
-#### app.config.js
-
-```js
-{
-  expo: {
-    plugins: [
-      [
-        'expo-build-properties',
-        {
-          ios: {
-            useFrameworks: 'static',
-          },
-        },
-      ],
-    ];
-  }
-}
-```
-
-## What does it do
-
-The AdMob module allows you to display adverts to your users. All adverts are served over the Google AdMob network, meaning
-a [Google AdMob account](https://apps.admob.com) is required.
-
-<YouTube id="9qCxo0D-Sak" />
-
-The module supports four types of Ads:
-
-1. Full screen [App Open Ads](/displaying-ads#app-open-ads).
-2. Full screen [Interstitial Ads](/displaying-ads#interstitial-ads).
-3. Full screen [Rewarded Ads](/displaying-ads#rewarded-ads).
-4. Component based [Banner Ads](/displaying-ads#banner-ads).
-
-## Getting Started
-
-A number of steps must be taken and considered before you start serving adverts to your users:
-
-- [Installation](#installation)
-- [Getting Started](#getting-started)
-  - [Setting up Google AdMob](#setting-up-google-admob)
-  - [Configure outbound requests](#configure-outbound-requests)
-  - [European User Consent](#european-user-consent)
-  - [Test ads](#test-ads)
-- [Next Steps](#next-steps)
+</TabItem>
+</Tabs>
 
 ### Setting up Google AdMob
 
@@ -84,7 +80,9 @@ Before you are able to display ads to your users, you must have a [Google AdMob
 "Apps" menu item, create or choose an existing Android/iOS app. Each app platform exposes a unique account ID which needs to
 be added to the project.
 
-> Attempting to build your app without a valid App ID in `app.json` or `app.config.js` will cause the app to crash on start or fail to build.
+<Warning>
+Attempting to build your app without a valid App ID in `app.json` will cause the app to crash on start or fail to build.
+</Warning>
 
 Under the "App settings" menu item, you can find the "App ID":
 
@@ -94,7 +92,9 @@ The app IDs for Android and iOS need to be inserted into your apps native code.
 For React Native projects without Expo, you can add the app IDs to the `app.json` file.
 For Expo projects, we provide an [Expo config plugin](https://docs.expo.dev/config-plugins/introduction/).
 
-#### For React Native projects (without Expo)
+
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
 
 ```json
 // <project-root>/app.json
@@ -117,11 +117,10 @@ npx react-native run-ios
 npx react-native run-android
 ```
 
-#### For Expo projects
-
-> ⚠️ This module contains custom native code which is NOT supported by Expo Go
+</TabItem>
+<TabItem value="expo">
 
-This library contains an Expo config plugin which you must add to your `app.json`, `app.config.js` or `app.config.ts` file.
+This library contains an Expo config plugin which you must add to your `app.json` file.
 For these changes to take effect, your must rebuild your project's native code and install the new build on your device.
 
 ```json
@@ -141,6 +140,10 @@ For these changes to take effect, your must rebuild your project's native code a
 }
 ```
 
+<Warning>
+️ This module contains custom native code which is NOT supported by Expo Go
+</Warning>
+
 If you're using Expo without EAS, run the following commands:
 
 ```bash
@@ -163,6 +166,9 @@ npx eas-cli build --profile development
 npx eas-cli build --profile development --local
 ```
 
+</TabItem>
+</Tabs>
+
 ### Configure outbound requests
 
 If the default ad settings are not correct for your app, you can provide settings that will apply to all ad requests.
@@ -202,8 +208,10 @@ To learn more about the request configuration settings, view the [`RequestConfig
 Before loading ads, have your app initialize the Google Mobile Ads SDK by calling `initialize` which initializes the SDK and returns a promise once initialization is complete (or after a 30-second timeout).
 This needs to be done only once, ideally at app launch.
 
-> ⚠️ **Warning:** Ads may be preloaded by the Mobile Ads SDK or mediation partner SDKs upon calling `initialize`.
-> If you need to obtain consent from users in the European Economic Area (EEA), set any request-specific flags (such as tagForChildDirectedTreatment), or otherwise take action before loading ads, ensure you do so before initializing the Mobile Ads SDK.
+<Warning>
+Ads may be preloaded by the Mobile Ads SDK or mediation partner SDKs upon calling `initialize`.
+If you need to obtain consent from users in the European Economic Area (EEA), set any request-specific flags (such as tagForChildDirectedTreatment), or otherwise take action before loading ads, ensure you do so before initializing the Mobile Ads SDK.
+</Warning>
 
 ```js
 import mobileAds from 'react-native-google-mobile-ads';
@@ -223,7 +231,8 @@ The Google Mobile Ads SDK supports conversion tracking using Apple's SKAdNetwork
 Within your projects `app.json` file, add the advised [SKAdNetwork identifiers](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/3p-skadnetworks).
 Note that these identifiers are subject to change and should be updated regularly.
 
-#### For React Native projects (without Expo)
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
 
 ```json
 // <project-root>/app.json
@@ -286,7 +295,8 @@ Note that these identifiers are subject to change and should be updated regularl
 }
 ```
 
-#### For Expo projects
+</TabItem>
+<TabItem value="expo">
 
 ```json
 // <project-root>/app.json
@@ -299,8 +309,55 @@ Note that these identifiers are subject to change and should be updated regularl
           "androidAppId": "ca-app-pub-xxxxxxxx~xxxxxxxx",
           "iosAppId": "ca-app-pub-xxxxxxxx~xxxxxxxx",
           "skAdNetworkItems": [
-            // list of network ids removed to avoid duplication
-            // please refer to the list in the `app.jaon` configuration section above
+            "cstr6suwn9.skadnetwork",
+            "4fzdc2evr5.skadnetwork",
+            "4pfyvq9l8r.skadnetwork",
+            "2fnua5tdw4.skadnetwork",
+            "ydx93a7ass.skadnetwork",
+            "5a6flpkh64.skadnetwork",
+            "p78axxw29g.skadnetwork",
+            "v72qych5uu.skadnetwork",
+            "ludvb6z3bs.skadnetwork",
+            "cp8zw746q7.skadnetwork",
+            "3sh42y64q3.skadnetwork",
+            "c6k4g5qg8m.skadnetwork",
+            "s39g8k73mm.skadnetwork",
+            "3qy4746246.skadnetwork",
+            "f38h382jlk.skadnetwork",
+            "hs6bdukanm.skadnetwork",
+            "v4nxqhlyqp.skadnetwork",
+            "wzmmz9fp6w.skadnetwork",
+            "yclnxrl5pm.skadnetwork",
+            "t38b2kh725.skadnetwork",
+            "7ug5zh24hu.skadnetwork",
+            "gta9lk7p23.skadnetwork",
+            "vutu7akeur.skadnetwork",
+            "y5ghdn5j9k.skadnetwork",
+            "n6fk4nfna4.skadnetwork",
+            "v9wttpbfk9.skadnetwork",
+            "n38lu8286q.skadnetwork",
+            "47vhws6wlr.skadnetwork",
+            "kbd757ywx3.skadnetwork",
+            "9t245vhmpl.skadnetwork",
+            "eh6m2bh4zr.skadnetwork",
+            "a2p9lx4jpn.skadnetwork",
+            "22mmun2rn5.skadnetwork",
+            "4468km3ulz.skadnetwork",
+            "2u9pt9hc89.skadnetwork",
+            "8s468mfl3y.skadnetwork",
+            "klf5c3l5u5.skadnetwork",
+            "ppxm28t8ap.skadnetwork",
+            "ecpz2srf59.skadnetwork",
+            "uw77j35x4d.skadnetwork",
+            "pwa73g5rt2.skadnetwork",
+            "mlmmfzh3r3.skadnetwork",
+            "578prtvx9j.skadnetwork",
+            "4dzt52r2t5.skadnetwork",
+            "e5fvkxwrpn.skadnetwork",
+            "8c4e2ghe7u.skadnetwork",
+            "zq492l623r.skadnetwork",
+            "3rd42ekr43.skadnetwork",
+            "3qcr597p9d.skadnetwork"
           ],
         }
       ]
@@ -309,12 +366,16 @@ Note that these identifiers are subject to change and should be updated regularl
 }
 ```
 
+</TabItem>
+</Tabs>
+
 ### App Tracking Transparency (iOS)
 
 Apple requires apps to display the App Tracking Transparency authorization request for accessing the IDFA (leaving the choice to the user, whether to use personalized or non-personalized ads).
 Within your projects `app.json` file, you have to provide a user tracking usage description:
 
-#### For React Native projects (without Expo)
+<Tabs groupId="framework" values={[{label: 'React Native', value: 'bare'}, {label: 'Expo', value: 'expo'}]}>
+<TabItem value="bare">
 
 ```json
 // <project-root>/app.json
@@ -327,7 +388,8 @@ Within your projects `app.json` file, you have to provide a user tracking usage
 }
 ```
 
-#### For Expo projects
+</TabItem>
+<TabItem value="expo">
 
 ```json
 // <project-root>/app.json
@@ -347,6 +409,9 @@ Within your projects `app.json` file, you have to provide a user tracking usage
 }
 ```
 
+</TabItem>
+</Tabs>
+
 #### Requesting App Tracking Transparency authorization
 
 To request the App Tracking Transparency authorization we recommend using the [react-native-permissions](https://github.com/zoontek/react-native-permissions) library or making it part of the UMP consent flow [European User Consent page](/european-user-consent).
@@ -407,4 +472,4 @@ adverts to our users. The AdMob module provides integration with three different
 - [App Open Ads](/displaying-ads#app-open-ads)
 - [Interstitial Ads](/displaying-ads#interstitial-ads)
 - [Rewarded Ads](/displaying-ads#rewarded-ads)
-- [Banner Ads](/displaying-ads#banner-ads)
+- [Banner Ads](/displaying-ads#banner-ads-component)

package/docs/video-ad_volume-control.mdx

@@ -0,0 +1,49 @@
+# Video ad volume control
+
+<Info>
+Video volume controls apply only to Google ads and are not forwarded to mediation networks.
+</Info>
+
+If your app has its own volume controls, such as custom music or sound effect volumes, disclosing app volume to the Google Mobile Ads SDK enables video ads to respect app volume settings. This ensures users receive video ads with the expected audio volume.
+
+The device volume, controlled through volume buttons or OS-level volume slider, determines the volume for device audio output. However, apps can independently adjust volume levels relative to the device volume to tailor the audio experience.
+
+For App Open, Banner, Interstitial, Rewarded, and Rewarded Interstitial ad formats you can report the relative app volume to the Google Mobile Ads SDK by calling the `setAppVolume` function. Valid ad volume values range from `0.0` (silent) to `1.0` (current device volume). Here's an example of how to report the relative app volume to the SDK:
+
+```js
+import React from 'react';
+import MobileAds, { GAMBannerAd, BannerAdSize, TestIds } from 'react-native-google-mobile-ads';
+
+const adUnitId = __DEV__ ? TestIds.GAM_BANNER : '/xxx/yyyy';
+
+function App() {
+  MobileAds().setAppVolume(0.5);
+
+  return <GAMBannerAd unitId={adUnitId} sizes={[BannerAdSize.FULL_BANNER]} />;
+}
+```
+
+<Error>
+Lowering your app's audio volume reduces video ad eligibility and might reduce your app's ad revenue. You should only utilize this API if your app provides custom volume controls to the user, and the user's volume is properly reflected in the API.
+</Error>
+
+For App Open, Banner, Interstitial, Rewarded, and Rewarded Interstitial ad formats, you can inform the Google Mobile Ads SDK that the app volume has been muted by calling the `setAppMuted` function:
+
+```js
+import React from 'react';
+import MobileAds, { GAMBannerAd, BannerAdSize, TestIds } from 'react-native-google-mobile-ads';
+
+const adUnitId = __DEV__ ? TestIds.GAM_BANNER : '/xxx/yyyy';
+
+function App() {
+  MobileAds().setAppMuted(true);
+
+  return <GAMBannerAd unitId={adUnitId} sizes={[BannerAdSize.FULL_BANNER]} />;
+}
+```
+
+By default, `appVolume` is set to 1 (the current device volume) and `appMuted` is set to `NO`.
+
+<Error>
+Muting your app reduces video ad eligibility and might reduce your app's ad revenue. You should only utilize this API if your app provides a custom mute control to the user, and the user's mute decision is properly reflected in the API.
+</Error>

package/docs.json

@@ -1,15 +1,32 @@
 {
   "name": "React Native Google Mobile Ads",
+  "logo": "https://raw.githubusercontent.com/invertase/react-native-google-mobile-ads/main/docs/img/logo_admob_192px.svg",
   "twitter": "invertaseio",
   "sidebar": [
-    ["Installation", "/"],
-    ["Displaying Ads", "/displaying-ads"],
-    ["Displaying Ads via Hook", "/displaying-ads-hook"],
-    ["European User Consent", "/european-user-consent"],
-    ["Ad Inspector", "/ad-inspector"],
-    ["Impression-level ad revenue", "/impression-level-ad-revenue"],
-    ["Common Reasons For Ads Not Showing", "/common-reasons-for-ads-not-showing"],
-    ["Migrating to v5", "/migrating-to-v5"],
-    ["Migrating to v6", "/migrating-to-v6"]
+    [
+      "Getting Started",
+      [
+        ["Getting Started", "/"],
+        ["Displaying Ads", "/displaying-ads"],
+        ["Common Reasons For Ads Not Showing", "/common-reasons-for-ads-not-showing"]
+      ]
+    ],
+    [
+      "Advanced Usage",
+      [
+        ["Displaying Ads via Hook", "/displaying-ads-hook"],
+        ["European User Consent", "/european-user-consent"],
+        ["Ad Inspector", "/ad-inspector"],
+        ["Impression-level ad revenue", "/impression-level-ad-revenue"],
+        ["Video ad volume control", "/video-ad_volume-control"]
+      ]
+    ],
+    [
+      "Migration Guides",
+      [
+        ["Migrating to v5", "/migrating-to-v5"],
+        ["Migrating to v6", "/migrating-to-v6"]
+      ]
+    ]
   ]
 }

package/ios/RNGoogleMobileAds/RNGoogleMobileAdsModule.mm

@@ -67,6 +67,18 @@ RCT_EXPORT_METHOD(openDebugMenu : (NSString *)adUnit) {
 #endif
 }
 
+RCT_EXPORT_METHOD(setAppVolume : (float)volume) {
+#if !TARGET_OS_MACCATALYST
+  GADMobileAds.sharedInstance.applicationVolume = volume;
+#endif
+}
+
+RCT_EXPORT_METHOD(setAppMuted : (BOOL *)muted) {
+#if !TARGET_OS_MACCATALYST
+  GADMobileAds.sharedInstance.applicationMuted = muted;
+#endif
+}
+
 #ifdef RCT_NEW_ARCH_ENABLED
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params {

package/jest.setup.ts

@@ -34,6 +34,8 @@ jest.doMock('react-native', () => {
             setRequestConfiguration: jest.fn(),
             openAdInspector: jest.fn(),
             openDebugMenu: jest.fn(),
+            setAppVolume: jest.fn(),
+            setAppMuted: jest.fn(),
           };
         },
       },

package/lib/commonjs/MobileAds.js

@@ -48,6 +48,13 @@ class MobileAdsModule {
     if (!adUnit) throw new Error('googleMobileAds.openDebugMenu expected a non-empty string value');
     _NativeGoogleMobileAdsModule.default.openDebugMenu(adUnit);
   }
+  setAppVolume(volume) {
+    if (volume < 0 || volume > 1) throw new Error('The app volume must be a value between 0 and 1 inclusive.');
+    _NativeGoogleMobileAdsModule.default.setAppVolume(volume);
+  }
+  setAppMuted(muted) {
+    _NativeGoogleMobileAdsModule.default.setAppMuted(muted);
+  }
 }
 const MobileAdsInstance = new MobileAdsModule();
 const MobileAds = () => {

package/lib/commonjs/MobileAds.js.map

@@ -1 +1 @@
-{"version":3,"names":["_NativeGoogleMobileAdsModule","_interopRequireDefault","require","_validateAdRequestConfiguration","_SharedEventEmitter","_GoogleMobileAdsNativeEventEmitter","e","__esModule","default","NATIVE_MODULE_EVENT_SUBSCRIPTIONS","nativeEvents","MobileAdsModule","constructor","length","i","len","subscribeToNativeModuleEvent","eventName","GoogleMobileAdsNativeEventEmitter","addListener","event","SharedEventEmitter","emit","adUnitId","requestId","initialize","RNGoogleMobileAdsModule","setRequestConfiguration","requestConfiguration","config","validateAdRequestConfiguration","Error","message","openAdInspector","openDebugMenu","adUnit","MobileAdsInstance","MobileAds","exports","_default"],"sourceRoot":"../../src","sources":["MobileAds.ts"],"mappings":";;;;;;AAAA,IAAAA,4BAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,+BAAA,GAAAD,OAAA;AACA,IAAAE,mBAAA,GAAAF,OAAA;AACA,IAAAG,kCAAA,GAAAH,OAAA;AAAiG,SAAAD,uBAAAK,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAIjG,MAAMG,iCAA0D,GAAG,CAAC,CAAC;AAErE,MAAMC,YAAY,GAAG,CACnB,kCAAkC,EAClC,sCAAsC,EACtC,kCAAkC,EAClC,+CAA+C,CAChD;AAED,MAAMC,eAAe,CAAqC;EACxDC,WAAWA,CAAA,EAAG;IACZ,IAAIF,YAAY,IAAIA,YAAY,CAACG,MAAM,EAAE;MACvC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEC,GAAG,GAAGL,YAAY,CAACG,MAAM,EAAEC,CAAC,GAAGC,GAAG,EAAED,CAAC,EAAE,EAAE;QACvD,IAAI,CAACE,4BAA4B,CAACN,YAAY,CAACI,CAAC,CAAC,CAAC;MACpD;IACF;EACF;EAEAE,4BAA4BA,CAACC,SAAiB,EAAE;IAC9C,IAAI,CAACR,iCAAiC,CAACQ,SAAS,CAAC,EAAE;MACjDC,oEAAiC,CAACC,WAAW,CAACF,SAAS,EAAEG,KAAK,IAAI;QAChEC,sCAAkB,CAACC,IAAI,CAAC,GAAGL,SAAS,IAAIG,KAAK,CAACG,QAAQ,IAAIH,KAAK,CAACI,SAAS,EAAE,EAAEJ,KAAK,CAAC;MACrF,CAAC,CAAC;MAEFX,iCAAiC,CAACQ,SAAS,CAAC,GAAG,IAAI;IACrD;EACF;EAEAQ,UAAUA,CAAA,EAAG;IACX,OAAOC,oCAAuB,CAACD,UAAU,CAAC,CAAC;EAC7C;EAEAE,uBAAuBA,CAACC,oBAA0C,EAAE;IAClE,IAAIC,MAAM;IACV,IAAI;MACFA,MAAM,GAAG,IAAAC,8DAA8B,EAACF,oBAAoB,CAAC;IAC/D,CAAC,CAAC,OAAOtB,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYyB,KAAK,EAAE;QACtB,MAAM,IAAIA,KAAK,CAAC,8CAA8CzB,CAAC,CAAC0B,OAAO,EAAE,CAAC;MAC5E;IACF;IAEA,OAAON,oCAAuB,CAACC,uBAAuB,CAACE,MAAM,CAAC;EAChE;EAEAI,eAAeA,CAAA,EAAG;IAChB,OAAOP,oCAAuB,CAACO,eAAe,CAAC,CAAC;EAClD;EAEAC,aAAaA,CAACC,MAAc,EAAE;IAC5B,IAAI,CAACA,MAAM,EAAE,MAAM,IAAIJ,KAAK,CAAC,iEAAiE,CAAC;IAC/FL,oCAAuB,CAACQ,aAAa,CAACC,MAAM,CAAC;EAC/C;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAIzB,eAAe,CAAC,CAAC;AAExC,MAAM0B,SAAS,GAAGA,CAAA,KAAM;EAC7B,OAAOD,iBAAiB;AAC1B,CAAC;AAACE,OAAA,CAAAD,SAAA,GAAAA,SAAA;AAAA,IAAAE,QAAA,GAAAD,OAAA,CAAA9B,OAAA,GAEa6B,SAAS","ignoreList":[]}
+{"version":3,"names":["_NativeGoogleMobileAdsModule","_interopRequireDefault","require","_validateAdRequestConfiguration","_SharedEventEmitter","_GoogleMobileAdsNativeEventEmitter","e","__esModule","default","NATIVE_MODULE_EVENT_SUBSCRIPTIONS","nativeEvents","MobileAdsModule","constructor","length","i","len","subscribeToNativeModuleEvent","eventName","GoogleMobileAdsNativeEventEmitter","addListener","event","SharedEventEmitter","emit","adUnitId","requestId","initialize","RNGoogleMobileAdsModule","setRequestConfiguration","requestConfiguration","config","validateAdRequestConfiguration","Error","message","openAdInspector","openDebugMenu","adUnit","setAppVolume","volume","setAppMuted","muted","MobileAdsInstance","MobileAds","exports","_default"],"sourceRoot":"../../src","sources":["MobileAds.ts"],"mappings":";;;;;;AAAA,IAAAA,4BAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,+BAAA,GAAAD,OAAA;AACA,IAAAE,mBAAA,GAAAF,OAAA;AACA,IAAAG,kCAAA,GAAAH,OAAA;AAAiG,SAAAD,uBAAAK,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAIjG,MAAMG,iCAA0D,GAAG,CAAC,CAAC;AAErE,MAAMC,YAAY,GAAG,CACnB,kCAAkC,EAClC,sCAAsC,EACtC,kCAAkC,EAClC,+CAA+C,CAChD;AAED,MAAMC,eAAe,CAAqC;EACxDC,WAAWA,CAAA,EAAG;IACZ,IAAIF,YAAY,IAAIA,YAAY,CAACG,MAAM,EAAE;MACvC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEC,GAAG,GAAGL,YAAY,CAACG,MAAM,EAAEC,CAAC,GAAGC,GAAG,EAAED,CAAC,EAAE,EAAE;QACvD,IAAI,CAACE,4BAA4B,CAACN,YAAY,CAACI,CAAC,CAAC,CAAC;MACpD;IACF;EACF;EAEAE,4BAA4BA,CAACC,SAAiB,EAAE;IAC9C,IAAI,CAACR,iCAAiC,CAACQ,SAAS,CAAC,EAAE;MACjDC,oEAAiC,CAACC,WAAW,CAACF,SAAS,EAAEG,KAAK,IAAI;QAChEC,sCAAkB,CAACC,IAAI,CAAC,GAAGL,SAAS,IAAIG,KAAK,CAACG,QAAQ,IAAIH,KAAK,CAACI,SAAS,EAAE,EAAEJ,KAAK,CAAC;MACrF,CAAC,CAAC;MAEFX,iCAAiC,CAACQ,SAAS,CAAC,GAAG,IAAI;IACrD;EACF;EAEAQ,UAAUA,CAAA,EAAG;IACX,OAAOC,oCAAuB,CAACD,UAAU,CAAC,CAAC;EAC7C;EAEAE,uBAAuBA,CAACC,oBAA0C,EAAE;IAClE,IAAIC,MAAM;IACV,IAAI;MACFA,MAAM,GAAG,IAAAC,8DAA8B,EAACF,oBAAoB,CAAC;IAC/D,CAAC,CAAC,OAAOtB,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYyB,KAAK,EAAE;QACtB,MAAM,IAAIA,KAAK,CAAC,8CAA8CzB,CAAC,CAAC0B,OAAO,EAAE,CAAC;MAC5E;IACF;IAEA,OAAON,oCAAuB,CAACC,uBAAuB,CAACE,MAAM,CAAC;EAChE;EAEAI,eAAeA,CAAA,EAAG;IAChB,OAAOP,oCAAuB,CAACO,eAAe,CAAC,CAAC;EAClD;EAEAC,aAAaA,CAACC,MAAc,EAAE;IAC5B,IAAI,CAACA,MAAM,EAAE,MAAM,IAAIJ,KAAK,CAAC,iEAAiE,CAAC;IAC/FL,oCAAuB,CAACQ,aAAa,CAACC,MAAM,CAAC;EAC/C;EAEAC,YAAYA,CAACC,MAAc,EAAE;IAC3B,IAAIA,MAAM,GAAG,CAAC,IAAIA,MAAM,GAAG,CAAC,EAC1B,MAAM,IAAIN,KAAK,CAAC,2DAA2D,CAAC;IAC9EL,oCAAuB,CAACU,YAAY,CAACC,MAAM,CAAC;EAC9C;EAEAC,WAAWA,CAACC,KAAc,EAAE;IAC1Bb,oCAAuB,CAACY,WAAW,CAACC,KAAK,CAAC;EAC5C;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAI7B,eAAe,CAAC,CAAC;AAExC,MAAM8B,SAAS,GAAGA,CAAA,KAAM;EAC7B,OAAOD,iBAAiB;AAC1B,CAAC;AAACE,OAAA,CAAAD,SAAA,GAAAA,SAAA;AAAA,IAAAE,QAAA,GAAAD,OAAA,CAAAlC,OAAA,GAEaiC,SAAS","ignoreList":[]}

package/lib/commonjs/NativeGoogleMobileAdsModule.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeGoogleMobileAdsModule.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAYpCC,gCAAmB,CAACC,YAAY,CAAO,yBAAyB,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeGoogleMobileAdsModule.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAcpCC,gCAAmB,CAACC,YAAY,CAAO,yBAAyB,CAAC","ignoreList":[]}

package/lib/commonjs/version.js

@@ -5,5 +5,5 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.version = void 0;
 // Generated by genversion.
-const version = exports.version = '14.1.0';
+const version = exports.version = '14.2.0';
 //# sourceMappingURL=version.js.map

package/lib/module/MobileAds.js

@@ -41,6 +41,13 @@ class MobileAdsModule {
     if (!adUnit) throw new Error('googleMobileAds.openDebugMenu expected a non-empty string value');
     RNGoogleMobileAdsModule.openDebugMenu(adUnit);
   }
+  setAppVolume(volume) {
+    if (volume < 0 || volume > 1) throw new Error('The app volume must be a value between 0 and 1 inclusive.');
+    RNGoogleMobileAdsModule.setAppVolume(volume);
+  }
+  setAppMuted(muted) {
+    RNGoogleMobileAdsModule.setAppMuted(muted);
+  }
 }
 const MobileAdsInstance = new MobileAdsModule();
 export const MobileAds = () => {

package/lib/module/MobileAds.js.map

@@ -1 +1 @@
-{"version":3,"names":["RNGoogleMobileAdsModule","validateAdRequestConfiguration","SharedEventEmitter","GoogleMobileAdsNativeEventEmitter","NATIVE_MODULE_EVENT_SUBSCRIPTIONS","nativeEvents","MobileAdsModule","constructor","length","i","len","subscribeToNativeModuleEvent","eventName","addListener","event","emit","adUnitId","requestId","initialize","setRequestConfiguration","requestConfiguration","config","e","Error","message","openAdInspector","openDebugMenu","adUnit","MobileAdsInstance","MobileAds"],"sourceRoot":"../../src","sources":["MobileAds.ts"],"mappings":"AAAA,OAAOA,uBAAuB,MAAM,+BAA+B;AACnE,SAASC,8BAA8B,QAAQ,kCAAkC;AACjF,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,iCAAiC,QAAQ,8CAA8C;AAIhG,MAAMC,iCAA0D,GAAG,CAAC,CAAC;AAErE,MAAMC,YAAY,GAAG,CACnB,kCAAkC,EAClC,sCAAsC,EACtC,kCAAkC,EAClC,+CAA+C,CAChD;AAED,MAAMC,eAAe,CAAqC;EACxDC,WAAWA,CAAA,EAAG;IACZ,IAAIF,YAAY,IAAIA,YAAY,CAACG,MAAM,EAAE;MACvC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEC,GAAG,GAAGL,YAAY,CAACG,MAAM,EAAEC,CAAC,GAAGC,GAAG,EAAED,CAAC,EAAE,EAAE;QACvD,IAAI,CAACE,4BAA4B,CAACN,YAAY,CAACI,CAAC,CAAC,CAAC;MACpD;IACF;EACF;EAEAE,4BAA4BA,CAACC,SAAiB,EAAE;IAC9C,IAAI,CAACR,iCAAiC,CAACQ,SAAS,CAAC,EAAE;MACjDT,iCAAiC,CAACU,WAAW,CAACD,SAAS,EAAEE,KAAK,IAAI;QAChEZ,kBAAkB,CAACa,IAAI,CAAC,GAAGH,SAAS,IAAIE,KAAK,CAACE,QAAQ,IAAIF,KAAK,CAACG,SAAS,EAAE,EAAEH,KAAK,CAAC;MACrF,CAAC,CAAC;MAEFV,iCAAiC,CAACQ,SAAS,CAAC,GAAG,IAAI;IACrD;EACF;EAEAM,UAAUA,CAAA,EAAG;IACX,OAAOlB,uBAAuB,CAACkB,UAAU,CAAC,CAAC;EAC7C;EAEAC,uBAAuBA,CAACC,oBAA0C,EAAE;IAClE,IAAIC,MAAM;IACV,IAAI;MACFA,MAAM,GAAGpB,8BAA8B,CAACmB,oBAAoB,CAAC;IAC/D,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYC,KAAK,EAAE;QACtB,MAAM,IAAIA,KAAK,CAAC,8CAA8CD,CAAC,CAACE,OAAO,EAAE,CAAC;MAC5E;IACF;IAEA,OAAOxB,uBAAuB,CAACmB,uBAAuB,CAACE,MAAM,CAAC;EAChE;EAEAI,eAAeA,CAAA,EAAG;IAChB,OAAOzB,uBAAuB,CAACyB,eAAe,CAAC,CAAC;EAClD;EAEAC,aAAaA,CAACC,MAAc,EAAE;IAC5B,IAAI,CAACA,MAAM,EAAE,MAAM,IAAIJ,KAAK,CAAC,iEAAiE,CAAC;IAC/FvB,uBAAuB,CAAC0B,aAAa,CAACC,MAAM,CAAC;EAC/C;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAItB,eAAe,CAAC,CAAC;AAE/C,OAAO,MAAMuB,SAAS,GAAGA,CAAA,KAAM;EAC7B,OAAOD,iBAAiB;AAC1B,CAAC;AAED,eAAeC,SAAS","ignoreList":[]}
+{"version":3,"names":["RNGoogleMobileAdsModule","validateAdRequestConfiguration","SharedEventEmitter","GoogleMobileAdsNativeEventEmitter","NATIVE_MODULE_EVENT_SUBSCRIPTIONS","nativeEvents","MobileAdsModule","constructor","length","i","len","subscribeToNativeModuleEvent","eventName","addListener","event","emit","adUnitId","requestId","initialize","setRequestConfiguration","requestConfiguration","config","e","Error","message","openAdInspector","openDebugMenu","adUnit","setAppVolume","volume","setAppMuted","muted","MobileAdsInstance","MobileAds"],"sourceRoot":"../../src","sources":["MobileAds.ts"],"mappings":"AAAA,OAAOA,uBAAuB,MAAM,+BAA+B;AACnE,SAASC,8BAA8B,QAAQ,kCAAkC;AACjF,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,iCAAiC,QAAQ,8CAA8C;AAIhG,MAAMC,iCAA0D,GAAG,CAAC,CAAC;AAErE,MAAMC,YAAY,GAAG,CACnB,kCAAkC,EAClC,sCAAsC,EACtC,kCAAkC,EAClC,+CAA+C,CAChD;AAED,MAAMC,eAAe,CAAqC;EACxDC,WAAWA,CAAA,EAAG;IACZ,IAAIF,YAAY,IAAIA,YAAY,CAACG,MAAM,EAAE;MACvC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEC,GAAG,GAAGL,YAAY,CAACG,MAAM,EAAEC,CAAC,GAAGC,GAAG,EAAED,CAAC,EAAE,EAAE;QACvD,IAAI,CAACE,4BAA4B,CAACN,YAAY,CAACI,CAAC,CAAC,CAAC;MACpD;IACF;EACF;EAEAE,4BAA4BA,CAACC,SAAiB,EAAE;IAC9C,IAAI,CAACR,iCAAiC,CAACQ,SAAS,CAAC,EAAE;MACjDT,iCAAiC,CAACU,WAAW,CAACD,SAAS,EAAEE,KAAK,IAAI;QAChEZ,kBAAkB,CAACa,IAAI,CAAC,GAAGH,SAAS,IAAIE,KAAK,CAACE,QAAQ,IAAIF,KAAK,CAACG,SAAS,EAAE,EAAEH,KAAK,CAAC;MACrF,CAAC,CAAC;MAEFV,iCAAiC,CAACQ,SAAS,CAAC,GAAG,IAAI;IACrD;EACF;EAEAM,UAAUA,CAAA,EAAG;IACX,OAAOlB,uBAAuB,CAACkB,UAAU,CAAC,CAAC;EAC7C;EAEAC,uBAAuBA,CAACC,oBAA0C,EAAE;IAClE,IAAIC,MAAM;IACV,IAAI;MACFA,MAAM,GAAGpB,8BAA8B,CAACmB,oBAAoB,CAAC;IAC/D,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYC,KAAK,EAAE;QACtB,MAAM,IAAIA,KAAK,CAAC,8CAA8CD,CAAC,CAACE,OAAO,EAAE,CAAC;MAC5E;IACF;IAEA,OAAOxB,uBAAuB,CAACmB,uBAAuB,CAACE,MAAM,CAAC;EAChE;EAEAI,eAAeA,CAAA,EAAG;IAChB,OAAOzB,uBAAuB,CAACyB,eAAe,CAAC,CAAC;EAClD;EAEAC,aAAaA,CAACC,MAAc,EAAE;IAC5B,IAAI,CAACA,MAAM,EAAE,MAAM,IAAIJ,KAAK,CAAC,iEAAiE,CAAC;IAC/FvB,uBAAuB,CAAC0B,aAAa,CAACC,MAAM,CAAC;EAC/C;EAEAC,YAAYA,CAACC,MAAc,EAAE;IAC3B,IAAIA,MAAM,GAAG,CAAC,IAAIA,MAAM,GAAG,CAAC,EAC1B,MAAM,IAAIN,KAAK,CAAC,2DAA2D,CAAC;IAC9EvB,uBAAuB,CAAC4B,YAAY,CAACC,MAAM,CAAC;EAC9C;EAEAC,WAAWA,CAACC,KAAc,EAAE;IAC1B/B,uBAAuB,CAAC8B,WAAW,CAACC,KAAK,CAAC;EAC5C;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAI1B,eAAe,CAAC,CAAC;AAE/C,OAAO,MAAM2B,SAAS,GAAGA,CAAA,KAAM;EAC7B,OAAOD,iBAAiB;AAC1B,CAAC;AAED,eAAeC,SAAS","ignoreList":[]}

package/lib/module/NativeGoogleMobileAdsModule.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeGoogleMobileAdsModule.ts"],"mappings":"AACA,SAASA,mBAAmB,QAAQ,cAAc;AAYlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,yBAAyB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeGoogleMobileAdsModule.ts"],"mappings":"AACA,SAASA,mBAAmB,QAAQ,cAAc;AAclD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,yBAAyB,CAAC","ignoreList":[]}

package/lib/module/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '14.1.0';
+export const version = '14.2.0';
 //# sourceMappingURL=version.js.map

package/lib/typescript/MobileAds.d.ts

@@ -7,6 +7,8 @@ declare class MobileAdsModule implements MobileAdsModuleInterface {
     setRequestConfiguration(requestConfiguration: RequestConfiguration): Promise<void>;
     openAdInspector(): Promise<void>;
     openDebugMenu(adUnit: string): void;
+    setAppVolume(volume: number): void;
+    setAppMuted(muted: boolean): void;
 }
 export declare const MobileAds: () => MobileAdsModule;
 export default MobileAds;

package/lib/typescript/MobileAds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileAds.d.ts","sourceRoot":"","sources":["../../src/MobileAds.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAWpE,cAAM,eAAgB,YAAW,wBAAwB;;IASvD,4BAA4B,CAAC,SAAS,EAAE,MAAM;IAU9C,UAAU;IAIV,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB;IAalE,eAAe;IAIf,aAAa,CAAC,MAAM,EAAE,MAAM;CAI7B;AAID,eAAO,MAAM,SAAS,uBAErB,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"MobileAds.d.ts","sourceRoot":"","sources":["../../src/MobileAds.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAWpE,cAAM,eAAgB,YAAW,wBAAwB;;IASvD,4BAA4B,CAAC,SAAS,EAAE,MAAM;IAU9C,UAAU;IAIV,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB;IAalE,eAAe;IAIf,aAAa,CAAC,MAAM,EAAE,MAAM;IAK5B,YAAY,CAAC,MAAM,EAAE,MAAM;IAM3B,WAAW,CAAC,KAAK,EAAE,OAAO;CAG3B;AAID,eAAO,MAAM,SAAS,uBAErB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/typescript/NativeGoogleMobileAdsModule.d.ts

@@ -6,6 +6,8 @@ export interface Spec extends TurboModule {
     setRequestConfiguration(requestConfiguration?: UnsafeObject): Promise<void>;
     openAdInspector(): Promise<void>;
     openDebugMenu(adUnit: string): void;
+    setAppVolume(volume: number): void;
+    setAppMuted(muted: boolean): void;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/NativeGoogleMobileAdsModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeGoogleMobileAdsModule.d.ts","sourceRoot":"","sources":["../../src/NativeGoogleMobileAdsModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACvC,uBAAuB,CAAC,oBAAoB,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;;AAED,wBAAiF"}
+{"version":3,"file":"NativeGoogleMobileAdsModule.d.ts","sourceRoot":"","sources":["../../src/NativeGoogleMobileAdsModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACvC,uBAAuB,CAAC,oBAAoB,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;;AAED,wBAAiF"}

package/lib/typescript/index.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "14.1.0";
+export declare const SDK_VERSION = "14.2.0";
 export { default, MobileAds } from './MobileAds';
 export { AdsConsentDebugGeography } from './AdsConsentDebugGeography';
 export { AdsConsentPurposes } from './AdsConsentPurposes';

package/lib/typescript/types/MobileAdsModule.interface.d.ts

@@ -45,5 +45,31 @@ export interface MobileAdsModuleInterface {
      * @param adUnit Any valid ad unit from your Ad Manager account is sufficient to open the debug options menu.
      */
     openDebugMenu(adUnit: string): void;
+    /**
+     * Sets the application's audio volume. Affects audio volumes of all ads relative to other audio output.
+     *
+     * Warning: Lowering your app's audio volume reduces video ad eligibility and may reduce your app's ad revenue.
+     * You should only utilize this API if your app provides custom volume controls to the user, and you should reflect
+     * the user's volume choice in this API.
+     *
+     * @see https://developers.google.com/ad-manager/mobile-ads-sdk/android/global-settings
+     * @see https://developers.google.com/ad-manager/mobile-ads-sdk/ios/global-settings
+     *
+     * @param volume the volume as a float from 0 (muted) to 1.0 (full media volume). Defaults to 1.0
+     */
+    setAppVolume(volume: number): void;
+    /**
+     * Indicates whether the application's audio is muted. Affects initial mute state for all ads.
+     *
+     * Warning: Muting your application reduces video ad eligibility and may reduce your app's ad revenue.
+     * You should only utilize this API if your app provides a custom mute control to the user, and you should
+     * reflect the user's mute decision in this API.
+     *
+     * @see https://developers.google.com/ad-manager/mobile-ads-sdk/android/global-settings
+     * @see https://developers.google.com/ad-manager/mobile-ads-sdk/ios/global-settings
+     *
+     * @param muted true if the app is muted, false otherwise. Defaults to false.
+     */
+    setAppMuted(muted: boolean): void;
 }
 //# sourceMappingURL=MobileAdsModule.interface.d.ts.map

package/lib/typescript/types/MobileAdsModule.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileAdsModule.interface.d.ts","sourceRoot":"","sources":["../../../src/types/MobileAdsModule.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEvC;;;;;;;;;;;;;;;OAeG;IACH,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF;;;;;;;OAOG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC"}
+{"version":3,"file":"MobileAdsModule.interface.d.ts","sourceRoot":"","sources":["../../../src/types/MobileAdsModule.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEvC;;;;;;;;;;;;;;;OAeG;IACH,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF;;;;;;;OAOG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC"}

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "14.1.0";
+export declare const version = "14.2.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-google-mobile-ads",
-  "version": "14.1.0",
+  "version": "14.2.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Google Mobile Ads is an easy way to monetize mobile apps with targeted, in-app advertising.",
   "main": "lib/commonjs/index.js",

package/src/MobileAds.ts

@@ -58,6 +58,16 @@ class MobileAdsModule implements MobileAdsModuleInterface {
     if (!adUnit) throw new Error('googleMobileAds.openDebugMenu expected a non-empty string value');
     RNGoogleMobileAdsModule.openDebugMenu(adUnit);
   }
+
+  setAppVolume(volume: number) {
+    if (volume < 0 || volume > 1)
+      throw new Error('The app volume must be a value between 0 and 1 inclusive.');
+    RNGoogleMobileAdsModule.setAppVolume(volume);
+  }
+
+  setAppMuted(muted: boolean) {
+    RNGoogleMobileAdsModule.setAppMuted(muted);
+  }
 }
 
 const MobileAdsInstance = new MobileAdsModule();

package/src/NativeGoogleMobileAdsModule.ts

@@ -9,6 +9,8 @@ export interface Spec extends TurboModule {
   setRequestConfiguration(requestConfiguration?: UnsafeObject): Promise<void>;
   openAdInspector(): Promise<void>;
   openDebugMenu(adUnit: string): void;
+  setAppVolume(volume: number): void;
+  setAppMuted(muted: boolean): void;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('RNGoogleMobileAdsModule');

package/src/types/MobileAdsModule.interface.ts

@@ -49,4 +49,32 @@ export interface MobileAdsModuleInterface {
    * @param adUnit Any valid ad unit from your Ad Manager account is sufficient to open the debug options menu.
    */
   openDebugMenu(adUnit: string): void;
+
+  /**
+   * Sets the application's audio volume. Affects audio volumes of all ads relative to other audio output.
+   *
+   * Warning: Lowering your app's audio volume reduces video ad eligibility and may reduce your app's ad revenue.
+   * You should only utilize this API if your app provides custom volume controls to the user, and you should reflect
+   * the user's volume choice in this API.
+   *
+   * @see https://developers.google.com/ad-manager/mobile-ads-sdk/android/global-settings
+   * @see https://developers.google.com/ad-manager/mobile-ads-sdk/ios/global-settings
+   *
+   * @param volume the volume as a float from 0 (muted) to 1.0 (full media volume). Defaults to 1.0
+   */
+  setAppVolume(volume: number): void;
+
+  /**
+   * Indicates whether the application's audio is muted. Affects initial mute state for all ads.
+   *
+   * Warning: Muting your application reduces video ad eligibility and may reduce your app's ad revenue.
+   * You should only utilize this API if your app provides a custom mute control to the user, and you should
+   * reflect the user's mute decision in this API.
+   *
+   * @see https://developers.google.com/ad-manager/mobile-ads-sdk/android/global-settings
+   * @see https://developers.google.com/ad-manager/mobile-ads-sdk/ios/global-settings
+   *
+   * @param muted true if the app is muted, false otherwise. Defaults to false.
+   */
+  setAppMuted(muted: boolean): void;
 }

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '14.1.0';
+export const version = '14.2.0';