Mit Cloud Storage for Firebase können Sie schnell und einfach Dateien aus einem von Firebase bereitgestellten und verwalteten Cloud Storage-Bucket herunterladen.
Referenz erstellen
Wenn Sie eine Datei herunterladen möchten, müssen Sie zuerst eine Cloud Storage-Referenz für die Datei erstellen, die Sie herunterladen möchten.
Sie können eine Referenz erstellen, indem Sie untergeordnete Pfade an den Stamm Ihres Cloud Storage-Buckets anhängen. Alternativ können Sie eine Referenz aus einer vorhandenen gs://- oder https://-URL erstellen, die auf ein Objekt in Cloud Storage verweist.
// Create a reference with an initial file path and name StorageReference path_reference = storage->GetReference("images/stars.jpg"); // Create a reference from a Cloud Storage URI StorageReference gs_reference = storage->GetReferenceFromUrl("gs://bucket/images/stars.jpg"); // Create a reference from an HTTPS URL // Note that in the URL, characters are URL escaped! StorageReference https_reference = storage->GetReferenceFromUrl("https://firebasestorage.googleapis.com/b/bucket/o/images%20stars.jpg");
Dateien herunterladen
Sobald Sie eine Referenz haben, können Sie Dateien aus Cloud Storage auf drei Arten herunterladen:
- In einen Puffer im Arbeitsspeicher herunterladen
- In einen bestimmten Pfad auf dem Gerät herunterladen
- Eine String-URL generieren, die die Datei online darstellt
In den Arbeitsspeicher herunterladen
Laden Sie die Datei mit der Methode GetBytes() in einen Bytepuffer im Arbeitsspeicher herunter. Dies ist die einfachste Möglichkeit, eine Datei schnell herunterzuladen. Allerdings muss der gesamte Inhalt der Datei in den Arbeitsspeicher geladen werden. Wenn Sie eine Datei anfordern, die größer ist als der für Ihre App verfügbare Arbeitsspeicher, stürzt Ihre App ab. Um Speicherprobleme zu vermeiden, sollten Sie die maximale Größe auf einen Wert festlegen, den Ihre App verarbeiten kann, oder eine andere Downloadmethode verwenden.
// Create a reference to the file you want to download StorageReference island_ref = storage_ref.Child("images/island.jpg"); // Download in memory with a maximum allowed size of 1MB (1 * 1024 * 1024 bytes) const size_t kMaxAllowedSize = 1 * 1024 * 1024 int8_t byte_buffer[kMaxAllowedSize]; firebase::Future<size_t> future = island_ref.GetBytes(byte_buffer, kMaxAllowedSize);
Die Anfrage wurde gestellt, aber wir müssen warten, bis das Future abgeschlossen ist, bevor wir die Datei lesen können. Da Spiele in der Regel in einer Schleife ausgeführt werden und weniger auf Rückrufen basieren als andere Anwendungen, wird der Abschluss in der Regel abgefragt.
// In the game loop that polls for the result... if (future.status() != firebase::kFutureStatusPending) { if (future.status() != firebase::kFutureStatusComplete) { LogMessage("ERROR: GetBytes() returned an invalid future."); // Handle the error... } else if (future.Error() != firebase::storage::kErrorNone) { LogMessage("ERROR: GetBytes() returned error %d: %s", future.Error(), future.error_message()); // Handle the error... } else { // byte_buffer is now populated with data for "images/island.jpg" } }
In eine lokale Datei herunterladen
Mit der Methode GetFile() wird eine Datei direkt auf ein lokales Gerät heruntergeladen. Verwenden Sie diese Option, wenn Ihre Nutzer offline auf die Datei zugreifen oder sie in einer anderen App freigeben möchten.
// Create a reference to the file you want to download StorageReference islandRef = storage_ref.Child("images/island.jpg"]; // Create local filesystem URL const char* local_url = "file:///local/images/island.jpg"; // Download to the local filesystem Future<size_t> future = islandRef.GetFile(local_url); // Wait for Future to complete... if (future.Error() != firebase::storage::kErrorNone) { // Uh-oh, an error occurred! } else { // The file has been downloaded to local file URL "images/island.jpg" }
GetFile() akzeptiert ein optionales Controller-Argument, mit dem Sie den Download verwalten können. Weitere Informationen finden Sie unter Downloads verwalten.
Download-URL generieren
Wenn Sie bereits eine Downloadinfrastruktur haben, die auf URLs basiert, oder einfach eine URL zum Teilen benötigen, können Sie die Download-URL für eine Datei abrufen, indem Sie die Methode GetDownloadUrl() für eine Cloud Storage-Referenz aufrufen.
// Create a reference to the file you want to download StorageReference stars_ref = storage_ref.Child("images/stars.jpg"); // Fetch the download URL firebase::Future<std::string> future = stars_ref.GetDownloadUrl(); // Wait for Future to complete... if (future.Error() != firebase::storage::kErrorNone) { // Uh-oh, an error occurred! } else { // Get the download URL for 'images/stars.jpg' std::string download_url = future.Result(); }
Downloads verwalten
Sie können Downloads nicht nur starten, sondern auch pausieren, fortsetzen und abbrechen. Verwenden Sie dazu die Methoden Pause(), Resume() und Cancel() für Controller, das Sie optional an die Methoden GetBytes() oder GetFile() übergeben können.
// Start downloading a file Controller controller; storage_ref.Child("images/mountains.jpg").GetFile(local_file, nullptr, &controller); // Pause the download controller.Pause(); // Resume the download controller.Resume(); // Cancel the download controller.Cancel();
Downloadfortschritt im Blick behalten
Sie können Listener an Downloads anhängen, um den Fortschritt des Downloads zu überwachen.
class MyListener : public firebase::storage::Listener { public: virtual void OnProgress(firebase::storage::Controller* controller) { // A progress event occurred } }; { // Start uploading a file MyEventListener my_listener; storage_ref.Child("images/mountains.jpg").GetFile(local_file, my_listener); }
Fehler beheben
Es gibt eine Reihe von Gründen, warum beim Herunterladen Fehler auftreten können. Dazu gehören, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung hat, auf die gewünschte Datei zuzugreifen. Weitere Informationen zu Fehlern finden Sie in der Dokumentation im Abschnitt Fehlerbehandlung.
Nächste Schritte
Sie können auch Metadaten für Dateien abrufen und aktualisieren, die in Cloud Storage gespeichert sind.