Mit Cloud Storage for Firebase können Sie Dateien schnell und einfach aus einem von Firebase bereitgestellten und verwalteten Cloud Storage-Bucket herunterladen.
Referenz erstellen
Wenn Sie eine Datei herunterladen möchten, erstellen Sie zuerst eine Cloud Storage-Referenz auf die Datei, die Sie herunterladen möchten.
Sie können eine Referenz erstellen, indem Sie dem Stammverzeichnis Ihres Cloud Storage-Buckets untergeordnete Pfade anhängen. Sie können auch eine Referenz über eine vorhandene 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 auf drei Arten von Cloud Storage herunterladen:
- In einen Zwischenspeicher im Arbeitsspeicher herunterladen
- Auf einen bestimmten Pfad auf dem Gerät herunterladen
- Eine String-URL generieren, die die Datei online darstellt
In den Arbeitsspeicher herunterladen
Lade die Datei mit der Methode GetBytes() in einen Byte-Puffer 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 als der verfügbare Arbeitsspeicher Ihrer App ist, stürzt Ihre App ab. Um Speicherprobleme zu vermeiden, legen Sie die maximale Größe auf einen Wert fest, den Ihre App verarbeiten kann, oder verwenden Sie eine andere Downloadmethode.
// 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 future = island_ref.GetBytes(byte_buffer, kMaxAllowedSize);
Die Anfrage wurde bereits gesendet, aber wir müssen warten, bis die Future abgeschlossen ist, bevor wir die Datei lesen können. Da Spiele in der Regel in einer Schleife ausgeführt werden und weniger Callback-gesteuert sind als andere Anwendungen, wird in der Regel der Abschluss 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 GetFile()-Methode 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 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 du den Download verwalten kannst. Weitere Informationen finden Sie unter Downloads verwalten.
Download-URL generieren
Wenn Sie bereits eine URL-basierte Downloadinfrastruktur haben oder nur eine URL zum Freigeben benötigen, können Sie die Download-URL für eine Datei abrufen, indem Sie die Methode GetDownloadUrl() auf eine Cloud Storage-Referenz anwenden.
// 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 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
Du kannst Downloads nicht nur starten, sondern auch mit den Methoden Pause(), Resume() und Cancel() von Controller pausieren, fortsetzen und abbrechen. Diese Methoden kannst du optional an die Methoden GetBytes() oder GetFile() übergeben.
// 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 verfolgen.
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 behandeln
Es kann verschiedene Gründe dafür geben, dass beim Download Fehler auftreten. Beispielsweise kann die Datei nicht vorhanden sein oder der Nutzer hat keine Berechtigung zum Zugriff auf die gewünschte Datei. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehler beheben der Dokumentation.
Nächste Schritte
Sie können auch Metadaten für Dateien abrufen und aktualisieren, die in Cloud Storage gespeichert sind.