react-native-zoom-us

This is a bridge for ZoomUS SDK:

Platform	Version	Url	Changelog
iOS	5.5.12511.0421	https://github.com/zoom/zoom-sdk-ios	https://marketplace.zoom.us/docs/changelog#labels/client-sdk-i-os
Android	5.0.24433.0616	https://github.com/zoom/zoom-sdk-android	https://marketplace.zoom.us/docs/changelog#labels/client-sdk-android

Tested on XCode 12.4 and react-native 0.64.0. (See details)

Pull requests are welcome.

Getting started

$ npm install react-native-zoom-us

Installation

If you have react-native < 0.60, check Full Linking Guide

Android

Add repository to android/build.gradle:

allprojects {
    repositories {
        flatDir {
            dirs "$rootDir/../node_modules/react-native-zoom-us/android/libs"
        }
    }
}

Set minSdkVersion to 21

buildscript {
    ext {
        minSdkVersion = 21
    }
}

See diff for reference.

Optional: Add custom activity config (android/app/src/main/res/values/config.xml)

If you have custom conference activity, instead official activity or custom UI.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="zm_config_conf_activity">ID of your custom activity</string>
</resources>

See docs for more details.

iOS

Make sure you have appropriate description in Info.plist:

<key>NSBluetoothPeripheralUsageDescription</key>
<string>We will use your Bluetooth to access your Bluetooth headphones.</string>
	
<key>NSCameraUsageDescription</key>
<string>For people to see you during meetings, we need access to your camera.</string>
	
<key>NSMicrophoneUsageDescription</key>
<string>For people to hear you during meetings, we need access to your microphone.</string>
	
<key>NSPhotoLibraryUsageDescription</key>
<string>For people to share, we need access to your photos.</string>

Update pods using cd ios/ && pod install && cd ..
Make sure to set ENABLE_BITCODE = NO; for both Debug and Release because bitcode is not supported by Zoom iOS SDK
Optional: Implement custom UI See docs for more details.

Usage

import ZoomUs from 'react-native-zoom-us';

// initialize minimal
await ZoomUs.initialize({
  clientKey: '...',
  clientSecret: '...',
})

// initialize using JWT
await ZoomUs.initialize({
  jwtToken: '...',
})

// initialize with extra config
await ZoomUs.initialize({
  clientKey: '...',
  clientSecret: '...',
  domain: 'zoom.us'
}, {
  disableShowVideoPreviewWhenJoinMeeting: true,
  enableCustomizedMeetingUI: true
})


// Start Meeting
await ZoomUs.startMeeting({
  userName: 'Johny',
  meetingNumber: '12345678',
  userId: 'our-identifier',
  zoomAccessToken: zak,
  userType: 2, // optional
})


// Join Meeting
await ZoomUs.joinMeeting({
  userName: 'Johny',
  meetingNumber: '12345678',
})

// Join Meeting with extra params
await ZoomUs.joinMeeting({
  userName: 'Johny',
  meetingNumber: '12345678',
  password: '1234',
  participantID: 'our-unique-id',
  noAudio: true,
  noVideo: true,
})

// Leave Meeting
await ZoomUs.leaveMeeting()

// Connect Audio
await ZoomUs.connectAudio()
// you can also use autoConnectAudio: true in `ZoomUs.joinMeeting`

Docs

Testing

The plugin has been tested for joinMeeting using [smoke test procedure]https://github.com/mieszko4/react-native-zoom-us-test#smoke-test-procedure:

react-native-zoom-us: 5.8.3
react-native: 0.64.0
node: 14.16.0
macOS: 10.15.5
XCode: 12.4
android minSdkVersion: 21

FAQ

Does library support Expo?

You have to eject your expo project to use this library.

ajithvgiri/react-native-zoom-us