Flutter未知功能插件tivy的使用

根据提供的内容，tivy 是一个用于获取 Vimeo 和 YouTube 视频质量 URL 的实用包。以下是如何在 Flutter 项目中安装和使用 tivy 插件的详细说明。

安装 💻

步骤 1: 添加依赖

首先，在您的 pubspec.yaml 文件中添加 tivy 依赖：

dependencies:
  tivy: ^最新版本号

请确保将 ^最新版本号 替换为实际的最新版本号。您可以在 pub.dev 上找到最新版本号。

步骤 2: 安装依赖

运行以下命令来安装新添加的依赖项：

flutter packages get

使用

导入包

在需要使用 tivy 的 Dart 文件中导入它：

import 'package:tivy/tivy.dart';

获取 Vimeo 视频质量 URL

要获取 Vimeo 视频的质量 URL，请使用 getVideoQualityUrls 方法：

final videoQualityUrls = await Tivy.getVideoQualityUrls(
  'your_private_vimeo_video_id',
  accessToken: 'your_access_token',
);

获取 YouTube 视频质量 URL

要获取 YouTube 视频的质量 URL，请使用 getYouTubeVideoQualityUrls 方法：

final youTubeVideoUrl = await Tivy.getYouTubeVideoQualityUrls(
  'your_youtube_video_url',
);

// 可用的混合视频链接（带有音频和视频）
final muxedUrls = youTubeVideoUrl.muxedUrls;

// 可用的流视频链接
final streamsUrls = youTubeVideoUrl.streamUrls;

示例 Demo

以下是一个完整的示例应用，展示了如何使用 tivy 来获取并展示 Vimeo 和 YouTube 视频的质量 URL。

import 'dart:developer';

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Tivy Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Tivy Demo'),
    );
  }
}

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

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  List<VideoQualityUrl> _youtubeVideoUrls = [];
  List<VideoQualityUrl> _vimeoVideoUrls = [];
  VimeoVideoInfo? _vimeoVideoInfo;

  String? _error;

  @override
  void initState() {
    _getVimeoVideoInfo();
    _getYouTubeData();
    _getVimeoData();
    super.initState();
  }

  _getVimeoVideoInfo() async {
    try {
      final result =
          await Tivy.getVimeoVideoInfo('https://vimeo.com/989554278');
      setState(() {
        _vimeoVideoInfo = result;
      });
    } catch (e) {
      log('Error: $e');
    }
  }

  _getYouTubeData() async {
    final ytResult = await Tivy.getYouTubeVideoQualityUrls(
      'https://www.youtube.com/embed/wNT0Hm5bfiQ',
    );

    setState(() {
      _youtubeVideoUrls = ytResult.muxedUrls;
    });
  }

  _getVimeoData() async {
    try {
      final vimeoResult = await Tivy.getVimeoVideoQualityUrls(
        '989554278',
        accessToken: 'your_vimeo_access_token',
      );
      log('vimeoUrls: $vimeoResult');
      setState(() {
        _vimeoVideoUrls = vimeoResult;
      });
    } catch (error) {
      setState(() {
        _vimeoVideoUrls = [];
        _error = '===== VIMEO API ERROR ==========';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: SingleChildScrollView(
        child: Column(
          children: [
            Container(
              alignment: Alignment.centerLeft,
              padding: const EdgeInsets.all(16),
              child: Text(
                "YouTube URI : https://www.youtube.com/watch?v=_EYk-E29edo",
                style: Theme.of(context).textTheme.labelSmall!.copyWith(
                      fontSize: 15,
                    ),
              ),
            ),
            Text(
              "YouTube Video Quality Links",
              style: Theme.of(context).textTheme.headlineSmall,
            ),
            _youtubeVideoUrls.isEmpty
                ? const Center(
                    child: Text("No links"),
                  )
                : ListView.separated(
                    primary: false,
                    shrinkWrap: true,
                    itemBuilder: (context, index) {
                      final videoUrl = _youtubeVideoUrls[index];
                      return ListTile(
                        onTap: () {
                          Navigator.of(context).push(
                            MaterialPageRoute(
                              builder: (context) => LinkDetailPage(
                                title: '${videoUrl.quality}p',
                                link: videoUrl.url,
                              ),
                            ),
                          );
                        },
                        title: Text(videoUrl.quality.toString()),
                        subtitle: Text(
                          videoUrl.url,
                          maxLines: 2,
                          overflow: TextOverflow.ellipsis,
                        ),
                      );
                    },
                    separatorBuilder: (_, __) => const Divider(),
                    itemCount: _youtubeVideoUrls.length,
                  ),
            const SizedBox(height: 20),
            Container(
              alignment: Alignment.centerLeft,
              padding: const EdgeInsets.all(16),
              child: Text(
                "Vimeo URI : https://vimeo.com/6718739",
                style: Theme.of(context).textTheme.labelSmall!.copyWith(
                      fontSize: 15,
                    ),
              ),
            ),
            if (_vimeoVideoInfo != null) ...[
              Text(_vimeoVideoInfo?.html ?? 'unknown html'),
              const SizedBox(height: 10),
            ],
            if (_error != null)
              Center(
                child: Text(_error ?? 'Error'),
              ),
            if (_error == null)
              Text(
                "Vimeo Video Quality Links",
                style: Theme.of(context).textTheme.headlineSmall,
              ),
            _vimeoVideoUrls.isEmpty && _error == null
                ? const Center(
                    child: Text("No video links"),
                  )
                : ListView.separated(
                    primary: false,
                    shrinkWrap: true,
                    itemBuilder: (context, index) {
                      final videoUrl = _vimeoVideoUrls[index];
                      return ListTile(
                        onTap: () {
                          Navigator.of(context).push(
                            MaterialPageRoute(
                              builder: (context) => LinkDetailPage(
                                title: '${videoUrl.quality}p',
                                link: videoUrl.url,
                              ),
                            ),
                          );
                        },
                        title: Text(videoUrl.quality.toString()),
                        subtitle: Text(
                          videoUrl.url,
                          maxLines: 2,
                          overflow: TextOverflow.ellipsis,
                        ),
                      );
                    },
                    separatorBuilder: (_, __) => const Divider(),
                    itemCount: _vimeoVideoUrls.length,
                  ),
          ],
        ),
      ),
    );
  }
}

class LinkDetailPage extends StatelessWidget {
  const LinkDetailPage({
    super.key,
    required this.title,
    required this.link,
  });

  final String title;
  final String link;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(title),
      ),
      body: Padding(
        padding: const EdgeInsets.all(20),
        child: Text(
          link,
          style: Theme.of(context).textTheme.titleMedium,
        ),
      ),
    );
  }
}

这个示例展示了如何使用 tivy 包来获取 Vimeo 和 YouTube 视频的质量 URL，并在 Flutter 应用中显示这些链接。希望这对您有所帮助！