--- title: Flutter 캡처 description: Human Plugin 생성 응답이 반환한 링크를 사용해 Flutter 앱에서 플랫폼 채널로 Journey 플로우의 캡처를 실행합니다. canonical: https://developer.unico.io/ko/human-plugin/integrations/flutter locale: ko generated_by: markdown-export --- # Flutter 캡처 플랫폼 채널을 사용해 Flutter 앱에서 캡처를 엽니다. 백엔드가 Journey 플로우와 앱의 URL 스킴을 사용하는 `callbackUri`로 Human Plugin에서 프로세스를 생성합니다. `MethodChannel`이 응답의 `link`를 iOS에서는 `ASWebAuthenticationSession`, Android에서는 Custom Tabs로 엽니다. 외부 패키지는 필요하지 않습니다. 생성 응답의 Human Plugin `id`를 보관하세요. 백엔드가 이 값으로 결과를 읽습니다. ## 사전 요구 사항 - Flutter 3 이상 - iOS용 Xcode 14 이상 - Android용 Android Studio - 앱 고유의 URL 스킴(예: `myapp`) ## 1. 스킴을 지정해 프로세스 생성 백엔드가 스킴을 `callbackUri`로 전송합니다. ```json { "flow": "humantoken", "clientId": "client-a", "correlationId": "order-1001", "credential": { "type": "DUI_TYPE_NG_BVN", "value": "" }, "callbackUri": "myapp://callback" } ``` 그리고 `id`와 `link`를 앱에 반환합니다. ## 2. Dart 서비스 생성 ```dart // lib/services/capture_service.dart import 'package:flutter/services.dart'; class CaptureService { static const _channel = MethodChannel('capture_plugin'); /// 캡처가 끝나면 true, 사용자가 닫으면 false를 반환합니다. Future open(String link) async { try { final result = await _channel.invokeMethod('openSession', {'url': link}); return result != null; } on PlatformException { return false; } } } ``` ## 3. iOS 플러그인 구현 ```swift // ios/Runner/CapturePlugin.swift import Flutter import AuthenticationServices class CapturePlugin: NSObject, FlutterPlugin, ASWebAuthenticationPresentationContextProviding { private var session: ASWebAuthenticationSession? static func register(with registrar: FlutterPluginRegistrar) { let channel = FlutterMethodChannel(name: "capture_plugin", binaryMessenger: registrar.messenger()) let instance = CapturePlugin() registrar.addMethodCallDelegate(instance, channel: channel) } func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) { guard call.method == "openSession", let args = call.arguments as? [String: Any], let urlString = args["url"] as? String, let url = URL(string: urlString) else { result(FlutterMethodNotImplemented) return } let newSession = ASWebAuthenticationSession( url: url, callbackURLScheme: "myapp" ) { callbackURL, error in self.session = nil if let callbackURL = callbackURL { result(callbackURL.absoluteString) } else { result(FlutterError(code: "SESSION_ERROR", message: error?.localizedDescription ?? "Session cancelled", details: nil)) } } newSession.presentationContextProvider = self newSession.prefersEphemeralWebBrowserSession = true newSession.start() session = newSession } func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor { guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, let window = windowScene.windows.first else { return ASPresentationAnchor() } return window } } ``` `AppDelegate.swift`에 등록합니다. ```swift CapturePlugin.register(with: self.registrar(forPlugin: "CapturePlugin")!) ``` ## 4. Android 플러그인 구현 `android/app/build.gradle`에 의존성을 추가합니다. ```groovy implementation("androidx.browser:browser:1.5.0") ``` ```kotlin // android/app/src/main/kotlin//CapturePlugin.kt package com.yourapp import android.net.Uri import androidx.browser.customtabs.CustomTabsIntent import io.flutter.embedding.engine.plugins.FlutterPlugin import io.flutter.embedding.engine.plugins.activity.ActivityAware import io.flutter.embedding.engine.plugins.activity.ActivityPluginBinding import io.flutter.plugin.common.MethodCall import io.flutter.plugin.common.MethodChannel class CapturePlugin : FlutterPlugin, MethodChannel.MethodCallHandler, ActivityAware { private var channel: MethodChannel? = null private var binding: ActivityPluginBinding? = null private var pendingResult: MethodChannel.Result? = null override fun onAttachedToEngine(flutterBinding: FlutterPlugin.FlutterPluginBinding) { channel = MethodChannel(flutterBinding.binaryMessenger, "capture_plugin") channel?.setMethodCallHandler(this) } override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) { if (call.method == "openSession") { val url = call.argument("url") ?: return result.error("MISSING_URL", "URL is required", null) pendingResult = result val activity = binding?.activity ?: return result.error("NO_ACTIVITY", "No activity", null) CustomTabsIntent.Builder().build().launchUrl(activity, Uri.parse(url)) } else { result.notImplemented() } } fun handleRedirect(uri: Uri) { if (uri.scheme == "myapp") { pendingResult?.success(uri.toString()) pendingResult = null } } override fun onAttachedToActivity(binding: ActivityPluginBinding) { this.binding = binding } override fun onDetachedFromActivity() { binding = null } override fun onReattachedToActivityForConfigChanges(binding: ActivityPluginBinding) { this.binding = binding } override fun onDetachedFromActivityForConfigChanges() { binding = null } override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) { channel = null } } ``` `MainActivity.kt`에서 등록하고 복귀를 처리합니다. ```kotlin override fun configureFlutterEngine(flutterEngine: FlutterEngine) { super.configureFlutterEngine(flutterEngine) flutterEngine.plugins.add(CapturePlugin()) } override fun onNewIntent(intent: Intent) { super.onNewIntent(intent) intent.data?.let { uri -> if (uri.scheme == "myapp") { val plugin = flutterEngine?.plugins?.get(CapturePlugin::class.java) as? CapturePlugin plugin?.handleRedirect(uri) } } } ``` ## 5. 스킴 등록 ### iOS `Info.plist`에 추가합니다. ```xml CFBundleURLTypes CFBundleURLSchemes myapp ``` ### Android `AndroidManifest.xml`의 메인 `` 안에 추가합니다. ```xml ``` ## 6. 캡처 시작 ```dart final ended = await CaptureService().open(link); if (ended) { // 캡처가 끝났습니다. 백엔드에 Human Plugin id로 // GET /v1/processes/{id}를 호출해 결과를 읽도록 요청하세요. } else { // 사용자가 세션을 닫았습니다. } ``` ## 요약 | 파일 | 용도 | |---|---| | `lib/services/capture_service.dart` | Dart `MethodChannel` 서비스 | | `ios/Runner/CapturePlugin.swift` | iOS: `ASWebAuthenticationSession` | | `ios/Runner/AppDelegate.swift` | 플러그인 등록 | | `android/.../CapturePlugin.kt` | Android: Custom Tabs | | `android/.../MainActivity.kt` | 플러그인 등록 및 복귀 처리 | | `Info.plist` | iOS URL 스킴 | | `AndroidManifest.xml` | Android 인텐트 필터 |