JavaScript SDK'sıyla canlı mesajlar ve iletişim durumu gönderin
Çalışan bir yığına karşı gözlemlenen her çağrının davranışıyla birlikte aura.realtime günlük akışları.
Kanallar ve durumları#
Kanal, adlandırılmış bir odadır. Aynı adı açan istemciler birbirlerinin mesajlarını alırlar. Abone olduğunuzda istemci kendi kendine bağlanır.
const room = aura.realtime.channel('room-1')
room.subscribe((status) => {
// 'ABONE OLDU' | 'CHANNEL_ERROR' | 'TIMED_OUT' | 'KAPALI'
if (status === 'SUBSCRIBED') console.log('ready')
})
Yalnızca SUBSCRIBED tarihinden sonra gönderin. Bundan önce veya reddedildikten sonra send(), göndermek yerine not_connected veya requires_subscription gibi bir durumu döndürür. Kanalların kapsamı projenize göre belirlenir: iki proje birbirini görmeden aynı adı kullanabilir.
Yayın mesajları#
// Al
room.on('broadcast', { event: 'ping' }, (message) => {
console.log(message.payload) // { etkinlik: 'ping', n: 1, metin: 'merhaba' }
})
// ABONE OLDUĞUNUZDA gönderin
const status = await room.send({ type: 'broadcast', event: 'ping', payload: { n: 1, text: 'hello' } })
// → 'tamam'
Gerçek bir çalışmada, oturum açan ikinci bir istemci mesajı iki saniyeden kısa bir sürede aldı.
Aldığınız mesaja payload: { "event": "ping", "n": 1, … } eklenmiş etkinlik adı eklenmiştir. Kendi event anahtarına sahip bir veri reddedilir (channel.send şunu döndürür: 'invalid_payload', httpBroadcast şunu döndürür: realtime_payload_event_reserved): anahtarı yeniden adlandırın, örneğin kind.
- Varsayılan olarak kendi mesajlarınızı almazsınız. Bunları almak için
{ config: { broadcast: { self: true } } }ile kanalı açın. - Bir mesaj
id,topic,timestamp,eventvepayloadtaşır.
Mevcudiyet#
Varlık, seçtiğiniz bir durumla bir kanala kimin bağlı olduğunu gösterir.
const lobby = aura.realtime.channel('lobby', { config: { presence: { key: user.id } } })
lobby.on('presence', { event: 'sync' }, () => {
console.log(lobby.presenceState())
})
lobby.subscribe(async (status) => {
if (status === 'SUBSCRIBED') await lobby.track({ name: 'Bob' })
})
presenceState() kullanıcı kimliğiyle anahtarlanır. Her giriş kullanıcının bağlantılarını listeler:
{
"d6ba3994-…": [
{ "client_id": "936cb015-…", "user_id": "d6ba3994-…", "metadata": { "name": "Bob" },
"joined_at": "2026-10-12T19:32:19.093Z", "last_seen": "2026-10-12T19:32:19.096Z" }
]
}
untrack() sizi listeden çıkarır ve kanaldan ayrılmak veya sayfayı kapatmak sizin için bunu yapar.
Veritabanı değişiklikleri#
postgres_changes projelerde kendi veri tabanıyla çalışır. Önce her tabloyu etkinleştirin: PUT /v1/db/schema/tables/{table}/realtime (veya aura db table realtime <table> on), {"enabled": true} gövdesi ve service_role anahtarıyla. Dinleme, ilk müşteri abone olduğunda başlar ve son müşteri ayrıldıktan birkaç dakika sonra durur. Teslimat en az bir kez yapılır: sunucu yeniden başlatıldıktan sonra değişiklik iki kez gelebilir, bu nedenle örneğin satırın birincil anahtarını tuşlayarak işleyicinizi bağımsız hale getirin. Meşgul bir küme, yeni bir dinleyiciyi kapasite hatasıyla reddedebilir; kısa süre sonra tekrar deneyin. Herhangi bir kanal adı işe yarar: her filtrenin table'si dinlenecek tabloyu seçer ve bir kanal birden fazla tabloyu dinleyebilir. db:<schema>.<table> adlı bir kanalda her filtrenin bir table değerine ihtiyacı vardır. İlk abone, abone olmadan hemen önce yapılan değişiklikleri 5 saniyeye kadar alabilir. Değişiklikler, kurtarma için bir saat süreyle tutulur, ardından silinir. Küme dolduğunda abonelik capacité d'écoute postgres_changes atteinte pour la base de ce projet, réessayez ile başarısız olur. Dinleme bir dakikadan uzun süre kapalı kalırsa, kanal CHANNEL_ERROR'ye geçer, ardından dinleme yeniden başlatıldığında SUBSCRIBED'ye geri döner; tekrar abone olmanıza gerek yoktur. Bir kesinti bir saatlik saklama süresini aşarsa kanal ayrıca CHANNEL_ERROR ile changements postgres_changes perdus pendant l'interruption, resynchronisez alır: verileri veritabanından yeniden yükler. Bir değişiklik her teslim edildiğinde aynı id değerini korur, böylece daha önce işlem yaptığınız bir id öğesini de atlayabilirsiniz. Silme satırı artık mevcut olmadığından satır düzeyindeki güvenlik bunun üzerinde değerlendirilemez. Satır düzeyinde güvenliğe sahip bir tabloda, bir DELETE bu nedenle yalnızca rolü tabloda SELECT politikasına sahip olan (veya RLS gibi service_role atlayan) abonelere teslim edilir: okuma politikası olmayan bir ziyaretçi (anon) bunu almaz. Satır düzeyinde güvenliğin olmadığı bir tabloda her abone bunu alır. DELETE'nin payload.old'si yalnızca birincil anahtar sütunlarını tutar (tabloda birincil anahtar yoksa hiçbir şey yoktur) ve başka herhangi bir sütundaki filtre hiçbir zaman bir silme işlemiyle eşleşmez. Bir UPDATE için, payload.old ayrıca önceki satırın yalnızca birincil anahtar sütunlarını (anahtar değiştiyse önceki değerleri) tutar, diğer değerlerini asla tutmaz: satır düzeyi güvenliği yalnızca yeni satırda kontrol edilir. UPDATE filtresi yeni satıra uygulanır. Hassas bilgileri birincil anahtarlardan uzak tutun.
const changes = aura.realtime
.channel('todos')
.on('postgres_changes', { event: '*', schema: 'public', table: 'todos' }, (payload) => {
console.log(payload.eventType, payload.new)
})
.subscribe((status) => {
if (status === 'CHANNEL_ERROR') console.warn('database changes are not available for this project')
})
Temizlemek#
room.unsubscribe() // bir kanaldan ayrıl
aura.realtime.removeChannel(room) // git ve unut gitsin
aura.realtime.removeAllChannels() // her kanalı bırak
aura.realtime.disconnect() // bağlantıyı kapat
aura.realtime.onStateChange(callback) ve onError(callback) ile bağlantıyı izleyin. Bir kesintiden sonra, siz setAutoReconnect(false) çağırmadığınız sürece istemci kendi kendine yeniden bağlanır.