メインコンテンツへスキップ
React Native でのキャプチャ

ネイティブモジュールを使って React Native アプリからキャプチャを開きます。

Markdown

バックエンドは、Journey フローと、アプリの URL スキームを使った callbackUri を指定して、Human Plugin にプロセスを作成します。ネイティブモジュールが、レスポンスの link を iOS では ASWebAuthenticationSession で、Android では Custom Tabs で開きます。キャプチャが終了するとモジュールが promise を resolve し、アプリに制御が戻ります。

作成のレスポンスの Human Plugin id を保持してください。バックエンドはこの id で結果を読み取ります。

前提条件​

  • React Native 0.71 以降
  • iOS 向け: Xcode 14 以降
  • Android 向け: Android Studio
  • myapp のような、アプリ固有の URL スキーム

1. スキームを指定してプロセスを作成する​

バックエンドはスキームを callbackUri として送信します。

{
  "flow": "humantoken",
  "clientId": "client-a",
  "correlationId": "order-1001",
  "credential": { "type": "DUI_TYPE_NG_BVN", "value": "<document number>" },
  "callbackUri": "myapp://callback"
}

そして id と link をアプリに返します。

2. TypeScript ブリッジを作成する​

// src/modules/CaptureModule.ts
import { NativeModules } from 'react-native';

const { CaptureModule } = NativeModules;

if (!CaptureModule) {
  throw new Error('CaptureModule not found. Make sure the native module is linked correctly.');
}

export const Capture = {
  openSession: (url: string): Promise<string> => CaptureModule.openSession(url),
};

3. iOS モジュールを実装する​

// ios/CaptureModule.m
#import <React/RCTBridgeModule.h>

@interface RCT_EXTERN_MODULE(CaptureModule, NSObject)
RCT_EXTERN_METHOD(openSession:(NSString *)url
                  resolve:(RCTPromiseResolveBlock)resolve
                  reject:(RCTPromiseRejectBlock)reject)
@end

4. Android モジュールを実装する​

android/app/build.gradle に依存関係を追加します。

implementation("androidx.browser:browser:1.5.0")
// android/app/src/main/java/<your.package>/CaptureModule.kt
package com.yourapp

import android.net.Uri
import androidx.browser.customtabs.CustomTabsIntent
import com.facebook.react.bridge.*

class CaptureModule(private val reactContext: ReactApplicationContext) :
    ReactContextBaseJavaModule(reactContext) {

    private var pendingPromise: Promise? = null

    override fun getName() = "CaptureModule"

    @ReactMethod
    fun openSession(url: String, promise: Promise) {
        pendingPromise = promise
        currentActivity?.runOnUiThread {
            CustomTabsIntent.Builder().build()
                .launchUrl(currentActivity!!, Uri.parse(url))
        } ?: promise.reject("NO_ACTIVITY", "No current activity")
    }

    fun handleRedirectUrl(uri: Uri) {
        if (uri.scheme == "myapp") {
            pendingPromise?.resolve(uri.toString())
            pendingPromise = null
        }
    }
}
// CapturePackage.kt
package com.yourapp

import com.facebook.react.ReactPackage
import com.facebook.react.bridge.NativeModule
import com.facebook.react.bridge.ReactApplicationContext
import com.facebook.react.uimanager.ViewManager

class CapturePackage : ReactPackage {
    override fun createNativeModules(ctx: ReactApplicationContext): List<NativeModule> =
        listOf(CaptureModule(ctx))
    override fun createViewManagers(ctx: ReactApplicationContext): List<ViewManager<*, *>> =
        emptyList()
}

MainApplication.kt に登録します。

override fun getPackages(): List<ReactPackage> =
    PackageList(this).packages.apply {
        add(CapturePackage())
    }

MainActivity.kt で戻りを処理します。

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let { uri ->
        if (uri.scheme == "myapp") {
            val module = reactInstanceManager
                .currentReactContext
                ?.getNativeModule(CaptureModule::class.java)
            module?.handleRedirectUrl(uri)
        }
    }
}

5. Android でスキームを登録する​

AndroidManifest.xml に追加します。

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

<activity android:name=".MainActivity" ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="myapp" android:host="callback" />
    </intent-filter>
</activity>

6. キャプチャを開始する​

import { Capture } from './modules/CaptureModule';

try {
  await Capture.openSession(link);
  // キャプチャが終了しました。バックエンドに、Human Plugin の id を使った
  // GET /v1/processes/{id} で結果を読み取るよう依頼します。
} catch {
  // 本人がセッションを閉じました。
}

まとめ​

ファイル用途
src/modules/CaptureModule.tsTypeScript ブリッジ
ios/CaptureModule.mObjective-C 宣言
ios/CaptureModule.swiftiOS: ASWebAuthenticationSession
android/.../CaptureModule.ktAndroid: Custom Tabs
android/.../CapturePackage.ktパッケージの登録
android/.../MainApplication.ktパッケージを追加
android/.../MainActivity.kt戻りの処理
AndroidManifest.xmlintent filter
最終更新 に