API anahtarı oluşturun
Ball2D hesabınız için oda açmaya yetkili bir sunucu tanımlayın.
Node.js'den açılan her oda bir API anahtarına ihtiyaç duyar. Bir anahtar, hesabınızı Ball2D servisine tanıtır; servis bu anahtarı odaları kabul etmek ve oda sınırlarınızı uygulamak için kullanır.
Oturum açın
Ball2D hesabınızı açın ve oturum açın. Google, GitHub, Steam ve e-posta hesaplarının tümü çalışır.
Anahtarı oluşturun
Oda barındırma bölümünde, anahtarın nerede kullanıldığını size hatırlatacak bir ad girin, örneğin Production host, ve süresinin ne zaman dolacağını seçin: 7, 30, 90 veya 365 gün. API anahtarı oluştur'u seçin.
Şimdi kaydedin
Anahtarın tam hali yalnızca bir kez gösterilir. Kapatmadan önce sunucunuzun gizli bilgi deposuna kopyalayın; Ball2D yalnızca bir hash tutar ve bir daha gösteremez. Anahtarlar b2d_ ile başlar.
Sunucunuza verin
Anahtarı sürecinize bir ortam değişkeni olarak geçirin. Bu dokümantasyondaki örnekler BALL2D_API_KEY değerini okur.
export BALL2D_API_KEY="b2d_…"
node host.mjsAnahtarları sunucunuzda tutun
Bir API anahtarı, sahibinin hesabınızda oda açmasını sağlar. Onu yalnızca host sürecinizin okuyabileceği bir yerde tutun:
- Platformunuzun gizli bilgi yöneticisinde veya sürüm kontrolüne eklenmemiş bir ortam dosyasında saklayın.
- Asla tarayıcı kodunda, bir oda adında, bir sohbet mesajında veya bir davet bağlantısında kullanmayın.
- Her dağıtım için ayrı bir anahtar kullanın, böylece diğerlerini durdurmadan birini iptal edebilirsiniz.
SDK, anahtarı yalnızca yapılandırılmış servise, HTTPS üzerinden bir Authorization başlığında gönderir. Anahtar oyunculara asla gönderilmez.
Sınırlar
Bir hesap iki aktif anahtar tutabilir. Her anahtar aynı anda bir oda çalıştırabilir ve bir hesap iki oda çalıştırabilir. Kabul ve sınırlar tüm sınırları listeler.
Bir anahtarı iptal edin
Hesabınızdaki bir anahtarın yanında İptal et'i seçin. Ball2D, anahtarı devre dışı bırakır ve başarıyı bildirmeden önce anahtarın açtığı odaları kapatır. Temizlik tamamlanamazsa anahtar iptal edilmiş olarak kalır ve Oda temizliğini yeniden dene gösterilir; odaların kapatılmasını tamamlamak için bunu seçin.
Bir anahtarı iptal etmek, odalarını Ball2D servisi üzerinden durdurur. Değiştirilmiş bir host'a doğrudan zaten bağlı olan oyuncular, o host durana kadar paket alışverişine devam edebilir; iptal işlemi uzaktan bir kapatma anahtarı değildir.
Bir anahtarın süresi dolduğunda, odaları aynı şekilde kapanır. Eskisi süresi dolmadan önce yerine geçecek bir anahtar oluşturun ve bir sonraki dağıtımınızla devreye alın.