Flutter插件tutelarfluttersdk的使用方法介绍

Flutter插件tutelarfluttersdk的使用方法介绍

Tutelar 是风险管理专家。我们的高功率技术解决方案简化了欺诈风险管理和自动化辅助业务流程，使公司能够专注于其核心产品和服务。

要求

Android

1. 使用 Android 6.0 (API 级别 23) 及以上版本。
2. 使用 Kotlin 版本 1.6.10 及以上版本：例如 ext.kotlin_version = '1.6.10'。
3. （可选）READ_PHONE_STATE 权限用于设备 ID。
4. （可选）ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 权限用于设备位置。

iOS

1. 使用 iOS 11.0 或更高版本。
2. 使用 Swift 版本 5.0 及以上版本。
3. （可选）Core Location permission 权限用于设备位置。

注意： 如果应用程序没有列出的权限，将忽略使用这些权限收集的值。为了提供有效的设备指纹，我们建议根据您的用例尽可能多地使用权限。

步骤 1 - 安装

在 pubspec.yaml 的 dependencies: 部分中添加以下行：

dependencies:
  tutelarfluttersdk: 1.0.1

步骤 2 - 初始化 SDK

添加以下代码行以使用从 Tutelar 商户面板获取的 API 密钥初始化 SDK。如果没有 API 密钥，请创建一个新的。

Tutelar tutelar = Tutelar("YOUR API KEY");

步骤 3 - 获取设备信息

通过调用以下函数来接收设备信息：

var sdkResponse = await tutelar.getDeviceDetails();
if(sdkResponse['success'] == true){
    var deviceDetail = sdkResponse['data'];
    // 处理成功流程
} else {
    var failureMessage = sdkResponse['message'];
    // 处理失败流程
}

步骤 4 - 更新 iOS 权限（可选）

如果您正在处理 iOS 构建，您需要在 Info.plist 中添加此权限：

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs access to location when open.</string>

步骤 5 - Proguard 规则（Android 可选）

如果您使用 Proguard 进行构建，请包含以下 Proguard 规则：

-keep,allowobfuscation,allowshrinking interface retrofit2.Call
-keep,allowobfuscation,allowshrinking class retrofit2.Response
-keep,allowobfuscation,allowshrinking class kotlin.coroutines.** { *; }

-dontwarn com.tutelarfluttersdk.**
-keep class com.tutelarfluttersdk.** {*;}

至此，集成完成，现在可以将获得的设备指纹发送到服务器。

示例代码

import 'package:flutter/material.dart';
import 'package:tutelarfluttersdk/tutelarfluttersdk.dart';
import 'dart:async';
import 'package:tutelarfluttersdk_example/theme.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: AppTheme.lightTheme,
      home: const DemoApp(),
    );
  }
}

class DemoApp extends StatefulWidget {
  const DemoApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<DemoApp> createState() => _DemoAppState();
}

class _DemoAppState extends State<DemoApp> {
  late Tutelar tutelar;
  String detail = "";

  [@override](/user/override)
  void initState() {
    super.initState();
    tutelar = Tutelar("YOUR API KEY");
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      color: Colors.white,
      child: ListView(
        scrollDirection: Axis.vertical,
        children: [
          Padding(
            padding: const EdgeInsets.only(left: 50, top: 25, right: 50, bottom: 0),
            child: ElevatedButton(
              onPressed: () async {
                var response = await tutelar.getDeviceDetails();
                setState(() {
                  if(response['success'] == true){
                    detail = response['data'];
                  } else {
                    detail = response['message'];
                  }
                });
              },
              child: const Text(
                "GET DETAIL",
              ),
            ),
          ),
          Padding(
            padding: const EdgeInsets.all(30.0),
            child: Text(
              detail,
              style: const TextStyle(
                color: Colors.black,
                decoration: TextDecoration.none,
                fontSize: 12,
              ),
            ),
          ),
        ],
      ),
    );
  }
}