Flutter电视应用用户同意管理插件appconsent_tv的使用

AppConsent® cmp 是一个基于透明度的用户同意管理平台，特别适用于电视应用。下面将介绍如何在Flutter项目中集成和使用appconsent_tv插件。

获取开始

第一个示例

首先，通过setup方法初始化AppconsentTv，确保使用await关键字来等待初始化完成。然后，在需要的时候显示CMP（用户同意管理界面）。

import 'package:appconsent_tv/appconsent_tv.dart';

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

// 如果需要，在设置后显示CMP
AppconsentTv.presentNotice(false);

第二个示例

同样地，使用setup方法初始化AppconsentTv，然后调用AppconsentTv.presentNotice(false)来显示CMP。

import 'package:appconsent_tv/appconsent_tv.dart';

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

完整示例代码

以下是一个完整的Flutter TV应用示例，展示了如何集成和使用appconsent_tv插件：

import 'dart:async';
import 'dart:developer';

import 'package:appconsent_tv/appconsent_tv.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeController();
  runApp(const MyApp());
}

Future<void> initializeController() async {
  try {
    // 使用第一个方法在需要时显示CMP - 确保AWAIT setup
    await AppconsentTv.setup('APP_KEY', true, true);
  } catch (error, stacktrace) {
    log(error.toString());
    debugPrintStack(stackTrace: stacktrace);
  }
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

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

  @override
  void initState() {
    super.initState();
    initCMP();
  }

  Future<void> initCMP() async {
    showCMPIfNeeded();
  }

  Future<void> showCMPIfNeeded() async {
    bool isUpdateNeeded = await AppconsentTv.checkForUpdate;
    if (isUpdateNeeded) {
      await AppconsentTv.presentNotice(false);
    }
  }

  Future<void> showSettings() async {
    await AppconsentTv.presentNotice(true);
  }

  Future<void> resetConsent() async {
    await AppconsentTv.clearConsent();
  }

  Future<void> checkConsent() async {
    bool consentGiven;

    try {
      consentGiven = await AppconsentTv.consentGiven;
    } on PlatformException {
      consentGiven = false;
    }

    if (!mounted) return;

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

  @override
  Widget build(BuildContext context) {
    return Shortcuts(
        shortcuts: <LogicalKeySet, Intent>{
          LogicalKeySet(LogicalKeyboardKey.select): const ActivateIntent(),
        },
        child: MaterialApp(
          title: 'SFBX AppConsent Flutter TV',
          theme: ThemeData(
            primarySwatch: Colors.blue,
            visualDensity: VisualDensity.adaptivePlatformDensity,
          ),
          home: Scaffold(
            appBar: AppBar(
              title: const Text('SFBX AppConsent Flutter TV'),
            ),
            body: Center(
                child: Column(
                    mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                    children: [
                  ElevatedButton(
                    onPressed: showCMPIfNeeded,
                    child: const Text('Show CMP if needed'),
                  ),
                  ElevatedButton(
                    onPressed: showSettings,
                    child: const Text('Display Settings'),
                  ),
                  ElevatedButton(
                    onPressed: resetConsent,
                    child: const Text('Reset Consent'),
                  ),
                  ElevatedButton(
                    onPressed: checkConsent,
                    child: const Text('Check Consent'),
                  ),
                  Text('Consent Preferences Saved? $_consentGiven\n'),
                ])),
          ),
        ));
  }
}

文档

详细的文档可以在 这里 查阅。

通过以上步骤，您可以在Flutter电视应用中集成用户同意管理功能，确保符合隐私法规要求。