Kabul ve sınırlar
Bir hesabın kaç anahtar, oda ve istek kullanabileceği ve bir sınıra ulaşıldığında ne olduğu.
Ball2D servisi, sunucunuz bir oda açmak istediğinde bu sınırları uygular. Bunlar sizin sürecinizi değil, servisi korur: Ball2D tarafında kontrol edilir ve anahtarlarınızı kullanan her host için geçerlidir.
Anahtarlar ve odalar
| Sınır | Değer |
|---|---|
| Hesap başına etkin API anahtarı | 2 |
| Anahtar başına etkin oda | 1 |
| Hesap başına etkin oda | 2 |
| Anahtar ömrü | 1–365 gün (hesap sayfasında 7, 30, 90 veya 365) |
Bir oda, servis tarafından kabul edildiği andan kapanana kadar bu sınırlara sayılır. Yerinin hemen serbest kalması için odaları close() ile kapatın.
İstek kotaları
| Kota | Değer |
|---|---|
| Anahtar başına yeni oda isteği | Dakikada 3 |
| Hesap başına yeni oda isteği | Dakikada 5 |
| Bir anahtarla yapılan istekler | Dakikada 10 |
| Hesap başına oda isteği | Dakikada 20 |
Bir oda sınırı dolu olduğu için reddedilen istekler de dakikalık kotalara sayılır.
Bir sınıra ulaştığınızda
createRoom(), 429 durumuyla bir RoomAdmissionError ile reddedilir:
| Mesaj | Anlamı |
|---|---|
This API key already has an active room. | O odayı kapatın veya başka bir anahtar kullanın. |
Your account already has two active rooms. | Odalarınızdan birini kapatın. |
Room request budget exhausted. Try again later. | Başka bir oda istemeden önce bekleyin. |
Too many requests. Please try again later. | Başka bir oda istemeden önce bekleyin. |
retryAfterSeconds, ne kadar beklemeniz gerektiğini söyler; şu an için her zaman 60'tır. Sıkı bir döngüde asla yeniden denemeyin: reddedilen her istek yine de dakikalık kotanızı kullanır.
Başlatma ve ömür
Servis, hostunuz başlarken bir odanın yerini 30 saniye boyunca tutar. Oda açıldıktan sonra, kapanana, anahtarı iptal edilene veya anahtarının süresi dolana (en fazla bir yıl) kadar yetkili kalır. SDK, oda çalışırken herhangi bir şeyi yenilemek zorunda değildir.
Oyuncular
maxPlayers, bir host oyuncusu varsa onu da sayarak, bir odanın kabul edeceği oyuncu sayısını 2 ile 30 arasında ayarlar. Oyuncular için hesap sınırı yoktur.