Monitor Better Player (Flutter)

1
dependencies:  
2
fastpix_better_player_wrapper: 0.0.1 
3
 better_player_plus: ^1.0.8 

1
flutter  pub  get 

1
// Import FastPix Better Player Wrapper SDK into Dart files
2
import  'package:fastpix_better_player_wrapper/fastpix_better_player_wrapper.dart';

1
class  VideoPlayerScreen  extends  StatefulWidget { 
2
 @override 
3
 _VideoPlayerScreenState  createState() =>  _VideoPlayerScreenState(); 
4
 } 
5
 class  _VideoPlayerScreenState  extends  State<VideoPlayerScreen> { 
6
     late  BetterPlayerController _betterPlayerController; 
7
     late  FastPixBaseBetterPlayer _fastPixPlayer; 
8
  
9
@override 
10
 void  initState() { 
11
     super.initState(); 
12
     _initializePlayer(); 
13
 } 
14
  
15
void  _initializePlayer() { 
16
     _betterPlayerController =  BetterPlayerController( 
17
     BetterPlayerConfiguration( 
18
     autoPlay: true, 
19
     looping: false, 
20
     aspectRatio:  16  /  9, 
21
 ), 
22
  
23
betterPlayerDataSource:  BetterPlayerDataSource( 
24
     BetterPlayerDataSourceType.network, 
25
         "https://example.com/video.mp4", 
26
     ), 
27
 ); 
28
  
29
// Create FastPix wrapper 
30
 _fastPixPlayer =  FastPixBaseVideoPlayerBuilder( 
31
     playerController: _betterPlayerController, 
32
     workspaceId:  "your_workspace_id", // Required 
33
     beaconUrl:  "https://your-beacon-url.com", 
34
     viewerId:  "unique_viewer_id", // Required 
35
 ) 
36
  
37
.setVideoData( 
38
     VideoData( 
39
         videoUrl:  "https://example.com/video.mp4", 
40
         videoThumbnailUrl:  "https://example.com/thumbnail.jpg", 
41
     ), 
42
 ) 
43
 .setEnabledLogging(true) // Optional: for debugging 
44
 .build(); 
45
 _fastPixPlayer.start(); 
46
 }

1
@override 
2
 Widget  build(BuildContext context) { 
3
 return  Scaffold( 
4
     appBar:  AppBar(title:  Text('Video Player')), 
5
         body:  Column( 
6
             children: [ 
7
                 AspectRatio( 
8
                     aspectRatio:  16  /  9, 
9
                     child:  BetterPlayer(controller: _betterPlayerController), 
10
                 ), 
11
             ], 
12
         ), 
13
     ); 
14
 } 

1
@override 
2
 void  dispose() { 
3
     // Dispose analytics and player controller 
4
     _fastPixPlayer.disposeMetrix(); 
5
     super.dispose(); 
6
 } 

1
// Define custom analytics data 
2
 List<CustomData> customData = [ 
3
     CustomData(value:  "entertainment"), 
4
     CustomData(value:  "action"), 
5
     CustomData(value:  "PG-13"), 
6
     CustomData(value:  "English"), 
7
 ]; 
8
  
9
// Player metadata 
10
 PlayerData playerData =  PlayerData( 
11
     playerName:  "CustomVideoPlayer", 
12
     playerVersion:  "2.1.0", 
13
     playerType:  "mobile", 
14
 ); 
15
  
16
// Video metadata 
17
 VideoData videoData =  VideoData( 
18
     videoUrl:  "https://example.com/video.mp4", 
19
     videoThumbnailUrl:  "https://example.com/thumbnail.jpg", 
20
     videoTitle:  "Sample Video", 
21
     videoDuration:  120000, // in milliseconds 
22
 ); 
23
  
24
 
25
 
26
// Build with advanced configuration 
27
 _fastPixPlayer =  FastPixBaseVideoPlayerBuilder( 
28
     playerController: _betterPlayerController, 
29
     workspaceId:  "your_workspace_id", 
30
     beaconUrl:  "https://your-beacon-url.com", 
31
     viewerId:  "unique_viewer_id", 
32
 ) 
33
 .setVideoData(videoData) 
34
 .setPlayerData(playerData) 
35
 .setCustomData(customData) 
36
 .setEnabledLogging(true) 
37
 .build(); 
38
39
Player Dimension Tracking 
40
41
For player layout insights, you can report player size using a `GlobalKey`. 
42
43
 
44
45
class  _VideoPlayerScreenState  extends  State<VideoPlayerScreen> { 
46
 final  GlobalKey _playerKey =  GlobalKey(); 
47
  
48
@override 
49
 Widget  build(BuildContext context) { 
50
 return  Scaffold( 
51
         body:  Column( 
52
             children: [ 
53
                 AspectRatio( 
54
                     aspectRatio:  16  /  9, 
55
                     child:  Container( 
56
                         key: _playerKey, // Add key for dimension tracking 
57
                         child:  BetterPlayer(controller: _betterPlayerController), 
58
                 ), 
59
                 ), 
60
             ], 
61
         ), 
62
 ); 
63
 } 
64
  
65
@override 
66
 void  initState() { 
67
     super.initState(); 
68
     _initializePlayer(); 
69
     // Report player dimensions for analytics 
70
     WidgetsBinding.instance.addPostFrameCallback((_) { 
71
         _fastPixPlayer.reportPlayerSize(_playerKey); 
72
     }); 
73
     } 
74
 } 

1
FastPixBaseVideoPlayerBuilder({ 
2
     required  BetterPlayerController playerController, 
3
     required  String workspaceId, 
4
     String? beaconUrl, 
5
     required  String viewerId, 
6
 }) 

1
// Check for player errors 
2
 ErrorModel? error = _fastPixPlayer.getPlayerError(); 
3
 if (error != null) { 
4
     print('Player error: ${error.message}'); 
5
     print('Error source: ${error.source}'); 
6
 } 

1
@override 
2
 void  dispose() { 
3
     // Always dispose FastPix wrapper before disposing controller 
4
     _fastPixPlayer.disposeMetrix(); 
5
     super.dispose(); 
6
 } 

1
void  _initializePlayer() { 
2
     try { 
3
         _fastPixPlayer =  FastPixBaseVideoPlayerBuilder( 
4
         // ... configuration 
5
         ).build(); 
6
         _fastPixPlayer.start(); 
7
     } catch (e) { 
8
         print('Failed to initialize FastPix player: $e'); 
9
         // Handle initialization error 
10
     } 
11
 } 

1
// Validate required parameters 
2
 if (workspaceId.isEmpty || viewerId.isEmpty) { 
3
     throw  ArgumentError('workspaceId and viewerId are required'); 
4
 } 
5
 // Validate video data 
6
 if (videoData?.videoUrl.isEmpty ?? true) { 
7
     throw  ArgumentError('Valid video URL is required'); 
8
 } 

1
// Enable logging only in debug mode 
2
 .setEnabledLogging(kDebugMode) 
3
 // Use meaningful viewer IDs for analytics 
4
 .viewerId:  "user_${userId}_session_${sessionId}" 

1
import 'package:flutter/material.dart'; 
2
import 'package:better_player_plus/better_player_plus.dart'; 
3
import 'package:fastpix_better_player_wrapper/fastpix_better_player_wrapper.dart'; 
4
 
5
class VideoPlayerPage extends StatefulWidget { 
6
  final String videoUrl; 
7
  final String videoTitle; 
8
  final String workspaceId; 
9
  final String viewerId; 
10
 
11
  const VideoPlayerPage({ 
12
    Key? key, 
13
    required this.videoUrl, 
14
    required this.videoTitle, 
15
    required this.workspaceId, 
16
    required this.viewerId, 
17
  }) : super(key: key); 
18
 
19
  @override 
20
  _VideoPlayerPageState createState() => _VideoPlayerPageState(); 
21
} 
22
 
23
class _VideoPlayerPageState extends State<VideoPlayerPage> { 
24
  late BetterPlayerController _betterPlayerController; 
25
  late FastPixBaseBetterPlayer _fastPixPlayer; 
26
  final GlobalKey _playerKey = GlobalKey(); 
27
   
28
  bool _isLoading = true; 
29
  String? _errorMessage; 
30
 
31
  @override 
32
  void initState() { 
33
    super.initState(); 
34
    _initializePlayer(); 
35
  } 
36
 
37
  void _initializePlayer() async { 
38
    try { 
39
      setState(() { 
40
        _isLoading = true; 
41
        _errorMessage = null; 
42
      }); 
43
 
44
      // Initialize BetterPlayer controller 
45
      _betterPlayerController = BetterPlayerController( 
46
        BetterPlayerConfiguration( 
47
          autoPlay: true, 
48
          looping: false, 
49
          aspectRatio: 16 / 9, 
50
          fit: BoxFit.contain, 
51
          controlsEnabled: true, 
52
          showPlaceholderUntilPlay: true, 
53
          placeholder: Container( 
54
            color: Colors.black, 
55
            child: const Center( 
56
              child: CircularProgressIndicator(color: Colors.white), 
57
            ), 
58
          ), 
59
        ), 
60
        betterPlayerDataSource: BetterPlayerDataSource( 
61
          BetterPlayerDataSourceType.network, 
62
          widget.videoUrl, 
63
        ), 
64
      ); 
65
 
66
      // Configure video metadata 
67
      VideoData videoData = VideoData( 
68
        videoUrl: widget.videoUrl, 
69
        videoTitle: widget.videoTitle, 
70
        videoThumbnailUrl: "https://example.com/thumbnail.jpg", 
71
        videoDuration: 0, // Will be auto-detected 
72
      ); 
73
 
74
      // Configure player metadata 
75
      PlayerData playerData = PlayerData( 
76
        playerName: "FastPixVideoPlayer", 
77
        playerVersion: "1.0.0", 
78
        playerType: "mobile", 
79
      ); 
80
 
81
      // Configure custom analytics data 
82
      List<CustomData> customData = [ 
83
        CustomData(value: "entertainment"), 
84
        CustomData(value: "movie"), 
85
        CustomData(value: "HD"), 
86
      ]; 
87
 
88
      // Build FastPix player with analytics 
89
      _fastPixPlayer = FastPixBaseVideoPlayerBuilder( 
90
        playerController: _betterPlayerController, 
91
        workspaceId: widget.workspaceId, 
92
        beaconUrl: "https://your-beacon-url.com", // Replace with your beacon URL 
93
        viewerId: widget.viewerId, 
94
      ) 
95
          .setVideoData(videoData) 
96
          .setPlayerData(playerData) 
97
          .setCustomData(customData) 
98
          .setEnabledLogging(kDebugMode) // Enable logging in debug mode 
99
          .build(); 
100
 
101
      // Start analytics tracking 
102
      _fastPixPlayer.start(); 
103
 
104
      // Report player dimensions after widget is built 
105
      WidgetsBinding.instance.addPostFrameCallback((_) { 
106
        _fastPixPlayer.reportPlayerSize(_playerKey); 
107
      }); 
108
 
109
      setState(() { 
110
        _isLoading = false; 
111
      }); 
112
 
113
    } catch (e) { 
114
      setState(() { 
115
        _isLoading = false; 
116
        _errorMessage = 'Failed to initialize player: $e'; 
117
      }); 
118
      print('Player initialization error: $e'); 
119
    } 
120
  } 
121
 
122
  @override 
123
  Widget build(BuildContext context) { 
124
    return Scaffold( 
125
      appBar: AppBar( 
126
        title: Text(widget.videoTitle), 
127
        backgroundColor: Colors.black, 
128
        foregroundColor: Colors.white, 
129
      ), 
130
      body: _buildBody(), 
131
    ); 
132
  } 
133
 
134
  Widget _buildBody() { 
135
    if (_isLoading) { 
136
      return const Center( 
137
        child: CircularProgressIndicator(), 
138
      ); 
139
    } 
140
 
141
    if (_errorMessage != null) { 
142
      return Center( 
143
        child: Column( 
144
          mainAxisAlignment: MainAxisAlignment.center, 
145
          children: [ 
146
            const Icon( 
147
              Icons.error_outline, 
148
              size: 64, 
149
              color: Colors.red, 
150
            ), 
151
            const SizedBox(height: 16), 
152
            Text( 
153
              'Error', 
154
              style: Theme.of(context).textTheme.headlineSmall, 
155
            ), 
156
            const SizedBox(height: 8), 
157
            Text( 
158
              _errorMessage!, 
159
              textAlign: TextAlign.center, 
160
              style: Theme.of(context).textTheme.bodyMedium, 
161
            ), 
162
            const SizedBox(height: 16), 
163
            ElevatedButton( 
164
              onPressed: _initializePlayer, 
165
              child: const Text('Retry'), 
166
            ), 
167
          ], 
168
        ), 
169
      ); 
170
    } 
171
 
172
    return Column( 
173
      children: [ 
174
        // Video Player 
175
        AspectRatio( 
176
          aspectRatio: 16 / 9, 
177
          child: Container( 
178
            key: _playerKey, 
179
            color: Colors.black, 
180
            child: BetterPlayer(controller: _betterPlayerController), 
181
          ), 
182
        ), 
183
         
184
        // Player Info Panel 
185
        Container( 
186
          padding: const EdgeInsets.all(16), 
187
          child: Column( 
188
            crossAxisAlignment: CrossAxisAlignment.start, 
189
            children: [ 
190
              Text( 
191
                widget.videoTitle, 
192
                style: Theme.of(context).textTheme.headlineSmall, 
193
              ), 
194
              const SizedBox(height: 8), 
195
              Text( 
196
                'Video URL: ${widget.videoUrl}', 
197
                style: Theme.of(context).textTheme.bodySmall, 
198
              ), 
199
              const SizedBox(height: 8), 
200
              Text( 
201
                'Viewer ID: ${widget.viewerId}', 
202
                style: Theme.of(context).textTheme.bodySmall, 
203
              ), 
204
            ], 
205
          ), 
206
        ), 
207
      ], 
208
    ); 
209
  } 
210
 
211
  @override 
212
  void dispose() { 
213
    // Clean up resources 
214
    _fastPixPlayer.disposeMetrix(); 
215
    _betterPlayerController.dispose(); 
216
    super.dispose(); 
217
  } 
218
} 
219
 
220
// Usage in main app 
221
class MyApp extends StatelessWidget { 
222
  @override 
223
  Widget build(BuildContext context) { 
224
    return MaterialApp( 
225
      title: 'FastPix Video Player Demo', 
226
      theme: ThemeData( 
227
        primarySwatch: Colors.blue, 
228
        brightness: Brightness.dark, 
229
      ), 
230
      home: const VideoPlayerPage( 
231
        videoUrl: "https://example.com/sample-video.mp4", 
232
        videoTitle: "Sample Video", 
233
        workspaceId: "your_workspace_id", 
234
        viewerId: "user_123_session_456", 
235
      ), 
236
    ); 
237
  } 
238
}