README.md

Integrate Pagecall for your iOS Application

[!] Bitcode is not supported, because it depends on WebRTC framework which does not supported bitcode for now.

Prerequisites

• Make sure you set NSMicrophoneUsageDescription, and NSCameraUsageDescription if you are creating a video call application.
• Also, Those UIBackgroundModes should be enabled: audio, fetch, voip.

Usage

• It is not suppored to instantiate from a storyboard, because a required WKWebViewConfiguration cannot be applied with it.

1. Programatically create a PagecallWebView

import UIKit
import WebKit
import PagecallSDK

class ViewController: UIViewController, WKUIDelegate {
    var webView: PagecallWebView?

    override func viewDidLoad() {
        super.viewDidLoad()
        let webView = PagecallWebView(frame: CGRect.zero)
        webView.load(URLRequest(url: "https://app.pagecall.net/my_room_id"))
        self.view.addSubview(webView)
        self.webView = webView

        webView.translatesAutoresizingMaskIntoConstraints = false
        webView.topAnchor.constraint(equalTo: self.view.topAnchor, constant: 80.0).isActive = true
        webView.bottomAnchor.constraint(equalTo: self.view.bottomAnchor, constant: -20.0).isActive = true
        webView.leadingAnchor.constraint(equalTo: self.view.leadingAnchor, constant: 20.0).isActive = true
        webView.trailingAnchor.constraint(equalTo: self.view.trailingAnchor, constant: -20.0).isActive = true
    }

    override func viewDidDisappear(_ animated: Bool) {
        // If it is not called, the webView can still have the access to microphone or camera
        webView?.dispose()
        webView = nil
    }
}

2. Handle delegate

This SDK uses a native bridge for WebRTC before iOS 15.0, and WKWebView-native WebRTC on iOS 15.0 and after. WKWebView-native WebRTC asks for permission permission everytime an user enters the meeting room, unless you apply changes below.

class ViewController: UIViewController, WKUIDelegate {
    override func viewDidLoad() {
        super.viewDidLoad()
        let webView = PagecallWebView(frame: CGRect.zero)
+       webView.uiDelegate = self
        // ...
    }
    
    ...

+   @available(iOS 15.0, *)
+   func webView(_ webView: WKWebView, requestMediaCapturePermissionFor origin: WKSecurityOrigin, initiatedByFrame frame: WKFrameInfo, type: WKMediaCaptureType, decisionHandler: @escaping (WKPermissionDecision) -> Void) {
+       decisionHandler(.grant)
+   }
}

Tips

• If you want something to happen on a webview closing, you need to handle it in your view controller.

  class ViewController: UIViewController, WKUIDelegate {
      override func viewDidLoad() {
          // Wherever a PagecallWebView is created
          webView.uiDelegate = self
      }
    
      func webViewDidClose(_ webView: WKWebView) {
          self.dismiss(animated: true)
      }
  }