Flutter广告拦截检测插件adblock_detector的使用

插件简介

adblock_detector 是一个跨平台的Flutter插件，用于检测用户是否启用了广告拦截器。它能够检查用户是否启用了DNS级别的广告拦截（如PiHole、AdGuard DNS、uBlock、Brave Shields等），并提供了一些内置的广告网络检测选项。

功能特性

• 检测用户是否启用了DNS级别的广告拦截器（如PiHole、AdGuard DNS、uBlock、Brave Shields等）。
• 检测用户是否启用了AdGuard DNS。

使用注意事项

请负责任地使用此插件！

使用方法

基本用法

import 'package:adblock_detector/adblock_detector.dart';

void checkAdBlock() async {
  AdBlockDetector adBlockDetector = AdBlockDetector();

  bool isAdblocking = await adBlockDetector.isAdBlockEnabled(
    testAdNetworks: [AdNetworks.googleAdMob],
  );

  print('AdBlock detected: $isAdblocking');
}

内置广告网络

插件提供了以下内置的广告网络：

• AdNetworks.googleAdMob
• AdNetworks.mediaNet
• AdNetworks.appSumari
• AdNetworks.startApp
• AdNetworks.adColony

请注意，某些广告网络在某些国家/地区可能被阻止（例如，在中国Google AdMob不会被阻止）。

自定义广告网络

您还可以传递自定义的广告网络进行检测：

import 'package:adblock_detector/adblock_detector.dart';

void checkCustomAdBlock() async {
  AdBlockDetector adBlockDetector = AdBlockDetector();

  bool isAdblocking = await adBlockDetector.isAdBlockEnabled(
    testAdNetworks: [],
    customAdNetworks: [Uri.parse('https://a-test-url-for-the-adnetwork.com')],
  );

  print('AdBlock detected: $isAdblocking');
}

检查网络连接

默认情况下，插件会尝试发送GET请求到https://example.com以检查是否有互联网连接。如果未检测到互联网连接，isAdBlockEnabled()将返回false以防止误报。

您可以更改测试URL：

import 'package:adblock_detector/adblock_detector.dart';

void checkAdBlockWithCustomTestHost() async {
  AdBlockDetector adBlockDetector = AdBlockDetector();

  adBlockDetector.testHost = Uri.parse('https://cdn.vibin.llc/test.txt');

  bool isAdblocking = await adBlockDetector.isAdBlockEnabled(
    testAdNetworks: [AdNetworks.googleAdMob],
  );

  print('AdBlock detected: $isAdblocking');
}

确保URL有效，并返回200状态码。

检查用户是否使用AdGuard DNS

import 'package:adblock_detector/adblock_detector.dart';

void checkAdGuardDNS() async {
  AdBlockDetector adBlockDetector = AdBlockDetector();

  bool isAdGuardDns = await adBlockDetector.isAdguardDNS();

  print('AdGuard DNS detected: $isAdGuardDns');
}

示例代码

以下是一个完整的示例应用，展示了如何使用adblock_detector插件：

import 'package:adblock_detector/adblock_detector.dart';
import 'package:flutter/material.dart';

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Adblock Detector Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Adblock Detector Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text('Press the button below to check for Adblock'),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton.extended(
        onPressed: () async {
          print('btn click');
          AdBlockDetector adBlockDetector = AdBlockDetector();
          print('testing adblock...');

          bool isAdblocking = await adBlockDetector.isAdBlockEnabled(
            testAdNetworks: [AdNetworks.googleAdMob],
          );

          print('adblock test complete with value: $isAdblocking');

          if (isAdblocking) {
            showDialog<void>(
              context: context,
              barrierDismissible: false,
              builder: (BuildContext context) {
                return AlertDialog(
                  title: const Text('AdBlock Detected'),
                  content: const SingleChildScrollView(
                    child: ListBody(
                      children: <Widget>[
                        Text('Adblock is detected on your device'),
                        Text('Would you like check if user is connected to AdGuard DNS?'),
                      ],
                    ),
                  ),
                  actions: <Widget>[
                    TextButton(
                      child: const Text('Check AdGuard DNS'),
                      onPressed: () async {
                        bool isAdGuardDns = await adBlockDetector.isAdguardDNS();

                        showDialog<void>(
                          context: context,
                          barrierDismissible: false,
                          builder: (BuildContext context) {
                            return AlertDialog(
                              title: Text('AdGuard DNS ${isAdGuardDns ? 'Detected' : 'Not Detected'}'),
                              actions: <Widget>[
                                TextButton(
                                  child: const Text('Close'),
                                  onPressed: () {
                                    Navigator.of(context).pop();
                                  },
                                ),
                              ],
                            );
                          },
                        );
                      },
                    ),
                    TextButton(
                      child: const Text('Close'),
                      onPressed: () {
                        Navigator.of(context).pop();
                      },
                    ),
                  ],
                );
              },
            );
          } else {
            showDialog<void>(
              context: context,
              barrierDismissible: false,
              builder: (BuildContext context) {
                return AlertDialog(
                  title: const Text('No AdBlock Detected'),
                  actions: <Widget>[
                    TextButton(
                      child: const Text('Close'),
                      onPressed: () {
                        Navigator.of(context).pop();
                      },
                    ),
                  ],
                );
              },
            );
          }
        },
        label: const Text('Run Adblock Detector'),
      ),
    );
  }
}

这个示例应用包含了一个浮动按钮，点击后会检测设备是否启用了广告拦截，并根据结果弹出相应的对话框。