Applications mobiles (iOS et Android)

<key>NSCameraUsageDescription</key>
<string>Take the photos requested for your booking.</string>

import WebKit

final class CaptureViewController: UIViewController, WKUIDelegate, WKNavigationDelegate {
    let captureHost = "capture.tryvidimus.com"
    let returnHost = "app.example.com"      // the site you declared
    var captureURL: URL!                     // capture_url, received from YOUR server

    override func viewDidLoad() {
        super.viewDidLoad()
        let config = WKWebViewConfiguration()
        config.allowsInlineMediaPlayback = true
        let webView = WKWebView(frame: view.bounds, configuration: config)
        webView.uiDelegate = self
        webView.navigationDelegate = self
        view.addSubview(webView)
        webView.load(URLRequest(url: captureURL))
    }

    // iOS 15+: the capture page may use the camera, no other site may.
    func webView(_ webView: WKWebView,
                 requestMediaCapturePermissionFor origin: WKSecurityOrigin,
                 initiatedByFrame frame: WKFrameInfo, type: WKMediaCaptureType,
                 decisionHandler: @escaping (WKPermissionDecision) -> Void) {
        decisionHandler(origin.host == captureHost ? .grant : .deny)
    }

    // The page ends by going to your return_url: catch it and close the screen.
    func webView(_ webView: WKWebView, decidePolicyFor action: WKNavigationAction,
                 decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
        if let url = action.request.url, url.host == returnHost,
           url.path == "/bookings/4471/capture-done" {
            decisionHandler(.cancel)
            dismiss(animated: true)          // url carries ?proof_id=…&session_id=…
            return
        }
        decisionHandler(.allow)
    }
}

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="false" />

class CaptureActivity : ComponentActivity() {
    private val captureHost = "capture.tryvidimus.com"
    private val returnHost = "app.example.com"   // the site you declared
    private var pending: PermissionRequest? = null

    private val askCamera =
        registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
            pending?.let {
                if (granted) it.grant(arrayOf(PermissionRequest.RESOURCE_VIDEO_CAPTURE)) else it.deny()
            }
            pending = null
        }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val webView = WebView(this)
        webView.settings.javaScriptEnabled = true
        webView.settings.domStorageEnabled = true            // the page keeps the photos to resume
        webView.settings.mediaPlaybackRequiresUserGesture = false

        webView.webChromeClient = object : WebChromeClient() {
            override fun onPermissionRequest(request: PermissionRequest) {
                if (request.origin.host != captureHost) { request.deny(); return }
                runOnUiThread { pending = request; askCamera.launch(Manifest.permission.CAMERA) }
            }
        }
        webView.webViewClient = object : WebViewClient() {
            override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest): Boolean {
                val url = request.url
                if (url.host == returnHost && url.path == "/bookings/4471/capture-done") {
                    finish()                                  // url carries proof_id and session_id
                    return true
                }
                return false
            }
        }
        setContentView(webView)
        webView.loadUrl(intent.getStringExtra("capture_url")!!)   // from YOUR server
    }
}

// https://app.example.com/.well-known/apple-app-site-association
{
  "applinks": {
    "details": [
      { "appIDs": ["TEAMID.com.example.app"],
        "components": [{ "/": "/bookings/*/capture-done" }] }
    ]
  }
}

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="app.example.com"
        android:pathPrefix="/bookings" />
</intent-filter>