Flutter Pixiv API访问插件pixiv_dart_api的使用

pixiv_dart_api 是一个用于访问 Pixiv API 的 Dart/Flutter 插件。它允许开发者在 Flutter 应用中与 Pixiv 的 API 进行交互，获取插画、漫画、用户信息等数据。

以下是如何在 Flutter 项目中使用 pixiv_dart_api 的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 pixiv_dart_api 依赖：

dependencies:
  flutter:
    sdk: flutter
  pixiv_dart_api: ^0.1.0  # 请使用最新版本

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

2. 导入包

在需要使用 Pixiv API 的 Dart 文件中导入 pixiv_dart_api：

import 'package:pixiv_dart_api/pixiv_dart_api.dart';

3. 初始化 Pixiv API 客户端

在使用 API 之前，你需要初始化一个 PixivApiClient 实例。通常你需要提供 Pixiv 的登录凭据（如用户名和密码）来进行认证。

final client = PixivApiClient();
await client.auth(username: 'your_username', password: 'your_password');

4. 使用 API 获取数据

一旦你成功认证，就可以使用 PixivApiClient 实例来访问 Pixiv 的 API 了。以下是一些常见的 API 调用示例：

获取插画详情

final illustration = await client.getIllustrationDetail(illustrationId: 123456);
print(illustration.title);

获取用户作品

final userIllustrations = await client.getUserIllustrations(userId: 789012);
print(userIllustrations.length);

搜索插画

final searchResults = await client.searchIllustrations(word: '初音ミク');
print(searchResults.total);

获取排行榜

final ranking = await client.getIllustrationRanking(mode: 'day');
print(ranking.illusts.length);

5. 处理响应

API 调用会返回相应的数据模型，你可以根据需要对数据进行处理和展示。

6. 错误处理

在使用 API 时，可能会遇到各种错误（如网络错误、认证失败等），建议使用 try-catch 语句来捕获并处理这些错误。

try {
  final illustration = await client.getIllustrationDetail(illustrationId: 123456);
  print(illustration.title);
} catch (e) {
  print('Error: $e');
}

7. 释放资源

在不再需要使用 PixivApiClient 时，可以调用 dispose 方法来释放资源。

client.dispose();

示例代码

以下是一个完整的示例，展示如何使用 pixiv_dart_api 获取插画详情并显示在 Flutter 应用中：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: PixivIllustrationDetailScreen(),
    );
  }
}

class PixivIllustrationDetailScreen extends StatefulWidget {
  [@override](/user/override)
  _PixivIllustrationDetailScreenState createState() => _PixivIllustrationDetailScreenState();
}

class _PixivIllustrationDetailScreenState extends State<PixivIllustrationDetailScreen> {
  Illustration? illustration;
  bool isLoading = true;

  [@override](/user/override)
  void initState() {
    super.initState();
    fetchIllustrationDetail();
  }

  Future<void> fetchIllustrationDetail() async {
    final client = PixivApiClient();
    try {
      await client.auth(username: 'your_username', password: 'your_password');
      final result = await client.getIllustrationDetail(illustrationId: 123456);
      setState(() {
        illustration = result;
        isLoading = false;
      });
    } catch (e) {
      print('Error: $e');
      setState(() {
        isLoading = false;
      });
    } finally {
      client.dispose();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Pixiv Illustration Detail'),
      ),
      body: isLoading
          ? Center(child: CircularProgressIndicator())
          : illustration != null
              ? Center(
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      Text('Title: ${illustration!.title}'),
                      Text('Author: ${illustration!.user.name}'),
                      // 你可以在这里添加更多信息或显示插画图片
                    ],
                  ),
                )
              : Center(child: Text('Failed to load illustration')),
    );
  }
}