Cloud Storage for Firebase 可讓您輕鬆快速地下載 從 Cloud Storage 由 Firebase 提供並管理的值區
可建立參照
如要下載檔案,請先建立 Cloud Storage 參考資料 加入要下載的檔案
您可以在
Cloud Storage 值區,或者您也可以從現有
gs://
或 https://
網址;參照 Cloud Storage 中的物件。
// Create a storage reference from our app
final storageRef = FirebaseStorage.instance.ref();
// Create a reference with an initial file path and name
final pathReference = storageRef.child("images/stars.jpg");
// Create a reference to a file from a Google Cloud Storage URI
final gsReference =
FirebaseStorage.instance.refFromURL("gs://YOUR_BUCKET/images/stars.jpg");
// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
final httpsReference = FirebaseStorage.instance.refFromURL(
"https://firebasestorage.googleapis.com/b/YOUR_BUCKET/o/images%20stars.jpg");
下載檔案
取得參考資料後,您可以從 Cloud Storage 下載檔案
呼叫 getData()
或 getStream()
如果偏好下載檔案
但您可以使用 getDownloadUrl()
取得下載網址。
在記憶體中下載
使用 getData()
方法將檔案下載到 UInt8List
。這是
下載檔案是最簡單的方法,但必須載入
將檔案匯入記憶體如果您要求的檔案超過應用程式可用空間
因此應用程式將當機為防範記憶體問題,getData()
需要的最大下載位元組數將大小上限設為其他內容
或其他下載方式。
final islandRef = storageRef.child("images/island.jpg");
try {
const oneMegabyte = 1024 * 1024;
final Uint8List? data = await islandRef.getData(oneMegabyte);
// Data for "images/island.jpg" is returned, use this as needed.
} on FirebaseException catch (e) {
// Handle any errors.
}
下載至本機檔案
writeToFile()
方法會將檔案直接下載到本機裝置。適用情況
使用者希望在離線時存取檔案,或是在
不同的應用程式writeToFile()
會傳回 DownloadTask
,供您用於管理
請依照下載狀態監控下載狀態,並監控下載狀態。
final islandRef = storageRef.child("images/island.jpg");
final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);
final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
switch (taskSnapshot.state) {
case TaskState.running:
// TODO: Handle this case.
break;
case TaskState.paused:
// TODO: Handle this case.
break;
case TaskState.success:
// TODO: Handle this case.
break;
case TaskState.canceled:
// TODO: Handle this case.
break;
case TaskState.error:
// TODO: Handle this case.
break;
}
});
透過網址下載資料
如果您已擁有以網址為基礎的下載基礎架構,或是
要分享網址,您可以呼叫
Cloud Storage 參考資料的 getDownloadURL()
方法。
final imageUrl =
await storageRef.child("users/me/profile.png").getDownloadURL();
處理錯誤
下載時可能會發生錯誤的原因有很多,包括 檔案不存在,或使用者沒有存取所需檔案的權限。 如要進一步瞭解錯誤,請參閱處理錯誤一文 一節。
完整範例
下面是含有錯誤處理的下載完整範例:
final islandRef = storageRef.child("images/island.jpg");
final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);
final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
switch (taskSnapshot.state) {
case TaskState.running:
// TODO: Handle this case.
break;
case TaskState.paused:
// TODO: Handle this case.
break;
case TaskState.success:
// TODO: Handle this case.
break;
case TaskState.canceled:
// TODO: Handle this case.
break;
case TaskState.error:
// TODO: Handle this case.
break;
}
});
你也可以針對儲存的檔案取得及更新中繼資料 複製到 Cloud Storage 中