クラウドストレージAPI (廃止)

• アプリの使用環境やインストール環境の間で進行状況を保存する。ユーザーは、保存したデータを失うことなく、アンインストールと再インストールを行うことができます。
• デバイス間で進行状況を共有する。ユーザーは、デバイス間でデータを同期できます。
• 障害回復を提供する。デバイスをなくしたりデバイスが損傷したりした場合や、ローカルデータが破損した場合、ユーザーデータを復元できます。

注: Meta QuestデバイスでクラウドストレージV2にアクセスできます。クラウドストレージを使用してユーザーの個人情報を保管しないでください。

• アクセス許可: デフォルトの場所が外部ストレージであるため、クラウドストレージV2を使用するAndroidアプリにはWRITE_EXTERNAL_STORAGEアクセス許可が必要になります。詳しくは、Android向けドキュメントのアクセス許可の概要⁠およびWRITE_EXTERNAL_STORAGE⁠をご覧ください。注: Androidでは、Meta Questソフトウェアのバージョン19以降、WRITE_EXTERNAL_STORAGEアクセス許可が不要になりました。
• 競合の解決: アプリの起動時に、クラウドとローカルデバイスの間にファイルの競合がある場合、ユーザーは、デバイスのデータかクラウドのデータのどちらかを選択するよう求められます。アプリの起動をキャンセルすることもできます。
• パスとファイル名に関する制限: すべてのプラットフォームとの互換性を保つために、パスの全長を260文字以内に制限する必要があります。個々のファイル名が255文字を超えないようにしてください。
• ファイルタイプ: クラウドストレージV2を使用してあらゆるファイルタイプを保存できます。
• ファイルの数とサイズ: 各ファイルの最大サイズは10 MBで、1つのアプリまたはアプリグループにつき100個のファイルを同期できます。
• 選択的同期: オプションで、特定のフォルダーやファイルを同期対象として指定できます。選択的同期のファイルパスの先頭にはスラッシュを使用します。ディレクトリ名、ファイル名、ファイル拡張子にはワイルドカード文字(*)を含めることができます。その他の特殊文字および一部のファイル名は許可されていません。詳しい要件については、選択的同期をご覧ください。
• コードでのローカル保存場所の取得: ファイルを保存するユーザーデバイスのディレクトリを取得するには、ovr_CloudStorage2_GetUserDirectoryPath()メソッドを使用します。

1. Meta Horizon開発者ダッシュボード⁠にサインインします。
2. アプリを選択します。
3. 左側のナビゲーションで、[Development (開発)] > [Cloud Storage (クラウドストレージ)]を選択します。
4. [Cloud Storage (クラウドストレージ)]ページで、[自動クラウドバックアップを有効にする]をオンにします。
   これにより、ユーザーデバイスのデフォルトディレクトリからクラウドにファイルが同期されます。
   プラットフォームの互換性に関する理由から、CON、PRN、AUX、NUL、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM0、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、LPT0という名前のファイルはクラウドに同期されません。詳しくは、Windowsデスクトップのファイルの名前付け⁠をご覧ください。

注: 同期場所を設定するオプションが表示されない場合は、クラウドストレージV2オプションを有効にした後、保存を行ったか確認してください。

• パスを入力します。パスの要件は次のとおりです。
  • 先頭にスラッシュを使用します。
  • ディレクトリ名に1セットのワイルドカード文字(**)を含めることができます。
  • ファイルの名前および拡張子に複数のワイルドカード文字(*)を含めることができます。
  • その他の特殊文字(\ : ? “ < > | &)を含めることはできません。これらの文字が含まれるパスは無視されます。
  • 260文字より長くすることはできません。個々のファイル名が255文字を超えないようにしてください。
  例えば、/scores/*.datは有効な選択的同期パスです。
• [Submit (送信する)]をクリックします。

• 開発者ダッシュボードで、アプリまたはアプリグループを探し、[Cloud Storage (クラウドストレージ)]に移動します。
• [Cloud Storage (クラウドストレージ)]ページで、[Cloud Storage V2 (クラウドストレージV2)]の下にある[Selective Sync (選択的同期)]の表から、変更するパスを見つけます。
• その行の省略記号(...)ボタンをクリックし、[Edit (編集する)]または[Delete (削除)]を選択します。
• パスの編集が終わったら、または削除を確定するために、[Submit (送信する)]をクリックします。

1. デバイスの保存場所を取得するには、ovr_CloudStorage2_GetUserDirectoryPath()メソッドを呼び出します。
2. 次に、Message_GetStringを使用して、その呼び出しの結果を解析します。