alive_flutter_plugin 0.1.0

A new Flutter plugin.

活体检测

根据提示做出相应动作，SDK 实时采集动态信息，判断用户是否为活体、真人

平台支持（兼容性）

Android	iOS
适用版本区间：4.4以上	适用版本区间：9 - 14

环境准备

CocoaPods 安装教程

资源引入/集成

在 pubspec.yaml 中添加

dependencies:
    alive_flutter_plugin: ^0.0.9

项目开发配置

Android 配置

在 flutter 工程对应的 android/app/build.gradle 文件的 android 域中添加

repositories {
    flatDir {
        dirs project(':alive_flutter_plugin').file('libs')
    }
}

插件依赖于相机权限，需要动态申请！可以引入 permission_handler: ^8.1.6 插件动态申请 camera 权限

//当前权限
Permission permission = Permission.camera;
//权限的状态
PermissionStatus status = await permission.status;
if (status.isUndetermined) {
  //发起权限申请
  PermissionStatus status = await permission.request();
  if (status.isGranted) {
    return true;
  }
} else {
  return true;
}

release 包需要添加混淆规则

-keep class com.netease.nis.alivedetected.entity.*{*;}
-keep class com.netease.nis.alivedetected.AliveDetector  {
    public <methods>;
    public <fields>;
}
-keep class com.netease.nis.alivedetected.DetectedEngine{
    native <methods>;
}
-keep class com.netease.nis.alivedetected.NISCameraPreview  {
    public <methods>;
}
-keep class com.netease.nis.alivedetected.DetectedListener{*;}
-keep class com.netease.nis.alivedetected.ActionType{ *;}

iOS 配置

在 flutter 工程对应的 example/ios/Runner/info.plist 里 ，添加

<key>NSPhotoLibraryUsageDescription</key> 
<string></string> 
<key>NSCameraUsageDescription</key>
<string></string>

调用示例

class LiveDetectExample extends StatefulWidget {
  @override
  _LiveDetectExampleState createState() => _LiveDetectExampleState();
}

class _LiveDetectExampleState extends State<LiveDetectExample> {
  final AliveFlutterPlugin aliveFlutterPlugin = new AliveFlutterPlugin();

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      aliveFlutterPlugin.init("易盾业务id", 40);
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('易盾活体检测'),
        ),
        body: new SingleChildScrollView(
          physics: BouncingScrollPhysics(),
          child: new Center(
            child: Center(
              child: new Column(
                children: [showFaceImageWidget(), startDetectButton()],
              ),
            ),
          ),
        ),
      ),
    );
  }

  Widget showFaceImageWidget() {
    if (defaultTargetPlatform == TargetPlatform.android) {
      return new Center(
        child: Container(
            width: 300,
            height: 300,
            child: AndroidView(
                viewType: 'platform-view-alive',
                creationParams: {"width": 300, "height": 400},
                creationParamsCodec: const StandardMessageCodec()),
            alignment: Alignment.center),
      );
    } else if (defaultTargetPlatform == TargetPlatform.iOS) {
      return new Center(
        child: Container(
          width: 200,
          height: 200,
          decoration: BoxDecoration(
              borderRadius: BorderRadius.all(Radius.circular(100))),
          child: UiKitView(
            viewType: 'com.flutter.alive.imageview',
            creationParams: {
              "width": "200",
              "height": "200",
              "radius": "100",
            },
            //参数的编码方式
            creationParamsCodec: const StandardMessageCodec(),
          ),
        ),
      );
    }
    return Text('$defaultTargetPlatform is not yet supported by this plugin');
  }

  Widget startDetectButton() {
    return new Container(
      child: SizedBox(
        child: new TextButton(
          onPressed: () {
            startLive();
          },
          child: Text("开始检测"),
        ),
        width: double.infinity,
        height: 49,
      ),
      margin: EdgeInsets.fromLTRB(40, 5, 40, 5),
    );
  }

  void startLive() {
    aliveFlutterPlugin.startLiveDetect().then((value) {
      /**
       * action表示返回的动作，动作状态表示：0——正面，1——右转，2——左转，3——张嘴，4——眨眼。
       */
      var actions = value["actions"];
      print(actions);
    });
  }
}

更多使用场景请参考 demo

SDK 方法说明

1 初始化活体检测

代码说明：

// 初始化对象
final AliveFlutterPlugin aliveFlutterPlugin = new AliveFlutterPlugin(); 
aliveFlutterPlugin.init("businessId", “timeout”);

参数说明：

• options 基础参数：

  参数	类型	是否必填	默认值	描述
  businessId	String	是	无	易盾分配的业务id
  timeout	Number	否	30秒	活体检测超时时间

2 开始活体检测验证

代码说明：

aliveFlutterPlugin.startLiveDetect().then((value) {
    var actions = value["actions"];
});

回调参数说明

• 回调参数说明

  参数	类型	描述
  actions	String	检查动作 0：正视前方 1：向右转头 2：向左转头 3：张嘴动作 4：眨眼动作，例如：actions = "123",表示需要做向右转头、向左转头、张嘴动作三个动作

3 停止活体检测

代码说明：

aliveFlutterPlugin.stopLiveDetect();

4 检测状态监听

代码说明：

var eventChannel = const EventChannel("yd_alive_flutter_event_channel")

eventChannel.receiveBroadcastStream().listen(_onData, onError: _onError);
   
void _onData(response) {
    if (response is Map) {
        setState(() {
        var type = response["type"];
        if (type == "checking") {
            _currentStep = response["currentStep"];
            _result = response["message"];
        } else if (type == "checked") {
            _result = response["message"];
            _currentStep = 0;
            stopLive();
        } else if (type == "exception") {
            _result = response["message"];
    }
}

• response 监听回调说明

  回调字段	类型	描述
  checked	String	检测完成
  currentStep	String	检查动作 0：正视前方 1：向右转头 2：向左转头 3：张嘴动作 4：眨眼动作
  exception	String	异常状态 1：保持面部在框内 2：环境光线过暗 3：环境光线过亮 4：请勿抖动手机

5 资源释放

Android 特有，建议放在 dispose 生命周期

代码说明：

void dispose() {
    if (defaultTargetPlatform == TargetPlatform.android) {
      //android需要释放资源，否则会引发内存泄露
      aliveFlutterPlugin.destroy();
    }
    super.dispose();
  }