Налаштування сховища медіафайлів мобільного додатку (S3/Cloud Storage)

Завантаження фото та відео з мобільного додатку — завдання, яке легко недооцінити. Один запит на 50 МБ відео через бекенд-проксі створює колосальне навантаження на сервер, збільшує час відповіді та витрачає подвійний трафік. Користувачі кидають завантаження, якщо воно триває довше трьох секунд. Ми пропонуємо перевірену архітектуру: presigned URL → пряме завантаження з клієнта в S3 або GCS. Бекенд тільки видає токен і отримує підтвердження — вся важкість лягає на хмарну інфраструктуру. Такий підхід під ключ знижує навантаження на ваш сервер, прискорює віддачу контенту та гарантує безпеку. Наш досвід — понад 5 років інтеграції хмарних сховищ у мобільні додатки для iOS та Android.

Чому варто завантажувати медіа безпосередньо в S3?

Пряме завантаження через presigned URL вирішує проблеми з продуктивністю та надійністю. Порівняйте з проксі-методом:

Ми наполегливо рекомендуємо пряме завантаження для медіа — це знижує вартість інфраструктури та підвищує чуйність додатку. Офіційна документація AWS: Presigned URLs.

Порівняння провайдерів хмарного зберігання

R2 та B2 сумісні з S3 API — один і той же клієнтський код, тільки інший endpoint. Вибір провайдера залежить від регіону трафіку та бюджету. Наприклад, для проєктів з великим вихідним трафіком Cloudflare R2 може скоротити витрати на egress до нуля.

Як ми реалізуємо завантаження з прогресом?

Користувач бачить progress bar — це не опціонально для відео. Кроки реалізації:

1. Додаток запитує у бекенда presigned URL, передаючи тип та розмір файлу.
2. Бекенд генерує тимчасовий токен з обмеженими правами (наприклад, PUT-дозвіл на конкретний об'єкт).
3. Клієнт завантажує файл безпосередньо в хмарне сховище, використовуючи отриманий URL та стандартні механізми відстеження прогресу.

iOS через URLSession.uploadTask з делегатом:

class MediaUploader: NSObject, URLSessionTaskDelegate { private lazy var session: URLSession = { URLSession(configuration: .default, delegate: self, delegateQueue: nil) }() func upload(fileURL: URL, presignedURL: URL, progress: @escaping (Double) -> Void, completion: @escaping (Result<Void, Error>) -> Void) { var request = URLRequest(url: presignedURL) request.httpMethod = "PUT" request.setValue(fileURL.mimeType, forHTTPHeaderField: "Content-Type") let task = session.uploadTask(with: request, fromFile: fileURL) task.taskDescription = fileURL.lastPathComponent uploadCompletionHandlers[task.taskIdentifier] = completion uploadProgressHandlers[task.taskIdentifier] = progress task.resume() } func urlSession(_ session: URLSession, task: URLSessionTask, didSendBodyData bytesSent: Int64, totalBytesSent: Int64, totalBytesExpectedToSend: Int64) { let progress = Double(totalBytesSent) / Double(totalBytesExpectedToSend) uploadProgressHandlers[task.taskIdentifier]?(progress) } } 

На Android через OkHttp з кастомним RequestBody:

class ProgressRequestBody( private val file: File, private val contentType: MediaType, private val onProgress: (Int) -> Unit ) : RequestBody() { override fun contentType() = contentType override fun contentLength() = file.length() override fun writeTo(sink: BufferedSink) { val buffer = ByteArray(8192) var uploaded = 0L file.inputStream().use { input -> var bytesRead: Int while (input.read(buffer).also { bytesRead = it } != -1) { sink.write(buffer, 0, bytesRead) uploaded += bytesRead val progress = (uploaded * 100 / file.length()).toInt() onProgress(progress) } } } } 

Що робити з великими відеофайлами?

S3 вимагає multipart для файлів більше 5 МБ (рекомендується від 100 МБ). Переваги: паралельне завантаження частин, можливість відновити після переривання.

class S3MultipartUploader(private val s3Client: S3Client) { suspend fun upload(bucketName: String, key: String, file: File): String { // 1. Ініціалізуємо multipart upload val createResponse = s3Client.createMultipartUpload { bucket = bucketName this.key = key contentType = file.detectMimeType() } val uploadId = createResponse.uploadId!! val partSize = 10 * 1024 * 1024L // 10 МБ на частину val parts = mutableListOf<CompletedPart>() try { file.inputStream().use { stream -> var partNumber = 1 val buffer = ByteArray(partSize.toInt()) var bytesRead: Int while (stream.read(buffer).also { bytesRead = it } != -1) { val partData = buffer.copyOf(bytesRead) val uploadPartResponse = s3Client.uploadPart { bucket = bucketName this.key = key this.uploadId = uploadId this.partNumber = partNumber body = ByteStream.fromBytes(partData) } parts.add(CompletedPart { this.partNumber = partNumber eTag = uploadPartResponse.eTag }) partNumber++ } } // 3. Завершуємо multipart upload s3Client.completeMultipartUpload { bucket = bucketName this.key = key this.uploadId = uploadId multipartUpload = CompletedMultipartUpload { this.parts = parts } } return "https://$bucketName.s3.amazonaws.com/$key" } catch (e: Exception) { // Очищаємо незавершений upload — інакше оплачується s3Client.abortMultipartUpload { bucket = bucketName this.key = key this.uploadId = uploadId } throw e } } } 

abortMultipartUpload при помилці — важливо. Незавершені multipart uploads продовжують тарифікуватися в AWS. Додайте Lifecycle Rule на видалення незавершених uploads через 7 днів як страховку.

Обробка медіа перед завантаженням

Відео 4K 200 МБ безпосередньо в S3 — рідко потрібно. На клієнті перед завантаженням:

• Зображення: стиснення через UIGraphicsImageRenderer (iOS) або BitmapFactory.Options.inSampleSize (Android). WebP замість JPEG — краще співвідношення якості/розміру.
• Відео: транскодування через AVAssetExportSession (iOS) або MediaCodec/Transformer (Android) до 1080p/720p. Для React Native — react-native-video-processing.

// iOS: стиснення відео перед завантаженням let exporter = AVAssetExportSession(asset: asset, presetName: AVAssetExportPreset1280x720)! exporter.outputURL = outputURL exporter.outputFileType = .mp4 exporter.shouldOptimizeForNetworkUse = true await exporter.export() // Після експорту — завантажуємо outputURL в S3 

Клієнтське стиснення — компроміс: менше трафіку, швидше завантаження, але навантаження на CPU пристрою. Це дозволяє заощадити на зберіганні та вихідному трафіку (особливо при великих обсягах).

CDN для роздачі

S3 безпосередньо — тільки для приватних файлів. Публічні медіа (аватари, контент) — через CloudFront або Cloudflare CDN. Це кешування на edge-вузлах по всьому світу та HTTPS без додаткового налаштування. Підключення CDN може знизити затримки до 50 мс для користувачів у віддалених регіонах.

{ "CORSRules": [ { "AllowedOrigins": ["*"], "AllowedMethods": ["PUT", "POST"], "AllowedHeaders": ["*"], "ExposeHeaders": ["ETag"] } ] }