Flutter应用权限请求插件appconsent_classic的使用

Flutter应用权限请求插件appconsent_classic的使用

简介

appconsent_classic 是一个用于Flutter应用的权限管理插件，它基于透明度的同意管理平台（CMP），帮助开发者在应用中处理用户隐私和权限请求。通过该插件，开发者可以轻松地集成GDPR和ATT（App Tracking Transparency）相关的权限请求和管理功能。

插件图标

示例演示

• Android版本演示：

• iOS版本演示：

快速开始

第一个示例

首先，使用 setup 方法初始化 AppconsentClassic，确保在调用时使用 await 关键字以等待初始化完成。然后根据需要显示CMP（Consent Management Platform）。

import 'package:appconsent_classic/appconsent_classic.dart';

// 配置启动 (appKey: forceApplyGDPR: forceATT)
await AppconsentClassic.setup("YOUR_APP_KEY", true, true);

// 在初始化后显示CMP（如果需要）
AppconsentClassic.presentNotice(false);

第二个示例

初始化 AppconsentClassic 后，立即调用 presentNotice 方法来显示CMP。

import 'package:appconsent_classic/appconsent_classic.dart';

// 配置启动 (appKey: forceApplyGDPR: forceATT)
AppconsentClassic.setup("YOUR_APP_KEY", false, true)
    .then((value) => AppconsentClassic.presentNotice(false));

完整示例代码

以下是一个完整的Flutter应用示例，展示了如何使用 appconsent_classic 插件来处理权限请求和管理。

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:appconsent_classic/appconsent_classic.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool _consentGiven = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    initCMP();
  }

  // 初始化CMP
  Future<void> initCMP() async {
    // 使用你的应用密钥进行配置 (appKey: forceApplyGDPR: forceATT)
    await AppconsentClassic.setup(
        "4e9a99ed-1261-4241-8213-4f6e31d361c2", false, true);
    showCMPIfNeeded();
  }

  // 如果需要，显示CMP
  Future<void> showCMPIfNeeded() async {
    await AppconsentClassic.presentNotice(false);
  }

  // 显示设置页面
  Future<void> showSettings() async {
    await AppconsentClassic.presentNotice(true);
  }

  // 重置同意状态
  Future<void> resetConsent() async {
    await AppconsentClassic.clearConsent();
  }

  // 检查用户是否已同意
  Future<void> checkConsent() async {
    bool consentGiven;

    try {
      // 获取用户的同意状态
      consentGiven = await AppconsentClassic.consentGiven;
    } on PlatformException {
      // 如果出现异常，默认为未同意
      consentGiven = false;
    }

    if (!mounted) return;

    setState(() {
      _consentGiven = consentGiven;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('SFBX AppConsent Flutter'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              ElevatedButton(
                onPressed: showCMPIfNeeded,
                child: const Text('显示CMP（如果需要）'),
              ),
              ElevatedButton(
                onPressed: showSettings,
                child: const Text('显示设置'),
              ),
              ElevatedButton(
                onPressed: resetConsent,
                child: const Text('重置同意状态'),
              ),
              ElevatedButton(
                onPressed: checkConsent,
                child: const Text('检查同意状态'),
              ),
              Text('用户已同意？ $_consentGiven\n'),
            ],
          ),
        ),
      ),
    );
  }
}