Skip to content

Latest commit

 

History

History
87 lines (54 loc) · 3.37 KB

README.md

File metadata and controls

87 lines (54 loc) · 3.37 KB

Agora-RTC-SDK-for-Electron npm packageMac Build StatusWindows Build status

The Agora-RTC-SDK-for-Electron is an open-source wrapper for Electron developers. This SDK takes advantage of Node.js C++ Addons and Agora RTC SDKs on Windows/macOS.

其他语言版本: 简体中文

Quick Start

Attention to Changelog for newest information

You can directly install the sdk through npm:

# install newest sdk and we will download prebuilt binary file for you
npm install agora-electron-sdk
import AgoraRtcEngine from 'agora-electron-sdk'

Switch prebuilt addon version in .npmrc (default to use 1.8.3)

# range(1.8.3, <3.0.0) will download a prebuilt addon built with electron 1.8.3
AGORA_ELECTRON_DEPENDENT=2.0.0
# or
# range(>=3.0.0) will download a prebuilt addon built with electron 3.0.6
AGORA_ELECTRON_DEPENDENT=3.0.6
# or
# range(= 4.0.0) will download a prebuilt addon built with electron 4.0.0
AGORA_ELECTRON_DEPENDENT=4.0.0

Resources

Prerequisites

  • Node.js 6.9.1+

  • Electron 1.8.3+

How to develop

Assuming that you have Node installed and can use npm in command line.

  • Run npm install to install dependency

  • Usually it will trigger npm run download, or you can run it manually.

  • If you want to debug with xcode/visual studio, run npm run debug to generate the project file and sdk for debug env.

Find more scripts in package.json

Notice:

  • Must create a developer account at Agora.io, when you want to use Agora APIs.

  • For macOS, please always use the latest Xcode.

  • For Windows, if Visual Studio or Electron version are not the same as in script, change the corresponding parameters in the script. Electron 1.8.3+ needs Visual Studio 2015 or above. And you have to install a 32-bit electron by npm install -D --arch=ia32 electron

  • For more information about develop environment, visit node-gyp for help.

Contributions Welcome

We are still opmizing our project, welcome for pr and issules.

License

The MIT License (MIT).