제한 사항
Understand the API rate limits, data size limits, and other constraints for Cloud Code modules.
읽는 시간 1분최근 업데이트: 12시간 전
Cloud Code 모듈에는 처리할 수 있는 데이터의 양에 제한이 있습니다.
Cloud Code API
- Cloud Code 클라이언트 API 서비스는 각 플레이어에 대해 요청을 분당 12,000개로 제한합니다.
- Cloud Code 관리자 API 서비스는 각 서비스 계정에 대해 요청을 분당 120개로 제한합니다.
- 관리자 API는 속도 제한이 더 낮으므로 플레이어당 기준으로 관리자 API를 호출하지 마십시오.
Cloud Code C# 모듈
- 모듈이 포함된 .ccm 파일의 크기는 10MB를 초과할 수 없습니다.
- 프로젝트의 모든 .ccm 파일을 합한 크기는 128MB를 초과할 수 없습니다.
- 모듈 실행 시 응답 본문(모듈의 출력)을 합한 크기는 2MiB를 초과할 수 없습니다.
- 프로젝트의 모든 환경에서 모듈 수가 20개를 초과할 수 없습니다.
- 모듈 함수 실행 시간은 15초를 초과할 수 없습니다. 함수가 이 시간 제한을 초과한 경우 프로세스가 종료됩니다.
- 모듈은 최대 10개의 태그를 포함할 수 있으며 태그 키 및 태그 값당 허용되는 최대 문자 수는 128자입니다.
- 지난 15분 내에 모듈에 어떤 트래픽도 수신되지 않으면 콜드 스타트 지연을 경험하게 될 수 있습니다. 모듈에 대한 후속 호출이 발생하면 이는 더 빠르게 처리됩니다.
- 패턴은 오류를 유발합니다. 항상
async void또는Task를 반환합니다. 비동기 프로그래밍의 성공 사례는 공식 Microsoft 기술 자료를 참고하십시오.Task<T> - Cloud Code는 Cloud Code 함수에 정적 메서드를 지원하지 않습니다.
호출 간 모듈 유지
모듈 상태가 호출 간에 유지된다는 보장은 없습니다. 모듈이 다른 워커에서 다시 로드될 수 있으므로 항상 모듈 함수 호출 간에 공유된 상태에 대해 의존하지 않는 것이 좋습니다. 하지만 모듈이 로드된 상태로 유지되는 동안에는 정적 변수와 싱글톤 종속성이 호출 간에 공유됩니다. 이 동작을 유리한 방향으로 사용하여 정적 변수나 싱글톤 종속성에 데이터를 캐시하여 외부 서비스에서 가져와야 하는 데이터 양을 줄일 수 있습니다. 데이터를 유지하는 데 이 모듈 동작을 사용하면 안 되며, 특히 모든 플레이어에 대해 일관성이 필요한 데이터일 경우 사용하지 않습니다.종속성 삽입
- 여러 워커가 있을 때마다 API 호출이 동일한 워커에 적용된다는 보장이 없으므로 모듈 함수 호출 전반에서 공유 상태를 활용하지 마십시오.
- Cloud Code에서 워커가 256MB 메모리 제한을 초과한 경우 해당 워커에서 크래시가 발생합니다.
- 구성은 한 모듈의 단일 클래스에서만 구현해야 합니다.
ICloudCodeSetup
푸시 메시지
- WebSocket 연결을 통해 전송되는 메시지에는 10KB 제한이 있습니다.
UGS CLI 및 에디터 배포
- UGS CLI와 Deployment 창에서는 동일한 프로젝트에 여러 모듈이 포함된 모듈을 배포할 수 없습니다.
- UGS CLI와 Deployment 창에서는 모듈 태그를 지원하지 않으며 태그를 무시합니다.
에디터 바인딩
- 생성된 파라미터는 필수 파라미터와 선택 파라미터를 구별하지 않습니다.
- Tuple은 파라미터나 반환 값으로 지원되지 않습니다.
Cloud Code와 다른 Unity 서비스 연동
- 모든 Unity 서비스에는 플레이어당 속도 제한이 있어 과도한 API 사용을 방지합니다. Cloud Code 속도 제한은 게임과 서버 코드 간에 공유됩니다. 예를 들어 Cloud Code와 게임 모두에서 Economy를 사용하는 경우 예기치 않은 속도 오류가 발생할 수 있습니다. 이러한 오류를 디버깅할 때는 두 가지 사용 유형을 모두 고려해야 합니다.
- 모듈은 모듈이 저장되는 환경에 사용자가 배포하는 다른 UGS 리소스에만 액세스할 수 있습니다. 다른 환경의 서비스에는 모듈이 액세스할 수 없습니다.