ID Verification:Compatibility configuration for H5 mobile SDK integrated in apps

Android configuration

Due to the severe fragmentation of the Android ecosystem, using the Android native Webview in your app to access the system camera may cause compatibility issues, such as camera access being rejected or the facial verification page failing to launch after re-authorization.

Follow these steps to resolve compatibility issues:

1. Declare the following permissions in the AndroidManifest.xml file:

   <!--Application camera access permission.-->
   <uses-permission android:name="android.permission.CAMERA" />
   <!--Application network access permission.-->
   <uses-permission android:name="android.permission.INTERNET" />

2. Configure WebView:

   1. Override the onPermissionRequest() method to enable the callback for the web page's permission prompt.

      For WebView-based web applications, permission management is handled by the browser. When a user on an H5 page attempts to access the camera, if they deny the permission request, any subsequent attempts to access the camera on that page will be denied by default.

      Therefore, you can override the onPermissionRequest() method to customize the handling of webpage permission requests. See the following example:

      webView.setWebChromeClient(new WebChromeClient(){
          @Override
          public void onPermissionRequest(PremissionRequest request) {
              if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                  // Check if the current device system version is Android 5.0 or later.
                  // If so, directly grant all permissions requested by the webpage. This example is for reference only. Rewrite according to your actual situation.
                  request.grant(request.getResources());
              }
          }
      });

   2. Configure WebView to allow automatic video playback on webpages:

      // Allow autoplay.
      webView.getSettings().setMediaPlaybackRequiresUserGesture(false);

iOS configuration

1. In the Info.plist file, declare the NSCameraUsageDescription key, and provide a clear description to inform users why the application needs to access camera permissions. For example:

   <key>NSCameraUsageDescription</key>
   <string>We need to access your camera to take photos or scan QR codes.</string>

2. Configure the WKWebViewConfiguration of WebView, and set it to allow automatic video playback and in-page playback:

   Swift

   // Configure camera usage through WKWebViewConfiguration class.
   let config = WKWebViewConfiguration()
   config.allowsPictureInPictureMediaPlayback = true
   
   // Allow automatic video playback.
   let myAudiovisualMediaType: WKAudiovisualMediaTypes = []
   config.mediaTypesRequiringUserActionForPlayback = myAudiovisualMediaType
   
   // Allow video playback within the webpage (non-full screen playback).
   config.allowsInlineMediaPlayback = true

   Objective-C

   // Configure camera usage through WKWebViewConfiguration class.
   WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
   config.allowsInlineMediaPlayback = YES;
   
   // Allow automatic video playback.
   config.mediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypeNone;
   
   // Allow video playback within the webpage (non-full screen playback).
   config.allowsInlineMediaPlayback = YES;

WebRTC compatibility support list