Flutter微控制器通信插件flutter_mcu_api的使用

特性

• 简单的身份验证，TS值在拦截器中基于API密钥计算
• 所有端点及其关系都在端点对象中管理
• 可以轻松通过map传递查询参数
• 所有现有的图像变体都作为枚举可用

开始使用

首先，您需要API密钥，您可以在开发者页面获取它们。 请注意并考虑Marvel API的使用条款。

使用方法

获取角色列表

// 准备
McuApi api = McuApi(
    publicApiKey: '您的公共API密钥',
    privateApiKey: '您的私有API密钥'
);

// 获取前20个角色
final ApiResponse<CharacterDataContainer> response = await api.characters.fetch();

// 使用查询参数获取接下来的20个角色
final ApiResponse<CharacterDataContainer> response = await api.characters.fetch(args: { 'offset': 20 });

// 根据ID获取一个角色
final ApiResponse<CharacterDataContainer> response = await api.characters.fetch(id: 4711);

获取角色关联

// 通过角色获取漫画列表
final ApiResponse<CharacterDataContainer> response = await api.characters.comics(4711);

// 从角色获取事件列表
final ApiResponse<CharacterDataContainer> response = await api.characters.events(4711);

获取图像变体

final imageUrl = response.thumbnail?.getImageVariant(ImageSizes.standard_large);

额外信息

建议查看Marvel API的使用指南和交互式文档。

---

```dart
// example/lib/main.dart

import 'package:example/pages/character_page.dart';
import 'package:example/pages/comic_page.dart';
import 'package:example/pages/creator_page.dart';
import 'package:example/pages/events_page.dart';
import 'package:example/pages/series_page.dart';
import 'package:example/pages/stories_page.dart';
import 'package:flutter/material.dart';
import 'package:flutter_mcu_api/flutter_mcu_api.dart';

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

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

  // 这个小部件是你的应用的根节点。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'MCU Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  int currentViewIndex = 0;

  late McuApi _mcuApi;
  // 设置您的API密钥
  final String publicApiKey = const String.fromEnvironment('publicKey');
  final String privateApiKey = const String.fromEnvironment('privateKey');

  _HomePageState();

  [@override](/user/override)
  void initState() {
    super.initState();
    _mcuApi = McuApi(
      publicApiKey: publicApiKey, // 使用您自己的公共密钥
      privateApiKey: privateApiKey, // 使用您自己的私有密钥
    );
  }

  void setIndex(int index) {
    setState(() {
      currentViewIndex = index;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    final textTheme = Theme.of(context).textTheme;
    return Scaffold(
      appBar: AppBar(
        title: const Text('MCU英雄'),
      ),
      drawer: Drawer(
        child: ListView(
          padding: const EdgeInsets.all(0.0),
          children: [
            DrawerHeader(
              decoration: const BoxDecoration(
                color: Colors.blue,
              ),
              child: Center(
                  child: Text(
                'MCU API Demo',
                style: textTheme.headlineSmall,
              )),
            ),
            ListTile(
              title: const Text('角色'),
              onTap: () {
                setIndex(0);
                Navigator.pop(context);
              },
            ),
            ListTile(
              title: const Text('漫画'),
              onTap: () {
                setIndex(1);
                Navigator.pop(context);
              },
            ),
            ListTile(
              title: const Text('创作者'),
              onTap: () {
                setIndex(2);
                Navigator.pop(context);
              },
            ),
            ListTile(
              title: const Text('事件'),
              onTap: () {
                setIndex(3);
                Navigator.pop(context);
              },
            ),
            ListTile(
              title: const Text('系列'),
              onTap: () {
                setIndex(4);
                Navigator.pop(context);
              },
            ),
            ListTile(
              title: const Text('故事'),
              onTap: () {
                setIndex(5);
                Navigator.pop(context);
              },
            ),
          ],
        ),
      ),
      body: IndexedStack(
        index: currentViewIndex,
        children: [
          CharacterPage(
            mcuApi: _mcuApi,
          ),
          ComicPage(mcuApi: _mcuApi),
          CreatorPage(mcuApi: _mcuApi),
          EventsPage(mcuApi: _mcuApi),
          SeriesPage(mcuApi: _mcuApi),
          StoriesPage(mcuApi: _mcuApi),
        ],
      ),
    );
  }
}