@daily-co/config-plugin-rn-daily-js

Expo is an open-source framework for apps that run natively on Android, iOS, and the web.

This project cannot be used with an Expo Go app because it requires custom native code. Follow the steps in the article on how to make your own development build or prebuild your native projects.

This plugin will automatically configure your native code when it's generated (e.g. with npx expo prebuild) so that it can be used with react-native-daily-js.

Versioning

Ensure you use versions that work together!

expo	@daily-co/react-native-webrtc	@config-plugins/react-native-webrtc	@daily-co/react-native-daily-js	@daily-co/config-plugin-rn-daily-js
53.x	124.0.6-daily.1	-	0.81.0	0.0.10
53.x	118.0.3-daily.2	-	0.76.0	0.0.9
52.x	118.0.3-daily.2	10.0.0	0.76.0	0.0.8
52.x	118.0.3-daily.2	10.0.0	0.70.0	0.0.7
51.x	118.0.3-daily.2	9.0.0	0.64.0	0.0.6
50.x	118.0.3-daily.2	8.0.0	0.59.0	0.0.5
49.x	111.0.0-daily.2	7.0.0	0.49.0	0.0.3
48.x	111.0.0-daily.1	6.0.0	0.43.0	0.0.2
47.x	1.94.1-daily.8	5.0.0	0.36.0	0.0.1

IMPORTANT: Starting with version 0.0.9, you no longer need to install @config-plugins/react-native-webrtc. You only need to install @daily-co/config-plugin-rn-daily-js.

Expo installation

Tested against Expo SDK 47 This package cannot be used in the "Expo Go" app because it requires custom native code.

Install react-native-daily-js dependencies

Install the react-native-daily-js dependencies as mentioned here.

npm i @daily-co/react-native-daily-js @react-native-async-storage/async-storage@^1.15.7 react-native-background-timer@^2.3.1 expo-random@^13.6.0 react-native-get-random-values@^1.10.0
npm i --save-exact @daily-co/[email protected]

Install Expo config plugins

npm i @config-plugins/react-native-webrtc @daily-co/config-plugin-rn-daily-js

After installing these packages, add the config plugin to the plugins array of your app.json or app.config.js.

• For iOS you also need to add the voip background permission.

{
  "expo": {
    "ios": {
      "infoPlist": {
        "UIBackgroundModes": [
          "voip"
        ]
      }
    },
    "plugins": [
      [
        "@daily-co/config-plugin-rn-daily-js",
        {
          "enableCamera": true,
          "enableMicrophone": true,
          "enableScreenShare": true
        }
      ],
      [
        "expo-build-properties",
        {
          "android": {
            "minSdkVersion": 24
          },
          "ios": {
            "deploymentTarget": "13.0"
          }
        }
      ]
    ]
  }
}

Screen Sharing Support

Starting with version 0.0.8, the @daily-co/config-plugin-rn-daily-js plugin now supports screen sharing on iOS via the ScreenCaptureExtension.

How to Enable

To enable screen sharing, add the plugin to your app.json with the enableScreenShare property set to true:

[
  "@daily-co/config-plugin-rn-daily-js",
  {
    "enableScreenShare": true
  }
]

If enableScreenShare is not set or is false, the plugin will not attempt to create the ScreenCaptureExtension.

The App Group ID used for screen sharing will follow this format:

• group.<your_app_bundle_identifier>

It only works with v0.0.8 or above.

Expo build

After installing all the dependencies, rebuild your app as described in the "Adding custom native code" guide.

Extra customization

The @config-plugins/react-native-webrtc provides props for extra customization, for instance, to define the camera and microphone permissions prompt messages. See the plugin API to learn more.

Troubleshooting

Super expression must either be null or a function

• This issue may happen when using Expo 50 and @daily-co/react-native-webrtc 118.
• event-target-shim version must match the same one requested by @daily-co/react-native-webrtc: "event-target-shim": "6.0.2".
• You can check inside package-lock.json to be sure you are using the right version.
• If your version of event-target-shim doesn't match the one requested by @daily-co/react-native-webrtc, you can try to update running the following: npm update event-target-shim