Flutter用户同意管理插件flutter_conscent_plugin的使用

本文档将逐步指导您如何在您的应用程序中集成flutter_conscent_plugin。该插件基于Flutter开发，支持Android和iOS设备。

Step-1

使用我们的插件包作为库。

Step-2

在您的应用程序中传入clientId（客户端ID）和要使用的环境模式，如下所示的示例：

ConscentInitializer("your_client_id", MODE.SANDBOX);

1. clientId会在您创建ConsCent账户后获得，登录到客户端Conscent后可以获取访问权限。
2. 环境模式可以设置为MODE.SANDBOX或MODE.PRODUCTION。它用于配置不同环境的测试。

环境模式用于不同环境的配置测试。

Step-3

登录Conscent时，需要传递令牌（从API {{BASE_URL}}/client/generate-temp-token 获取的令牌）和电子邮件或电话号码。登录方法会返回两个参数：

• 成功：{status, userId}
• 失败：{status, message}

登录示例代码：

String redirectUrl = await ConscentMethods()
    .prepareAutoLoginUrl([(token.text), (phone.text), (email.text)]);

Navigator.push(
    context,
    MaterialPageRoute(
        builder: (context) => WebViewDefaultApp(
              redirectUrl: redirectUrl,
            )),
).then((value) {
    print("response $value");
    if (value != null) {
        ScaffoldMessenger.of(context).showSnackBar(SnackBar(
          content: Text('$value'),
        ));
    }
});

登出示例代码：

TextButton.icon(
    onPressed: () async {
        String? logout = await ConscentMethods().userLogOut();
        ScaffoldMessenger.of(context).showSnackBar(SnackBar(
          content: Text('${logout}'),
        ));
    },
    icon: const Icon(Icons.logout, size: 24.0),
    label: const Text('Logout'),
),

Step-4

检查内容是否免费/付费或需要付款，在您的类中使用以下示例：

支付格式说明：

登录到ConsCent后，验证凭据并购买高级内容。有三种支付方式：

1. CONTENT：按次计费系统，用户只需为他们想要访问的具体高级内容付费。
2. PASS：允许用户在1小时到14天内访问所有高级内容，具体时间可以在ConsCent仪表板中更改。
3. SUBSCRIPTION：允许用户从一个月开始访问所有高级内容。

检查内容访问权限示例代码：

ConscentInitializer.setContentId('your_content_id');

FutureBuilder<ContentAccessModel?>(
    future: ConscentMethods().getContentAccess(),
    builder: (context, snapshot) {
        if (snapshot.hasData) {
            if (snapshot.data!.signature != null) {
                showContent = true;
            } else {
                showContent = false;
            }
            setState(() {});
        }
        return Paywall((response) {
            // 根据响应处理逻辑
        });
    },
),

订阅示例代码：

FutureBuilder<Subscription_Access?>(
    future: ConscentMethods().getSubscriptionAccess(),
    builder: (context, snapshot) {
        if (snapshot.hasData) {
            return SubscriptionPaywall((response) {
                // 根据订阅响应处理逻辑
            });
        }
        return Container(); // 默认加载状态
    },
),

高级内容注册

当您使用ConsCent API时，必须根据所操作的环境更新API_URL变量。

此端点允许客户端在ConsCent上注册其内容，包括内容标题、内容ID、内容URL、标签、分析像素（Facebook和Google）、价格以及任何特定国家的价格覆盖（以设置相关内容在特定国家的价格）。此外，contentType字段是可选的，默认值为客户默认的contentType。通过在注册内容时传递priceCategory字段，可以启用类别定价，前提是类别已在ConsCent仪表板中注册并设置了相应的价格、持续时间和价格覆盖。

HTTP 请求示例：

POST {API_URL}/api/v1/content

授权：

客户端API密钥和密码必须通过Basic Auth传递在Authorization头中，其中API密钥作为用户名，API密码作为密码。

请求体示例：

示例代码

以下是完整的示例代码：

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter_conscent_plugin/conscent_initializer.dart';
import 'package:flutter_conscent_plugin/conscent_methods.dart';
import 'package:flutter_conscent_plugin/datamodel/api_mode.dart';
import 'package:flutter_conscent_plugin/datamodel/getuser_detail.dart';
import 'package:flutter_conscent_plugin/extra.dart';
import 'package:flutter_conscent_plugin/web_view_default.dart';
import 'package:flutter_inappwebview/flutter_inappwebview.dart';

import 'paywall.dart';

ConscentInitializer? conscentInitializer;

Future main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (!kIsWeb && kDebugMode && defaultTargetPlatform == TargetPlatform.android) {
    await InAppWebViewController.setWebContentsDebuggingEnabled(kDebugMode);
  }

  runApp(
    MaterialApp(
      theme: ThemeData(useMaterial3: true),
      home: const MyApps(),
    ),
  );

  conscentInitializer =
      ConscentInitializer("5f92a62013332e0f667794dc", ENVIRONMENTMODE.STAGE);
}

class MyApps extends StatefulWidget {
  const MyApps({super.key});

  [@override](/user/override)
  State<MyApps> createState() => _MyCustomForm();
}

class _MyCustomForm extends State<MyApps> {
  final clientIdController = TextEditingController();
  final contentIdController = TextEditingController();
  final token = TextEditingController();
  final phone = TextEditingController();
  final email = TextEditingController();

  [@override](/user/override)
  void initState() {
    super.initState();
    clientIdController.text = '5f92a62013332e0f667794dc';
    contentIdController.text = 'Client-Story-Id-1';
    token.text = '644291cf2ef1470d7c2a324c';
    email.text = "roshan@conscent.ai";
    phone.text = "";
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text(
          'Conscent 设置',
          style: TextStyle(color: Colors.white),
        ),
        backgroundColor: Colors.blue,
      ),
      body: SingleChildScrollView(
        child: Column(
          children: [
            TextFormField(
              controller: clientIdController,
              decoration: const InputDecoration(labelText: '输入您的ClientId'),
            ),
            TextFormField(
              controller: contentIdController,
              decoration: const InputDecoration(labelText: '输入您的ContentId'),
            ),
            TextFormField(
              controller: token,
              decoration: const InputDecoration(labelText: '输入登录Token'),
            ),
            TextFormField(
              controller: phone,
              decoration: const InputDecoration(labelText: '输入手机号码'),
            ),
            TextFormField(
              controller: email,
              decoration: const InputDecoration(labelText: '输入电子邮件'),
            ),
            TextButton.icon(
              onPressed: () {
                ConscentInitializer.setClientId(clientIdController.text);
                ConscentInitializer.setContentId(contentIdController.text);
                Navigator.push(
                  context,
                  MaterialPageRoute(builder: (context) => const MyAppff()),
                );
              },
              icon: const Icon(Icons.skip_next),
              label: const Text('下一步'),
            ),
            TextButton.icon(
              onPressed: () {
                ConscentInitializer.setContentId(contentIdController.text);
                Navigator.push(
                  context,
                  MaterialPageRoute(builder: (context) => MyAp()),
                );
              },
              icon: const Icon(Icons.mode),
              label: const Text('嵌入模式'),
            ),
            TextButton.icon(
              onPressed: () async {
                const CircularProgressIndicator();
                GetUserDetail? getusermain = await ConscentMethods().getUser();
                print('${getusermain?.toJson()}');
                if (context.mounted) {
                  showDialog<String>(
                    context: context,
                    builder: (BuildContext context) => AlertDialog(
                      title: const Text('用户详情'),
                      content: Text('${getusermain?.toJson()}'),
                      actions: [
                        TextButton(onPressed: () => Navigator.pop(context, 'Cancel'), child: const Text('取消')),
                        TextButton(onPressed: () => Navigator.pop(context, 'OK'), child: const Text('确认')),
                      ],
                    ),
                  );
                }
              },
              icon: const Icon(Icons.person),
              label: const Text('用户详情'),
            ),
            TextButton.icon(
              onPressed: () async {
                String redirectUrl = await ConscentMethods()
                    .prepareAutoLoginUrl([token.text, phone.text, email.text]);
                if (context.mounted) {
                  Navigator.push(
                    context,
                    MaterialPageRoute(
                        builder: (context) => WebViewDefaultApp(redirectUrl: redirectUrl)),
                  ).then((value) {
                    print("response $value");
                    if (value != null) {
                      ScaffoldMessenger.of(context).showSnackBar(SnackBar(
                        content: Text('$value'),
                      ));
                    }
                  });
                }
              },
              icon: const Icon(Icons.login),
              label: const Text('登录'),
            ),
            TextButton.icon(
              onPressed: () async {
                String? logout = await ConscentMethods().userLogOut();
                if (context.mounted) {
                  ScaffoldMessenger.of(context).showSnackBar(SnackBar(
                    content: Text('$logout'),
                  ));
                }
              },
              icon: const Icon(Icons.logout),
              label: const Text('登出'),
            ),
          ],
        ),
      ),
    );
  }
}