Flash Liveness SDK
Flash Liveness SDK cung cấp luồng xác thực khuôn mặt/liveness cho ứng dụng mobile. Bộ SDK hiện có ba hướng tích hợp chính:
| Nền tảng | Package | Phiên bản hiện tại |
|---|---|---|
| Android native | io.liveness.flash:sdk-android | 1.7.23 |
| iOS native | FlashLiveness pod | 1.4.8 |
| Flutter | flashliveness_flutter | 1.6.14 |
Luồng tích hợp tổng quát
- Nhận thông tin tích hợp từ QTS:
appId,baseURL,publicKey,privateKey, credential truy cập repository/package private và các header/param bổ sung nếu backend yêu cầu. - Cấu hình dependency native theo nền tảng.
- Khai báo quyền camera và kiểm tra quyền trước khi mở liveness.
- Khởi tạo SDK bằng thông tin tích hợp được cấp.
- Mở luồng live check hoặc register face.
- Nhận callback/event, xử lý kết quả thành công/thất bại và đóng màn hình camera đúng lifecycle.
Chọn tài liệu theo nền tảng
- Android native: dùng cho ứng dụng Kotlin/Java tích hợp trực tiếp AAR từ GitHub Packages.
- iOS native: dùng cho ứng dụng Swift/Objective-C tích hợp qua CocoaPods.
- Flutter: dùng cho ứng dụng Flutter wrapper qua plugin
flashliveness_flutter.
thông tin
Thông tin nhạy cảm
Không hard-code privateKey, GitHub token hoặc token backend trong source public. Với production, nên lấy cấu hình từ backend/remote config an toàn, hoặc inject qua cơ chế secret của hệ thống build.
Best practices
- Luôn kiểm tra quyền camera trước khi start SDK để tránh mở màn hình trắng hoặc lỗi permission.
- Test liveness trên thiết bị thật. iOS SDK hiện đóng gói
ios-arm64, không phải lựa chọn ổn định cho simulator. - Với màn hình nhúng camera, dùng layout full-screen hoặc gần full-screen, kích thước ổn định trước khi start session.
- Giữ strong reference tới detector/view liveness cho đến khi flow kết thúc.
- Tắt log chi tiết trong production, chỉ bật debug log khi cần điều tra lỗi tích hợp.