Flutter即时通讯插件instantly_sdk的使用

Instantly SDK For Dart（非官方）

Instantly SDK 是一个为 Dart 开发者设计的封装库，用于与 Instantly 邮件营销平台集成。它简化了在 Dart 或 Flutter 应用程序中发送邮件、管理订阅者以及分析活动表现的过程。

使用步骤

以下是一个完整的示例，展示如何在 Flutter 中使用 instantly_sdk 插件来发送邮件和管理订阅者。

1. 添加依赖

首先，在项目的 pubspec.yaml 文件中添加 instantly_sdk 依赖：

dependencies:
  instantly_sdk: ^1.0.0

然后运行 flutter pub get 来安装依赖。

2. 初始化 SDK

在使用之前，需要初始化 SDK 并设置您的 API 密钥。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final InstantlySdk _instantlySdk = InstantlySdk(apiKey: 'your_api_key_here');

  @override
  void initState() {
    super.initState();
    // 初始化 SDK
    _instantlySdk.initialize().then((_) {
      print('Instantly SDK initialized');
    }).catchError((error) {
      print('Failed to initialize SDK: $error');
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Instantly SDK Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            sendEmailAndManageSubscribers();
          },
          child: Text('Send Email & Manage Subscribers'),
        ),
      ),
    );
  }

  Future<void> sendEmailAndManageSubscribers() async {
    try {
      // 发送邮件
      await _instantlySdk.sendEmail(
        subject: 'Hello from Flutter',
        body: 'This is a test email sent from a Flutter app.',
        recipientEmails: ['example@example.com'],
      );

      // 管理订阅者
      await _instantlySdk.manageSubscriber(
        email: 'new_subscriber@example.com',
        action: SubscriberAction.subscribe,
      );

      print('Email sent and subscriber managed successfully.');
    } catch (error) {
      print('Error during email sending or subscriber management: $error');
    }
  }
}

3. 解释代码

初始化 SDK：
```
_instantlySdk.initialize()
```
调用 initialize 方法来初始化 SDK，并传入您的 API 密钥。

发送邮件：

_instantlySdk.sendEmail(
  subject: 'Hello from Flutter',
  body: 'This is a test email sent from a Flutter app.',
  recipientEmails: ['example@example.com'],
)

使用 sendEmail 方法发送邮件，传入主题、正文和收件人邮箱。

管理订阅者：

_instantlySdk.manageSubscriber(
  email: 'new_subscriber@example.com',
  action: SubscriberAction.subscribe,
)

更多关于Flutter即时通讯插件instantly_sdk的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

htzhanglong 1楼

更多关于Flutter即时通讯插件instantly_sdk的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

instantly_sdk 是一个用于 Flutter 的即时通讯插件，它可以帮助开发者快速集成即时通讯功能到 Flutter 应用中。以下是如何使用 instantly_sdk 的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 instantly_sdk 的依赖：

dependencies:
  flutter:
    sdk: flutter
  instantly_sdk: ^latest_version

然后运行 flutter pub get 来获取依赖。

2. 初始化 SDK

在你的 Flutter 项目中，首先需要初始化 instantly_sdk。通常，你可以在 main.dart 文件中进行初始化：

import 'package:instantly_sdk/instantly_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 Instantly SDK
  await InstantlySdk.initialize(
    apiKey: 'YOUR_API_KEY',
    userId: 'YOUR_USER_ID',
  );

  runApp(MyApp());
}

3. 登录用户

在初始化 SDK 之后，你需要登录用户。通常，这会在用户登录你的应用时进行：

await InstantlySdk.login(
  userId: 'YOUR_USER_ID',
  token: 'USER_AUTH_TOKEN',
);

4. 发送消息

你可以使用 InstantlySdk 来发送消息：

await InstantlySdk.sendMessage(
  channelId: 'CHANNEL_ID',
  message: 'Hello, World!',
);

5. 接收消息

为了接收消息，你需要监听消息流：

InstantlySdk.messageStream.listen((message) {
  print('Received message: ${message.content}');
});

6. 创建频道

你可以创建一个新的频道：

await InstantlySdk.createChannel(
  channelId: 'NEW_CHANNEL_ID',
  name: 'New Channel',
);

7. 加入频道

用户可以加入一个已有的频道：

await InstantlySdk.joinChannel(
  channelId: 'CHANNEL_ID',
);

8. 离开频道

用户可以离开一个频道：

await InstantlySdk.leaveChannel(
  channelId: 'CHANNEL_ID',
);

9. 获取频道列表

你可以获取用户所在的频道列表：

List<Channel> channels = await InstantlySdk.getChannels();

10. 获取消息历史

你可以获取某个频道的消息历史：

List<Message> messages = await InstantlySdk.getMessages(
  channelId: 'CHANNEL_ID',
);

11. 处理错误

在使用 SDK 时，可能会遇到错误。你可以通过捕获异常来处理这些错误：

try {
  await InstantlySdk.sendMessage(
    channelId: 'CHANNEL_ID',
    message: 'Hello, World!',
  );
} catch (e) {
  print('Error sending message: $e');
}

12. 注销用户

当用户注销时，你可以调用注销方法：

await InstantlySdk.logout();

13. 清理资源

在应用退出时，你可以清理 SDK 的资源：

await InstantlySdk.dispose();

示例代码

以下是一个简单的示例，展示了如何使用 instantly_sdk 进行基本的即时通讯操作：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await InstantlySdk.initialize(
    apiKey: 'YOUR_API_KEY',
    userId: 'YOUR_USER_ID',
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Instantly SDK Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                onPressed: () async {
                  await InstantlySdk.sendMessage(
                    channelId: 'CHANNEL_ID',
                    message: 'Hello, World!',
                  );
                },
                child: Text('Send Message'),
              ),
              ElevatedButton(
                onPressed: () async {
                  List<Message> messages = await InstantlySdk.getMessages(
                    channelId: 'CHANNEL_ID',
                  );
                  print('Messages: $messages');
                },
                child: Text('Get Messages'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}