cincopa_video_player

A Flutter package that wraps an HLS video stream with built‑in Cincopa analytics tracking. Easily embed Cincopa-powered video playback in your Flutter apps, send events on play/pause/timeupdate, and configure user and video metadata.

Features

• HLS playback: Stream .m3u8 sources via a Flutter-friendly widget.
• Cincopa analytics: Automatically send video.play, video.pause, and periodic video.timeupdate events to Cincopa endpoints.
• Configurable metadata: Pass user data (e.g. email, acc_id) and video config (e.g. autoplay).
• Customizable UI: Control aspectRatio, key, and embed inside any layout.

Installation

In your Flutter app’s pubspec.yaml, add:

dependencies:
  flutter:
    sdk: flutter
  cincopa_video_player:
    ^0.0.1  # or path/git reference to your local package

Then run:

flutter pub get

Usage

Import the package and use the CincopaVideoPlayer widget:

import 'package:flutter/material.dart';
import 'package:cincopa_video_player/cincopa_video_player.dart';
import 'dart:math';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  // Example HLS URL
  String _hlsStreamUrl = 'https://rtcdn.cincopa.com/AcEDQoI4gGxV.m3u8';
  String _videoTitle = 'Amazing Cincopa  Video';
  Key _videoPlayerKey = UniqueKey();

  // User data for analytics
  Map<String, String> get _userData {
    final random = Random();
    final id = random.nextInt(1000000);
    return {
      'email': 'user${id}@example.com',
      'acc_id': '${1000 + id}',
    };
  }
  void _switchVideo(String newUrl, String newTitle) {
    setState(() {
      _hlsStreamUrl = newUrl;
      _videoTitle = newTitle;
      _videoPlayerKey = UniqueKey();
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text(_videoTitle)),
        body: Center(
          child: Column(
            children: [
              AspectRatio(
                aspectRatio: 16 / 9,
                key: _videoPlayerKey,
                child: CincopaVideoPlayer(
                  hlsUrl: _hlsStreamUrl,
                  userData: _userData
                ),
              ),
              ElevatedButton(
                onPressed: () => _switchVideo(
                  'https://rtcdn.cincopa.com/AcCDOtcj2pv-.m3u8',
                  'Another Cincopa Video',
                ),
                child: const Text('Switch Video'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

API Reference

CincopaVideoPlayer

Example

See the full example/ directory for a working demo app that switches streams and shows analytics events in action.

Contributing

Feel free to open issues or PRs on GitHub. Please follow the Flutter package conventions and include tests for new features.

License

MIT © Cincopa