İçeriğe atla

Oda ve olaylarOda

Moderasyon

Oyuncuları susturun, odadan atın ve yasaklayın, kimlerin katılabileceğini kontrol edin.

Yasaklamalar, parolalar ve katılım doğrulaması Ball2D servisi tarafından uygulanır, bu nedenle bu komutlar servisin onayını bekler ve servis onaylamazsa reddedilir.

Oyuncular

setPlayerMuted()

yöntem
room.setPlayerMuted(id: number, muted: boolean): Promise<void>

Bu oyuncunun oda sohbetini susturma kaldırılana veya oyuncu ayrılana kadar susturur.

Susturulmuş bir oyuncu oda sohbeti, özel mesaj veya yazıyor göstergesi gönderemez ve mesajları onPlayerChat'a asla ulaşmaz. Susturma, siz kaldırana veya oyuncu ayrılana kadar sürer; birini uzak tutmak için yasaklama kullanın. Host oyuncusu susturulamaz. onPlayerMuteChange tetiklenir.

Parametreler

idnumberzorunlu
Oyuncu ID'si.
mutedbooleanzorunlu
Susturmak için true, susturmayı kaldırmak için false.

Döndürür

Promise<void>

JavaScript
await room.setPlayerMuted(player.id, true);

kickPlayer()

yöntem
room.kickPlayer(id: number, reason?: string, ban?: boolean): Promise<void>

Bir oyuncuyu kaldırır. onPlayerLeave tetiklenir, ardından onPlayerKicked. Host oyuncusu ve bilinmeyen ID'ler yok sayılır.

Bir yasaklama, servis tarafından oyuncunun ağ adresine karşı saklanır ve bu odanın ömrü boyunca geçerlidir, en fazla 256 yasaklama. Servis yasaklamayı 10 saniye içinde onaylayamazsa komut reddedilir ve oyuncu odada kalır.

Parametreler

idnumberzorunlu
Oyuncu ID'si.
reasonstring
Oyuncuya gösterilir, en fazla 100 karakter. Varsayılan olarak Removed by host.
banboolean
Oyuncuyu bu odaya yeniden katılmaktan da yasaklamak için true.

Döndürür

Promise<void>

JavaScript
await room.kickPlayer(
  player.id,
  'Spamming the chat',
  true,
);

clearBan()

yöntem
room.clearBan(id: number): Promise<void>

Bu oda tarafından uygulanan bir yasaklamayı kaldırır. Bilinmeyen ID'ler hiçbir şey yapmaz.

Parametreler

idnumberzorunlu
Oyuncuyu yasakladığınızda sahip olduğu ID.

Döndürür

Promise<void>

JavaScript
await room.clearBan(bannedId);

clearBans()

yöntem
room.clearBans(): Promise<void>

Odadaki her yasaklamayı kaldırır.

Döndürür

Promise<void>

Katılım

setPassword()

yöntem
room.setPassword(password: string | null): Promise<void>

Değişiklikten sonra katılan oyuncuların yeni parolaya gereksinimi vardır; odada zaten olan oyuncular kalır. Servis, bir odanın parolasını ne sıklıkla değiştirebileceğini sınırlar; Password update limit. Try later. gibi bir reddetme, yeniden denemeden önce beklemeniz gerektiği anlamına gelir.

Parametreler

passwordstring | nullzorunlu
En fazla 64 karakter, veya parolayı kaldırmak için null ya da "".

Döndürür

Promise<void>

JavaScript
await room.setPassword('derby-night');
await room.setPassword(null); // open again

requireVerification

özellik
room.requireVerification: boolean | null
salt okunur

Katılan oyuncuların bir insan doğrulama testinden geçmesi gerekip gerekmediği. Oda kabul edilmeden önce, kapandıktan sonra veya bir güncellemenin sonucu bilinmezken null.

setRequireVerification()

yöntem
room.setRequireVerification(required: boolean): Promise<void>

Katılıma bir insan doğrulama testi ekler, bu da otomatik katılımları yavaşlatır. Doğrulama sunmayan bir serviste Room verification is not configured on this server. ile reddedilir.

Parametreler

requiredbooleanzorunlu
Şu andan itibaren katılan oyunculardan doğrulama istemek için true.

Döndürür

Promise<void>

JavaScript
await room.setRequireVerification(true);