Flutter芯片组件插件my_chips_flutter_sdk的使用

描述

MyChips Flutter SDK插件用于在Flutter应用中集成奖励墙等功能。

使用

初始化SDK

在使用SDK之前，必须使用您的API密钥进行初始化。

await MCOfferwallSdk.instance.init(yourApiKey);

设置用户ID

您可以选择性地设置用户ID。如果您不提供用户ID，SDK将自动生成一个。一旦设置了用户ID（无论是手动还是自动），它将一直使用直到提供新的用户ID为止。要手动提供用户ID：

await MCOfferwallSdk.instance.setUserId(userId); 

检查奖励

要检查是否有奖励，请使用checkReward函数。该函数需要您的广告单元ID、奖励回调（如果有奖励会调用）以及错误回调：

MCOfferwallSdk.instance.checkReward(
    adUnitId: yourAdUnitId,
    onReward: (reward) {
        // 做一些与奖励相关的操作，这里我们只是打印出来
        print("Reward: $reward");
    },
    onError: (e, st) {
        // 在发生错误时做一些操作，这里我们只是打印出来
        print("Error: $e");
        print("Stacktrace: $st");
    });

显示奖励墙

为了显示奖励墙，我们提供了一个名为OfferwallPage的Widget。您应该将其作为页面展示，并使用您喜欢的导航包或方法。例如，使用默认的Flutter导航器：

Navigator.of(context).push(
    MaterialPageRoute(
        builder: (context) => OfferwallPage(
        adunitId: yourAdUnitId,
        ),
    ),
);

示例代码

以下是完整的示例代码，展示了如何使用my_chips_flutter_sdk插件。

import 'dart:developer';

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

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

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

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: Scaffold(
        body: MainAppBody(),
      ),
    );
  }
}

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

  @override
  State<MainAppBody> createState() => _MainAppBodyState();
}

class _MainAppBodyState extends State<MainAppBody> {
  late final AppLifecycleListener _appLifecycleListener;

  final adunitId = "5612fe1f-8cdb-4bb7-bc89-850fa59d2c9c";
  final apiKey = "3kQCjW1GfVOESHFd";
  final userId = "flutterTestUserId2";

  Future<void> initialize() async {
    // 初始化SDK并设置用户ID
    await MCOfferwallSdk.instance.init(apiKey);
    await MCOfferwallSdk.instance.setUserId(userId);

    // 在示例中，让我们在应用恢复时检查奖励
    _appLifecycleListener = AppLifecycleListener(
      onResume: () {
        log("Checking for reward");

        MCOfferwallSdk.instance.checkReward(
          adUnitId: adunitId,
          onReward: (reward) {
            // 显示SnackBar
            ScaffoldMessenger.of(context).showSnackBar(
              SnackBar(
                content: Text("Reward: ${reward.virtualCurrencyReward}"),
              ),
            );
            log("Reward: ${reward.virtualCurrencyReward}");
          },
          onError: (e, st) {
            // 显示带有错误信息的SnackBar
            ScaffoldMessenger.of(context).showSnackBar(
              SnackBar(
                content: Text("Error: $e"),
              ),
            );

            log("Error: $e");
          },
        );
      },
    );
  }

  @override
  void initState() {
    super.initState();
    initialize();
  }

  @override
  void dispose() {
    _appLifecycleListener.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Center(
      child: ElevatedButton(
          child: const Text('显示奖励墙！'),
          onPressed: () async {
            // 导航到奖励墙页面
            Navigator.of(context).push(
              MaterialPageRoute(
                builder: (context) => OfferwallPage(
                  adunitId: adunitId,
                ),
              ),
            );
          }),
    );
  }
}