Flutter YouTube API集成插件youtube_api_client的使用

Flutter YouTube API 集成插件 youtube_api_client 的使用

YouTube API 客户端 (youtube_api_client)

这个插件是从 youtube_api 分叉而来，并进行了全面重构和改进。它是一个用于通过 API 与 YouTube 服务器交互以获取数据的 Flutter 插件，支持 iOS 和 Android 平台。

特性

• 按关键词或 ID 搜索视频、播放列表和频道。
• 根据地区代码获取热门视频。

使用方法

要使用此插件，在 pubspec.yaml 文件中添加 youtube_api_client 作为依赖项。

示例

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'package:youtube_api_client/youtube_api.dart';

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

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

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

class _DemoAppState extends State<DemoApp> {
  static String _key = "YOUR_API_KEY"; // 替换为你的 API 密钥

  final _youtube = YoutubeApi(_key);
  List<ApiResult> _result = [];

  Future<void> callAPI() async {
    String query = "Flutter";
    _result = await _youtube.search(
      query,
      options: SearchOptions(
        order: Order.relevance,
        videoDuration: VideoDuration.any,
      ),
    );

    // 获取仅频道类型的结果
    _result = await _youtube.search(
      query,
      options: SearchOptions(
        type: [ResultType.channel],
      ),
    );

    // 获取下一页结果
    _result = (await _youtube.nextPage()) ?? [];

    // 按 ID 搜索视频
    _result = await _youtube.searchVideosById([
      "4AoFA19gbLo"
    ], parts: {
      VideoPart.snippet,
      VideoPart.contentDetails,
    });

    // 按 ID 搜索播放列表
    _result = await _youtube
        .searchPlaylistsById(["PLjxrf2q8roU0WrDTm4tUB430Mja7dQEVP"]);

    // 按 ID 搜索频道
    _result = await _youtube.searchChannelsById([
      "UCwXdFgeE9KYzlDdR7TG9cMw"
    ], parts: {
      ChannelPart.snippet,
      ChannelPart.brandingSettings,
    });

    setState(() {});
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    callAPI();
    print('hello');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.blue[100],
      appBar: AppBar(
        title: Text('YouTube API'),
      ),
      body: ListView(
        children: _result.map<Widget>(listItem).toList(),
      ),
    );
  }

  Widget listItem(ApiResult obj) {
    return Card(
      child: Container(
        margin: EdgeInsets.symmetric(vertical: 7.0),
        padding: EdgeInsets.all(12.0),
        child: Row(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: <Widget>[
            if (obj.snippet != null) ...[
              if (obj.snippet!.thumbnails != null)
                Padding(
                  padding: const EdgeInsets.only(right: 20.0),
                  child: Image.network(
                    obj.snippet!.thumbnails![ThumbnailResolution.default_]?.url ??
                        '',
                    width: 120.0,
                  ),
                ),
            ],
            Expanded(
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: <Widget>[
                  Text(
                    obj.url,
                    softWrap: true,
                  ),
                  if (obj is YoutubeVideo)
                    ..._buildVideoElements(obj)
                  else if (obj is YoutubeChannel)
                    ..._buildChannelElements(obj)
                  else if (obj is YoutubePlaylist)
                    ..._buildPlaylistElements(obj)
                ],
              ),
            )
          ],
        ),
      ),
    );
  }

  List<Widget> _buildVideoElements(YoutubeVideo obj) => [
        if (obj.snippet != null) ...[
          Text(
            obj.snippet!.title ?? '',
            style: TextStyle(fontSize: 18.0),
          ),
          Padding(
            padding: EdgeInsets.symmetric(vertical: 3.0),
            child: Text(
              obj.snippet!.channelTitle ?? '',
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
          ),
          Text("publishedAt: ${obj.snippet!.publishedAt}"),
          Text("tags: ${obj.snippet!.tags?.take(3).join(", ")}"),
          Text("category: ${obj.snippet!.category?.name}"),
        ],
        if (obj.contentDetails != null) ...[
          Text("duration: ${obj.contentDetails?.duration}"),
        ],
      ];

  List<Widget> _buildChannelElements(YoutubeChannel obj) => [
        if (obj.snippet != null) ...[
          Text(
            obj.snippet!.title ?? '',
            style: TextStyle(fontSize: 18.0),
          ),
          Padding(
            padding: EdgeInsets.symmetric(vertical: 3.0),
            child: Text(
              obj.snippet!.customUrl ?? '',
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
          ),
          Text("publishedAt: ${obj.snippet!.publishedAt}"),
          Text("description: ${obj.snippet!.description}"),
        ],
        if (obj.brandingSettings != null) ...[
          Text(
            obj.brandingSettings!.country ?? '',
            style: TextStyle(fontSize: 18.0),
          ),
          Padding(
            padding: EdgeInsets.symmetric(vertical: 3.0),
            child: Text(
              obj.brandingSettings!.keywords.toString(),
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
          ),
          Text("moderateComments: ${obj.brandingSettings!.moderateComments}"),
          Text("unsubscribedTrailer: ${obj.brandingSettings!.unsubscribedTrailer}"),
        ],
      ];

  List<Widget> _buildPlaylistElements(YoutubePlaylist obj) => [
        if (obj.snippet != null) ...[
          Text(
            obj.snippet!.title ?? '',
            style: TextStyle(fontSize: 18.0),
          ),
          Padding(
            padding: EdgeInsets.symmetric(vertical: 3.0),
            child: Text(
              obj.snippet!.channelTitle ?? '',
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
          ),
          Text("publishedAt: ${obj.snippet!.publishedAt}"),
        ],
      ];
}