Flutter游戏数据库查询插件igdb_dart_protobuff的使用

当然，以下是一个关于如何在Flutter项目中使用igdb_dart_protobuf插件来进行游戏数据库查询的示例代码。这个插件允许你访问IGDB（Internet Game Database）的游戏数据。

首先，确保你已经在pubspec.yaml文件中添加了依赖：

dependencies:
  flutter:
    sdk: flutter
  igdb_dart_protobuf: ^最新版本号  # 请替换为实际最新版本号

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

接下来，你需要进行一些初始化设置，比如获取IGDB的API密钥（这通常需要你注册一个IGDB账户并创建一个API密钥）。

下面是一个完整的示例代码，展示了如何使用igdb_dart_protobuf进行游戏查询：

import 'package:flutter/material.dart';
import 'package:igdb_dart_protobuf/igdb_dart_protobuf.dart';
import 'dart:convert';
import 'package:http/http.dart' as http;

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<Game> games = [];
  bool isLoading = false;

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

  Future<void> fetchGames() async {
    setState(() {
      isLoading = true;
    });

    final String apiKey = '你的IGDB API密钥';
    final String endpoint = 'https://api.igdb.com/v4/games';
    final String fields = 'name,platforms,release_dates';
    final String filter = 'platforms.id=41'; // 例如，只查询在PlayStation 4上的游戏
    final String sort = 'release_dates.date:desc'; // 按发布日期降序排序
    final String limit = '10'; // 限制返回结果数量

    final Uri uri = Uri.https(
      'api.igdb.com',
      '/v4/games',
      <String, String>{
        'fields': fields,
        'filter': filter,
        'sort': sort,
        'limit': limit,
        'key': apiKey,
      },
    );

    try {
      final response = await http.get(uri);
      if (response.statusCode == 200) {
        final Map<String, dynamic> responseBody = jsonDecode(response.body);
        final List<dynamic> rawGames = responseBody['data'];

        // 假设你已经有igdb_dart_protobuf生成的Game类和其他相关类
        // 这里我们模拟解析过程，实际使用时需要根据你的protobuf文件生成的代码来解析
        // 由于protobuf的使用涉及到生成代码，这里不展示生成代码的过程，但基本流程如下：
        // 1. 使用protoc编译你的.proto文件生成Dart代码
        // 2. 使用生成的代码来解析响应数据

        // 示例解析（这里仅作为示意，实际代码会依赖于protobuf生成的类）
        // List<Game> parsedGames = rawGames.map((gameData) => Game.fromJson(gameData)).toList();

        // 由于我们没有实际的protobuf生成代码，这里直接假设解析完成并赋值给games
        // 请注意，这里的代码需要根据你实际的protobuf生成代码进行调整
        games = rawGames.map((gameData) {
          // 这是一个模拟的Game对象，实际中应使用protobuf生成的类
          return Game()
            ..name = gameData['name']
            ..platforms = (gameData['platforms'] as List).map((platform) => Platform()..name = platform['name']).toList()
            ..releaseDates = (gameData['release_dates'] as List).map((date) => ReleaseDate()..date = date['date']).toList();
        }).toList();

        setState(() {});
      } else {
        throw Exception('Failed to load games');
      }
    } catch (e) {
      print('Error: $e');
    } finally {
      setState(() {
        isLoading = false;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('IGDB Game Query'),
        ),
        body: isLoading
            ? Center(child: CircularProgressIndicator())
            : ListView.builder(
                itemCount: games.length,
                itemBuilder: (context, index) {
                  final Game game = games[index];
                  return ListTile(
                    title: Text(game.name),
                    subtitle: Text('Platforms: ${game.platforms.map((platform) => platform.name).join(', ')}'),
                  );
                },
              ),
      ),
    );
  }
}

// 模拟Game类（实际中应使用protobuf生成的类）
class Game {
  String name;
  List<Platform> platforms;
  List<ReleaseDate> releaseDates;

  Game({this.name, this.platforms, this.releaseDates});

  // 实际中应使用protobuf生成的fromJson方法
  Game.fromJson(Map<String, dynamic> json) {
    name = json['name'];
    // platforms和releaseDates的解析需要基于protobuf生成的类进行
  }
}

// 模拟Platform类（实际中应使用protobuf生成的类）
class Platform {
  String name;

  Platform({this.name});
}

// 模拟ReleaseDate类（实际中应使用protobuf生成的类）
class ReleaseDate {
  String date;

  ReleaseDate({this.date});
}

注意：

1. 上面的代码示例中，Game、Platform和ReleaseDate类是基于JSON解析的模拟类。在实际使用中，你需要使用protoc工具从IGDB的.proto文件生成相应的Dart类，并使用这些类来解析从IGDB API获取的数据。

2. igdb_dart_protobuf插件本身可能不包含直接用于HTTP请求的代码，因此你可能需要结合http包或其他网络请求库来使用。

3. 由于IGDB的API可能会更新，因此请确保你使用的API端点、字段名称和参数是最新的。

4. 在实际开发中，请妥善处理API密钥，不要将其硬编码在客户端代码中，而是考虑使用环境变量或安全的密钥管理服务。