https://github.com/bcc-code/bccm-player
Flutter package for video-heavy apps
https://github.com/bcc-code/bccm-player
android dart dart-library dartlang flutter flutter-package flutter-plugin ios player video
Last synced: about 1 year ago
JSON representation
Flutter package for video-heavy apps
- Host: GitHub
- URL: https://github.com/bcc-code/bccm-player
- Owner: bcc-code
- License: apache-2.0
- Created: 2023-08-02T09:25:15.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T12:21:42.000Z (about 2 years ago)
- Last Synced: 2024-04-14T02:53:07.821Z (about 2 years ago)
- Topics: android, dart, dart-library, dartlang, flutter, flutter-package, flutter-plugin, ios, player, video
- Language: Dart
- Homepage: https://bcc-code.github.io/bccm-player/
- Size: 25.4 MB
- Stars: 15
- Watchers: 2
- Forks: 7
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# BccmPlayer - a flutter video player package
Note: this is not proper open source. See [./LICENSE](./LICENSE)
This is a video player primarily designed for video-heavy apps that need features like background playback, PiP, casting, analytics, etc.
Used by the apps [Bible Kids](https://play.google.com/store/apps/details?id=media.bcc.kids) and [BCC Media](https://apps.apple.com/no/app/brunstadtv/id913268220).
 \_
## Documentation
For all the features to work correctly, it's vital that you read the docs.
Documentation: https://bcc-code.github.io/bccm-player/
## Difference from video_player/chewie/betterplayer, etc.
A major difference is that BccmPlayer uses hybrid composition platform views to display the video instead of textures.
This means the video is rendered in the native view hierarchy without any intermediate steps, which has several benefits:
- Native video performance
- Subtitles are rendered by the native player (avplayer/exoplayer)
- Can use native controls (`showControls` on [VideoPlatformView])
## Platforms
- [x] iOS
- [x] Android
- [ ] ~~Web~~. Some groundwork is there, but it's not complete and it's not supported.
## Features
- [x] Native video via hybrid composition
- [x] HLS, DASH, MP4 (anything exoplayer and avplayer supports)
- [x] Chromecast
- [x] Background playback
- [x] Picture in picture
- [x] Notification center
- [x] Audio track selection
- [x] Subtitle track selection
- [x] Fullscreen
- [x] NPAW/Youbora analytics
- [x] Metadata
- [x] HDR content (read [HDR](https://bcc-code.github.io/bccm-player/advanced-usage/hdr-content/) in the docs)
# Example
```dart
import 'package:bccm_player/bccm_player.dart';
import 'package:flutter/material.dart';
class SimplePlayer extends StatefulWidget {
const SimplePlayer({super.key});
@override
State createState() => _SimplePlayerState();
}
class _SimplePlayerState extends State {
late BccmPlayerController playerController;
@override
void initState() {
// You can also use the global "primary" controller: BccmPlayerController.primary;
// The primary player has superpowers like notification player, background playback, casting, etc.
playerController = BccmPlayerController(
MediaItem(
url: 'https://devstreaming-cdn.apple.com/videos/streaming/examples/adv_dv_atmos/main.m3u8',
mimeType: 'application/x-mpegURL',
metadata: MediaMetadata(title: 'Apple advanced (HLS/HDR)'),
),
);
playerController.initialize().then((_) => playerController.setMixWithOthers(true)); // if you want to play together with other videos
super.initState();
}
@override
void dispose() {
playerController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return ListView(
children: [
Column(
children: [
BccmPlayerView(
playerController,
//config: BccmPlayerViewConfig()
),
ElevatedButton(
onPressed: () {
playerController.setPrimary();
},
child: const Text('Make primary'),
),
ElevatedButton(
onPressed: () {
final currentMs = playerController.value.playbackPositionMs;
if (currentMs != null) {
playerController.seekTo(Duration(milliseconds: currentMs + 20000));
}
},
child: const Text('Skip 20 seconds'),
),
],
),
],
);
}
}
```