Flutter元数据管理插件wzap_meta的使用

Wzap Meta

Wzap Meta 是为W2O Softwares开发的，旨在通过与Meta集成的API发送WhatsApp消息。

如何使用

首先，在您的pubspec.yaml文件中添加wzap_meta插件。

更改仓库URL以匹配您的Bitbucket用户名。例如，我的用户名是adilsonjuniordev，请将其替换为您自己的用户名：

dependencies:
  wzap:
    git:
      url: https://adilsonjuniordev@bitbucket.org/time-w2o/wzapmeta-flutter-package.git
      ref: main

首先，需要在项目中初始化该包并设置必要的配置。在您的main函数中添加以下代码：

import 'package:wzap_meta/wzap_meta.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化WzapMessenger
  await WzapMessenger.instance.configure(apiKey: 'SUA_API_KEY');

  runApp(MyApp());
}

配置完成后，就可以使用发送消息的方法了。

以下是一个使用示例：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 必须填写API密钥
  await WzapMessenger.instance.configure(apiKey: '');

  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'WzapMeta W2O Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(),
      debugShowCheckedModeBanner: false,
    );
  }
}

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

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool isLoading = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('WzapMeta W2O Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            isLoading
                ? const Column(
                    children: [
                      CircularProgressIndicator(),
                      SizedBox(height: 20),
                      Text('Enviando...', style: TextStyle(fontSize: 20)),
                    ],
                  )
                : const Text(
                    '按按钮发送WhatsApp消息',
                  ),
          ],
        ),
      ),
      floatingActionButton: isLoading
          ? null
          : FloatingActionButton(
              onPressed: _sendMessage,
              tooltip: '发送',
              child: const Icon(Icons.send),
            ),
    );
  }

  void _sendMessage() async {
    isLoading = true;
    setState(() {});

    // 模拟延迟发送
    await Future.delayed(const Duration(seconds: 1));

    try {
      // 发送模板消息
      await WzapMessenger.instance
          .sendTemplateMessage(
        // 必须填写模板ID
        templateId: '',
        // 必须填写目标电话号码
        phoneNumber: '',
        // 必须填写变量
        message: MessageModel(body: ['João', '(35) 98765-4321']),
      );

      // 显示成功消息
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(
          content: Text(
            'WhatsApp消息发送成功',
            style: TextStyle(color: Colors.white),
          ),
          backgroundColor: Colors.green,
        ),
      );
    } catch (e) {
      // 显示错误消息
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(
          content: Text(
            '发送WhatsApp消息时出错',
            style: TextStyle(color: Colors.white),
          ),
          backgroundColor: Colors.red,
        ),
      );
    }

    isLoading = false;
    setState(() {});
  }
}