FAQ: iOS App Webview Issues

When integrating Hireflix inside an iOS WebView (WKWebView), you may encounter one of the following issues:

• “Open this on Safari”
• “Your camera or microphone is not working”

These issues are related to how iOS handles WebViews and media permissions. Below you’ll find the complete solution.

1. Fixing the “Open this on Safari” Error

By default, Hireflix detects certain in-app browsers or WebViews and may block them for compatibility reasons.

✅ Solution

Append the following query parameter to your interview URL:

?ios_webview=true

Example

Instead of:

https://app.hireflix.com/z6-UPBAA

Use:

https://app.hireflix.com/z6-UPBAA?ios_webview=true

This tells Hireflix that the interview is intentionally being loaded inside an iOS WebView.

2. Fixing the “Camera or Microphone is Not Working” Error

Even after enabling WebView support, iOS will not automatically grant camera or microphone access.

For security reasons, your app must explicitly:

• Declare camera & microphone usage in Info.plist
• Request runtime permissions
• Properly configure WKWebView to handle media permissions

Step 1: Add Privacy Permissions in Xcode

In Xcode:

1. Select your project in the navigator
2. Select your app target
3. Open the Info tab
4. Click the “+” button to add new keys
5. Add:

• Privacy - Camera Usage Description
• Privacy - Microphone Usage Description

These are required. Without them, permission requests will silently fail.

Step 2: Import Required Frameworks

import SwiftUI
import WebKit
import AVFoundation

Step 3: Request Camera & Microphone Permissions

Add permission request logic in your app:

private func requestMediaPermissions() {
    guard !permissionsRequested else { return }
    permissionsRequested = true
    
    // Ensure usage descriptions exist
    guard Bundle.main.object(forInfoDictionaryKey: "NSCameraUsageDescription") != nil,
          Bundle.main.object(forInfoDictionaryKey: "NSMicrophoneUsageDescription") != nil else {
        print("Warning: Camera and/or Microphone usage descriptions not found in Info.plist")
        return
    }
    
    Task {
        // Camera
        let cameraStatus = AVCaptureDevice.authorizationStatus(for: .video)
        if cameraStatus == .notDetermined {
            _ = await AVCaptureDevice.requestAccess(for: .video)
        }
        
        // Microphone
        let microphoneStatus = AVCaptureDevice.authorizationStatus(for: .audio)
        if microphoneStatus == .notDetermined {
            _ = await AVCaptureDevice.requestAccess(for: .audio)
        }
    }
}

Step 4: Configure WKWebView to Handle Media Permissions

If you’re using WKWebView, implement the WKUIDelegate method:

func webView(_ webView: WKWebView,
             requestMediaCapturePermissionFor origin: WKSecurityOrigin,
             initiatedByFrame frame: WKFrameInfo,
             type: WKMediaCaptureType,
             decisionHandler: @escaping (WKPermissionDecision) -> Void) {
    
    let mediaType: AVMediaType = type == .camera ? .video : .audio
    let status = AVCaptureDevice.authorizationStatus(for: mediaType)
    
    switch status {
    case .authorized:
        decisionHandler(.grant)
    case .denied, .restricted:
        decisionHandler(.deny)
    case .notDetermined:
        Task { @MainActor in
            let granted = await AVCaptureDevice.requestAccess(for: mediaType)
            decisionHandler(granted ? .grant : .deny)
        }
    @unknown default:
        decisionHandler(.deny)
    }
}

Step 5: Assign the WKWebView UI Delegate

When creating your WebView:

func makeUIView(context: Context) -> WKWebView {
    let config = WKWebViewConfiguration()
    let webView = WKWebView(frame: .zero, configuration: config)
    webView.navigationDelegate = context.coordinator
    webView.uiDelegate = context.coordinator // Required for media permissions
    return webView
}

Setting the uiDelegate is critical. Without it, media permission requests will not be handled correctly.

Summary

When embedding Hireflix in an iOS WebView:

1. ✅ Add ?ios_webview=true to the interview URL
2. ✅ Add camera & microphone usage descriptions in Info.plist
3. ✅ Explicitly request AVFoundation permissions
4. ✅ Implement WKUIDelegate media permission handling
5. ✅ Assign the WebView’s uiDelegate

Once these steps are completed, interviews will work correctly inside your iOS app.