制限

Understand the API rate limits, data size limits, and other constraints for Cloud Code modules.

読み終わるまでの所要時間 8 分

最終更新 8ヶ月前

Cloud Code モジュールには、処理できるデータ量に制限があります。

Cloud Code API

モジュールを含む .ccm ファイルのサイズが 10 MB を超えることはできません。
プロジェクト内のすべての .ccm ファイルの合計サイズが 128 Mb を超えることはできません。
モジュールを実行するときのレスポンス本文 (モジュールの出力) の合計サイズは、2 MiB を超えることはできません。
プロジェクト内のすべての環境にまたがるモジュール数は 20 以下である必要があります。
モジュール関数の実行時間が 15 秒を超えることはできません。関数がこの時間制限を超えた場合、プロセスは強制停止されます。
モジュールは最大 10 個のタグを持つことができ、タグキーとタグ値ごとに使用できる最大文字数は 128 です。
モジュールが過去 15 分間にトラフィックを受信しなかった場合、コールドスタートの待ち時間が発生する可能性があります。その後のモジュールへの呼び出しは、より高速になります。
```
async void
```
パターンはエラーの原因になります。常に
```
Task
```
または
```
Task<T>
```
を返します。非同期プログラミングのベストプラクティスについては、Microsoft の公式ドキュメントを参照してください。
Cloud Code は、Cloud Code 関数の静的メソッドをサポートしていません。

モジュールの状態が呼び出し間で持続する保証はありません。モジュールは別のワーカーでリロードされる可能性があるため、モジュール関数の呼び出し間で常に共有状態に依存できるとは限りません。ただし、モジュールがロードされたままである間は、静的変数とシングルトン依存関係は呼び出し間で共有されます。

この動作を有効活用して、静的変数またはシングルトン依存関係にデータをキャッシュし、外部サービスからフェッチする必要があるデータの量を減らすことができます。データ (特にすべてのプレイヤーに対して一貫性を保つ必要のあるデータ) を保持するためにこのモジュールの動作を使用しないでください。

UGS CLI と Deployment (デプロイ) ウィンドウでは、同じプロジェクト内に複数のモジュールが含まれるモジュールをデプロイすることはできません。
UGS CLI と Deployment (デプロイ) ウィンドウはモジュールタグをサポートしていないため、それらを無視します。

すべての Unity サービスには、API の過剰な使用を防ぐためにプレイヤーごとのレート制限があります。Cloud Code レート制限は、ゲームとサーバーコード間で共有されます。例えば、Cloud Code とゲームの両方から Economy を使用する場合、予期しないレート制限エラーを受け取る可能性があります。これらのエラーをデバッグする際には、両方の使用タイプを考慮することが重要です。
モジュールは、モジュールを保存したのと同じ環境にデプロイする他の UGS リソースにのみアクセスできます。モジュールは、他の環境内のサービスにアクセスできません。

Cloud Code と統合する方法について詳しくは、他の Unity サービスとのインテグレーションのページを参照してください。