Flutter不良词汇检测插件ai_profanity_textfield的使用

AI Profanity TextField 🛡️

一个智能的、基于AI的Flutter文本字段小部件，使用Gemini API实时过滤不良词汇！在任何语言中保持应用内容的清洁和友好！✨

特性 🌟

• 🌍 支持所有语言的多语言不良词汇检测
• 🤖 使用Gemini的AI支持不良词汇检测
• ✅ 支持自定义验证器
• ⚡ 实时验证（边打字边验证）
• 🎨 完全可定制的外观
• 🔄 加载指示器和验证状态
• ❌ 自定义错误消息
• ✅ 成功指示器
• 🕒 支持防抖动以优化性能

语言支持 🌐

多亏了Gemini强大的AI能力，我们的小部件可以检测以下语言中的不良词汇：

• 英语 🇺🇸
• 西班牙语 🇪🇸
• 法语 🇫🇷
• 德语 🇩🇪
• 土耳其语 🇹🇷
• 中文 🇨🇳
• 日语 🇯🇵
• 韩语 🇰🇷
• 阿拉伯语 🇸🇦
• 俄语 🇷🇺
• …还有很多！

AI模型理解每种语言的上下文和文化细微差别，确保全球范围内准确的不良词汇检测！ 🌎

开始使用 🚀

安装

在pubspec.yaml文件中添加以下内容：

dependencies:
  ai_profanity_textfield: ^1.0.0

获取您的API密钥

1. 访问 Google AI Studio
2. 使用您的Google帐户登录
3. 点击“创建API密钥”
4. 复制您的API密钥

快速开始 🏃

ProfanityTextFormField(
  geminiService: geminiService, // 您的Gemini服务实例
  decoration: InputDecoration(
    hintText: 'Enter text here...',
  ),
  onProfanityDetected: (text) {
    print('Profanity detected in: $text');
  },
)

自定义验证器 ✨

您可以添加自己的验证规则，与AI不良词汇检测一起使用！

ProfanityTextFormField(
  geminiService: geminiService,
  checkWhileTyping: true,
  debounceDuration: const Duration(milliseconds: 500),
  validators: [
    (value) => value.isEmpty ? 'Required field' : null,
    (value) => value.length < 3 ? 'Too short' : null,
    (value) => !value.contains('@') ? 'Must contain @' : null,
  ],
  onProfanityDetected: (text) => print('Profanity detected!'),
  onCleanText: (text) => print('Text is clean and valid'),
  decoration: InputDecoration(
    hintText: 'Type something...',
    fillColor: Colors.white,
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(18),
    ),
  ),
  showValidIcon: true,
  profanityMessage: 'Oops! Let\'s keep it friendly 😊',
  validationMessageDuration: const Duration(seconds: 3),
)

验证过程 🔄

1. 自定义验证器首先运行，按它们定义的顺序。
2. 如果所有自定义验证通过，将运行AI不良词汇检查。
3. 文本仅当自定义验证和不良词汇检查都通过时才被视为有效。

多语言示例 🌐

ProfanityTextFormField(
  geminiService: geminiService,
  decoration: InputDecoration(
    hintText: '여기에 텍스트를 입력하세요...', // 韩语
    // 或者 '在此输入文字...' // 中文
    // 或者 'Écrivez ici...' // 法语
    // 等等
  ),
  profanityMessage: 'Lütfen nazik olalım! 😊', // 土耳其语
  validators: [
    // 自定义验证器适用于任何语言！
    (value) {
      if (value.length < 5) {
        return '最小5文字必要です'; // 日语错误信息
      }
      return null;
    },
  ],
)

高级功能 🔧

实时验证 ⚡

小部件在用户输入时验证文本，并带有可自定义的防抖持续时间：

ProfanityTextFormField(
  geminiService: geminiService,
  checkWhileTyping: true,
  debounceDuration: Duration(milliseconds: 500),
  validators: [
    // 自定义验证器也实时运行！
    (value) => value.length < 3 ? 'Too short!' : null,
  ],
  onCleanText: (text) {
    print('Text is clean and valid: $text');
  },
)

自定义样式 🎨

让其匹配您的应用程序主题：

ProfanityTextFormField(
  geminiService: geminiService,
  successDecoration: InputDecoration(
    fillColor: Colors.green,
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(18),
    ),
  ),
  profanityDecoration: InputDecoration(
    fillColor: Colors.red,
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(18),
    ),
  ),
  progressIndicatorColor: Colors.blue,
  progressIndicatorSize: 20,
)

验证状态 🚦

小部件提供了不同的状态，具有可自定义的外观：

• ⏳ 加载中
• ✅ 有效（所有自定义验证和不良词汇检查均通过）
• ❌ 无效
• 🆕 初始状态

错误处理 🚫

任何语言的自定义错误消息和处理程序：

ProfanityTextFormField(
  geminiService: geminiService,
  profanityMessage: 'Please keep it friendly! 😊',
  validators: [
    (value) => value.isEmpty ? 'Field cannot be empty!' : null,
  ],
  onError: (error) {
    print('Error occurred: $error');
  },
  clearOnProfanity: true,
)

属性 📋

示例 📝

用户名字段

ProfanityTextFormField(
  geminiService: geminiService,
  decoration: InputDecoration(
    labelText: 'Username',
    prefixIcon: Icon(Icons.person),
  ),
  validators: [
    (value) => value.length < 3 ? 'Username too short' : null,
    (value) => value.contains(' ') ? 'No spaces allowed' : null,
  ],
)

评论字段

ProfanityTextFormField(
  geminiService: geminiService,
  decoration: InputDecoration(
    labelText: 'Comment',
    hintText: 'Share your thoughts...',
  ),
  maxLines: 3,
  clearOnProfanity: true,
  profanityMessage: 'Please keep comments friendly!',
)

搜索字段

ProfanityTextFormField(
  geminiService: geminiService,
  decoration: InputDecoration(
    labelText: 'Search',
    prefixIcon: Icon(Icons.search),
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(30),
    ),
  ),
  debounceDuration: Duration(milliseconds: 300),
)