Flutter电影数据库查询插件jp_moviedb的使用

一个用于查询电影数据库的Flutter插件，该插件作为The Movie Database (TMDB) API的封装。它简化了与TMDB的交互，并提供了访问各种端点的简单方法。

功能

该插件目前支持以下TMDB API端点：

1. 发现电影
2. 搜索人员
3. 获取电影类型

安装

在你的pubspec.yaml文件中添加以下内容：

dependencies:
  jp_moviedb:
    git:
      url: https://github.com/jpDxsolo/moviedb.git

然后运行：

flutter pub get

使用

首先，导入插件：

import 'package:jp_moviedb/api.dart';
import 'package:jp_moviedb/filters/movie.dart';
import 'package:jp_moviedb/types/movie.dart';
import 'package:jp_moviedb/types/person.dart';
import 'package:jp_moviedb/types/genre.dart';

发现电影

要发现电影：

final TmdbApi api = TmdbApi('YOUR_API_KEY');
late Future<List<Movie>> movies;

[@override](/user/override)
void initState() {
  super.initState();
  MovieFilters filters = MovieFilters();
  filters.page = 10;
  filters.language = 'en';
  filters.primaryReleaseDateGte = DateTime(1980, 01, 01);
  filters.primaryReleaseDateLte = DateTime(1981, 01, 01);
  movies = api.discover.getMovies(filters);
}

搜索人员

要搜索人员：

late Future<List<Person>> persons;

[@override](/user/override)
void initState() {
  super.initState();
  persons = api.search.getPerson('Tom Hanks');
}

获取电影类型

要获取电影类型列表：

late Future<List<Genre>> genres;

[@override](/user/override)
void initState() {
  super.initState();
  genres = api.genres.getGenres();
}

示例代码

以下是一个完整的示例代码，展示了如何使用jp_moviedb插件来查询电影数据。

import 'package:flutter/material.dart';
import 'package:jp_moviedb/api.dart';
import 'package:jp_moviedb/filters/movie.dart';
import 'package:jp_moviedb/types/movie.dart';
import 'package:jp_moviedb/types/person.dart';
import 'package:jp_moviedb/types/genre.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '电影查询示例',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: '电影查询示例'),
    );
  }
}

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

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final TmdbApi api = TmdbApi('YOUR_API_KEY');
  late Future<List<Movie>> movies;
  late Future<List<Person>> persons;
  late Future<List<Genre>> genres;

  [@override](/user/override)
  void initState() {
    super.initState();
    MovieFilters filters = MovieFilters();
    filters.page = 10;
    filters.language = 'en';
    filters.primaryReleaseDateGte = DateTime(1980, 01, 01);
    filters.primaryReleaseDateLte = DateTime(1981, 01, 01);
    movies = api.discover.getMovies(filters);
    persons = api.search.getPerson('Tom Hanks');
    genres = api.genres.getGenres();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('电影查询示例'),
      ),
      body: Center(
        child: FutureBuilder<List<Movie>>(
          future: movies,
          builder: (context, snapshot) {
            if (snapshot.hasData) {
              return ListView.builder(
                itemCount: snapshot.data!.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Column(
                      children: [
                        Row(
                          children: [
                            Text(snapshot.data![index].title),
                            Padding(
                              padding: const EdgeInsets.all(8.0),
                              child: Text(
                                  '上映日期 ${snapshot.data![index].releaseDate.year.toString()}-${snapshot.data![index].releaseDate.month.toString()}-${snapshot.data![index].releaseDate.day.toString()}'),
                            )
                          ],
                        ),
                        Text(snapshot.data![index].overview)
                      ],
                    ),
                    subtitle: Image.network(snapshot.data![index].posterPath),
                  );
                },
              );
            } else if (snapshot.hasError) {
              return Text('${snapshot.error}');
            }
            // 默认显示加载指示器。
            return const CircularProgressIndicator();
          },
        ),
      ),
    );
  }
}