Gateway olayları¶

Bir gönderim (Dispatch), Gateway üzerinden bir değişikliği ya da bir komutun sonucunu bildirir. İşlem kodu (opcode) 0'dır; bir olay adı ve bir yük taşır.

Dispatch zarfı¶

{
  "op": 0,
  "t": "MESSAGE_CREATE",
  "s": 17,
  "d": { }
}

Ready sırayı 1 olarak başlatır. Canlı Dispatch'ler sırayı birer artırır. Yeniden oynatılan Dispatch'ler özgün sıralarını korur ve aralarında boşluk olabilir. Resumed, oturumun geçerli sırasını artırmadan taşır. Sıra tek bir Gateway oturumuna özeldir; shard'lar veya HTTP işlemleri arasında hiçbir şeyi sıralamaz.

Dispatch teslimi¶

Olay filtreleme, teslimi sunucu erişilebilirliğine, kanal görünürlüğüne, izinlere ve oturum ayarlarına göre tanımlar. Hesap kapsamlı Dispatch'ler yalnızca oturum düzeyindeki filtrelerden, yani shard filtresinden ve ignored_events listesinden geçer.

Sunucu kapsamlı Dispatch'lerin çoğu bir guild_id dizesi taşır; Gateway bunu bir sunucuya dağıttığı her olaya ekler. Guild Create ve Guild Sync sunucuyu id olarak tanımlar. Guild Counts Update ve Channel Member Counts Update üst düzeyde guild_id taşımaz; counts dizilerindeki her girdinin kendi guild_id alanı vardır.

İşlemi başlatan oturum bir Dispatch'ten yalnızca sunucu kanalındaki Message Reaction Add ve Message Reaction Remove için ve yalnızca HTTP isteği bir session_id sorgu parametresi verdiyse hariç tutulur. Bu alan yükten çıkarılır. Doğrudan mesaj tepkisindeki aynı alan her alıcıya değiştirilmeden iletilir ve kimseyi hariç tutmaz. Diğer tüm değişiklikler Dispatch'lerini, uygun olan her oturum gibi işlemi yapan oturuma da teslim eder.

Bir Dispatch, Guild Sync, Guild Member List Update veya Guild Members Chunk değilse Resume yeniden oynatması için arabelleğe alınır. Bu üçü canlı teslim edilir ve hiç saklanmaz. Tek başına aşırı büyük bir Dispatch, Sınırlar ve hız sınırları sayfasında anlatıldığı gibi teslim edilir ama saklanmaz. Ready de yeniden oynatma arabelleğinin dışında gönderilir.

Dispatch olayları¶

TEBHOS kendi istemcileri için ürüne özgü bir olay kümesi de gönderir. Bunlar TEBHOS istemci olayları altında listelenmiştir.

TEBHOS hiçbir zaman FAVORITE_MEME_CREATE göndermez: kayıtlı mem oluşturan bir yol yoktur.

Oturum ve geçerli kullanıcı¶

READY¶

İlk oturum durumu. Başarılı bir Identify sonrasında bir kez, her zaman sıra 1 ile gönderilir.

Yük ayrıca TEBHOS istemcilerinin okuma durumu önbelleğini doldurmak için kullandığı channels ve read_state_proto alanlarını da taşıyabilir. Bunları iç alan olarak değerlendirin.

Ready yeniden oynatma arabelleğinin dışında gönderilir; bu yüzden bir Resume onu hiçbir zaman yeniden oynatmaz.

Bir bot oturumu, kimliği doğrulanır doğrulanmaz boş bir guilds dizisiyle Ready alır. Ardından oturum her sunucuya bağlandıkça sunucular tek tek gelir: erişilebilir her sunucu için bir Guild Create, erişilemeyen her sunucu için unavailable: true taşıyan bir Guild Delete. Bunlar sıradan Dispatch'lerdir ve diğerleri gibi yeniden oynatma arabelleğinde tutulur.

Ready'den kısa süre sonra her oturum, etkin araması olan her özel kanalı için bir Call Create alır.

Guild ready nesnesi¶

Aynı yapı Ready, Guild Create ve Guild Sync içinde görünür.

Üye listesinin geri kalanına ihtiyaç duyan bir istemci bunu Request Guild Members ile ister ya da Lazy Request aracılığıyla bir üye listesine abone olur.

Erişilemez bir sunucu id ve unavailable: true alanlarına indirgenir; sunucu gizliyse bunlara unavailable_hidden: true eklenir.

Ready içinde members içindeki her girdinin user alanı {"id": "..."} ile değiştirilir ve çıkarılan hesaplar Ready'nin users dizisinde yer alır. Ready'den sonra gönderilen bir Guild Create (bir botun kendi sunucuları için aldıkları dahil) ve her Guild Sync üyeleri user alanı eksiksiz olarak taşır.

Session presence nesnesi¶

İlk girdi her zaman session_id: "all" değerini ve hesabın birleşik durumunu taşır.

WebAuthn credential nesnesi¶

RTC region nesnesi¶

Dizi her zaman id değeri automatic ve name değeri Automatic olan yapay bir girdiyle başlar. Bu girdinin seçilmesi bölge seçimini sunucuya bırakır. Diğer her girdi hesabın kullanabileceği bir bölgedir; Identify özelliklerindeki latitude ve longitude değerlerinin ikisi de sayı olarak çözümlenebiliyorsa bu konuma uzaklığa göre, aksi hâlde bölge kimliğine göre sıralanır.

RESUMED¶

Başarılı bir Resume, verilen sıranın üzerindeki tüm saklanan Dispatch'leri yeniden oynattıktan sonra gönderilir. Yük, personel hesapları için isteğe bağlı bir zamanlama nesnesi dışında boştur. Resumed, oturumun geçerli sırasını s içinde artırmadan taşır.

SESSIONS_REPLACE¶

Hesabın canlı oturum kümesi değişti. Yük, session presence nesnelerinden oluşan çıplak bir JSON dizisidir ve her zaman kümenin tamamıdır. Ready ilk kümeyi sessions olarak gönderir.

AUTH_SESSION_CHANGE¶

Hesabın giriş oturumları, diğer cihazların tepki vermesi gereken bir şekilde değişti.

RATE_LIMITED¶

Bir Request Guild Members komutu, bot tam üye listesi bütçesi tarafından reddedildi. Yalnızca isteği yapan oturuma teslim edilir.

Bütçe, her bot hesabı ve sunucu için 30,000 ms'de bir filtresiz üye isteğine izin verir. Diğer tüm komut retleri sessizdir.

USER_UPDATE¶

Geçerli kullanıcının hesap kaydı değişti. Yük, özel gösterimdeki eksiksiz user nesnesidir.

USER_SETTINGS_UPDATE¶

Geçerli kullanıcının hesap geneli ayarları değişti. Yük, eksiksiz user settings nesnesidir.

USER_GUILD_SETTINGS_UPDATE¶

Bir sunucunun bildirim ayarları değişti. Yük, o sunucunun user_id eklenmiş eksiksiz user guild settings nesnesidir.

USER_NOTE_UPDATE¶

Geçerli kullanıcı özel bir not yazdı veya temizledi.

USER_PINNED_DMS_UPDATE¶

Geçerli kullanıcının sabitlenmiş özel kanal kümesi değişti.

channels her zaman kümenin tamamıdır. Ready ilk kümeyi pinned_dms olarak gönderir.

USER_CONNECTIONS_UPDATE¶

Geçerli kullanıcının dış bağlantı kümesi değişti.

WEBAUTHN_CREDENTIALS_UPDATE¶

Geçerli kullanıcının geçiş anahtarı kümesi değişti. Yük, WebAuthn credential nesnelerinden oluşan çıplak bir JSON dizisidir ve her zaman kümenin tamamıdır.

RELATIONSHIP_ADD¶

Geçerli kullanıcı bir ilişki kazandı.

RELATIONSHIP_UPDATE¶

Mevcut bir ilişki değişti. Yük, Relationship Add ile aynı yapıya sahiptir.

RELATIONSHIP_REMOVE¶

Bir ilişki sona erdi.

SAVED_MESSAGE_CREATE¶

Geçerli kullanıcı bir mesajı kaydetti. Yük, o kullanıcının gördüğü biçimiyle, message_id eklenmiş eksiksiz message nesnesidir.

SAVED_MESSAGE_DELETE¶

Geçerli kullanıcı bir mesajın kaydını kaldırdı.

RECENT_MENTION_DELETE¶

Geçerli kullanıcı bir mesajı son bahsetmeler akışından kaldırdı.

FAVORITE_MEME_UPDATE¶

Geçerli kullanıcının kayıtlı memlerinden biri değişti. Yük, eksiksiz meme nesnesidir.

FAVORITE_MEME_DELETE¶

Geçerli kullanıcı kayıtlı bir memi sildi.

Sunucular ve kanallar¶

GUILD_CREATE¶

Bir sunucu oturum için erişilebilir hâle geldi. Yük bir guild ready nesnesidir.

roles, channels, emojis, stickers ve voice_states her zaman eksiksizdir; istemci depoladığı listeleri bunlarla değiştirir. members kısmi bir listedir: bu üyeleri ekleyin veya güncelleyin, geri kalanını koruyun.

Bir sunucu Ready'den sonra erişilebilir hâle geldiğinde, örneğin bir sunucuya katıldıktan ya da erişilemez bir sunucu toparlandıktan sonra, her oturum Guild Create alır. Bot oturumu, Ready'si hiç sunucu taşımadığı için, Ready'den sonra erişilebilir her sunucusu için de bir tane alır.

GUILD_SYNC¶

Lazy Request aracılığıyla eşitleme isteyen bir oturum, sunucunun tüm güncel durumunu yeniden alır. Yük bir guild ready nesnesidir ve istemci bunu Guild Create gibi işler.

TEBHOS, bir Lazy Request sunucuyu etkin ile pasif arasında geçirdiğinde ve sync: true sunucuyu belirttiğinde eşitleme gönderir.

GUILD_UPDATE¶

Bir sunucunun yapılandırması değişti. Yük, guild_id eklenmiş eksiksiz guild nesnesidir.

Guild Update, erişilemez bir sunucunun gönderdiği tek Dispatch'tir.

GUILD_DELETE¶

Bir sunucu oturumun görünürlüğünden çıktı ya da erişilemez oldu.

Bu olayı iki kaynak gönderir. Gateway, oturum sunucudan ayrıldığında {id}, sunucuya geçici olarak ulaşılamadığında {id, unavailable: true} gönderir. API ayrıca sunucu silindiğinde, kullanıcı atıldığında ve kullanıcı ayrıldığında etkilenen kullanıcıya {guild_id, reason} gönderir. İstemci sunucuyu hangisi varsa id veya guild_id alanından okur.

unavailable yoksa hesap artık üye değildir ve istemci o sunucu için depoladığı her şeyi siler. unavailable: true varsa istemci, daha sonraki bir Guild Create gelene kadar sunucuyu erişilemez bir girdi olarak tutar.

GUILD_ROLE_CREATE¶

Bir sunucuda rol oluşturuldu.

GUILD_ROLE_UPDATE¶

Tam olarak bir rol kaydı değişti.

GUILD_ROLE_UPDATE_BULK¶

Tek bir işlem, çoğunlukla bir yeniden sıralama, birkaç rolü birlikte değiştirdi.

GUILD_ROLE_DELETE¶

Bir sunucudan rol silindi.

GUILD_EMOJIS_UPDATE¶

Bir sunucunun emojileri değişti.

İstemci depoladığı emojileri bu diziyle değiştirir. TEBHOS emoji başına olay göndermez.

GUILD_STICKERS_UPDATE¶

Bir sunucunun çıkartmaları değişti.

İstemci depoladığı çıkartmaları bu diziyle değiştirir. TEBHOS çıkartma başına olay göndermez.

CHANNEL_CREATE¶

Bir kanal, yeni oluşturulduğu ya da yeni izin verildiği için oturuma görünür hâle geldi. Yük eksiksiz channel nesnesidir; sunucu kanalında guild_id bulunur.

CHANNEL_UPDATE¶

Görünür bir kanal değişti. Yük eksiksiz channel nesnesidir.

CHANNEL_UPDATE_BULK¶

Tek bir işlem, çoğunlukla bir yeniden sıralama, birkaç kanalı birlikte değiştirdi.

Her alıcı yalnızca görebildiği kanalları görür. Boş sonuç Dispatch üretmez ve sıra numarası tüketmez.

CHANNEL_DELETE¶

Bir kanal, silindiği ya da yeni gizlendiği için oturumun görünürlüğünden çıktı. Sunucu kanalında yük, değişiklikten önceki hâliyle channel nesnesidir ve alıcılar onu görebilen oturumlardır. Geçerli kullanıcı bir özel kanalı kapattığında veya ondan ayrıldığında yük {id, channel_id, type} olur.

CHANNEL_RECIPIENT_ADD¶

Bir kullanıcı, oturumun dahil olduğu bir grup DM'ye katıldı.

CHANNEL_RECIPIENT_REMOVE¶

Bir kullanıcı, oturumun dahil olduğu bir grup DM'den ayrıldı.

WEBHOOKS_UPDATE¶

Bir sunucu kanalının webhook kümesi değişti. Olay webhook verisi taşımaz; yeni kümeye ihtiyaç duyan istemci onu HTTP API üzerinden okur.

INVITE_CREATE¶

Bir sunucu daveti oluşturuldu. Yük, GET /invites/{code} yolunun döndürdüğü gövdeyle aynı olan eksiksiz invite nesnesidir. Davetin kanalında MANAGE_CHANNELS iznine sahip oturumlara ulaşır.

INVITE_DELETE¶

Bir sunucu daveti silindi.

Alıcılar Invite Create ile aynı şekilde seçilir.

Üyeler ve moderasyon¶

GUILD_MEMBER_ADD¶

Bir kullanıcı, oturumun bağlı olduğu bir sunucunun üyesi oldu. Yük, guild_id eklenmiş eksiksiz guild member nesnesidir.

GUILD_MEMBER_UPDATE¶

Bir üyenin sunucu durumu veya herkese açık kullanıcı gösterimi değişti. Yük, guild_id eklenmiş eksiksiz guild member nesnesidir.

250'den fazla üyesi olan bir sunucuda pasif bir oturum bu olayı yalnızca konu kendi kullanıcısı olduğunda alır.

GUILD_MEMBER_REMOVE¶

Bir kullanıcı, oturumun bağlı olduğu bir sunucunun üyesi olmaktan çıktı.

250'den fazla üyesi olan bir sunucuda pasif bir oturum bu olayı yalnızca konu kendi kullanıcısı olduğunda alır.

GUILD_MEMBERS_CHUNK¶

İsteği yapan oturum için Request Guild Members komutunu yanıtlar.

Hiçbir üyeyle eşleşmeyen bir istek de boş bir members dizisi, chunk_index 0 ve chunk_count 1 ile bir parça üretir. Bu olay Resume için hiçbir zaman saklanmaz.

GUILD_MEMBER_LIST_UPDATE¶

Oturumun Lazy Request aracılığıyla abone olduğu bir üye listesi, abonenin aralıklarını yeniden eşitler.

Member list group nesnesi¶

Sayısı 0 olan grup çıkarılır. offline grubu 1,000'den fazla üye içerdiğinde de öğeleriyle birlikte çıkarılır.

Member list operation nesnesi¶

TEBHOS'un gönderdiği tek işlem SYNC'tir. İstemci tanımadığı bir işlemi yok saymak ZORUNDADIR.

Member list item nesnesi¶

Her öğe alanlardan tam olarak birini içerir.

GUILD_AUDIT_LOG_ENTRY_CREATE¶

Bir denetim kaydı girdisi yazıldı. Yük, guild_id eklenmiş denetim kaydı girdisidir. Alıcılar, işlemi yapan oturum dahil, sunucuda VIEW_AUDIT_LOG iznine sahip tüm oturumlardır.

GUILD_BAN_ADD¶

Bir sunucu yasaklaması oluşturuldu.

GUILD_BAN_REMOVE¶

Bir sunucu yasaklaması kaldırıldı.

PRESENCE_UPDATE¶

Görünür bir durum (presence) değişti. Yük bir presence nesnesidir.

Bir oturum; bir arkadaş için, dahil olduğu bir grup DM'nin alıcısı için ve bir Lazy Request komutunun members dizisiyle abone olduğu bir sunucu üyesi için durum alır. Bot oturumunun arkadaş veya grup DM aboneliği yoktur; bu yüzden ona ulaşan tek yol sunucu yoludur.

Presence nesnesi¶

Bir hesabın yayımlanan status değeri, canlı oturumları arasındaki en yüksek öncelikli durumdur; öncelik sırası dnd, online, idle, invisible şeklindedir, hiçbir oturum canlı değilse offline olur. invisible seçen bir oturum ve canlı oturumu olmayan bir hesap, ikisi de status: "offline" yayımlar. Taşıma katmanını kaybeden bir oturum 60,000 ms boyunca resume edilebilir kalsa da 5,000 ms sonra offline olarak yayımlanır. Yayımlanan durum offline olduğunda custom_status her zaman null olur.

Custom status nesnesi¶

PRESENCE_UPDATE_BULK¶

Tek Dispatch'te teslim edilen birkaç görünür durum. Bir sunucu bunu yalnızca erişilemez durumdan çıktığında, onu geri getiren Guild Create olayının hemen ardından gönderir.

PASSIVE_UPDATES¶

250'den fazla üyesi olan bir sunucudaki pasif oturum, kaçırdığı değişiklikleri her 30,000 ms'de bir alır. Hiçbir şey değişmediyse olay gönderilmez.

Mesajlar ve tepkiler¶

MESSAGE_CREATE¶

Görünür bir mesaj oluşturuldu. Yük, aşağıdaki alanlar eklenmiş eksiksiz message nesnesidir.

Mesaj oturumun kullanıcısından bahsettiğinde Message Create hem pasif filtreyi hem de ignored_events listesini geçersiz kılar. Bkz. Olay filtreleme.

MESSAGE_UPDATE¶

Görünür bir mesaj değişti. Yük, eksiksiz güncel message nesnesidir. Sunucu kanalında guild_id ve member ile genişletilir.

MESSAGE_DELETE¶

Görünür bir mesaj silindi.

MESSAGE_DELETE_BULK¶

Tek kanaldaki birkaç mesaj birlikte silindi.

MESSAGE_ACK¶

Geçerli kullanıcının bir kanaldaki okuma durumu ilerledi; genellikle hesabın başka bir oturumu kanalı okuduğu için.

MESSAGE_REACTION_ADD¶

Bir kullanıcı bir mesaja tepki ekledi.

Sunucu kanalında isteğin session_id ile belirttiği oturum hariç tutulur ve alan kaldırılır. Özel kanalda alan teslim edilir ve kimseyi hariç tutmaz; bu nedenle istemci kendi tepkisinin geri gelmesine dayanıklı olmak ZORUNDADIR.

Reaction emoji nesnesi¶

MESSAGE_REACTION_ADD_MANY¶

DEBOUNCE_MESSAGE_REACTIONS oturum bayrağı ile özel kanal eklemeleri 650 ms boyunca gruplanır ve birlikte teslim edilir. Her pencere en son 512 eklemeyi tutar. Sunucu kanalı eklemeleri her zaman ayrı Message Reaction Add olayları olarak gelir.

Birkaç mesajı kapsayan bir pencere, her mesaj için ayrı bir Dispatch üretir. Pencere tam olarak tek bir ekleme tutarak kapanırsa oturum düz bir Message Reaction Add alır.

MESSAGE_REACTION_REMOVE¶

Bir kullanıcının tepkisi bir mesajdan kaldırıldı. Yük, Message Reaction Add ile aynı alanlara sahiptir ve hariç tutma da aynı şekilde çalışır.

MESSAGE_REACTION_REMOVE_ALL¶

Bir mesajdaki tüm tepkiler bir kerede kaldırıldı.

MESSAGE_REACTION_REMOVE_EMOJI¶

Bir mesajdan tek bir emojiyi kullanan tüm tepkiler kaldırıldı.

TYPING_START¶

Görünür bir kullanıcı bir kanalda yazmaya başladı.

Sunucuda teslimi Lazy Request ile ayarlanan typing geçersiz kılması belirler. Geçersiz kılma yoksa oturum, sunucuda etkinse ya da sunucunun 250 veya daha az üyesi varsa olayı alır.

CHANNEL_PINS_UPDATE¶

Bir mesaj sabitlendi veya sabitlemesi kaldırıldı.

CHANNEL_PINS_ACK¶

Geçerli kullanıcı bir kanalın sabitlemelerini onayladı. Hesabın her oturumu bunu alır.

Ses ve aramalar¶

VOICE_STATE_UPDATE¶

Bir katılımcının ses durumu değişti. Yük bir voice state nesnesidir. Alıcılar, pasif oturumlar dahil, ses kanalını görebilen oturumlardır. channel_id değerinin null olması katılımcının ayrıldığı anlamına gelir.

Voice state nesnesi¶

VOICE_SERVER_UPDATE¶

Oturum kendi ses iznini aldı veya değiştirdi. Yalnızca isteği yapan oturuma teslim edilir.

TEBHOS ses medyası için LiveKit kullanır. İkinci bir ses WebSocket'i, ses işlem kodu kümesi veya UDP keşif adımı yoktur. Bkz. Ses.

İzin; bir bağlantı açıldığında, başka bir kanala taşındığında ve bölgesi değiştiğinde verilir. self_mute, self_video veya self_stream değerlerini değiştirmek yeni izin üretmez.

ENTRANCE_SOUND_PLAY¶

Bir katılımcı, bağlı olduğu bir ses kanalında giriş sesini çaldı. Bkz. Giriş sesleri.

Alıcılar, o kanalda ses durumu olan diğer tüm hesaplardır; her hesaba bir kez. Olay bir hesabın tüm oturumlarına ulaşır; bu yüzden istemci channel_id üzerinden filtreler.

CALL_CREATE¶

Bir özel kanal araması başladı ya da oturumun ilk durumunda görünür hâle geldi.

Alıcılar, aramaya katılıp katılmadıklarından bağımsız olarak kanalın tüm alıcılarıdır. Call Update ve Call Delete de aynı kümeye gider.

CALL_UPDATE¶

Etkin bir aramanın çaldırılanlar kümesi, katılımcı listesi veya bölgesi değişti. Gateway biçimi, recipients ve created_at olmadan Call Create ile aynı yapıya sahiptir ve yalnızca arama durumu görünür biçimde değiştiğinde gönderilir. HTTP üzerinden yapılan bir bölge değişikliği ayrıca id, call_id, channel_id, initiator_id, livekit_room_name, started_at, region, voice_states, ringing ve message_id içeren bir API biçimi gönderir.

CALL_DELETE¶

Bir arama sona erdi ya da erişilemez oldu.

unavailable: true varsa istemci aramayı erişilemez bir girdi olarak tutar. Arama yeniden erişilebilir olursa yeni bir Call Create recipients ve created_at içerir.

Sayım yanıt olayları¶

GUILD_COUNTS_UPDATE¶

İsteği yapan oturum için Request Guild Counts komutunu yanıtlar.

Guild count entry nesnesi¶

CHANNEL_MEMBER_COUNTS_UPDATE¶

İsteği yapan oturum için Request Channel Member Counts komutunu yanıtlar.

Channel count entry nesnesi¶

TEBHOS istemci olayları¶

TEBHOS web, masaüstü ve mobil istemcileri aşağıdaki olayları da alır. Bu olaylar standart bir olayı olmayan ürün özelliklerini (canlı odalar, Pro, takviyeler, kategoriler, kozmetikler) yönetir ya da istemcilere standart bir olayın yanında daha hızlı ve daha küçük bir sinyal verir. Yükleri TEBHOS istemcileri için biçimlendirilmiştir ve haber verilmeden değişebilir; bu nedenle bir botun yukarıdaki standart olaylara dayanması ve bunları yok sayması GEREKİR. Her biri ignored_events kuralına tabidir.

Kaynak gösterimi¶

Bu sayfada adı geçen her kaynak nesnesi, HTTP API tarafından tanımlanan gösterime sahiptir. Kaynak nesnesi içeren bir Dispatch yükü aynı alanlara sahiptir; sunucu kapsamlı olaylar guild_id, mesaj ve tepki olayları member ekler.

Aşağıdaki indirgemeler Gateway'e özeldir. Ready, her ilişkiden ve her sunucu üyesinden user alanını çıkarır ve bu hesapları users dizisine taşır. Bir mesaj olayına eklenen member alanının kendi user alanı kaldırılmıştır; hesap mesajın author alanında bulunur.