Flutter信息检索插件nookipedia_flutter的使用

特性

该插件包含以下端点的包装方法：

1. 艺术品
2. 衣服
3. 活动
4. 家具
5. 室内装饰
6. 游戏中可用的其他物品
7. 照片和海报
8. 配方
9. 工具
10. 村民
11. 昆虫
12. 鱼类
13. 海洋生物
14. 化石

开始使用

首先，需要导入该插件：

import 'package:nookipedia_flutter/nookipedia_flutter.dart';

然后，在使用之前初始化NookipediaClient：

void main() {
  NookipediaClient.initialize(
    apiKey: "YOUR_API_KEY_HERE", // 必填。你需要在这里填写你的API密钥。
    version: "API_VERSION_HERE", // 可选。它控制你调用哪个版本的API。
  );
  runApp(const MyApp());
}

使用方法

你可以通过客户端实例调用API提供的方法：

// 使用FutureBuilder来异步获取数据并显示在界面上
FutureBuilder(
    future: NookipediaClient.instance.clothing
        .fetchNames(category: ClothingCategory.dressUp), // 获取特定类别（例如dressUp）的衣服名称列表
    builder: ((context, AsyncSnapshot<List<String>> snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator()); // 加载指示器
        }
        if (snapshot.hasError) {
            return Text(snapshot.error?.toString() ?? "Something went wrong"); // 错误处理
        }
        var data = snapshot.data!;
        return ListView.builder( // 构建一个滚动视图
            itemCount: data.length,
            itemBuilder: ((context, index) {
                return ListTile(title: Text(data[index])); // 显示每条数据
            }),
        );
    }),
)

完整示例代码

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

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

void main() {
  NookipediaClient.initialize(
    apiKey: "YOUR_API_KEY_HERE", // 请替换为你的API密钥
  );
  runApp(const MyApp());
}

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

  // 这是应用的根组件
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatelessWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(title),
      ),
      body: FutureBuilder(
        future: NookipediaClient.instance.clothing
            .fetchNames(category: ClothingCategory.dressUp), // 获取特定类别（例如dressUp）的衣服名称列表
        builder: ((context, AsyncSnapshot<List<String>> snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator()); // 加载指示器
          }
          if (snapshot.hasError) {
            return Text(snapshot.error?.toString() ?? "Something went wrong"); // 错误处理
          }
          var data = snapshot.data!;
          return ListView.builder( // 构建一个滚动视图
            itemCount: data.length,
            itemBuilder: ((context, index) {
              return ListTile(title: Text(data[index])); // 显示每条数据
            }),
          );
        }),
      ),
    );
  }
}