RTCMultiConnection Docs

Write iOS apps using RTCMultiConnection

HOME © Muaz Khan . @WebRTCWeb . Github . Latest issues . What's New?

All RTCMultiConnection Demos has their equivalent (open-sourced) apps for both platforms: Android and iOS.

Development Environment Prerequisites

  1. MacOSX 10.11 or higher
  2. XCode 7.3 or higher
  3. iOS 9.2 (DO NOT use any other version)
Please also check: iOS platform prerequisites Or check if your system is ready

Cordova Prerequisites

Install Cordova:

npm install -g cordova

Check if your system is ready

cordova requirements

Above command will/should display a result similar to this:

Apple OS X: installed darwin ---- OSX should be 10.11 or higher
Xcode: installed 7.3         ---- MUST always be 7.3
ios-deploy: installed 1.8.4  ---- optional
ios-sim: installed 5.0.6     ---- optional
Please make sure to re-install the prerequisites if you get different result.

Download Open-Sourced Cordova Apps

Download any HTML-demo-file from this page and search for "blockquote". You will find a link to download the open-sourced app/codes.

Example demo file: github/Scalable-Broadcast.html#L113

Download & extract the mobile-app's ZIP file.

Modify Config.xml

"Config.xml" file will have following information:

<?xml version='1.0' encoding='utf-8'?>
<widget id="com.webrtc.scalablebroadcast" version="3.0.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
    <name>Scalable-Broadcast</name>
    <icon src="www/img/icon.png" />
</widget>

Please mdofiy following XML attributes:

  1. "id" attribute: It should be something like this:
    <widget id="com.yourdomain">
    
  2. "name" attribute: Name should NOT have spaces or special characters. Consider it as a "username":
    <name>yourAppName</name>
    
  3. "icon" attribute: You can replace "icon.png" file with your own app-icon.

Re-Add Cordova-based iOS platform

# first of all, remove old iOS platforms
cordova platform remove ios

# strongly recommended version: 3.9.2
# please NEVER use any newer version

cordova platform add ios@3.9.2 --save
It will re-generate iOS prerequisites according to your app's new name, id, and icon. (things that you modifed in the config.xml file)

Build iOS App

cordova build ios
Now go to "platforms/ios/build/emulator" and you will find the iOS app.

Test on Emulator

cordova emulate ios

Test on a Real iPhone device

  1. (Using USB cable) Plugin your iPhone (6p or 7) device to your MacBook
  2. Open XCode and click "Generic iOS Device" from the tool-bar
  3. Select your real iPhone device
  4. Click "Run" button from the same tool-bar
It will generate iOS app, automatically install it on your real iPhone device and automatically open it as well.

Now your real iPhone will be used as an emulator.

Latest Issues

Want to ask a Question?

You can include your email for private conversation!

Latest Updates