ID Verification:アプリに統合された H5 モバイル SDK の互換性構成

Android の構成

Android エコシステムの深刻な断片化のため、アプリで Android ネイティブの [Webview] を使用してシステム カメラにアクセスすると、カメラ アクセスが拒否されたり、再認証後に顔認証ページが起動に失敗したりするなど、互換性の問題が発生する可能性があります。

互換性の問題を解決するには、次の手順に従います。

1. AndroidManifest.xml ファイルで次の権限を宣言します。

   <!--アプリケーションのカメラアクセス許可-->
   <uses-permission android:name="android.permission.CAMERA" />
   <!--アプリケーションのネットワークアクセス許可-->
   <uses-permission android:name="android.permission.INTERNET" />

2. WebView を構成します。

   1. onPermissionRequest() メソッドをオーバーライドして、Web ページの権限リクエスト コールバックを許可します。

      WebView ベースの Web アプリケーションの場合、ブラウザが権限管理を担当するため、ユーザーがカメラを呼び出す H5 Web ページにアクセスすると、ユーザーが権限リクエストを拒否した場合、Web ページを開いてカメラを再度呼び出すと、アクセス拒否メッセージが表示されます。

      したがって、onPermissionRequest() メソッドをオーバーライドして、Web ページの権限リクエストの処理をカスタマイズできます。 次の例を参照してください。

      webView.setWebChromeClient(new WebChromeClient(){
          @Override
          public void onPermissionRequest(PremissionRequest request) {
              if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                  // 現在のデバイスのシステムバージョンが Android 5.0 以降であるかどうかを確認します
                  // その場合は、Web ページによって要求されたすべての権限を直接付与します。 この例は参照用です。 実際の状況に合わせて書き直してください。
                  request.grant(request.getResources());
              }
          }
      });

   2. Web ページでビデオの自動再生を許可するように WebView を構成します。

      // 自動再生を許可する
      webView.getSettings().setMediaPlaybackRequiresUserGesture(false);

iOS の構成

1. Info.plist ファイルで、NSCameraUsageDescription キーを宣言し、アプリケーションがカメラの権限にアクセスする必要がある理由をユーザーに明確に説明します。 例：

   <key>NSCameraUsageDescription</key>
   <string>写真を撮ったり QR コードをスキャンしたりするには、カメラにアクセスする必要があります。</string>

2. WebView の WKWebViewConfiguration を設定して、ビデオの自動再生とページ内再生を許可します：

   Swift

   // WKWebViewConfiguration クラスを使用してカメラの使用を構成する
   let config = WKWebViewConfiguration()
   config.allowsPictureInPictureMediaPlayback = true
   
   // ビデオの自動再生を許可する
   let myAudiovisualMediaType: WKAudiovisualMediaTypes = []
   config.mediaTypesRequiringUserActionForPlayback = myAudiovisualMediaType
   
   // Web ページ内でのビデオ再生を許可する（全画面再生ではない）
   config.allowsInlineMediaPlayback = true

   Objective-C

   // WKWebViewConfiguration クラスを使用してカメラの使用を構成する
   WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
   config.allowsInlineMediaPlayback = YES;
   
   // ビデオの自動再生を許可する
   config.mediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypeNone;
   
   // Web ページ内でのビデオ再生を許可する（全画面再生ではない）
   config.allowsInlineMediaPlayback = YES;

WebRTC 互換性サポート リスト