cordova.plugin.zoom

4.6.2166-6.603 • Public • Published

Zoom Ionic SDK for Ionic Angular

Note: This is a community project initiated by Zoom. Zoom does not actively enhance the interfaces in the Ionic plugin. If you would like to contribute, please contact us or submit a pull request. Thanks! :)

Table of Contents

🚨 Announcement 🚨

To align with Zoom’s recent announcement pertaining to our security initiative, Zoom Client SDKs have added AES 256-bit GCM encryption support, which provides more protection for meeting data and greater resistance to tampering. The system-wide account enablement of AES 256-bit GCM encryption will take place on June 01, 2020. You are strongly recommended to start the required upgrade to this latest version 4.6.21666.0512 at your earliest convenience. Please note that any Client SDK versions below 4.6.21666.0512 will no longer be operational from June 01.

If you would like to test the latest SDK with AES 256-bit GCM encryption meeting before 05/30, you may:

  1. Download the latest version of Zoom client: https://zoom.us/download
  2. Visit https://zoom.us/testgcm and launch a GCM enabled meeting with your Zoom client, you will see a Green Shield icon that indicates the GCM encryption is enabled
  3. Use SDK to join this meeting

Latest SDK Notifications

  1. Please note that our Ionic SDK only support Ionic Angular.

Full Documentation && Community Support

You can find the full Zoom Ionic SDK documentation and the community support forum here:

What is Zoom Ionic SDK?

Zoom SDK makes it easy to integrate Zoom with your mobile applications, and boosts up your applications with the power of Zoom.

  • Easy to use: Our SDK is built to be easy to use. Just import the libraries, call a few functions, and we will take care all video conferencing related stuffs for you.
  • Localizable: Our SDK naturally supports 7 major languages, so you can grow your applications internationally.

Disclaimer

Please be aware that all hard-coded variables and constants shown in the documentation and in the demo, such as Zoom Token, Zoom Access, Token, etc., are ONLY FOR DEMO AND TESTING PURPOSES. We STRONGLY DISCOURAGE the way of HARDCODING any Zoom Credentials (username, password, API Keys & secrets, SDK keys & secrets, etc.) or any Personal Identifiable Information (PII) inside your application. WE DON’T MAKE ANY COMMITMENTS ABOUT ANY LOSS CAUSED BY HARD-CODING CREDENTIALS OR SENSITIVE INFORMATION INSIDE YOUR APP WHEN DEVELOPING WITH OUR SDK.

Getting Started

The following instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

Before you try out our SDK, you would need the following to get started:

  • A Zoom Account: If you do not have one, you can sign up at https://zoom.us/signup.
  • A mobile device
    • Android
      • Android 5.0 (API Level 21) or later.
      • CPU: armeabi-v7a, x86, armeabi, arm64-v8a, x86_64
      • compileSdkVersion: 29+
      • buildToolsVersion: 29+
      • minSdkVersion: 21
      • Required dependencies
      implementation 'androidx.multidex:multidex:2.0.0'
      implementation 'androidx.recyclerview:recyclerview:1.0.0'
      implementation 'androidx.appcompat:appcompat:1.0.0'
      implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
      implementation 'com.google.android.material:material:1.0.0-rc01'
      
    • iOS
      • iPhone or iPad
      • npm@6.13.4+
      • ionic-cli@6.9.0+
      • ionic/angular@5.0.0+
      • ionic-native/core@5.25.0+
      • ionic-native/zoom@5.25.0+

If you are developing on Android, you will need to install the latest version of cordova-android

ionic cordova platform add android@8.0.0+

and install the following 2 plugins before you can use the Ionic SDK:

ionic cordova plugin add cordova-plugin-androidx
ionic cordova plugin add cordova-plugin-androidx-adapter

Installing

Clone or download a copy of our SDK files from GitHub. After you unzipped the file, you should have the following folders:

.
├── README.md
├── libs
├── package.json
├── plugin.xml
├── src
└── www

In your Ionic application directory, run the following to install the plugin:

ionic cordova plugin add cordova.plugin.zoom

Usage

  1. Import the plugin
import { Zoom } from '@ionic-native/zoom';

constructor(private zoomService: Zoom) { }

1. Initialize Zoom SDK Initialize Zoom SDK, need to be called when app fired up.

this.zoomService.initialize(API_KEY, API_SECRET)
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));
  1. Login Log user in with Zoom username and password.
this.zoomService.login(userName, password)
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));
  1. Logout Log user out.
this.zoomService.logout()
  .then((success: boolean) => console.log(success))
  .catch((error: any) => console.log(error));
  1. isLoggedIn Check whether a user is logged in. Return true if the user is logged in. False if the user is not logged in.
this.zoomService.isLoggedIn()
  .then((success: boolean) => console.log(success))
  .catch((error: any) => console.log(error));
  1. MeetingOptions Meeting options. Configure the default meeting room. Some of the options are only available on Android.
let options = {
  custom_meeting_id: "Customized Title",
  no_share: false,
  no_audio: false,
  no_video: false,
  no_driving_mode: true,
  no_invite: true,
  no_meeting_end_message: true,
  no_dial_in_via_phone: false,
  no_dial_out_to_phone: false,
  no_disconnect_audio: true,
  no_meeting_error_message: true,
  no_unmute_confirm_dialog: true,    // Android only
  no_webinar_register_dialog: false, // Android only
  no_titlebar: false,
  no_bottom_toolbar: false,
  no_button_video: false,
  no_button_audio: false,
  no_button_share: false,
  no_button_participants: false,
  no_button_more: false,
  no_text_password: true,
  no_text_meeting_id: false,
  no_button_leave: false
 };
  1. Join Meeting Join meeting
this.zoomService.joinMeeting(meetingNumber, meetingPassword, displayName, options)
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));
  1. Start an existing meeting for non-login user Start an existing meeting for non-login user.
this.zoomService.startMeetingWithZAK(meetingNumber, vanityId, displayName, zoomToken, zoomAccessToken, userId, options)
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));
  1. Start an existing meeting for logged in user Start an existing meeting for logged in user.
this.zoomService.startMeeting(meetingNumber, vanityId, options)
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));
  1. Start an instant meeting for logged in user Start an instant meeting for logged in user.
this.zoomService.startInstantMeeting()
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));
  1. Set language Change in-meeting language.
this.zoomService.setLanguage("en-US")
  .then((success: any) => console.log(success))
  .catch((error: any) => console.log(error));

Supported Languages and Parameters The parameters are unified using IETF BCP 47 (https://tools.ietf.org/html/bcp47).

Language Language Tag / Parameter
English en-US
Simplified Chinese zh-CN
Japanese ja-JP
German de-DE
French fr-FR
Traditional Chinese zh-TW
Spanish es-419
Russian ru-RU
Portuguese pt-PT

Build Note

In order to use the camera and microphone on iOS, please add the following in your config.xml file. Otherwise, your app will not be able to initialize a meeting.

<edit-config file="*-Info.plist" mode="merge" target="NSCameraUsageDescription">
    <string>Need camera for video conferencing</string>
</edit-config>
<edit-config file="*-Info.plist" mode="merge" target="NSMicrophoneUsageDescription">
    <string>Need microphone for video conferencing</string>
</edit-config>

Simulator Support

By default, this plugin only support running on real devices. Since 4.4.55130.0712, we have introduced the simulator support. Here are the steps to add simulator support:

  1. Install the Zoom Ionic SDK plugin
ionic cordova plugin add cordova.plugin.zoom
  1. Navigate to appRoot/plugins/cordova.plugin.zoom, and back up the whole libs folder.
  2. Go to https://github.com/zoom/zoom-sdk-ionic/tags and download the ionic-zoomsdk-***.zip file; Unzipp it.
  3. Replace the libs folder in appRoot/plugins/cordova.plugin.zoom with the one in the ionic-zoomsdk-*** folder.
  4. Run ionic cordova platfrom rm android && ionic cordova platform add android or ionic cordova platform rm ios && ionic cordova platform add ios to make sure the new libraries are added to the project.
  5. If you are going to publish your app to the Google Play Store or Apple App Store, please use the original libs since a library that contians simulator architecture will not pass the app upload check.

Documentation

Please visit [https://marketplace.zoom.us/docs/sdk/hybrid-frameworks/ionic] for details of each features and functions.

Versioning

For the versions available, see the tags on this repository.

Change log

Please refer to our CHANGELOG for all changes.

Support

For any issues regarding our SDK, please visit our new Community Support Forum at https://devforum.zoom.us/.

License

Please refer to LICENSE.md file for details

Acknowledgments

  • ⭐️ If you like our SDK, please give us a "Star". Your support is what keeps us moving forward and delivering happiness to you! Thanks a million! 😃
  • If you need any support or assistance, we are here to help you: Zoom Developer Community Forum;

Copyright ©2019 Zoom Video Communications, Inc. All rights reserved.

Package Sidebar

Install

npm i cordova.plugin.zoom

Weekly Downloads

97

Version

4.6.2166-6.603

License

ISC

Unpacked Size

158 MB

Total Files

1176

Last publish

Collaborators

  • carsonzoom