Dateien mit Cloud Storage für C++ herunterladen

Cloud Storage for Firebase ermöglicht Ihnen das schnelle und einfache Herunterladen von Dateien aus einem Cloud Storage Bucket, der von Firebase bereitgestellt und verwaltet wird.

Hinweis: Standardmäßig ist für einen Cloud Storage for Firebase-Bucket Firebase Authentication erforderlich, um Aktionen an den Daten oder Dateien des Buckets auszuführen. Sie können Ihre Firebase Security Rules für Cloud Storage ändern, um in bestimmten Situationen den Zugriff ohne Authentifizierung zu ermöglichen. In den meisten Fällen empfehlen wir jedoch dringend, den Zugriff einzuschränken und robuste Sicherheitsregeln einzurichten (insbesondere für Produktions-Apps). Beachten Sie, dass Sie, wenn Sie Google App Engine verwenden und einen Standard-Cloud Storage Bucket mit einem Namens format von *.appspot.com haben, möglicherweise berücksichtigen müssen, wie sich Ihre Sicherheitsregeln auf den Zugriff auf App Engine Dateien auswirken.

Referenz erstellen

Wenn Sie eine Datei herunterladen möchten, erstellen Sie zuerst eine Cloud Storage Referenz zur gewünschten Datei.

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 auf drei Arten aus Cloud Storage herunterladen:

1. In einen Puffer im Arbeitsspeicher herunterladen
2. In einen bestimmten Pfad auf dem Gerät herunterladen
3. Eine String-URL generieren, die die Datei online darstellt

In den Arbeitsspeicher herunterladen

Laden Sie die Datei mit der Methode GetBytes() in einen Byte-Puffer im Arbeitsspeicher herunter. Dies ist die einfachste Möglichkeit, eine Datei schnell herunterzuladen. Dabei muss jedoch der gesamte Inhalt der Datei in den Arbeitsspeicher geladen werden. Wenn Sie eine Datei anfordern, die größer ist als der verfügbare Arbeitsspeicher Ihrer App, stürzt die 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<size_t> future = island_ref.GetBytes(byte_buffer, kMaxAllowedSize);

Die Anfrage wurde 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 auf Callbacks basieren 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 Methode GetFile() wird eine Datei direkt auf ein lokales Gerät heruntergeladen. Verwenden Sie diese Methode, 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() verwendet 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 nur eine URL zum Freigeben benötigen, können Sie die Download-URL für eine Datei abrufen, indem Sie die GetDownloadUrl() Methode 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 anhalten, fortsetzen und abbrechen. Verwenden Sie dazu die Methoden Pause(), Resume() und Cancel() für Controller, die 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 überwachen

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);
}

Fehlerbehebung

Es gibt eine Reihe von Gründen, warum beim Download Fehler auftreten können. Dazu gehören beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung hat, auf die gewünschte Datei zuzugreifen. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehlerbehebung in der Dokumentation.

Nächste Schritte

Sie können auch Metadaten abrufen und aktualisieren für Dateien, die in Cloud Storage gespeichert sind.