Cloud Storage for Firebase を使用すると、ユーザーが生成した画像や動画などのコンテンツをアップロードして共有し、リッチ メディア コンテンツをアプリ内に構築することができます。データは Google Cloud Storage バケットに格納されます。これはエクサバイト スケールのオブジェクト ストレージ ソリューションで、高い可用性とグローバルな冗長性を備えています。Cloud Storage を使用すると、モバイル端末やウェブブラウザからファイルを直接、安全にアップロードすることができ、不安定なネットワークからでも簡単に操作できます。
事前準備
- Firebase SDK をインストールします。
- Firebase コンソールの Firebase プロジェクトにアプリを追加します。
公開アクセスの設定
Cloud Storage for Firebase には宣言型のルール言語が用意されているため、データの構造化方法、インデックスの作成方法、データの書き込みと読み取りのタイミングを定義できます。認証ユーザーのみがデータの読み取りと書き込みを行えるように、Storage への読み書きアクセスはデフォルトで制限されています。認証を設定せずに開始するには、公開アクセスルールを設定します。
この場合、アプリを使用しない人を含むあらゆる人々に Storage が公開されるので、認証の設定時に、Storage を再度制限するようにしてください。
Cloud Storage のアプリへの追加
Cloud Storage の依存関係を build.gradle ファイルに追加します。
compile 'com.google.firebase:firebase-storage:10.2.6'
Cloud Storage の設定
ストレージ バケットにアクセスするための最初の手順は、FirebaseStorage のインスタンスを作成することです。
FirebaseStorage storage = FirebaseStorage.getInstance();
これで Cloud Storage が使えるようになりました。
まず、Cloud Storage 参照を作成する方法を学びましょう。
高度な設定
次のようないくつかの使用例では、追加の設定が必要です。
- 複数の地域でストレージ バケットを使用
- さまざまなストレージ クラスでストレージ バケットを使用
- 複数の認証ユーザーによって同一アプリ内でストレージ バケットを使用
最初の使用例は、ユーザーが世界中に存在し、それぞれのユーザーの近くにデータを保存したい場合に最適です。たとえば、レイテンシを短縮するため、米国、ヨーロッパ、アジアの各地域でバケットを作成して、各地域のユーザーのデータをそこに保存できます。
2 番目の使用例は、アクセス パターンの異なるデータがある場合に役立ちます。たとえば、写真など、頻繁にアクセスされるコンテンツを格納するためにマルチリージョンまたはリージョン バケットを設定し、ユーザー バックアップなど、アクセス頻度の低いコンテンツを格納するためにニアラインまたはコールドライン バケットを設定できます。
いずれの場合でも、複数のストレージ バケットを使用する必要があります。
3 番目の使用例は、Google ドライブのような、ユーザーが複数のログイン アカウント（個人用アカウントや仕事用アカウントなど）を持つことができるアプリを作成する場合に役立ちます。カスタムの Firebase アプリ インスタンスを使用して、追加の各アカウントを認証できます。
複数のストレージ バケットの使用
上記で提供されているデフォルト以外のストレージ バケットを使用する場合、または単一のアプリで複数のストレージ バケットを使用する場合は、カスタム バケットを参照する FirebaseStorage のインスタンスを作成できます。
// Get a non-default Storage bucket
FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
インポートされたバケットの操作
既存の Cloud Storage バケットを Firebase にインポートするときは、Google Cloud SDK に含まれている gsutil ツールを使用して、Firebase からこれらのファイルにアクセスできるようにする必要があります。
gsutil -m acl ch -r -u firebase-storage@system.gserviceaccount.com:O gs://<your-cloud-storage-bucket>
これは、新しく作成されるバケットには影響しません。新しく作成されるバケットには、Firebase を許可するデフォルトのアクセス制御が設定されます。これは一時的な措置であり、将来は自動的に行われるようになります。
カスタムの Firebase アプリの使用
カスタム FirebaseApp を使用して、より複雑なアプリを作成する場合は、このアプリで初期化した FirebaseStorage のインスタンスを作成します。
// Get the default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.getInstance(customApp); // Get a non-default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");
ご不明な点がありましたら、Google の