Flutter视频播放插件bitmovin_player的使用

简介

bitmovin_player_flutter 是一个开源项目，旨在帮助客户将 Bitmovin 移动播放器 SDK 集成到 Flutter 项目中。该项目为客户提供了一个起点，可以通过积极的合作和贡献来扩展和改进。我们期待看到这个库不断发展壮大。

平台支持

官方支持的平台包括：

• iOS / iPadOS: 14.0+
• Android: 5.0+（与 Android 4.x 兼容）
• Web

有关 Bitmovin 播放器 SDK 平台和设备支持的更多详细信息，请参阅 支持的平台和设备 页面。

功能支持

请参阅 功能 部分，了解最新支持的播放器功能列表。

文档

快速入门指南

我们的 快速入门指南 将引导你完成在 Flutter 项目中设置和配置 Bitmovin 播放器的步骤。

低代码向导

使用 低代码向导 可以快速开始使用播放器，只需几行代码即可。

示例应用

在 示例 文件夹中，你可以找到一个展示了许多播放器 Flutter SDK 功能的示例应用。不同示例的代码位于 example/lib/pages 目录下，这是学习如何使用播放器的好地方。

维护和更新

作为一个开源项目，此库不包含在定期维护或更新计划中，而是根据贡献者的贡献进行不定期更新。

贡献项目

我们欢迎社区成员提交更改、更新和修复。Bitmovin 将审查所有拉取请求。我们会尽力提供及时反馈，但请注意没有服务级别协议 (SLA)。新版本将在我们自行决定时发布。有关如何贡献的更多详细信息，请参阅 CONTRIBUTING.md。

提出功能建议

如果你发现某些有用的功能缺失但无法自己贡献，可以随时通过 Bitmovin 社区 提交功能请求。产品团队将考虑这些功能建议并纳入未来的路线图计划。

报告错误

如果你遇到与播放器 Flutter SDK 相关的错误，请通过 Bitmovin 仪表板 中的支持票务系统报告。

支持和服务级别协议 (SLA) 免责声明

作为开源项目而非核心产品，与该项目相关的任何请求、问题或查询均不包含在客户可能与 Bitmovin 或其他第三方服务提供商或公司贡献的任何 SLA 和支持条款中。所有更新完全由贡献者自行决定。

需要更多帮助？

如果你需要进一步的帮助，请联系你的 Bitmovin 账户团队。我们可以以多种方式提供帮助，从专业服务到推荐系统集成商，帮助你实现目标。

示例代码

以下是一个简单的示例，展示了如何在 Flutter 应用中使用 bitmovin_player_flutter 插件。

主入口文件 (main.dart)

import 'package:bitmovin_player_example/pages/analytics.dart';
import 'package:bitmovin_player_example/pages/audio_only.dart';
import 'package:bitmovin_player_example/pages/background_playback.dart';
import 'package:bitmovin_player_example/pages/basic_playback.dart';
import 'package:bitmovin_player_example/pages/casting.dart';
import 'package:bitmovin_player_example/pages/custom_html_ui.dart';
import 'package:bitmovin_player_example/pages/drm_playback.dart';
import 'package:bitmovin_player_example/pages/event_subscription.dart';
import 'package:bitmovin_player_example/pages/fullscreen_handling.dart';
import 'package:bitmovin_player_example/pages/home.dart';
import 'package:bitmovin_player_example/pages/picture_in_picture.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SystemChrome.setPreferredOrientations(
    [DeviceOrientation.portraitUp],
  );

  runApp(const MyApp());
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      initialRoute: '/',
      routes: {
        Home.routeName: (_) => Home(),
        PlayerAnalytics.routeName: (_) => const PlayerAnalytics(),
        BasicPlayback.routeName: (_) => const BasicPlayback(),
        DrmPlayback.routeName: (_) => const DrmPlayback(),
        AudioOnly.routeName: (_) => const AudioOnly(),
        EventSubscription.routeName: (_) => const EventSubscription(),
        CustomHtmlUi.routeName: (_) => const CustomHtmlUi(),
        FullscreenHandling.routeName: (_) => const FullscreenHandling(),
        Casting.routeName: (_) => const Casting(),
        BackgroundPlayback.routeName: (_) => const BackgroundPlayback(),
        PictureInPicture.routeName: (_) => const PictureInPicture(),
      },
      home: Scaffold(
        body: Home(),
      ),
      theme: ThemeData(
        useMaterial3: true,
        appBarTheme: const AppBarTheme(
          color: Color(0xFF006AED),
          foregroundColor: Colors.white,
        ),
      ),
    );
  }
}

基本播放页面 (basic_playback.dart)

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

class BasicPlayback extends StatelessWidget {
  static const String routeName = '/basic-playback';

  final PlayerController _playerController;

  BasicPlayback({Key? key})
      : _playerController = PlayerController(PlayerConfiguration()),
        super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Basic Playback')),
      body: Center(
        child: PlayerView(
          controller: _playerController,
          configuration: PlayerViewConfiguration(
            autoPlay: true,
            sources: [
              SourceConfiguration(
                dash: 'https://path/to/your/video.mpd',
              ),
            ],
          ),
        ),
      ),
    );
  }

  @override
  void dispose() {
    _playerController.dispose();
    super.dispose();
  }
}

主页 (home.dart)

import 'package:flutter/material.dart';
import 'package:bitmovin_player_example/pages/basic_playback.dart';

class Home extends StatelessWidget {
  static const String routeName = '/';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Bitmovin Player Example')),
      body: ListView(
        children: [
          ListTile(
            title: Text('Basic Playback'),
            onTap: () {
              Navigator.pushNamed(context, BasicPlayback.routeName);
            },
          ),
          // Add more list items for other pages
        ],
      ),
    );
  }
}

依赖项

在 pubspec.yaml 文件中添加 bitmovin_player 依赖项：

dependencies:
  flutter:
    sdk: flutter
  bitmovin_player: ^0.1.0  # 请使用最新的版本号

运行应用

1. 确保你已经安装了 Flutter 和 Dart。
2. 在终端中运行 flutter pub get 以获取依赖项。
3. 运行 flutter run 启动应用。

通过以上步骤，你应该能够在 Flutter 应用中成功集成和使用 bitmovin_player 插件。希望这个示例对你有所帮助！