/app-2jul2021

Primary LanguageTypeScriptOtherNOASSERTION

Zoom Ionic SDK sample app

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. Thanks! :)

Latest SDK Notifications

  1. Our brand new Zoom Developer Community Forum is now online!!! Check it out! We are here to help! :D

Full Documentation && Community Support

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

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 4.0 (API Level 14) or later.
    • iOS

      • iPhone or iPad
      • npm@6.7.0+
      • ionic-cli@5.2.3+
      • ionic/angular@4.1.0+
      • ionic-native/core@5.8.0+
      • ionic-native/zoom@5.8.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 demo app from GitHub. After you unzipped the file, you should have the following folders:

.
├── README.md
├── config.xml
├── ionic.config.json
├── package-lock.json
├── package.json
├── resources
├── src
├── tsconfig.json
├── tslint.json
└── www

In your Ionic application directory:

  1. Install the dependencies and platforms:
npm install
npm install @ionic-native/zoom #(Optional) if not successfully installed automatically with package.json
ionic cordova platform add android@8.0.0+
ionic cordova platform add ios
  1. run the following to install the plugin:
ionic cordova plugin add cordova-plugin-androidx
ionic cordova plugin add cordova-plugin-androidx-adapter

ionic cordova plugin add cordova.plugin.zoom
  1. Run the application:
ionic cordova run android
ionic cordova run ios

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. If you would like to develop and test with Android or iOS simulators, please visit https://github.com/zoom/zoom-sdk-ionic for more details.

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.