This Ionic Capacitor plugin is created to make video calls through the free, open-sourced Jitsi video platform (https://meet.jit.si) on iOS and Android.
| Capacitor | capacitor-jitsi-meet | supported |
|---|---|---|
| v3 | >= 2.0.0 | current |
| v2 | <= 1.5.14 | until Sept 30, 2021 |
| v1 | <= 1.3.6 | until June 30, 2020 |
Follow the official Capacitor doc to upgrade to Capacitor 3.
See the plugin changelog for plugin versions that are compatible to your local Xcode version.
This plugin does not currently support web implementation. We recommend using the Jitsi iFrame API (https://jitsi.github.io/handbook/docs/dev-guide/dev-guide-iframe) for full web implementation.
-
npm install capacitor-jitsi-meet
-
use it as a Capacitor Plugin
// On Capacitor 3
import { Jitsi } from 'capacitor-jitsi-meet';
// On Capacitor 1 and 2
import { Plugins } from '@capacitor/core';
import 'capacitor-jitsi-meet';
const { Jitsi } = Plugins;const result = await Jitsi.joinConference({
// required parameters
roomName: 'room1', // room identifier for the conference
url: 'https://meet.jit.si', // endpoint of the Jitsi Meet video bridge
// recommended settings for production build. see full list of featureFlags in the official Jitsi Meet SDK documentation
featureFlags: {
'recording.enabled': false, // disable as it requires Dropbox integration
'live-streaming.enabled': false, // 'sign in on Google' button not yet functional
'android.screensharing.enabled': false // experimental feature, not fully production ready
},
// optional parameters
subject: string, // name of the video room
displayName: string, // user's display name
email: string, // user's email
avatarURL: string, // user's avatar url
startWithAudioMuted: true, // start with audio muted, default: false
startWithVideoMuted: false, // start with video muted, default: false
chatEnabled: false, // enable Chat feature, default: true
inviteEnabled: false, // enable Invitation feature, default: true
// advanced parameters (optional)
token: string, // jwt authentication token
configOverrides: { 'p2p.enabled': false }, // see list of config overrides in the official Jitsi Meet SDK documentation
// advanced settings to be deprecated in 3.0. Use featureFlags and configOverrides instead
callIntegrationEnabled: true, // enable call integration (CallKit on iOS, ConnectionService on Android)
liveStreamingEnabled: false, // enable live streaming feature
recordingEnabled: false, // (experimental) enable recording feature
screenSharingEnabled: false, // (experimental) enable screen sharing feature
});
console.log(result) // { success: true }
window.addEventListener('onConferenceJoined', () => {
// do things here
});
window.addEventListener('onConferenceLeft', () => {
// do things here
});
const result = await Jitsi.leaveConference()
console.log(result) // { success: true }- Build the project
$ npm run build
This plugin uses the Jitsi Meet SDK. See the Jitsi Meet SDK documentation, and the lists of feature flags and config overrides.
You can see a React Demo App which runs the Jitsi meeting on the Android device
For feature requests, create an issue with a label 'feature request'. I also offer paid consultation services, such as SDK UI customization, and helping you implement the Picture-in-Picture mode of the video view. To submit a request, create an issue and add the label 'sdk customization' or 'pip implementation'.
This plugin enables web and mobile apps to implement video conferencing feature for free. The Jitsi Meet mobile SDKs are actively maintained by Jitsi. Video bridges for multi-user video conferencing is powered by Jitsi Meet, or you can run your own video bridge.