The package automatically handles internet connectivity changes:
Internet Lost: All active uploads are automatically paused
Internet Restored: All paused uploads are automatically resumed
No Manual Intervention: Works seamlessly in the background
Progress Preserved: No data loss during connectivity changes
// The connectivity handling is automatic - no additional code needed!// Uploads will pause when internet is lost and resume when restored
Managing Uploads
// Pause an upload
queueManager.pauseJob('job_id');
// Resume an upload
queueManager.resumeJob('job_id');
// Cancel an upload
queueManager.cancelJob('job_id');
// Get all pending jobsfinal pendingJobs = await queueManager.getPendingJobs();
// Get paused jobsfinal pausedJobs = await queueManager.getPausedJobs();
// Clear all jobs
queueManager.clearAllJobs();
Using the Debug Panel
import'package:flutter/material.dart';
import'package:flutter_chunked_upload/flutter_chunked_upload.dart';
classMyAppextendsStatelessWidget{
@overrideWidgetbuild(BuildContext context) {
returnMaterialApp(
home: Scaffold(
appBar: AppBar(title: Text('Upload Manager')),
body: UploadJobsDebugPanel(), // Shows all upload jobs with controls
),
);
}
}
Custom Storage Adapters
You can implement custom storage adapters for different persistence needs:
classCustomJobStorageAdapterimplementsUploadJobStorageAdapter{
// Implement the required methods@overrideFuture<void> saveJob(UploadJob job) async {
// Your custom implementation
}
// ... implement other methods
}
// Use custom adaptersawait queueManager.initAsync(
jobStorage: CustomJobStorageAdapter(),
chunkStorage: CustomChunkStorageAdapter(),
);
API Reference
UploadJob
The main class representing an upload job.
classUploadJob{
String id; // Unique identifierString filePath; // Path to fileString url; // Upload endpointint chunkSize; // Size of each chunkUploadJobStatus status; // Current statusint retryCount; // Number of retriesint maxRetries; // Maximum retriesbool isPaused; // Pause stateint priority; // Queue prioritydouble progress; // Upload progress (0.0-1.0)// CallbacksProgressCallback? onProgress;
UploadCompleteCallback? onComplete;
UploadFailedCallback? onFailed;
HeaderBuilder? headerBuilder;
}
UploadJobStatus
enumUploadJobStatus {
pending, // Waiting in queue
uploading, // Currently uploading
success, // Upload completed
failed, // Upload failed
}