号码认证 #

直连三大运营商，一步校验手机号与当前 SIM 卡号一致性。优化注册/登录/支付等场景验证流程

平台支持（兼容性） #

环境准备 #

CocoaPods安装教程

资源引入/集成 #

在 pubspec.yaml 中添加

dependencies:
    quickpass_yidun_flutter: ^1.0.3

项目开发配置 #

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

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

调用示例 #

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final QuickpassFlutterPlugin quickLoginPlugin = new QuickpassFlutterPlugin();

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('易盾一键登录'),
        ),
        body: _buildContent(),
      ),
    );
  }

  Widget _buildContent() {
    return Center(
      widthFactor: 2,
      child: new Column(
        children: <Widget>[
          new Container(
            margin: EdgeInsets.fromLTRB(40, 5, 40, 5),
            child: new Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                new FlatButton(
                    onPressed: () {
                      isInitSuccess();
                    },
                    child: Text("初始化"))
              ],
            ),
          ),
          new Container(
            child: SizedBox(
              child: new FlatButton(
                  onPressed: () {
                    preLogin();
                  },
                  child: Text("预取号")),
              width: double.infinity,
            ),
            margin: EdgeInsets.fromLTRB(40, 5, 40, 5),
          ),
          new Container(
            child: SizedBox(
              child: new FlatButton(
                onPressed: () {
                  quickLogin();
                },
                child: Text("调起授权页"),
              ),
              width: double.infinity,
            ),
            margin: EdgeInsets.fromLTRB(40, 5, 40, 5),
          ),
        ],
        mainAxisAlignment: MainAxisAlignment.start,
      ),
    );
  }

  /// sdk 初始化是否完成
  void isInitSuccess() {
    quickLoginPlugin.init("易盾业务id", 4).then((map) {
      bool result = map['success'];
    });
  }

  /// 预取号
  void preLogin() async {
    Map map = await quickLoginPlugin.preFetchNumber();
    if (map['success'] == true) {
      var ydToken = map['token'];
    } else {
      var ydToken = map['token'];
      var errorMsg = map['errorMsg'];
    }
  }

  void quickLogin() {
    var configMap;
    var param = "";
    String file = "";
    if (Platform.isIOS) {
      file = "asserts/ios-light-config.json";
    } else if (Platform.isAndroid) {
      file = "asserts/android-light-config.json";
    }
    rootBundle.loadString(file).then((value) async {
      configMap = {"uiConfig": json.decode(value)};
      quickLoginPlugin.setUiConfig(configMap);
      Map map = await quickLoginPlugin.onePassLogin();
      if (map["success"]) {
        var accessToken = map["accessToken"];
        quickLoginPlugin.closeLoginAuthView();
      } else {
        var errorMsg = map["msg"];
        quickLoginPlugin.closeLoginAuthView();
      }
    });
  }	

更多使用场景请参考 demo

SDK方法说明 #

1. 创建对象 #

代码说明：

import 'package:quickpass_yidun_flutter/quickpass_flutter_plugin.dart'
QuickpassFlutterPlugin quickLoginPlugin = new QuickpassFlutterPlugin();

2. 是否具备一键登录能力 #

代码说明：

quickLoginPlugin.checkVerifyEnable().then((map) {
    bool result = map['success'];
});

参数说明：

• 回调参数说明：

  回调参数	类型	描述
  success	Boolean	是否具备一键登录能力

3. 初始化 #

代码说明：

quickLoginPlugin.init(String businessId, int timeout).then((map) {
    bool result = map['success'];
});

参数说明：

• 入参说明：

  参数	类型	是否必填	默认值	描述
  businessId	String	是	无	易盾分配的业务 id
  timeout	int	否	3	运营商预取号和授权登录接口的超时时间，单位秒

• 回调参数说明：

  回调参数	类型	描述
  success	Boolean	初始化是否成功

4. 预取号 #

代码说明：

Map map = await quickLoginPlugin.preFetchNumber();
if (map['success'] == true) {
    var ydToken = map['token'];
} else {
    var ydToken = map['token'];
    var errorMsg = map['errorMsg'];
}

参数说明：

• 回调参数说明：

  回调参数	类型	描述
  success	Boolean	预取号是否成功
  token	String	如果预取号成功则返回易盾 token，否则无此字段
  errorMsg	String	如果预取号失败，返回错误详情

5. 自定义授权页面 #

在工程目录下新建asserts文件夹添加json配置文件，可配置项参考下面说明

代码说明：

String file = "";
if (Platform.isIOS) {
    file = "asserts/ios-light-config.json";
} else if (Platform.isAndroid) {
    file = "asserts/android-light-config.json";
}
rootBundle.loadString(file).then((value) async {
    configMap = {"uiConfig": json.decode(value)};
    quickLoginPlugin.setUiConfig(configMap);
});

参数说明：

• 基础参数：

  参数	类型	是否必填	默认值	描述
  config	Map	是	无	自定义配置项

config 可配置项说明： android版

状态栏

导航栏

应用 Logo

手机掩码

认证品牌

登录按钮

隐私协议

协议详情 Web 页面导航栏

其他

自定义view

config 可配置项说明： iOS版

设计规范概览

基础配置

转场动画

自定义控件

背景设置视频

背景设置 Gif

状态栏

导航栏

应用 Logo

手机掩码

认证品牌

登录按钮

隐私协议

若勾选框需要展示，请务必设置勾选框的选中态图片与未选中态图片 协议未勾选时，登录按钮是否可点击可以自定义设置，弹窗提示的样式也可以自定义

弹窗模式

点击事件的回调

6. 调起授权页面 #

代码说明：

// 拉起授权页面
Map map = await quickLoginPlugin.onePassLogin();
if (map["success"]) {
    var accessToken = map["accessToken"];
} else {
    var errorMsg = map["msg"];
}

参数说明：

• 回调参数说明：

  回调参数	类型	描述
  success	Boolean	授权是否成功
  accessToken	String	如果取号成功返回运营商授权码，否则无此字段
  msg	String	如果取号失败，返回错误详情

7. 事件监听 #

代码说明：

var eventChannel = const EventChannel("yd_quicklogin_flutter_event_channel");
@override
void initState() {
    super.initState();
    initPlatformState();
    eventChannel.receiveBroadcastStream().listen(_onData, onError: _onError);
}
void _onData(response) {
    if (response is Map) {
      var action = (response as Map)["action"];
    }
}

• action 参数说明：

  回调参数	类型	描述
  action	String	authViewDidLoad 表示正在加载授权页 authViewWillAppear 表示授权页已经出现 authViewWillDisappear 表示授权页将要消失 authViewDidDisappear表示授权页已经消失 authViewDealloc 表示授权页销毁 appDPrivacy 表示点击了默认协议 appFPrivacy 表示点击了议第一个协议点击 appSPrivacy 表示点击了第二个协议 loginAction 表示点击了登录按钮，data.checked = true 表示在点击登录按钮时复选框选已选中反之 checkedAction 表示点击了复选框，data.checked = true 表示复选框已选中反之 其他自定义的action

8. 关闭授权页面 #

代码说明：

quickLoginPlugin.closeLoginAuthView();