Flutter YouTube数据获取插件youtube_explode_dart的使用

简介

youtube_explode_dart 是一个基于C#版本 YoutubeExplode 的Dart端口，它提供了一个接口来查询YouTube视频、播放列表和频道的元数据，以及解析和下载视频流和字幕。由于它不使用官方API，因此不需要API密钥，并且没有使用配额限制。

主要特性

• 检索视频、播放列表、频道、流媒体和字幕的元数据
• 执行搜索查询并获取结果视频
• 获取或下载视频流
• 获取字幕
• 获取视频评论

安装

在 pubspec.yaml 文件中添加依赖（请检查最新版本）：

dependencies:
  youtube_explode_dart: ^2.3.4

然后在 Dart 文件中导入库：

import 'package:youtube_explode_dart/youtube_explode_dart.dart';

使用示例

获取视频元数据

以下代码展示了如何从YouTube视频中提取各种元数据：

import 'package:youtube_explode_dart/youtube_explode_dart.dart';

Future<void> main() async {
  final yt = YoutubeExplode();

  // 获取视频元数据
  final video = await yt.videos.get('https://youtube.com/watch?v=Dpp1sIL1m5Q');
  print(video.title); // 输出视频标题
  print(video.author); // 输出作者
  print(video.duration); // 输出时长

  // 关闭客户端
  yt.close();
}

下载视频流

每个YouTube视频都有多个可用的流，您可以根据需要选择合适的流进行下载：

import 'package:youtube_explode_dart/youtube_explode_dart.dart';
import 'dart:io';

Future<void> main() async {
  final yt = YoutubeExplode();

  // 获取流清单
  final manifest = await yt.videos.streams.getManifest('Dpp1sIL1m5Q');

  // 获取最高比特率的音频流
  final audioStreamInfo = manifest.audioOnly.withHighestBitrate();

  // 获取实际的字节流
  final stream = await yt.videos.streams.get(audioStreamInfo);

  // 创建文件并写入流内容
  final file = File('audio.mp4');
  final fileStream = file.openWrite();
  await stream.pipe(fileStream);
  await fileStream.flush();
  await fileStream.close();

  // 关闭客户端
  yt.close();
}

处理播放列表

您还可以使用 youtube_explode_dart 来处理播放列表：

import 'package:youtube_explode_dart/youtube_explode_dart.dart';

Future<void> main() async {
  final yt = YoutubeExplode();

  // 获取播放列表元数据
  final playlist = await yt.playlists.get('PLxxxxx');

  print(playlist.title);
  print(playlist.author);

  // 获取播放列表中的视频
  await for (var video in yt.playlists.getVideos(playlist.id)) {
    print(video.title);
    print(video.author);
  }

  // 关闭客户端
  yt.close();
}

提取字幕

提取字幕也很简单：

import 'package:youtube_explode_dart/youtube_explode_dart.dart';

Future<void> main() async {
  final yt = YoutubeExplode();

  // 获取字幕清单
  final trackManifest = await yt.videos.closedCaptions.getManifest('_QdPW8JrYzQ');

  // 获取英语字幕
  final trackInfo = trackManifest.getByLanguage('en');
  
  if (trackInfo != null) {
    // 获取实际的字幕轨道
    final track = await yt.videos.closedCaptions.get(trackInfo);
    
    // 获取1:01处的字幕
    final caption = track.getByTime(Duration(seconds: 61));
    print(caption?.text); // 输出字幕文本
  }

  // 关闭客户端
  yt.close();
}

获取评论

获取视频评论也非常容易：

import 'package:youtube_explode_dart/youtube_explode_dart.dart';

Future<void> main() async {
  final yt = YoutubeExplode();

  // 获取视频
  final video = await yt.videos.get('https://youtube.com/watch?v=Dpp1sIL1m5Q');

  // 获取评论
  var comments = await yt.videos.comments.getComments(video);

  // 打印前几条评论
  for (var comment in comments.take(5)) {
    print(comment.text);
  }

  // 获取更多评论
  comments = await comments.nextPage();
  if (comments != null) {
    for (var comment in comments.take(5)) {
      print(comment.text);
    }
  }

  // 关闭客户端
  yt.close();
}

清理

使用完毕后，请确保关闭 YoutubeExplode 的 HTTP 客户端，以防止 Dart 进程挂起：

yt.close();

故障排除

如果遇到问题，请先检查是否已在 issues section 中报告过。报告新问题时，请务必遵循问题模板，并提供导致问题的视频ID（如适用）和代码片段。

更多信息

更多示例和详细文档可以在 GitHub 和 API 文档 中找到。

希望这些信息能帮助您更好地使用 youtube_explode_dart 插件！如果有任何问题或需要进一步的帮助，请随时提问。